Submit order acknowledgement
Learn how to accept or reject a purchase order for fulfillment.
You can use the submitAcknowledgement operation to accept or reject a purchase order for fulfillment.
Prequisites
To complete this tutorial, you need:
- Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API Applications.
- The Vendor Retail Procurement Orders role assigned to your developer profile.
Amazon expects a complete acknowledgement, including all purchase order line items for the purchase order. If you do not provide all line items for the purchase order in the acknowledgement, Amazon implicitly rejects the missing line items. If the acknowledgment code is omitted, the acknowledgment is rejected.
The cost price in the acknowledgement must match the invoiced unit cost price. Book vendors are required to provide a list price and discount multiplier. The price cannot be higher than the price submitted in the purchase order.
Submit the acknowledgment within 24 hours, including backordered items. The acknowledgment must be an accurate view of the actual shipment quantities and dates.
You must submit an updated acknowledgment within 48 hours for any changes to quantity, price, ship dates, or delivery dates. You can submit a full acknowledgment update or update only a specific line item. Amazon always treats an update as a replacement of the earlier acknowledgment for the line item. After 48 hours, we only expect to receive updates to ship dates or delivery dates.
Caution
You must return the unit cost price in the acknowledgment. The cost price must match the unit cost price that is invoiced. Amazon payment systems compares the two and might delay payment if they do not match. Book vendors must provide a list price and discount multiplier.
If the first acknowledgment code for a specific line item was rejected, you cannot change this with your update to either accepted or backordered.
| Acknowledgement code | Description |
|---|---|
Accepted | Vendor accepts to fulfill the order items. |
Backordered | Vendor placed a backorder to fulfill the original order and provides a scheduledShipDate or scheduledDeliveryDate that is different than the expectedShipDate or expectedDeliveryDate provided in the purchase order. |
Rejected | Vendor rejects to fulfill the order items. |
If the price or availability change after the initial acknowledgment has been transmitted, you can provide manual notification. Your Amazon business representative can advise on when, how, and who to notify.
Country-specific business requirements
| Functionality | India | Europe | North America |
|---|---|---|---|
| Scheduled Ship Date | Conditional, depends on the freight terms and current business arrangement | Optional | Optional |
| Scheduled Delivery Date | Conditional, depends on the freight terms and current business arrangement | Optional | Optional |
| List Price | Needed only for Book Vendors | Supported | Needed only for Book Vendors |
Verify successfully submitted order acknowledgments
You can verify the status of the original or updated version of the order acknowledgment using Vendor Central or using the Transaction Status API. If the original or updated version doesn't appear after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central. Select Support, then Contact Us, and then API Integration.
You should send an order acknowledgment to successfully update the status of an order in the Amazon system. You can confirm your purchase order using the API or Vendor Central. You have 24 hours to accept a purchase order. Vendors should reject any purchase order that is on hold past the 24-hour time limit.
Note
You cannot send a higher quantity in the order acknowledgment than what was submitted in the purchase order. However, you can confirm smaller quantity than what was submitted in the purchase order.
Updated 1 day ago