Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation
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.
  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.