Below are some of the best practices which can be incorporated into integration Projects for Amazon Marketplace connector.
The ListOrders Business Process provides a list of all the orders present on the seller central. Using this BP, a user can retrieve the orders by applying the various request parameters listed below.
|MarketplaceId(Required)||A list of MarketplaceId values. It is used to select orders that were placed in the Marketplaces that you specify.|
|CreatedAfter(Required)||A date used for selecting orders created after (or at) a specified time.|
|LastUpdatedAfter(Required if CreatedAfter not specified)||A date used for selecting orders that were last updated after (or at) a specified time. An update is defined as any change in order status, including the creation of a new order. Includes updates made by Amazon and by the seller.|
ListOrders.bps has a throttling limit. At a time, max 6 requests (ListOrders) can be sent. If throttling has occurred, then the user needs to wait for 1 minute to send another request (only one). In case the user must send more than 1 request at a time then the user must wait for those many minutes. For example, if a user needs to send 3 requests after throttling occurs then the user needs to wait for 3 minutes before hitting the ListOrders.bps.
The ListOrderItems.bps task provides a list of all the items present in each order. The order item information includes Title, ASIN, SellerSKU, ItemPrice, ShippingPrice, as well as tax and promotion information.
You can retrieve order item information by first using the ListOrders operation to find orders created or updated during a time frame that you specify. An AmazonOrderId is included with each order that is returned. You can then use these AmazonOrderId values with the ListOrderItems operation to get detailed order item information for each order.
|AmazonOrderId||An Amazon-defined order identifier, in 3-7-7 format. Example 058-1233752-8214740|
- ListOrderItems.bps returns a maximum of 100 items at a time in the response. If there are more than 100 items to be retrieved, a NextToken field will be made available in the ListOrderItems response. This NextToken value can be used in the next bps task call (ListOrderItemsByNextToken) to retrieve the next set of orders. If NextToken is not returned, then there are no more items.
- ListOrderItems bps task has a throttling limit. At a time max 30 requests (ListOrderItems) can be sent. If throttling has occurred then the user needs to wait for 2 seconds in order to send another request(only one). In case the user has to send more than n request at a time then the user has to wait for (# of requests x2) seconds where n <=30. For example, if the user needs to send 3 requests after throttling occurs, then they must wait for 6 seconds (3x2) before hitting the API request.
This Business Process task is used to upload a feed for processing by Amazon. The SubmitFeed operation uploads a file and any necessary metadata for processing.
|FeedContent||The actual content of the feed itself, in XML or flat file format.|
|FeedType||A value indicating how the data should be processed. Example _POST_ORDER_FULFILLMENT_DATA_
- The size of per Feed submitted must be below 2Gib (2,147,483,648 bytes). If you have a large amount of data to submit, you should submit feeds smaller than the feed size limit by breaking up the data or submitting the feeds over a period.
- SubmitFeed BP task has a throttling limit. At a time, a maximum of 15 requests (SubmitFeed) can be sent. If throttling has occurred then the user needs to wait for 2 minutes in order to send another request (only one). In case the user has to send more than n request (where n<=15) at a time then the user has to wait for (# of requests x 2) minutes. For example, if a user needs to send 3 requests after throttling occurs, then they need to wait for 6 minutes (3x2) before hitting the API request.
For more information on the SubmitFeed API please refer to the below link: