Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

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.

Amazon MWS Documentation

Using 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. 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.

Note: You can use the Amazon MWS Sellers API section to determine what MarketplaceId values are associated with your SellerId.

Understanding how MarketplaceId values are used

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.

Behavior of Feeds When Submitting Multiple MarketplaceId values

If you include multiple MarketplaceId values when submitting a feed request, feeds processing has a more complex behavior. The following are some general rules when submitting a feed request with multiple MarketplaceId values:
  • Flat file feeds can only be applied to a single country. For example, a flat file feed submission would not be accepted if the MarketplaceId values were for a DE seller account and an FR seller account.
  • Feed behavior can vary, depending on the FeedType and MarketplaceId values submitted. See the table below for information on how a particular FeedType behaves when submitted with multiple MarketplaceId values.
  • If more than one MarketplaceId value is submitted and one or more of those MarketplaceId values fail validation for whatever reason (currency mismatch, language mismatch, country mismatch, one blocked and the other valid), then Amazon MWS returns an error and the submission fails.
  • Note that Amazon MWS validates a feed submission before it can be queued for processing. A feed submission passes validation when it contains appropriate MarketplaceId values for the FeedType submitted. Passing validation does not mean that the feed is correctly formatted or that it will process successfully.
  • When SubmitFeed is submitted with PurgeAndReplace set to true, the purge will be applied to all EU or NA marketplaces specified by the EU or NA seller. When no EU or NA marketplace is specified, then for backwards compatibility all marketplaces within a country will be updated.

Behavior of XML Product Feeds and XML Relationship Feeds when used with multiple MarketplaceId values

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:

  • Product Feed (_POST_PRODUCT_DATA_)
  • Relationships Feed (_POST_PRODUCT_RELATIONSHIP_DATA_)

Behavior of XML Inventory Feeds when used with multiple MarketplaceId values

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:

  • Inventory Feed (_POST_INVENTORY_AVAILABILITY_DATA_)

Behavior of XML Overrides Feeds when used with multiple MarketplaceId values

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:

  • Overrides Feed (_POST_PRODUCT_OVERRIDES_DATA_)

Behavior of XML Pricing Feeds when used with multiple MarketplaceId values

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:

  • Pricing Feed (_POST_PRODUCT_PRICING_DATA_)

Behavior of XML Product Image Feeds when used with multiple MarketplaceId values

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:

  • Product Images Feed (_POST_PRODUCT_IMAGE_DATA_)

Behavior of Flat File Product and Inventory Feeds when used with multiple MarketplaceId values

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:

  • Flat File Inventory Loader Feed (_POST_FLAT_FILE_INVLOADER_DATA_)
  • Flat File Listings Feed (_POST_FLAT_FILE_LISTINGS_DATA_)
  • Flat File Book Loader Feed (_POST_FLAT_FILE_BOOKLOADER_DATA_)
  • Flat File Music Loader Feed (_POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA_)
  • Flat File Video Loader Feed (_POST_FLAT_FILE_LISTINGS_DATA_)
  • Flat File Price and Quantity Update Feed (_POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA_)
  • UIEE Inventory Feed (_POST_UIEE_BOOKLOADER_DATA_)

Behavior of Order Feeds when used with multiple MarketplaceId values

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:

  • Order Acknowledgement Feed (_POST_ORDER_ACKNOWLEDGEMENT_DATA_)
  • Order Adjustments Feed (_POST_PAYMENT_ADJUSTMENT_DATA_)
  • Order Fulfillment Feed (_POST_ORDER_FULFILLMENT_DATA_)
  • Flat File Order Acknowledgement Feed (_POST_FLAT_FILE_ORDER_ACKNOWLEDGEMENT_DATA_)
  • Flat File Order Adjustments Feed (_POST_FLAT_FILE_PAYMENT_ADJUSTMENT_DATA_)
  • Flat File Order Fulfillment Feed (_POST_FLAT_FILE_FULFILLMENT_DATA_)

Behavior of XML FBA Fulfillment Order Feeds when used with multiple MarketplaceId values

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:

  • FBA Fulfillment Order Feed (_POST_FULFILLMENT_ORDER_REQUEST_DATA_)
  • FBA Fulfillment Order Cancellation Feed (_POST_FULFILLMENT_ORDER_CANCELLATION_REQUEST_DATA_)

Error messages when submitting multiple MarketplaceId values

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.