Test Dash Replenishment

Follow these guidelines to test Dash Replenishment in the Alexa app and with an Alexa-enabled device.

Prerequisites

Before you test Dash Replenishment, complete the following prerequisites:

  • Register your device in the Dash console and receive replenishment IDs from Amazon. Use the allow-listed test accounts for testing.
  • Verify that your discovery response includes the inventory sensor interfaces in each region that you enable replenishment.
  • Verify that your connected device reports inventory levels as the customer uses your device.
  • Create an Amazon retail account for the test account credentials to use for smart reorder testing. After your test triggers a reorder, you have 24 hours to cancel the order. Cancel the order from the order history page on your Amazon retail account. If you miss the order cancellation, initiate a return.

Test account linking and discovery

Complete the following steps to enable your skill in the Alexa app installed on your desktop, or your iOS or Android mobile device.

To enable your skill and discover devices

  1. Sign in to the Alexa app with the same credentials as your developer account.
  2. To find your skill in the Alexa app, tap More, and then tap Skills & Games.
  3. In Skills & Games, tap Your Skills.
  4. Scroll the skill types to the right, and then tap Dev.
  5. Scroll to find your skill.
  6. Tap on your skill name, and then tap ENABLE TO USE.
  7. Follow the prompts to enter your credentials for your device cloud account.
  8. To allow access to the skill, tap Allow, and then tap CLOSE.
  9. Tap DISCOVER DEVICES.
    Or, navigate back to the skill page, and then tap DISCOVER DEVICES.
    Alexa sends a Discover request to your skill to learn about the connected devices. Your skill returns the discovery response with the details about the devices.
  10. After Alexa finds your device, tap SET UP DEVICE.
    If the app can't discover devices, check the logs for your Lambda function. Use the logs to troubleshoot the issue. Common issues include incorrectly formatted discovery responses.
  1. Sign in to the Alexa app in your browser with your Alexa developer account credentials.
  2. To find your skill, on the left, select Skills.
  3. On the All Skills page, click Your Skills.
  4. On the Your Skills page, click Dev Skills.
  5. Scroll to find your skill, and then select your skill name.
  6. On the skill page, to link your account with the skill, click ENABLE.
  7. Follow the prompts to enter your credentials for your device cloud account.
    The prompts might be in another browser tab or window.
  8. If account linking is successful, Alexa displays <Skill-name> has been successfully linked.
  9. Close the browser tab.
  10. On the skill page, select DISCOVER DEVICES.
    Alexa sends a Discover request to your skill to learn about the connected devices. Your skill returns the discovery response with the details about the device.
  11. After Alexa finds your device, on the Devices page, you see your device name. If the app can't discover devices, check the logs for your Lambda function. Use the logs to troubleshoot the issue. Common issues include incorrectly formatted discovery responses.

Enable smart reordering

For smart home skills with Dash Replenishment, during SET UP DEVICE, the Alexa app prompts you to set up smart reordering. Choose Automatic reorder when supply is low. Here, Alexa directs you to select the replacement products and confirm address and payment details.

At any time, you can view the current inventory and change the replenishment settings in the Alexa app. Select Devices, tap your device, and then tap the settings gear. Scroll down to the Status section, and then tap Supplies. On the SETTINGS page, you see a list of current levels and supplies. To enable smart reordering, tap When my supplies are running low, and then tap Smart reorder.

Verify inventory updates

Test end-end functionality to verify that your device reports the inventory correctly to Alexa. For each replacement product, complete the tests for the applicable sensor.

Level sensor

Verify the level sensor and the replenishment experience by performing the following tests:

  1. Consumption history – For each replenishment ID, as you use the device, verify that the inventory level in the Alexa app matches the level reported by the device.
    1. Trigger inventory change reporting events to Alexa by using the device or simulating usage.
    2. To view the reported level in the Alexa app, go to the settings page for your device, and then tap Supplies > Consumption History.
    3. Verify that the inventory level reported in the Alexa app matches the inventory level reported by your device, if applicable, in your device app.
  2. Low inventory reorder – For each replenishment ID, trigger inventory reorder.
    1. To enable smart reordering, in the Alexa app, go to the settings page for your device, and then tap Supplies > When my supplies are running low. Choose Smart reorder, and then tap Select.
    2. Use the device so that the consumable level drops below the low-level threshold.
    3. Verify that you receive an email to confirm the reorder.
  3. Low inventory notification – For each replenishment ID, verify the low supply notification when the level of the consumable product drops below the configured low-level threshold.

    1. To set up notifications, in the Alexa app, go to the settings page for your device, and then tap Supplies > When my supplies are running low. Choose Just notify me, and then tap Select.
    2. Use the product so that the consumed level drops below the low-level threshold.
    3. Verify that you receive an email and a voice notification on the connected Echo device.
  4. Reset inventory – For each replenishment ID, verify the new inventory level in the Alexa app.
    1. Replace the consumable product in the device and let the device run.
    2. Trigger inventory change reporting events to Alexa by using the device or simulating usage.
    3. To verify the new level in the Alexa app, go to the settings page for your device, and then tap Supplies > Consumption History.

Usage Sensor

Usage sensors don't know the amount of inventory. Here, the customer sets the household inventory for each consumable product in the Alexa app as follows:

  1. To view the inventory, go to Device Settings > Supplies, and then tap # Units.
  2. To change the inventory, go to Device Settings > Supplies, and then tap Add extra supply.
  3. To set the amount, tap + to increase the amount and to decrease the amount.
  4. To save, tap Next.

Verify the usage sensor and the replenishment experience by performing the following tests:

  1. Consumption history – For each replenishment ID, as you use the device, verify that the inventory usage in the Alexa app matches the usage reported by the device.
    1. Trigger inventory consumed events to Alexa by using the device or simulating usage.
    2. To view the reported usage in the Alexa app, go to the settings page for your device, and then tap Supplies > Consumption History.
    3. Verify that the inventory usage reported in the Alexa app matches the inventory usage reported by your device, if applicable, in your device app.
  2. Low inventory reorder – For each replenishment ID, trigger inventory reorder.
    1. Set the household inventory to one more than the low-level threshold.
    2. Use the device so that the inventory drops below the low-level threshold.
    3. Verify that you receive an email to confirm the reorder.
  3. Low inventory notification – For each replenishment ID, verify the low supply notification when the usage of the consumable product drops below the configured low-level threshold.
    1. To set up notifications, in the Alexa app, go to the settings page for your device, and then tap Supplies > When my supplies are running low. Choose Just notify me, and then tap Select.
    2. Set the household inventory to one more than the low-level threshold.
    3. Use the product so that the consumed usage drops below the low-level threshold.
    4. After the reported inventory is zero, verify that you receive an email and a voice notification on the connected Alexa-enabled device.

Level Usage Sensor

Verify the level usage sensor and the replenishment experience by performing the following tests:

  1. Consumption history – For each replenishment ID, as you use the device, verify that the inventory consumption duration in the Alexa app matches the duration reported by the device.
    1. Trigger inventory events to Alexa by using the device or simulating usage.
    2. To view the consumed duration in the Alexa app, go to the settings page for your device, and then tap Supplies > Consumption History.
    3. Verify that the duration changes during device usage.
    4. Verify that the consumed duration reported in the Alexa app matches the consumed duration reported by your device, if applicable, in your device app.
    5. Repeat with different durations, such as hours, minutes.
  2. Reset inventory – For each replenishment ID, verify the replacement date in the Alexa app.
    1. To change the replacement date in the Alexa app, go to the settings page for your device, tap Supplies > Last Replaced Date, and then set the date to older than 30 days.
    2. Replace the consumable product in the device and let the device run.
    3. Verify that the device sends the inventory replaced event.
    4. Verify that the replacement date is reset in the Alexa app.