DRS - Test your skill

Integrate Dash Replenishment

STEP 1:
Overview

→

STEP 2:
Requirements

→

STEP 3:
Create a device

→

STEP 4:
Create a skill

→

STEP 5:
Create a Lambda function

→

STEP 6:
Test your integration

Tip: You are viewing the latest version of the DRS docs. To access the legacy APIs click here.

Step 1. Testing device discovery
- Testing your Lambda function
- Testing on a physical device
Step 2. Testing the end-to-end functionality
- Run the certification test cases
Next steps

Step 1. Testing device discovery

Testing your Lambda function

You may now perform a quick test of the Discovery request in the Lambda code editor.

Click on Test. The Configure test event page appears.
Leave Create new test event selected. For Event template, leave the default Hello World. In the Event name, enter discovery and replace the entire contents in the editor with the following code.

{
    "directive": {
        "header": {
            "namespace": "Alexa.Discovery",
            "name": "Discover",
            "payloadVersion": "3",
            "messageId": "1bd5d003-31b9-476f-ad03-71d471922820"
        },
        "payload": {
            "scope": {
                "type": "BearerToken",
                "token": "access-token-from-skill"
            }
        }
    }
}

Click Create, and then Test. If successful, the Execution Result should be similar to the following:

{
  "event": {
    "header": {
      "correlationToken": "12345692749237492",
      "messageId": "1bd5d003-31b9-476f-ad03-71d471922820",
      "name": "Discover.Response",
      "namespace": "Alexa.Discovery",
      "payloadVersion": "3"
    },
    "payload": {
      "endpoints": [{
          "endpointId": "appliance-001",
          "friendlyName": "Printer",
          "description": "Printer by Sample Manufacturer",
          "manufacturerName": "Sample Manufacturer",
          "displayCategories": [
            "OTHER"
          ],
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.InventoryLevelSensor",
              "version": "3",
              "instance": "InventoryLevelSensor-1",
              "properties": {
                "supported": [{
                  "name": "level"
                }],
                "proactivelyReported": true,
                "retrievable": true
              },
                // Other Capabilities here
            }
          ]
        }]
    }
  }
}

Testing on a physical device

When your implementation is completed, and you have tested your Lambda function, you can functionally test your smart home skill to ensure device discovery is working as expected.

Make sure you have a smart home trigger added and enabled. To check this, go to the Lambda console, select your smart home skill, and make sure you have an Alexa Smart Home trigger. If you don't, go back to the Step 5 of Creating the Lambda Function
Sign in to the Alexa app (available on Android, iOS or the web (Opens in a new tab) with the same credentials as your developer account.
Find your skill in the Alexa app. To do this, go to Skills, and tap Your Skills in the upper right corner of the All Skills page. Scroll to DEV SKILLS and find your skill.
Click the ENABLE button to enable the skill, and you will be directed to account-link the skill to a device cloud account. If you are unable to complete account linking, make sure you are using valid credentials for the device cloud. Otherwise, it is likely there is an issue with account-linking information you provided in the developer console. For help with this, see Alexa: Debugging account linking in the developer forums. If you want to remove account linking later, you should disable your skill in the Skills tab.
Close the window and tap the DISCOVER DEVICES button in the Alexa app.
If the skill does not discover devices, check the logs for your Lambda function to see if it received a discover directive from Alexa, and use the logs to troubleshoot the issue. Common issues include incorrectly formatted event responses.
If your skill successfully discovers devices, return to the Test page of the developer console. You may test other functionalities of the skill (if any).

Step 2. Testing the end-to-end functionality

Run the certification test cases

Important: Do not deregister until certification is approved from your Amazon program manager via email.

Set up a physical device through Alexa by opening the Alexa app and completing the DRS set-up upon device discovery. When selecting the notification and reorder options, choose the Automatic reorder when supply is low option.
Check that the inventory you are sending is being captured correctly (ensure the levels match any third-party app levels being reported).

To see the latest consumable level (for example, battery level), go to Device Settings > Supply.

Low supply notification

You will receive a notification email when the consumable level drops to your low level threshold. In some cases, we wait for three low-level PSU updates before sending a notification to be sure that it was not a random fluctuation causing the battery to report low threshold.
Trigger a low inventory level replenishment for each slot (replenishmentId).

Use the product so that the consumable level drops below the low-level threshold. (Note: For a replenishment order to be triggered, your consumable level must drop and remain at or below your low level threshold for 3 consecutive inventory level updates.)
Reset the inventory level for each slot (replenishmentId).

Replace the consumable (for example, replace the battery or ink cartridge) of the product and leave the device running until at least one ChangeReport with a new inventory value is sent to Alexa.
Check the selection for your device. Go to Device Settings > Supply and click on the ASIN. This shows you all the ASINs that customers can select for your device.
Trigger a low-inventory-level notification for each slot (replenishmentId):
1. Go to Device Settings, then tap on Change in the Status (Supply) section.
2. Tap on the setting in Supply Settings section to open the "Notification and reorder settings" page.
3. Select Notify me when supply is low and then Continue.
4. Use the product so that the consumable level drops below the low-level threshold.

Next steps

Once you are satisfied that the skill is performing the two main DRS functionalities (Discovery and Inventory updates), you may submit it for DART certification. Please liaise with your account manager or send an email to drs-support@amazon.com to start this process. Your account manager will reach out within 1-5 business days with the certification status and next steps.

You will need to provide the following information to your Amazon point of contact to initiate certification:

Vendor Code
3P Alexa Skill ID used for testing (should be production)
Endpoint ID of device used for testing
Encrypted Customer ID (CID) of customer/account used for executing test cases

To find the CID, using the test account, log in to the Developer Console, and then go to developer.amazon.com/mycid.html.

Last updated: Aug 15, 2019