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

此操作自动为所有输入的 amazonOrderId 预定时间段，生成相关的运输标签以及其他符合市场要求的文档（参考市场文档支持表）。

调用此操作的开发者可以选择性地分配 packageDetails 对象，使他们能够为请求中的每个订单输入首选的时间段。在这种情况下，亚马逊将尝试使用其可选设置安排相应的包裹。另一方面，即，如果未提供时间段，则亚马逊将选择尽可能早的时间段。

关于运输标签的文件格式，外部开发者可以选择 PDF 或 ZPL，亚马逊将相应地创建标签。

此操作返回一个数组，由已安排的包裹组成，并且包含一个短期有效的 URL，指向一个 zip 文件，其中包含生成的运输标签和其他为您的市场启用的文档。如果至少有一个订单无法安排，则亚马逊将在响应中添加 rejectedOrders 列表，其中包含我们无法处理的每个订单的条目。每个条目由一个错误消息组成，描述失败的原因，以便卖家能够采取相应的措施。

下表显示了支持的请求和突发最大速率：

使用计划：

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

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

请求参数

Body 参数application/json必填

示例

{
    "marketplaceId": "string",
    "orderScheduleDetailsList": [
        {
            "amazonOrderId": "string",
            "packageDetails": {
                "packageItems": [
                    {
                        "itemSequenceNumber": "string",
                        "amazonProductIdentifier": "string",
                        "vendorProductIdentifier": "string",
                        "shippedQuantity": {
                            "amount": 0,
                            "unitOfMeasure": "Cases",
                            "unitSize": 0,
                            "totalWeight": {
                                "unitOfMeasure": "POUNDS",
                                "amount": "string"
                            }
                        },
                        "itemDetails": {
                            "purchaseOrderNumber": "string",
                            "lotNumber": "string",
                            "lotNumberSourceReference": "string",
                            "lotNumberSourceType": "GLN",
                            "countryOfOrigin": "string",
                            "regulationReferences": {
                                "dueDiligenceReference": "string",
                                "dueDiligenceVerification": "string",
                                "dueDiligenceInformation": "string",
                                "dueDiligenceExemptionCode": "string"
                            },
                            "expiry": {
                                "manufacturerDate": "2019-08-24T14:15:22.123Z",
                                "expiryDate": "2019-08-24T14:15:22.123Z",
                                "expiryAfterDuration": {
                                    "durationUnit": "Days",
                                    "durationValue": 0
                                }
                            },
                            "maximumRetailPrice": {
                                "currencyCode": "string",
                                "amount": "string"
                            },
                            "handlingCode": "Oversized"
                        }
                    }
                ],
                "packageTimeSlot": {
                    "slotId": "string",
                    "startTime": "2019-08-24T14:15:22.123Z",
                    "endTime": "2019-08-24T14:15:22.123Z",
                    "handoverMethod": "PICKUP"
                },
                "packageIdentifier": "string"
            }
        }
    ],
    "labelFormat": "PDF"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sellingpartnerapi-na.amazon.com/easyShip/2022-03-23/packages/bulk' \
--header 'Content-Type: application/json' \
--data '{
    "marketplaceId": "string",
    "orderScheduleDetailsList": [
        {
            "amazonOrderId": "string",
            "packageDetails": {
                "packageItems": [
                    {
                        "itemSequenceNumber": "string",
                        "amazonProductIdentifier": "string",
                        "vendorProductIdentifier": "string",
                        "shippedQuantity": {
                            "amount": 0,
                            "unitOfMeasure": "Cases",
                            "unitSize": 0,
                            "totalWeight": {
                                "unitOfMeasure": "POUNDS",
                                "amount": "string"
                            }
                        },
                        "itemDetails": {
                            "purchaseOrderNumber": "string",
                            "lotNumber": "string",
                            "lotNumberSourceReference": "string",
                            "lotNumberSourceType": "GLN",
                            "countryOfOrigin": "string",
                            "regulationReferences": {
                                "dueDiligenceReference": "string",
                                "dueDiligenceVerification": "string",
                                "dueDiligenceInformation": "string",
                                "dueDiligenceExemptionCode": "string"
                            },
                            "expiry": {
                                "manufacturerDate": "2019-08-24T14:15:22.123Z",
                                "expiryDate": "2019-08-24T14:15:22.123Z",
                                "expiryAfterDuration": {
                                    "durationUnit": "Days",
                                    "durationValue": 0
                                }
                            },
                            "maximumRetailPrice": {
                                "currencyCode": "string",
                                "amount": "string"
                            },
                            "handlingCode": "Oversized"
                        }
                    }
                ],
                "packageTimeSlot": {
                    "slotId": "string",
                    "startTime": "2019-08-24T14:15:22.123Z",
                    "endTime": "2019-08-24T14:15:22.123Z",
                    "handoverMethod": "PICKUP"
                },
                "packageIdentifier": "string"
            }
        }
    ],
    "labelFormat": "PDF"
}'

返回响应

🟢200成功

application/json

成功

Headers

Bodyapplication/json

示例

{
    "scheduledPackages": [
        {
            "packageTrackingNumber": "string"
        }
    ],
    "rejectedOrders": [
        {
            "amazonOrderId": "string",
            "error": {
                "code": "string",
                "message": "string",
                "details": "string"
            }
        }
    ],
    "printableDocumentsUrl": "string"
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障