Skip to main content

Amazon Selling Partner Setup Guide

Prerequisites

  • An active Amazon Seller Central or Amazon Vendor Central account with admin access
  • For Client ID And Secret authentication only:
    • A Client ID and Client Secret for your private Selling Partner app
    • A valid Refresh Token for the region you want to sync

Setup Guide

  1. Choose an Authentication Method:
    • OAuth: Authorize access to all resources your Amazon user can access.
    • Client ID And Secret: Authorize scoped access through your own private app.
  2. If you are connecting a Vendor Central account, turn on the Vendor Account toggle. Leave it off for Seller Central accounts. Note: The account type can't be changed after the connector is created.
  3. Select the Region where your Seller or Vendor account is active.
  4. Authenticate:
    • OAuth: Click Sign In With Amazon, log in to Amazon, and approve access. You are redirected back to Matia and the Merchant ID field is filled in automatically.
    • Client ID And Secret: Enter the Refresh Token for the selected region, along with the Client ID and Client Secret of your private app.
  5. (Optional) Select your Active Marketplaces. If you leave this empty, Matia syncs all available marketplaces in the selected region, including marketplaces you join later. See Amazon's marketplace IDs. Not supported by all streams.
  6. (Optional) Enter an Attribution Window for incremental syncs. This value is a backward offset, in days, applied to each incremental report stream. Valid values range from 0 (to disable) to 15 (the default).
  7. (Optional) Enter a Replication Start Date from which you would like to start syncing data. Not supported by all streams.
  8. Enter a Name for the connector.
  9. (Optional) Enter a Description for the connector.
  10. Select the Owner of the connector.
  11. (Optional) Verify that your Amazon account is successfully connected by clicking on Test Connection.
  12. Click Connect.

Notes

  • The maximum retention period for most endpoints is limited by Amazon. Data cannot be fetched beyond the specified time range. In rare cases, internal constraints will take precedence over API limitations.

    StreamData Retention
    ALL NON-REPORTS2 Years
    FBA_INVENTORY_SUMMARY1 Day (None)
    FINANCIAL_EVENT_GROUP1 Years
    FULFILLED_SHIPMENTS_DATA_GENERAL_REPORT1 Year
    INVENTORY_REPORT1 Day (None)
    ORDERS_REPORT2 Years
    SALES_AND_TRAFFIC_BUSINESS_CHILD_ASIN_REPORT_DAILY6 Months
    SALES_AND_TRAFFIC_BUSINESS_SKU_REPORT_DAILY6 Months
    SALES_AND_TRAFFIC_BUSINESS_SKU_REPORT_MONTHLY6 Months
    SETTLEMENT_REPORT90 Days
    STORAGE_FEE_CHARGES_REPORT90 Days
    SUBSCRIBE_AND_SAVE_FORECAST_REPORT1 Year
    SUBSCRIBE_AND_SAVE_PERFORMANCE_REPORT1.5 Years
  • Due to the above constraints, the primary sync mode available for this connector is Incremental.

  • Amazon's attribution window spans ten to 14 days. To account for updates made to data from a previous sync, we run incremental syncs with a default backward offset of fifteen days. Please note that certain streams may deviate from this timeframe.

  • Some reports are available only for select marketplaces:

    StreamAvailable Marketplaces
    SUBSCRIBE_AND_SAVE_FORECAST_REPORT, SUBSCRIBE_AND_SAVE_PERFORMANCE_REPORTCanada, USA, France, Germany, Italy, Spain, UK

ON THIS PAGE

Need Help?

Get help and support on all things Matia.

Contact Us