updateScheduledPackages - Amazon Selling Partner API (SP-API)-中文

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

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

使用计划：

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

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

请求参数

Body 参数application/json

`updateScheduledPackages`操作的请求架构。

marketplaceId

string

必需

最长为255个字符的字符串。

>= 1 字符<= 255 字符

updatePackageDetailsList

array[object (UpdatePackageDetails) {2}]

必需

软件包更新详情列表。

>= 1 items<= 500 items

scheduledPackageId

object (ScheduledPackageId)

必需

识别要更新的计划包裹。

packageTimeSlot

object (TimeSlot)

必需

将Easy Ship包裹交给亚马逊物流的时间窗口。

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

一份包裹清单。

packages

array[object (Package) {9}]

一份包裹清单。

必需

>= 1 items<= 500 items

scheduledPackageId

object (ScheduledPackageId)

必需

识别要更新的计划包裹。

packageDimensions

object (Dimensions)

预定包裹的尺寸。

必需

packageWeight

object (Weight)

已安排包裹的重量

必需

packageItems

array[object (Item) {5}]

可选

包裹中包含的物品清单。

packageTimeSlot

object (TimeSlot)

必需

将Easy Ship包裹交给亚马逊物流的时间窗口。

packageIdentifier

string

可选

可选的卖家创建的标识符，印刷在运输标签上，以帮助卖家识别包裹。

invoice

object (InvoiceData)

发票号码和日期。

可选

packageStatus

enum<string>

包裹的状态。

可选

枚举值:

ReadyForPickupPickedUpAtOriginFCAtDestinationFCDeliveredRejectedUndeliverableReturnedToSellerLostInTransitLabelCanceledDamagedInTransitOutForDelivery

trackingDetails

object (TrackingDetails)

跟踪元数据的表示。

可选

示例

{
    "packages": [
        {
            "scheduledPackageId": {
                "amazonOrderId": "string",
                "packageId": "string"
            },
            "packageDimensions": {
                "length": 0.01,
                "width": 0.01,
                "height": 0.01,
                "unit": "Cm",
                "identifier": "string"
            },
            "packageWeight": {
                "value": 11,
                "unit": "Grams"
            },
            "packageItems": [
                {
                    "description": "string",
                    "relatedIdentifiers": [
                        {
                            "itemRelatedIdentifierName": "ORDER_ADJUSTMENT_ITEM_ID",
                            "itemRelatedIdentifierValue": "OAI-123456789"
                        }
                    ],
                    "totalAmount": {
                        "currencyCode": "string",
                        "currencyAmount": 0
                    },
                    "breakdowns": [
                        {
                            "breakdownType": "string",
                            "breakdownAmount": {
                                "currencyCode": "string",
                                "currencyAmount": 0
                            },
                            "breakdowns": {}
                        }
                    ],
                    "contexts": [
                        {
                            "contextType": "string",
                            "storeName": "Store 1",
                            "orderType": "Order Type",
                            "channel": "MFN",
                            "asin": "B07FGXZQZ1",
                            "sku": "sku-12",
                            "quantityShipped": 1,
                            "fulfillmentNetwork": "MFN",
                            "paymentType": "Debit Card",
                            "paymentMethod": "BANK",
                            "paymentReference": "XXXXX123",
                            "paymentDate": "2020-07-14T03:35:13.214Z",
                            "deferralReason": "B2B",
                            "maturityDate": "2024-07-14T00:00:00Z",
                            "deferralStatus": "HOLD",
                            "startTime": "2020-07-14T03:35:13.214Z",
                            "endTime": "2020-07-14T03:35:13.214Z"
                        }
                    ]
                }
            ],
            "packageTimeSlot": {
                "slotId": "string",
                "startTime": "2019-08-24T14:15:22Z",
                "endTime": "2019-08-24T14:15:22Z",
                "handoverMethod": "Pickup"
            },
            "packageIdentifier": "string",
            "invoice": {
                "invoiceNumber": "string",
                "invoiceDate": "2019-08-24T14:15:22Z"
            },
            "packageStatus": "ReadyForPickup",
            "trackingDetails": {
                "trackingId": "string"
            }
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障