Actions18
- Orders Actions
- Invoices Actions
- Shipments Actions
- Listings Actions
- Finance Actions
- Analytics Actions
- Prices Actions
Overview
This node interacts with the Amazon Selling Partner API to retrieve orders from specified Amazon marketplaces. It is useful for sellers who want to programmatically access order data within a given date range and apply filters such as order status, fulfillment channel, and payment method. For example, a seller can use this node to fetch all unshipped orders created in the last week from the US and UK marketplaces.
Use Case Examples
- Retrieve all orders created between two dates from Amazon.com (US) and Amazon.co.uk (UK) marketplaces.
- Filter orders to only include those with status 'Unshipped' and fulfillment channel 'Amazon Fulfillment'.
- Limit the number of orders returned per page and choose to return all results by handling pagination automatically.
Properties
| Name | Meaning |
|---|---|
| Marketplace IDs | Select the Amazon marketplaces to retrieve orders from, such as US, Canada, UK, etc. |
| Created After | Filter to retrieve orders created after this date and time (ISO 8601 format). This is a required field. |
| Created Before | Filter to retrieve orders created before this date and time (ISO 8601 format). This is a required field. |
| Additional Options | Optional filters and settings for the order retrieval operation. |
Output
JSON
orderId- Unique identifier for the order.purchaseDate- Date and time when the order was placed.orderStatus- Current status of the order.fulfillmentChannel- Channel through which the order is fulfilled (e.g., AFN or MFN).paymentMethod- Method used for payment of the order.buyerName- Name of the buyer who placed the order.shippingAddress- Shipping address details for the order.orderItems- List of items included in the order.
Dependencies
- Amazon Selling Partner API credentials
Troubleshooting
- Ensure that the Amazon Selling Partner API credentials are correctly configured and have the necessary permissions to access order data.
- Verify that the date filters (Created After and Created Before) are in valid ISO 8601 format and that Created After is earlier than Created Before.
- If no orders are returned, check that the selected marketplace IDs and filters match existing orders in the specified date range.
- Handle API rate limits and pagination properly, especially when Return All Results is enabled to avoid incomplete data retrieval.
Links
- Amazon Selling Partner API - Orders API Reference - Official documentation for the Orders API in Amazon Selling Partner API.