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
- 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.
- 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.
- Select the Region where your Seller or Vendor account is active.
- 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.
- (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.
- (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).
- (Optional) Enter a Replication Start Date from which you would like to start syncing data. Not supported by all streams.
- Enter a Name for the connector.
- (Optional) Enter a Description for the connector.
- Select the Owner of the connector.
- (Optional) Verify that your Amazon account is successfully connected by clicking on Test Connection.
- 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.
Stream Data Retention ALL NON-REPORTS 2 Years FBA_INVENTORY_SUMMARY 1 Day (None) FINANCIAL_EVENT_GROUP 1 Years FULFILLED_SHIPMENTS_DATA_GENERAL_REPORT 1 Year INVENTORY_REPORT 1 Day (None) ORDERS_REPORT 2 Years SALES_AND_TRAFFIC_BUSINESS_CHILD_ASIN_REPORT_DAILY 6 Months SALES_AND_TRAFFIC_BUSINESS_SKU_REPORT_DAILY 6 Months SALES_AND_TRAFFIC_BUSINESS_SKU_REPORT_MONTHLY 6 Months SETTLEMENT_REPORT 90 Days STORAGE_FEE_CHARGES_REPORT 90 Days SUBSCRIBE_AND_SAVE_FORECAST_REPORT 1 Year SUBSCRIBE_AND_SAVE_PERFORMANCE_REPORT 1.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:
Stream Available Marketplaces SUBSCRIBE_AND_SAVE_FORECAST_REPORT, SUBSCRIBE_AND_SAVE_PERFORMANCE_REPORT Canada, USA, France, Germany, Italy, Spain, UK