Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
Describes the best practices to follow when you are registered to sell in multiple marketplaces.
If you are registered in multiple marketplaces, then you have multiple MarketplaceId values associated with your SellerId. These multiple MarketplaceId values can be, for example, an Amazon seller account or a Checkout by Amazon account, where those services are available. If you are in the Europe (EU) or North America (NA) region, you can sell in multiple marketplaces if you have registered using a single, unified seller account, and you will have multiple MarketplaceId values associated with your account.
Every seller has a default marketplace. The default marketplace is based on the country in which you first registered as a seller. For example, if you used the DE Seller Central website to register, your default marketplace would be DE and your default MarketplaceId would be A1PA6795UKMFR9 (see the table below for seller MarketplaceId values). For more information on selling in multiple marketplaces, see Selling on Amazon's European Marketplaces.
For backwards compatibility, when no marketplace is specified, all marketplaces within the default country locale are shown.
You specify what marketplaces you want a report to cover by supplying a list of MarketplaceId values to the optional MarketplaceIdList parameter when you call the RequestReport operation. For example, an EU multiple-marketplace seller could specify that a report should include information from both their FR and DE marketplaces by specifying the MarketplaceIdList parameter as follows:
&MarketplaceIdList.Id.1=A13V1IB3VIYZZH &MarketplaceIdList.Id.2=A1PA6795UKMFR9
Do not confuse this parameter with the Marketplace parameter; the Marketplace parameter is no longer used for authentication and is deprecated.
For EU and NA sellers, you do not need to use a specific country endpoint, such as https://mws.amazonservices.de, to indicate what marketplace a report is for. EU and NA sellers can obtain reports for a given EU or NA marketplace by specifying that MarketplaceId when submitting a report request. For a list of MarketplaceId values, see Amazon MWS endpoints and MarketplaceId values. You can also specify a Checkout by Amazon MarketplaceId value.
If you include multiple MarketplaceId values when submitting a report request, report processing will have a more complex behavior. The following are some general rules when submitting a report request with multiple MarketplaceId values:
The Listings Reports in the "ReportType enumeration" topic can only provide information for one marketplace per request.
The flat file Order Reports in the "ReportType enumeration" topic can be used with the ShowSalesChannel parameter to show an additional column of sales channel information. The following code shows how the ReportOptions=ShowSalesChannel parameter is included in a report request:
POST /?AWSAccessKeyId=SDFSD235ASSDFG3445AS &Action=RequestReport &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceIdList.Id.1=A1F83G8C2ARO7P &MarketplaceIdList.Id.2=A1PA6795UKMFR9 &SellerId=AGFDG34255SFDSSHV83 &SignatureVersion=2 &Timestamp=2011-06-23T22%3A33%3A25Z &Version=2009-01-01 &Signature=%2BtKQ637UjDCoE%2F3w8GTmsd8E29Lrgsuc%2FkdYBLPfyE8%3D &SignatureMethod=HmacSHA256 &ReportType=_GET_CONVERGED_FLAT_FILE_ORDER_REPORT_DATA_ &ReportOptions=ShowSalesChannel%3Dtrue HTTP/1.1 Host: mws.amazonservices.com x-amazon-user-agent: AmazonJavascriptScratchpad/1.0 (Language=Javascript) Content-Type: text/xml
The Order Tracking Reports in the "ReportType enumeration" topic return orders from all of the marketplaces that you are registered in even if you specify only a subset of the marketplaces that you are registered in when you submit a report request.
The Settlement Reports in the "ReportType enumeration" topic can be retrieved regardless of the status of the seller in the marketplace. Settlement Reports will contain Amazon seller and Checkout by Amazon (if applicable) settlement transactions.