updateScheduledPackages

北美(North America）

https://sellingpartnerapi-na.amazon.com

PATCH

/easyShip/2022-03-23/package

更新指定 scheduledPackageId 的包裹交接时间段。您可以通过在再次进行 patch 调用之前调用 listHandoverSlots 操作来获取新的 slotId 值。

请查看市场支持表中的 更新包裹 列，以了解此操作支持哪些市场。

使用计划：

速率（每秒请求数）	突发
1	5

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

请求参数

Body 参数application/json

示例

{
    "marketplaceId": "string",
    "updatePackageDetailsList": [
        {
            "scheduledPackageId": {
                "amazonOrderId": "string",
                "packageId": "string"
            },
            "packageTimeSlot": {
                "slotId": "string",
                "startTime": "2019-08-24T14:15:22.123Z",
                "endTime": "2019-08-24T14:15:22.123Z",
                "handoverMethod": "PICKUP"
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://sellingpartnerapi-na.amazon.com/easyShip/2022-03-23/package' \
--header 'Content-Type: application/json' \
--data '{
    "marketplaceId": "string",
    "updatePackageDetailsList": [
        {
            "scheduledPackageId": {
                "amazonOrderId": "string",
                "packageId": "string"
            },
            "packageTimeSlot": {
                "slotId": "string",
                "startTime": "2019-08-24T14:15:22.123Z",
                "endTime": "2019-08-24T14:15:22.123Z",
                "handoverMethod": "PICKUP"
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

成功

Headers

Bodyapplication/json

示例

[
    {
        "packageTrackingNumber": "string"
    }
]

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2026-08-27 14:13:24

createScheduledPackage

createScheduledPackageBulk