getPurchaseOrders

返回在您指定的时间范围内创建或更改的采购订单列表。您可以使用 createdAfter、createdBefore、changedAfter 和 changedBefore 参数定义时间范围。日期范围不得超过 7 天，且仅可提取过去 6 个月内的数据。您可以将 includeDetails 设置为 false，只获取采购订单编号。然后，您可以使用 getPurchaseOrder 操作来获取特定采购订单的详细信息。

使用计划：

速率（每秒请求数）	突发
10	10

x-amzn-RateLimit-Limit 响应头会返回应用于所请求操作的使用计划速率限制（如果可用）。上表显示了此操作的默认速率和突发值。业务需求要求更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处显示的值。有关更多信息，请参阅Selling Partner API 中的使用计划和速率限制。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功。

Headers

Body

示例

{
    "payload": {
        "pagination": {
            "nextToken": "string"
        },
        "orders": [
            {
                "purchaseOrderNumber": "string",
                "purchaseOrderState": "New",
                "orderDetails": {
                    "purchaseOrderDate": "2019-08-24T14:15:22.123Z",
                    "purchaseOrderChangedDate": "2019-08-24T14:15:22.123Z",
                    "purchaseOrderStateChangedDate": "2019-08-24T14:15:22.123Z",
                    "purchaseOrderType": "RegularOrder",
                    "importDetails": {
                        "methodOfPayment": "PaidByBuyer",
                        "sealNumber": "string",
                        "route": {
                            "stops": [
                                {
                                    "functionCode": "PortOfDischarge",
                                    "locationIdentification": {
                                        "type": "string",
                                        "locationCode": "string",
                                        "countryCode": "string"
                                    },
                                    "arrivalTime": "2019-08-24T14:15:22.123Z",
                                    "departureTime": "2019-08-24T14:15:22.123Z"
                                }
                            ]
                        },
                        "importContainers": "string",
                        "billableWeight": {
                            "unitOfMeasure": "G",
                            "value": "string"
                        },
                        "estimatedShipByDate": "2019-08-24T14:15:22.123Z",
                        "handlingInstructions": "Oversized"
                    },
                    "dealCode": "string",
                    "paymentMethod": "Invoice",
                    "buyingParty": {
                        "address": {
                            "name": "string",
                            "addressLine1": "string",
                            "addressLine2": "string",
                            "addressLine3": "string",
                            "city": "string",
                            "county": "string",
                            "district": "string",
                            "stateOrRegion": "string",
                            "postalCode": "string",
                            "countryCode": "string",
                            "phone": "string"
                        },
                        "partyId": "string",
                        "taxRegistrationDetails": [
                            {
                                "taxRegistrationType": "VAT",
                                "taxRegistrationNumber": "string"
                            }
                        ]
                    },
                    "sellingParty": {
                        "address": {
                            "name": "string",
                            "addressLine1": "string",
                            "addressLine2": "string",
                            "addressLine3": "string",
                            "city": "string",
                            "county": "string",
                            "district": "string",
                            "stateOrRegion": "string",
                            "postalCode": "string",
                            "countryCode": "string",
                            "phone": "string"
                        },
                        "partyId": "string",
                        "taxRegistrationDetails": [
                            {
                                "taxRegistrationType": "VAT",
                                "taxRegistrationNumber": "string"
                            }
                        ]
                    },
                    "shipToParty": {
                        "address": {
                            "name": "string",
                            "addressLine1": "string",
                            "addressLine2": "string",
                            "addressLine3": "string",
                            "city": "string",
                            "county": "string",
                            "district": "string",
                            "stateOrRegion": "string",
                            "postalCode": "string",
                            "countryCode": "string",
                            "phone": "string"
                        },
                        "partyId": "string",
                        "taxRegistrationDetails": [
                            {
                                "taxRegistrationType": "VAT",
                                "taxRegistrationNumber": "string"
                            }
                        ]
                    },
                    "billToParty": {
                        "address": {
                            "name": "string",
                            "addressLine1": "string",
                            "addressLine2": "string",
                            "addressLine3": "string",
                            "city": "string",
                            "county": "string",
                            "district": "string",
                            "stateOrRegion": "string",
                            "postalCode": "string",
                            "countryCode": "string",
                            "phone": "string"
                        },
                        "partyId": "string",
                        "taxRegistrationDetails": [
                            {
                                "taxRegistrationType": "VAT",
                                "taxRegistrationNumber": "string"
                            }
                        ]
                    },
                    "shipWindow": "string",
                    "deliveryWindow": "string",
                    "items": [
                        {
                            "itemSequenceNumber": "string",
                            "amazonProductIdentifier": "string",
                            "vendorProductIdentifier": "string",
                            "orderedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0,
                                "totalWeight": {
                                    "unitOfMeasure": "POUNDS",
                                    "amount": "string"
                                }
                            },
                            "isBackOrderAllowed": true,
                            "netCost": {
                                "currencyCode": "string",
                                "amount": "string"
                            },
                            "listPrice": {
                                "currencyCode": "string",
                                "amount": "string"
                            }
                        }
                    ]
                }
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

请求示例代码

返回响应