We strongly recommend using Amazon v2 instead of v1. V2 uses the modern SP-API directly (synchronous, real-time), provides complete customer data via Restricted Data Tokens, and includes additional endpoints not available in v1.
About Amazon v1
Amazon v1 uses the Amazon SP-API SDK with an indirect, asynchronous approach for key operations:
- Products — Retrieved via the Reports API (
GET_FLAT_FILE_OPEN_LISTINGS_DATA). Amazon generates a report asynchronously; EcartAPI waits for it to be processed before returning the data. This is slower than v2. - Fulfillments — Created via the Feeds API using an XML document (
POST_ORDER_FULFILLMENT_DATA). The feed is submitted and processed asynchronously by Amazon. - Customer data — May be incomplete due to SP-API restrictions in this version.
- Webhooks — Uses Amazon's Notifications API via the SDK.
Exclusive to v1
- Cancel fulfillment (
DELETE /orders/{orderId}/fulfillments/{fulfillmentId}/cancel)
Not available in v1
- Allowed carriers endpoint (
GET /services/allowed) - Inventory update by location
- Update fulfillment status
The version is selected at the integration level via ecommerceSettings.version_api — it cannot be changed per request.
For step-by-step instructions on how to configure the version, see the Amazon API Version Setup guide.