Step 2: Submit your feed content
Before submitting your feed content, you need to set up the batch processing service's endpoint. You then submit the XML feed file using the SubmitFeed API call. After the feed content has been submitted, you can review and address any processing errors that might have occurred.
Setting up IPNs to receive batch processing messages
Before you can submit a feed you need to configure endpoints to receive messages from the batch process. Do this in Seller Central by clicking Settings and then clicking Integration Settings.
Notes:
- A feed can be sent to either a production or a sandbox batch processing endpoint. Ensure that when you are done testing, you change the marketplace ID and URL from sandbox to production.
- The batch processing endpoint URL is different from the one used for individual API calls.
The Batch Processing endpoints are shown below:
| Location | URL |
|---|---|
| US | https://mws.amazonservices.com/ |
| EU | https://mws-eu.amazonservices.com/ |
| Japan | https://mws-amazonservices.jp/ |
| China | https://mws.amazonservices.com.cn/ |
SubmitFeed API call
When you have created the XML file that contains a list of requests for the API call that you want to perform, submit it to Amazon Payments using the SubmitFeed operation of the OffAmazon Payments API along with an encrypted header and all required metadata, including a value for the FeedType request parameter. As with all submissions to Amazon MWS, you must also include authentication information.
For any of the supported operations, use the following parameter values in your query request:
| Parameter name | Description | Required | Valid values |
|---|---|---|---|
| FeedContent | The actual content of the feed itself, in XML format. You must include the FeedContent in the body of the HTTP request. Type: HTTP-BODY | Yes | None |
| FeedType | A FeedType value indicating how the data should be processed. Type: xs:string | Yes | The only valid value is _POST_TRANSACTION_PAYMENTS_BATCH_DATA_ |
| MarketplaceIdList* | A marketplace ID (of one of the marketplaces that you are registered to sell in) that you want the feed to be applied to. Example: &MarketplaceIdList.Id.1= A341L3VCFKNMIY &MarketplaceIdList.Id.2=A35A4JO734ER04 | No |
Use one of the following values for Amazon Pay marketplaces:
|
Note: The MarketplaceId denotes the Amazon Service (for example, Amazon Pay), region (for example, UK, Germany, etc.), and environment (for example, Sandbox or Live) that your request corresponds to. The valid values of MarketplaceId that you could use with the Batch Service are listed in the preceding table.
Processing errors
When the feed is submitted through the Amazon MWS Feeds API section, Amazon validates the feed, and the feed processing summary contains any validation errors encountered during processing.
The error codes for validation errors are as follows.
| Error code | Message | Description |
|---|---|---|
| 0001 | Invalid XML: Malformed Request Data | The XML fragment that constitutes a request is not well formed. |
| 0002 | Invalid XML: No SellerId found in request | The XML fragment does not contain the SellerId element in the request. |
| 0003 | Invalid XML: Incorrect number of SellerIds found in request | The XML fragment in the request contains more than one SellerId element. |
| 0004 | Invalid XML: Request SellerId does not match feed SellerId | The SellerId in the request must match the SellerId against which the feed is submitted. |
Note: The FeedType parameter value is always "POST_TRANSACTION_PAYMENTS_BATCH_DATA".