getPurchaseOrdersStatus

根据您指定的过滤条件返回采购订单状态。搜索的日期范围不得超过7天。您可以使用可用的过滤器返回采购订单状态列表，或通过提供采购订单编号返回单个采购订单状态。

使用计划：

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

x-amzn-RateLimit-Limit 响应头在可用时返回应用于请求操作的使用计划速率限制。上表指示此操作的默认速率和突发值。对业务需求要求更高的销售合作伙伴，可能会看到比这里显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴API中的使用计划和速率限制。

请求参数

Query 参数

limit

integer <int64>

可选

返回记录的数量限制。默认值为100条记录。

>= 1<= 100

sortOrder

enum<string>

可选

按采购订单创建日期升序或降序排序。

枚举值:

ASCDESC

nextToken

string

可选

用于分页，当采购订单数量超过指定结果大小限制时。

createdAfter

string <date-time>

可选

在此时间戳之后可用的采购订单将被包含在结果中。必须采用 ISO 8601 日期/时间格式。

createdBefore

string <date-time>

可选

在此时间戳之前生成的采购订单将会包含在结果中。必须采用 ISO 8601 日期/时间格式。

updatedAfter

string <date-time>

可选

在此时间戳之后进行最后一次更新的采购订单将被包含在结果中。必须使用ISO 8601日期/时间格式。

updatedBefore

string <date-time>

可选

购买订单中最后一次更新发生在该时间戳之前的订单将包含在结果中。必须采用 ISO 8601 日期/时间格式。

purchaseOrderNumber

string

可选

提供指定采购订单号的采购订单状态。

purchaseOrderStatus

enum<string>

可选

根据指定的采购订单状态过滤采购订单。如果未包含在过滤器中，则将返回所有状态的采购订单。

枚举值:

OPENCLOSED

itemConfirmationStatus

enum<string>

可选

根据物品确认状态过滤采购订单。如果过滤中不包含物品确认状态，则包括所有确认状态的采购订单。

枚举值:

ACCEPTEDPARTIALLY_ACCEPTEDREJECTEDUNCONFIRMED

itemReceiveStatus

enum<string>

可选

根据采购订单的物品接收状态过滤采购订单。如果物品接收状态不包含在过滤器中，则包括所有接收状态的采购订单。

枚举值:

NOT_RECEIVEDPARTIALLY_RECEIVEDRECEIVED

orderingVendorCode

string

可选

根据指定的订购供应商代码过滤采购订单。该值应与采购订单中的“sellingParty.partyId”相同。如果未包括在过滤器中，则返回用于授权API客户端应用程序的供应商组中所有存在的供应商代码的所有采购订单。

shipToPartyId

string

可选

通过在此处提供发货位置ID，过滤特定买家的履行中心/仓库的采购订单。此值应与采购订单中的'shipToParty.partyId'相同。如果未包括在过滤条件中，则将返回买家用于供应商集团采购订单的所有仓库的采购订单。

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`getPurchaseOrdersStatus` 操作的响应模式。

payload

object (OrderListStatus)

订单状态列表。

可选

pagination

object (Pagination)

可选

检索剩余数据所需的分页元素。

ordersStatus

array[object (OrderStatus) {7}]

可选

表示 OrderListStatus 中的订单状态。

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

示例

{
    "payload": {
        "pagination": {
            "nextToken": "string"
        },
        "ordersStatus": [
            {
                "purchaseOrderNumber": "string",
                "purchaseOrderStatus": "OPEN",
                "purchaseOrderDate": "2019-08-24T14:15:22Z",
                "lastUpdatedDate": "2019-08-24T14:15:22Z",
                "sellingParty": {
                    "partyId": "string",
                    "address": {
                        "name": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "addressLine3": "string",
                        "city": "string",
                        "county": "string",
                        "district": "string",
                        "stateOrRegion": "string",
                        "postalCode": "string",
                        "countryCode": "st",
                        "phone": "string"
                    },
                    "taxInfo": {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                },
                "shipToParty": {
                    "partyId": "string",
                    "address": {
                        "name": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "addressLine3": "string",
                        "city": "string",
                        "county": "string",
                        "district": "string",
                        "stateOrRegion": "string",
                        "postalCode": "string",
                        "countryCode": "st",
                        "phone": "string"
                    },
                    "taxInfo": {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                },
                "itemStatus": [
                    {
                        "itemSequenceNumber": "string",
                        "buyerProductIdentifier": "string",
                        "vendorProductIdentifier": "string",
                        "netCost": {
                            "currencyCode": "str",
                            "amount": "string"
                        },
                        "listPrice": {
                            "currencyCode": "str",
                            "amount": "string"
                        },
                        "orderedQuantity": {
                            "orderedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "orderedQuantityDetails": [
                                {
                                    "updatedDate": "2019-08-24T14:15:22Z",
                                    "orderedQuantity": {
                                        "amount": 0,
                                        "unitOfMeasure": "Cases",
                                        "unitSize": 0
                                    },
                                    "cancelledQuantity": {
                                        "amount": 0,
                                        "unitOfMeasure": "Cases",
                                        "unitSize": 0
                                    }
                                }
                            ]
                        },
                        "acknowledgementStatus": {
                            "confirmationStatus": "ACCEPTED",
                            "acceptedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "rejectedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "acknowledgementStatusDetails": [
                                {
                                    "acknowledgementDate": "2019-08-24T14:15:22Z",
                                    "acceptedQuantity": {
                                        "amount": 0,
                                        "unitOfMeasure": "Cases",
                                        "unitSize": 0
                                    },
                                    "rejectedQuantity": {
                                        "amount": 0,
                                        "unitOfMeasure": "Cases",
                                        "unitSize": 0
                                    }
                                }
                            ]
                        },
                        "receivingStatus": {
                            "receiveStatus": "NOT_RECEIVED",
                            "receivedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "lastReceiveDate": "2019-08-24T14:15:22Z"
                        }
                    }
                ]
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应