Collecting data from Amazon Vendor Central

This guide explains how to collect data from Amazon Vendor Central. To learn how to collect data from a different data source, go back to the Available data sources in Adverity overview.

Introduction

For a list of the fields that you can collect from Amazon Vendor Central, see Amazon Vendor Central.

Limitations

Collecting data from Amazon Vendor Central comes with the following limitations:

  • Amazon Vendor Central can collect a maximum of 1 million rows per single report. To fetch more data than this, split your fetch into smaller date ranges in the Initial Fetch step of creating a datastream.

  • Real-time data cannot be collected from Amazon Vendor Central. Real-time data includes data from today or yesterday. When collecting data from Amazon Vendor Central, the date picker is restricted. For more information on the date range restrictions when collecting data from Amazon Vendor Central, see Date range restrictions when collecting data from Amazon Vendor Central.

Prerequisites

Before you start collecting data from Amazon Vendor Central, perform all of the following actions:

  • Ensure you can log in to your Amazon Vendor Central account to set up the authorization to Adverity.

Creating a datastream to collect data from Amazon Vendor Central

The basics of creating a datastream to collect data from any data source are explained in our guide to Creating a datastream. This guide contains information about the specific steps to create a datastream to fetch data from Amazon Vendor Central.

Authorization: Allow Adverity to access Amazon Vendor Central

Before creating an authorization to give Adverity access to Amazon Vendor Central, perform the following actions:

  1. Log into your Amazon Vendor Central account and find your Seller ID (also known as Merchant Token) in your account details.

To set up a new authorization to fetch data from Amazon Vendor Central, follow these steps:

  1. In the Authorization step of the datastream wizard, click Access Amazon Vendor Central using your credentials.

  2. Click Next.

  1. In Marketplace, select the region for Amazon Vendor Central data.

  2. In Seller ID, enter your Seller ID (also known as Merchant Token).

  3. Click Authorize.

  4. You are directed to the Amazon Vendor Central login page. Before you log in, check the URL of the website to which you have been directed. Make sure the top-level domain of the URL matches the region you selected in Marketplace.

    For example, if you selected Australia, make sure the Amazon Vendor Central URL contains .com.au.

    If the selected marketplace and the Amazon Vendor Central URL do not match, log out of your Amazon Vendor Central account and log back in using the correct URL.

  5. Log in to your Amazon Vendor Central account.

  6. In the Amazon user interface, give consent for Adverity to work with your data.

As a result, Adverity is authorized to access Amazon Vendor Central. To continue creating your datastream, return to the Authorization step in the datastream wizard and select the newly created authorization from the list.

Configuration: Choose the data you want to collect from Amazon Vendor Central

To choose what data to collect and customize the Amazon Vendor Central datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  1. In Report type, select the type of data to collect from Amazon Vendor Central. The fields you need to configure in the following steps differ according to the report type you select.

  1. In Report period, select the time period that you want to use to group your data.

  2. In Distributor view, select the distributor view for which you want to collect data.

  3. In Currency, select the currency in which you want to collect data.

  4. If you selected the Catalog items report type, configure the following fields:

    1. In Identifier type, select the type of product identifiers that you want to use to select the products for which to collect data.

    2. In Identifiers, choose how you want to specify the identifiers on which to collect data:

      Type in

      Select this option to manually enter the identifiers on which you want to collect data.

      If you select this option, in Type in, type in the identifiers on which you want to collect data. Enter each identifier on a new line. If you are using keywords as identifiers, each keyword has to be one word only.

      Value table

      Select this option to provide a value table containing the identifiers on which you want to collect data.

      If you select this option, in Value table, select the value table containing the identifiers on which you want to collect data.

    3. In Fields, select the list of fields that you want to see in your data extracts.

    4. In Marketplaces, select the marketplaces for which to collect data.

What's next?

Troubleshooting Amazon Vendor Central

I see an error message when fetching data from Amazon Vendor Central

The Error in report request: The requested marketplaceId did not match the marketplace associated with the selling partner account: <ACCOUNT ID> error message appears when the seller ID selected during datastream configuration is not active on the marketplace for which you are trying to fetch data.

To resolve this issue, ensure that the authorization you are using to collect data from Amazon Vendor Central is active on all marketplaces for which you want to fetch data.

Advanced Amazon Vendor Central tips

Date range restrictions when collecting data from Amazon Vendor Central

When collecting data from Amazon Vendor Central, you cannot collect data created today or yesterday. The date picker when collecting data is restricted accordingly.

Amazon Vendor Central has additional restrictions when collecting data in a date range. In the API call, the dataStartTime and dataEndTime values must correspond to the first and last dates of the selected report period. For example, if the report period is a week, the first day of date range must be a Sunday and the end day must be a Saturday. This cannot be configured in the Adverity user interface. Adverity adjusts the date range to conform with Amazon's report period requirements.