getOrder

get https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/orders/2021-12-28/purchaseOrders/{purchaseOrderNumber}

Returns purchase order information for the purchaseOrderNumber that you specify.

Usage Plan:

Rate (requests per second)	Burst
10	10

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Responses

Response body

object

purchaseOrderNumber

string

required

The purchase order number for this order. Formatting Notes: alpha-numeric code.

orderDetails

object

Details of an order.

customerOrderNumber

string

required

The customer order number.

orderDate

date-time

required

The date the order was placed. This field is expected to be in ISO-8601 date/time format, for example:2018-07-16T23:00:00Z/ 2018-07-16T23:00:00-05:00 /2018-07-16T23:00:00-08:00. If no time zone is specified, UTC should be assumed.

orderStatus

string

Current status of the order.

NEW SHIPPED ACCEPTED CANCELLED

Show Details

NEW	Status for newly created orders.
SHIPPED	Status for orders that are already shipped.
ACCEPTED	Status for orders accepted by vendors.
CANCELLED	Status for cancelled orders.

shipmentDetails

object

required

Shipment details required for the shipment.

taxTotal

object

Total tax details for the line item.

sellingParty

object

required

Name, address and tax details of a party.

shipFromParty

object

required

Name, address and tax details of a party.

shipToParty

object

required

Address of the party.

billToParty

object

required

Name, address and tax details of a party.

items

array of objects

required

A list of items in this purchase order.

items*

object

itemSequenceNumber

string

required

Numbering of the item on the purchase order. The first item will be 1, the second 2, and so on.

buyerProductIdentifier

string

Buyer's standard identification number (ASIN) of an item.

vendorProductIdentifier

string

The vendor selected product identification of the item.

title

string

Title for the item.

orderedQuantity

object

required

Details of quantity ordered.

scheduledDeliveryShipment

object

Dates for the scheduled delivery shipments.

giftDetails

object

Gift details for the item.

netPrice

object

required

An amount of money, including units in the form of currency.

taxDetails

object

Total tax details for the line item.

totalPrice

object

An amount of money, including units in the form of currency.

buyerCustomizedInfo

object

The details of the products the vendor has configured as customizable.

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/orders/2021-12-28/purchaseOrders/purchaseOrderNumber \
3
     --header 'accept: application/json'


xxxxxxxxxx
107
}
1
{
2
  "purchaseOrderNumber": "2JK3S9VC",
3
  "orderDetails": {
4
    "customerOrderNumber": "123-ABC",
5
    "orderDate": "2020-02-20T13:51:00Z",
6
    "orderStatus": "NEW",
7
    "shipmentDetails": {
8
      "isPriorityShipment": false,
9
      "isScheduledDeliveryShipment": false,
10
      "isPslipRequired": true,
11
      "isGift": false,
12
      "shipMethod": "UPS_2ND",
13
      "shipmentDates": {
14
        "requiredShipDate": "2020-02-21T00:00:00Z",
15
        "promisedDeliveryDate": "2020-02-24T00:00:00Z"
16
      },
17
      "messageToCustomer": "This shipment completes your order. You can always check the status of your orders from the \"Your Account\" link at the top of each page of our site.Thank you for shopping at Amazon.com"
18
    },
19
    "taxTotal": {
20
      "taxLineItem": [
21
        {
22
          "taxAmount": {
23
            "currencyCode": "USD",
24
            "amount": "190"
25
          },

200Success.

400Request has missing or invalid parameters and cannot be parsed.

401The request's Authorization header is not formatted correctly or does not contain a valid token.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.