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.
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. You can submit a feed that is applied to one or several MarketplaceId values. If you are in the Europe (EU) or North America (NA) region, you can submit feeds to support multiple marketplaces if you have registered using a single, unified seller account.
If you sell in multiple marketplaces, you can manage your inventory levels using the same SKUs across multiple marketplaces. This eliminates the need for you to manually keep inventory levels across several marketplaces in sync. For more information on selling in multiple marketplaces, see Selling on Amazon's European Marketplaces.
For backwards compatibility, if no marketplace is specified the feed is applied to all marketplaces that share the same default country code.
You specify what marketplaces you want a feed to be applied to by supplying a list of MarketplaceId values to the optional MarketplaceIdList parameter when you call the SubmitFeed operation. For example, an EU multiple-marketplace seller could specify that a feed be applied to both their FR and DE marketplaces by specifying the MarketplaceIdList parameter as follows:
&MarketplaceIdList.Id.1=A13V1IB3VIYZZH &MarketplaceIdList.Id.2=A1PA6795UKMFR9
Do not confuse the optional MarketplaceIdList parameter with the Marketplace parameter in a request. 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 feed is to be applied to. You can apply changes to a given EU or NA marketplace by specifying that MarketplaceId when submitting a feed. For a list of MarketplaceId values, see Amazon MWS endpoints and MarketplaceId values. You can also specify a Checkout by Amazon MarketplaceId value.
An XML Product Feed or XML Relationship Feed submission that specifies a list of MarketplaceId values must specify marketplaces that all share the same language code or the feed is rejected at submission time. If no MarketplaceId values are specified, the feed is applied to all marketplaces that the seller is registered in and that share the same language code as the seller's default marketplace. An FBA MarketplaceId is not a valid MarketplaceId for this type of feed. This behavior applies to the following feeds:
In EU (for all sellers) and in NA (for self-fulfilled sellers only), quantity is a global value in relationship with a SKU, so changes to stock levels are reflected in all marketplaces in which the SKU is active. If multiple XML Inventory Feeds are processed for the same SKU in different marketplaces, then the quantity of the last uploaded XML Inventory Feed from the seller reflects the global inventory level. Setting the item inventory level to 0 effectively sets the item quantity to 0 in all marketplaces and makes the item non-buyable. All listing information is still maintained in the system. An FBA MarketplaceId is not a valid MarketplaceId for this type of feed. This behavior applies to the following feed:
Only a single marketplace can be specified for XML Overrides Feeds. An FBA MarketplaceId is not a valid MarketplaceId for this type of feed. This behavior applies to the following feed:
An XML Pricing Feed submission that specifies a list of MarketplaceId values must specify MarketplaceId values that all share the same currency code or the feed is rejected at submission time. If no MarketplaceId values are specified, the feed is applied to all marketplaces that the seller is registered in that share the same currency code as the seller's default marketplace. An FBA MarketplaceId is not a valid MarketplaceId for this type of feed. This behavior applies to the following feed:
XML Product Image Feeds map images to ASINs in the provided marketplaces. If no MarketplaceId values are specified, the feed is applied to all marketplaces that the seller is registered in and that are in the same country as the seller's original marketplace registration. This behavior applies to the following feed:
Flat File Product and Inventory Feeds can only be applied to one country, though they can apply to multiple marketplaces in that country, such as an Amazon seller MarketplaceId and a Checkout by Amazon MarketplaceId. However, in EU (for all sellers) and in NA (for self-fulfilled sellers only), quantity is a global value in relationship with a SKU, so changes to stock levels are reflected in all marketplaces that the SKU is active in. If multiple inventory feeds are processed for the same SKU in different marketplaces, then the quantity of the last uploaded inventory feed from the seller reflects the global inventory level. Setting the item inventory level to 0 effectively sets the item quantity to 0 in all marketplaces and makes the item non-buyable. All listing information is still maintained in the system. An FBA MarketplaceId is not a valid MarketplaceId for this type of feed. This behavior applies to the following feeds:
All Order Feeds refer to an Amazon order ID, which is a globally unique identifier. Therefore, Order Feeds are not marketplace-specific. This behavior applies to the following feeds:
All XML FBA Fulfillment Order Feeds can only be applied to one country, though they can apply to multiple marketplaces in that country, such as an Amazon seller MarketplaceId and a Checkout by Amazon MarketplaceId. An FBA MarketplaceId is not a valid MarketplaceId for this type of feed. This behavior applies to the following feeds:
There are several error messages that can be sent when submitting requests with multiple MarketplaceId values:
Error Message | Description |
---|---|
All provided marketplaces for this feed type must have the same default language code. [ABCD], [EFGH] have different default language codes. | Some feeds, such as the _POST_PRODUCT_DATA_ feed, can only be applied to marketplaces that share the same language. The specified MarketplaceId values do not share the same language. |
All provided marketplaces for this feed type must have the same default currency code. [ABCD], [EFGH] have different default currency codes. | Some feeds, especially those that deal with pricing such as the _POST_PRODUCT_PRICING_DATA_ feed, can only be applied to marketplaces that share the same currency. The specified MarketplaceId values do not share the same currency. |
All provided marketplaces for this feed type must be based in the same country. [ABCD], [EFGH] have different default country codes. | Flat-file feeds can only be applied to MarketplaceId values that are registered in the same country. The specified MarketplaceId values do not share the same default country. |
The provided marketplaces are correctly associated with your account, but you are prevented from performing this action in the following marketplaces: [ABCD], [ABCD]. Please contact Seller Support in your default marketplace for more information about your account. | There is some issue with your account and the MarketplaceId you specified. You can get this error message for several reasons, including not completing a marketplace registration. Contact Seller Support in your home marketplace to clear up the issue. |
One or more of the provided marketplaces is an FBA marketplace and cannot be used for this feed/report type: [ABCD], [ABCD]. | An FBA MarketplaceId is not a valid MarketplaceId for this type of feed. |
Your feed could not be applied to any marketplaces. | Since you did not provide a MarketplaceId, Amazon MWS attempted to determine an appropriate marketplace to use. It was unable to find a marketplace associated with your account that could be used to fulfill your request. |