"description":"Returns a list of purchase orders created during the time frame that you specify. You define the time frame using the createdAfter and createdBefore parameters. You must use both parameters. You can choose to get only the purchase order numbers by setting the includeDetails parameter to false. In that case, the operation returns a list of purchase order numbers. You can then call the getOrder operation to return the details of a specific order.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId":"getOrders",
"parameters":[
{
"name":"shipFromPartyId",
"in":"query",
"description":"The vendor warehouse identifier for the fulfillment warehouse. If not specified, the result will contain orders for all warehouses.",
"required":false,
"type":"string"
},
{
"name":"status",
"in":"query",
"description":"Returns only the purchase orders that match the specified status. If not specified, the result will contain orders that match any status.",
"required":false,
"type":"string",
"enum":[
"NEW",
"SHIPPED",
"ACCEPTED",
"CANCELLED"
],
"x-docgen-enum-table-extension":[
{
"value":"NEW",
"description":"Status for newly created purchase orders."
},
{
"value":"SHIPPED",
"description":"Status for purchase orders that are already shipped."
},
{
"value":"ACCEPTED",
"description":"Status for purchase orders accepted by vendors."
},
{
"value":"CANCELLED",
"description":"Status for cancelled purchase orders."
}
]
},
{
"name":"limit",
"in":"query",
"description":"The limit to the number of purchase orders returned.",
"required":false,
"type":"integer",
"maximum":100,
"minimum":1,
"format":"int64"
},
{
"name":"createdAfter",
"in":"query",
"description":"Purchase orders that became available after this date and time will be included in the result. Must be in ISO-8601 date/time format.",
"required":true,
"type":"string",
"format":"date-time"
},
{
"name":"createdBefore",
"in":"query",
"description":"Purchase orders that became available before this date and time will be included in the result. Must be in ISO-8601 date/time format.",
"required":true,
"type":"string",
"format":"date-time"
},
{
"name":"sortOrder",
"in":"query",
"description":"Sort the list in ascending or descending order by order creation date.",
"required":false,
"type":"string",
"enum":[
"ASC",
"DESC"
],
"x-docgen-enum-table-extension":[
{
"value":"ASC",
"description":"Sort in ascending order by order creation date."
},
{
"value":"DESC",
"description":"Sort in descending order by order creation date."
}
]
},
{
"name":"nextToken",
"in":"query",
"description":"Used for pagination when there are more orders than the specified result size limit. The token value is returned in the previous API call.",
"required":false,
"type":"string"
},
{
"name":"includeDetails",
"in":"query",
"description":"When true, returns the complete purchase order details. Otherwise, only purchase order numbers are returned.",
"required":false,
"type":"string",
"default":"true",
"format":"boolean"
}
],
"responses":{
"200":{
"description":"Success.",
"schema":{
"$ref":"#/definitions/OrderList"
},
"examples":{
"pagination":{
"nextToken":"MDAwMDAwMDAwMQ=="
},
"orders":[
{
"purchaseOrderNumber":"2JK3S9VC",
"orderDetails":{
"customerOrderNumber":"123-ABC",
"orderDate":"2020-02-20T13:51:00Z",
"orderStatus":"NEW",
"shipmentDetails":{
"isPriorityShipment":false,
"isScheduledDeliveryShipment":false,
"isPslipRequired":true,
"isGift":false,
"shipMethod":"UPS_2ND",
"shipmentDates":{
"requiredShipDate":"2020-02-21T00:00:00Z",
"promisedDeliveryDate":"2020-02-24T00:00:00Z"
},
"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"
},
"taxTotal":{
"taxLineItem":[
{
"taxRate":"0.1",
"taxAmount":{
"currencyCode":"USD",
"amount":"190"
},
"type":"TOTAL"
}
]
},
"sellingParty":{
"partyId":"999US"
},
"shipFromParty":{
"partyId":"ABCD"
},
"shipToParty":{
"name":"ABCD",
"attention":"ABCD",
"addressLine1":"123 XYZ Street",
"addressLine2":"Apt 5",
"city":"San Jose",
"stateOrRegion":"CA",
"postalCode":"94086",
"countryCode":"USA"
},
"billToParty":{
"partyId":"ABCD"
},
"items":[
{
"itemSequenceNumber":"00001",
"buyerProductIdentifier":"B07DFVDRAB",
"vendorProductIdentifier":"8806098286500",
"title":"LG 8 kg Inverter Wi-Fi Fully-Automatic Front Loading Washing Machine (FHT1408SWS, STS-VCM, Inbuilt Heater)",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Returns purchase order information for the purchaseOrderNumber that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId":"getOrder",
"parameters":[
{
"name":"purchaseOrderNumber",
"in":"path",
"description":"The order identifier for the purchase order that you want. Formatting Notes: alpha-numeric code.",
"required":true,
"type":"string"
}
],
"responses":{
"200":{
"description":"Success.",
"schema":{
"$ref":"#/definitions/Order"
},
"examples":{
"application/json":{
"purchaseOrderNumber":"2JK3S9VC",
"orderDetails":{
"customerOrderNumber":"123-ABC",
"orderDate":"2020-02-20T13:51:00Z",
"orderStatus":"NEW",
"shipmentDetails":{
"isPriorityShipment":false,
"isScheduledDeliveryShipment":false,
"isPslipRequired":true,
"isGift":false,
"shipMethod":"UPS_2ND",
"shipmentDates":{
"requiredShipDate":"2020-02-21T00:00:00Z",
"promisedDeliveryDate":"2020-02-24T00:00:00Z"
},
"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"
},
"taxTotal":{
"taxLineItem":[
{
"taxAmount":{
"currencyCode":"USD",
"amount":"190"
},
"type":"TOTAL"
}
]
},
"sellingParty":{
"partyId":"999US"
},
"shipFromParty":{
"partyId":"ABCD"
},
"shipToParty":{
"name":"ABCD",
"attention":"ABCD",
"addressLine1":"123 XYZ Street",
"addressLine2":"Apt 5",
"city":"San Jose",
"stateOrRegion":"CA",
"postalCode":"94086",
"countryCode":"USA"
},
"billToParty":{
"partyId":"ABCD"
},
"items":[
{
"itemSequenceNumber":"00001",
"buyerProductIdentifier":"B07DFVDRAB",
"vendorProductIdentifier":"8806098286500",
"title":"LG 8 kg Inverter Wi-Fi Fully-Automatic Front Loading Washing Machine (FHT1408SWS, STS-VCM, Inbuilt Heater)",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Submits acknowledgements for one or more purchase orders.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to the next request. If NextToken is not returned, there are no more order items to return."
"description":"The purchase order number for this order. Formatting Notes: alpha-numeric code."
},
"orderDetails":{
"description":"Purchase order details.",
"$ref":"#/definitions/OrderDetails"
}
}
},
"OrderDetails":{
"type":"object",
"required":[
"billToParty",
"customerOrderNumber",
"items",
"orderDate",
"sellingParty",
"shipFromParty",
"shipToParty",
"shipmentDetails"
],
"properties":{
"customerOrderNumber":{
"type":"string",
"description":"The customer order number."
},
"orderDate":{
"type":"string",
"format":"date-time",
"description":"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":{
"type":"string",
"description":"Current status of the order.",
"enum":[
"NEW",
"SHIPPED",
"ACCEPTED",
"CANCELLED"
],
"x-docgen-enum-table-extension":[
{
"value":"NEW",
"description":"Status for newly created orders."
},
{
"value":"SHIPPED",
"description":"Status for orders that are already shipped."
},
{
"value":"ACCEPTED",
"description":"Status for orders accepted by vendors."
},
{
"value":"CANCELLED",
"description":"Status for cancelled orders."
}
]
},
"shipmentDetails":{
"$ref":"#/definitions/ShipmentDetails"
},
"taxTotal":{
"$ref":"#/definitions/TaxItemDetails"
},
"sellingParty":{
"description":"PartyID of vendor code.",
"$ref":"#/definitions/PartyIdentification"
},
"shipFromParty":{
"description":"PartyID of vendor's warehouse.",
"$ref":"#/definitions/PartyIdentification"
},
"shipToParty":{
"description":"Name/Address and tax details of the ship to party.",
"$ref":"#/definitions/Address"
},
"billToParty":{
"description":"Name/Address and tax details of the bill to party.",
"$ref":"#/definitions/PartyIdentification"
},
"items":{
"type":"array",
"description":"A list of items in this purchase order.",
"description":"The name of the person, business or institution at that address. For Amazon label only vendors, this field will have the value `xxxxx` within the object `shipToParty`."
"description":"The attention name of the person at that address. For Amazon label only vendors, this field will have the value `xxxxx` within the object `shipToParty`."
"description":"Additional address information, if required. For Amazon label only vendors, this field will have the value `xxxxx` within the object `shipToParty`."
"description":"Additional address information, if required. For Amazon label only vendors, this field will have the value `xxxxx` within the object `shipToParty`."
"description":"The city where the person, business or institution is located. For Amazon label only vendors, this field will have the value `xxxxx` within the object `shipToParty`."
"description":"The county where person, business or institution is located. For Amazon label only vendors, this field will have the value `xxxxx` within the object `shipToParty`."
"description":"The district where person, business or institution is located. For Amazon label only vendors, this field will have the value `xxxxx` within the object `shipToParty`."
"description":"The phone number of the person, business or institution located at that address. For Amazon label only vendors, this field will have the value `xxxxx` within the object `shipToParty`."
"description":"The buyer information for products the vendor has configured as customizable, specifying the types of customizations or configurations along with types and ranges for their product. This provides the ability for buyers to customize multiple aspects of the products according to what the vendor allows.",
"description":"A [Base 64](https://datatracker.ietf.org/doc/html/rfc4648#section-4) encoded URL using the UTF-8 character set. The URL provides the location of the zip file that specifies the types of customizations or configurations allowed by the vendor, along with types and ranges for the attributes of their products."
"description":"A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation."
},
"SubmitAcknowledgementResponse":{
"type":"object",
"properties":{
"payload":{
"description":"The payload for the submitAcknowledgement operation.",
"$ref":"#/definitions/TransactionId"
},
"errors":{
"$ref":"#/definitions/ErrorList"
}
},
"description":"The response schema for the submitAcknowledgement operation."
},
"TransactionId":{
"type":"object",
"properties":{
"transactionId":{
"type":"string",
"description":"GUID assigned by Amazon to identify this transaction. This value can be used with the Transaction Status API to return the status of this transaction."
"description":"A list of one or more purchase orders.",
"items":{
"$ref":"#/definitions/OrderAcknowledgementItem"
}
}
},
"description":"The request schema for the submitAcknowledgement operation."
},
"OrderAcknowledgementItem":{
"type":"object",
"required":[
"acknowledgementDate",
"acknowledgementStatus",
"itemAcknowledgements",
"purchaseOrderNumber",
"sellingParty",
"shipFromParty",
"vendorOrderNumber"
],
"properties":{
"purchaseOrderNumber":{
"type":"string",
"description":"The purchase order number for this order. Formatting Notes: alpha-numeric code."
},
"vendorOrderNumber":{
"type":"string",
"description":"The vendor's order number for this order."
},
"acknowledgementDate":{
"type":"string",
"format":"date-time",
"description":"The date and time when the order is acknowledged, 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."
},
"acknowledgementStatus":{
"description":"Status of acknowledgement.",
"$ref":"#/definitions/AcknowledgementStatus"
},
"sellingParty":{
"description":"PartyID as vendor code.",
"$ref":"#/definitions/PartyIdentification"
},
"shipFromParty":{
"description":"PartyID as the vendor's warehouseId.",
"$ref":"#/definitions/PartyIdentification"
},
"itemAcknowledgements":{
"type":"array",
"description":"Item details including acknowledged quantity.",
"items":{
"$ref":"#/definitions/OrderItemAcknowledgement"
}
}
},
"description":"Details of an individual order being acknowledged."
},
"OrderItemAcknowledgement":{
"type":"object",
"required":[
"acknowledgedQuantity",
"itemSequenceNumber"
],
"properties":{
"itemSequenceNumber":{
"type":"string",
"description":"Line item sequence number for the item."
},
"buyerProductIdentifier":{
"type":"string",
"description":"Buyer's standard identification number (ASIN) of an item."
},
"vendorProductIdentifier":{
"type":"string",
"description":"The vendor selected product identification of the item. Should be the same as was provided in the purchase order."
},
"acknowledgedQuantity":{
"description":"Details of quantity acknowledged with the above acknowledgement code.",
"description":"Acknowledgement code is a unique two digit value which indicates the status of the acknowledgement. For a list of acknowledgement codes that Amazon supports, see the Vendor Direct Fulfillment APIs Use Case Guide."
},
"description":{
"type":"string",
"description":"Reason for the acknowledgement code."
}
},
"description":"Status of acknowledgement."
},
"Error":{
"type":"object",
"required":[
"code",
"message"
],
"properties":{
"code":{
"type":"string",
"description":"An error code that identifies the type of error that occurred."
},
"message":{
"type":"string",
"description":"A message that describes the error condition."
},
"details":{
"type":"string",
"description":"Additional details that can help the caller understand or fix the issue."
}
},
"description":"Error response returned when the request is unsuccessful."
},
"ShipmentDetails":{
"type":"object",
"required":[
"isPriorityShipment",
"isPslipRequired",
"messageToCustomer",
"shipMethod",
"shipmentDates"
],
"properties":{
"isPriorityShipment":{
"type":"boolean",
"description":"When true, this is a priority shipment."
},
"isScheduledDeliveryShipment":{
"type":"boolean",
"description":"When true, this order is part of a scheduled delivery program."
},
"isPslipRequired":{
"type":"boolean",
"description":"When true, a packing slip is required to be sent to the customer."
},
"isGift":{
"type":"boolean",
"description":"When true, the order contain a gift. Include the gift message and gift wrap information."
},
"shipMethod":{
"type":"string",
"description":"Ship method to be used for shipping the order. Amazon defines ship method codes indicating the shipping carrier and shipment service level. To see the full list of ship methods in use, including both the code and the friendly name, search the 'Help' section on Vendor Central for 'ship methods'."
},
"shipmentDates":{
"$ref":"#/definitions/ShipmentDates"
},
"messageToCustomer":{
"type":"string",
"description":"Message to customer for order status."
}
},
"description":"Shipment details required for the shipment."
},
"ShipmentDates":{
"type":"object",
"required":[
"requiredShipDate"
],
"properties":{
"requiredShipDate":{
"type":"string",
"format":"date-time",
"description":"Time by which the vendor is required to ship the order."
},
"promisedDeliveryDate":{
"type":"string",
"format":"date-time",
"description":"Delivery date promised to the Amazon customer."
}
},
"description":"Shipment dates."
},
"ScheduledDeliveryShipment":{
"type":"object",
"properties":{
"scheduledDeliveryServiceType":{
"type":"string",
"description":"Scheduled delivery service type."
},
"earliestNominatedDeliveryDate":{
"type":"string",
"format":"date-time",
"description":"Earliest nominated delivery date for the scheduled delivery."
},
"latestNominatedDeliveryDate":{
"type":"string",
"format":"date-time",
"description":"Latest nominated delivery date for the scheduled delivery."
}
},
"description":"Dates for the scheduled delivery shipments."
},
"GiftDetails":{
"type":"object",
"properties":{
"giftMessage":{
"type":"string",
"description":"Gift message to be printed in shipment."
},
"giftWrapId":{
"type":"string",
"description":"Gift wrap identifier for the gift wrapping, if any."
}
},
"description":"Gift details for the item."
},
"TaxItemDetails":{
"type":"object",
"description":"Total tax details for the line item.",