Connector Best Practices

Below are some of the best practices which can be incorporated into integration Projects for Amazon Marketplace connector.

Orders

• ListOrders.bps
• ListOrderItems.bps

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.

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.

Usage

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.

Constraints

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

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

 SubmitFeed

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.

Constraints

1. 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.
   
   
2. 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:

https://docs.developer.amazonservices.com/en_US/feeds/Feeds_SubmitFeed.html