Retrieve purchase order

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 (under listPrice and netCost) reflects the actual weight unit of measurement. The weight unit of measurement values includes POUNDS, OUNCES, GRAMS, and KILOGRAMS.

• 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 the getPurchaseOrders API response to determine whether a backorder is allowed. When true, the order can be processed as a backorder. When false, 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 is true). You can indicate one acknowledgment loop using the code accepted with the corresponding date and another acknowledgment loop using the code backordered 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