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

What you should know about the Amazon MWS Feeds API section

Overview

The Amazon MWS Feeds API section of the Amazon Marketplace Web Service (Amazon MWS) API lets you upload inventory and order data to Amazon. You can also use the Amazon MWS Feeds API section to get information about the processing of feeds.

The process for submitting feeds is as follows:

  1. Submit an XML or flat file using the SubmitFeed operation along with an encrypted header and all required metadata, including a value from the FeedType. As with all submissions to Amazon MWS, you must also include authentication information. The SubmitFeed operation returns a FeedSubmissionId, which you can use to periodically check the status of the feed using the GetFeedSubmissionList operation.
    Note: Rather than repeatedly polling the GetFeedSubmissionList operation to find out when feed processing is complete, Amazon recommends subscribing to the FeedProcessingFinishedNotification notification. After you subscribe, for each feed you submit Amazon will send you a push notification when feed processing is complete. This makes your workflow more efficient and helps you avoid exceeding the throttling limits of the GetFeedSubmissionList operation. For more information, see FeedProcessingFinishedNotification.
  2. If Amazon MWS is still processing a request, the FeedProcessingStatus element of the GetFeedSubmissionList operation returns a status of _IN_PROGRESS_. If the processing is complete, a status of _DONE_ is returned.
  3. When the feed processing is complete, you can use the GetFeedSubmissionResult operation to receive a processing report that describes which records in the feed were successful and which records generated errors. Note that you have to set up a stream that Amazon MWS uses to write out the report when you submit the GetFeedSubmissionResult operation. Use the Amazon MWS Feeds API section client library code for the GetFeedSubmissionResult operation to create the stream.
  4. Analyze the processing report, correct any errors in the file or transmission, and resubmit the feed using the SubmitFeed operation. Repeat the process until there are no errors in the processing report. When the processing report is error free, the transmission is complete.

The following flowchart shows the process for submitting a feed:

The Feeds API section contains the following operations:

Operation Description Availability
SubmitFeed Uploads a feed for processing by Amazon MWS. All marketplaces.
GetFeedSubmissionList Returns a list of all feed submissions submitted in the previous 90 days. All marketplaces.
GetFeedSubmissionListByNextToken Returns a list of feed submissions using the NextToken parameter. All marketplaces.
GetFeedSubmissionCount Returns a count of the feeds submitted in the previous 90 days. All marketplaces.
CancelFeedSubmissions Cancels one or more feed submissions and returns a count of the feed submissions that were canceled. All marketplaces.
GetFeedSubmissionResult Returns the feed processing report and the Content-MD5 header. All marketplaces.