Retrieve purchase order
Learn how to retrieve complete purchase order details.
The getPurchaseOrder
operation uses the purchase order number to return information you specify about the purchase order. The response includes complete purchase order information, including line item details, quantity, and cost.
Prerequisites
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.
Business requirements
-
Weight-based ordering
For weight-based orders, the
unitOfMeasure
field (underlistPrice
andnetCost
) reflects the actual weight unit of measurement. The weight unit of measurement values includesPOUNDS
,OUNCES
,GRAMS
, andKILOGRAMS
. -
Ship window and delivery window usage
Vendor-paid freights require that you specify delivery window information. Dates are represented in date time interval format in accordance with ISO 8601. The format is the start and end date separated by a hyphen (-). The start date field represents the earliest date that Amazon expects the freight to be delivered to the Amazon fulfillment center listed on the purchase order. The end date field represents the latest date that Amazon expects the freight to be delivered to the Amazon fulfillment center listed on the purchase order.
Use the ship window information for Amazon-paid freights. The date is represented in date/time interval format according to ISO 8601. The format is start and end date separated by a hyphen (-). The start date field represents the earliest date that Amazon expects to pick up the freight. The end date represents the latest date that Amazon expects to pick up the freight. If the same date is listed in the start date and end date fields, then read that date as the date that Amazon expects to pick up the freight.
-
Backorders
The backorder policy is determined by your Amazon business representative. Read the value in the
isBackOrderAllowed
field in thegetPurchaseOrders
API response to determine whether a backorder is allowed. Whentrue
, the order can be processed as a backorder. Whenfalse
, backorders are not accepted.You must provide the price data for items on backorder. Amazon can then update the status of the order correctly. If the price is omitted, the acknowledgment is rejected.
-
Partial shipments
Partial shipments are allowed if the purchase order allows backorders (when
isBackOrderAllowed
istrue
). You can indicate one acknowledgment loop using the codeaccepted
with the corresponding date and another acknowledgment loop using the codebackordered
and the corresponding date.-
Use
accepted
for the items that can be fulfilled immediately. -
Use
backordered
for the remaining quantity that cannot be fulfilled immediately. The remaining quantity (ordered quantity minus all confirmed quantity) is delivered later (backordered).
For more information, refer to the Confirm partial item quantity and backorder the rest of the quantity and
SubmitShipmentConfirmations
. -
-
Deal codes
Deal codes are promotional codes reported in the
dealCode
field of the order. Any information related to promo codes, special discounts, or pricing is present in this field.
Note
Backorder cancellation dates may not be submitted in the order.
-
Use the API to change an order
Submitting a change to an order using the API is not possible. After an order is placed, changing it is a manual process through Vendor Central.
Country-specific business requirements
Functionality | India | Europe | North America |
---|---|---|---|
Net cost | Conditional, either net cost or list price. | Conditional, either net cost or list price. | Conditional, either net cost or list price. |
List price | Conditional, either net cost or list price. | Conditional, either net cost or list price. | Conditional, either net cost or list price. |
Backorder | Not applicable. | Supported. | Supported. |
Buying party | The address of the Amazon buying entity | The assigned party ID for the buying party. | Not applicable. |
Selling party | The Amazon Vendor Code assigned to the vendor. | The Amazon Vendor Code assigned to the vendor. | The Amazon Vendor Code assigned to the vendor. |
Ship-to party | The address of the ship-to entity. | The assigned party ID for the ship-to party. | Not applicable. |
Bill-to party | The address of the bill-to entity. | The address of the bill-to entity | Not applicable. |
Updated 1 day ago