Amazon Vendor DF Get Transaction Status
Summary of Changes: (The purpose of this table is to keep traceability and Product team to highlight the things that were changed into the scope, based on comments or discussions)
| Version | Date | Created / Updated | Notes |
|---|---|---|---|
| v1.0 | 09.02.2024 | Bogomil Pavlov | First publish |
All validations, triggers and standardizations are as per
Order management general requirements
Get Transaction
Vendors can use the getTransactionStatus operation to check the status of a POST transaction. When a request is posted to Amazon using certain POST operations in the vendor APIs, such as submitAcknowledgement or submitShipmentConfirmations, for example, a successful response contains a transaction ID that uniquely identifies the transaction. Amazon will process the transaction asynchronously, and the final response will be available via the getTransactionStatus operation.
Thus we want to store the feed in Marketplace Feeds table with the relevant details which later we will read using the Get Transaction API
See the corresponding integration workflow diagram in the other sections of this guide to understand when to call the getTransactionStatus operation to get the transaction status.
Amazon offers the final processed status for POST transactions such as submitAcknowledgement and submitShipmentConfirmations via this API. We highly recommend that vendors check the status using this API to ensure that transactions were processed successfully. If an error occurred you will receive the error details so you can correct the transaction and resubmit it.
| Transaction Status | Definition |
|---|---|
Processing |
The API transaction was received by Amazon is being processed. The processing is not completed yet. Check the SLA for each API operation for the expected time to complete processing. |
Success |
The API transaction was successfully processed by Amazon. |
Failure |
The API transaction failed during processing. The error details will be provided in the getTransactionStatus response body. |
The transaction status is supported for the following Direct Fulfillment APIs:
| Description | API Section | Operation |
|---|---|---|
| Acknowledge Order | Direct Fulfillment Orders | submitAcknowledgement |
| Submit Shipment Confirmations | Direct Fulfillment Shipping | submitShipmentConfirmations |
| Shipping Label Request | Direct Fulfillment Shipping | submitShippingLabelRequest |
| Shipping Status Updates | Direct Fulfillment Shipping | submitShipmentStatusUpdates |
| Inventory Update | Direct Fulfillment Inventory | submitInventoryUpdate |
| Invoice | Direct Fulfillment Payments | submitInvoice |
The transaction status supports only Processing and Failure status codes for now. If the transaction status is Processing and has not been updated to Failure after 30 minutes, that indicates the transaction has successfully processed in our systems. The Success status will be supported in the future.
API GET [https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/transactions/v1/transactions/20190904190535-eef8cad8-418e-4ed3-ac72-789e2ee6214a](https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/transactions/v1/transactions/20190904190535-eef8cad8-418e-4ed3-ac72-789e2ee6214a)
Sample Request:
GET [https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/transactions/v1/transactions/20190904190535-eef8cad8-418e-4ed3-ac72-789e2ee6214a](https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/transactions/v1/transactions/20190904190535-eef8cad8-418e-4ed3-ac72-789e2ee6214a)
Sample Response:
{
"transactionId": "20190918190535-eef8cad8-418e-456f-ac72-789e2ee6813c",
"status": "Failure",
"errors": [
{
"code": "INVALID_ORDER_ID",
"message": "Invalid order ID."
}
]
}Mapping:
Limits