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

setPackingInformation

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingInformation

FBA inbound operations. 2024-03-20

设置入境计划的装箱信息。创建入境计划后，应调用此功能以填充规划和运输估算所需的箱级信息。

使用计划：

速率（每秒请求）	峰值
2	2

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

请求参数

Path 参数

inboundPlanId

string

入境计划的标识符。

必需

>= 38 字符<= 38 字符

正则匹配:

^[a-zA-Z0-9-]*$

Body 参数application/json

`setPackingInformation` 请求。

packageGroupings

array[object (PackageGroupingInput) {3}]

必需

入库计划的包装信息列表。

>= 1 items

boxes

array[object (BoxInput) {5}]

必需

提供盒子级别的信息。

>= 1 items<= 5000 items

packingGroupId

string

可选

packingGroup的ID，用于分组包裹。PackingGroupId只能在确认放置之前提供，且必须属于已确认的PackingOption。每个请求必须提供ShipmentId或PackingGroupId之一。

>= 38 字符<= 38 字符

正则匹配:

^[a-zA-Z0-9-]*$

shipmentId

string

可选

根据分组的包装的发货ID。ShipmentId 只能在确认发货后提供，并且该发货必须属于确认的放置选项。每个请求必须提供 ShipmentId 或 PackingGroupId 之一。

>= 38 字符<= 38 字符

正则匹配:

^[a-zA-Z0-9-]*$

示例

{
    "packageGroupings": [
        {
            "boxes": [
                {
                    "boxId": "FBA10ABC0YY100001",
                    "contentInformationSource": "BOX_CONTENT_PROVIDED",
                    "dimensions": {
                        "height": 5,
                        "length": 3,
                        "unitOfMeasurement": "CM",
                        "width": 4
                    },
                    "items": [
                        {
                            "expiration": "2024-01-01",
                            "labelOwner": "AMAZON",
                            "manufacturingLotCode": "manufacturingLotCode",
                            "msku": "Sunglasses",
                            "prepOwner": "AMAZON",
                            "quantity": 10
                        }
                    ],
                    "quantity": 2,
                    "weight": {
                        "unit": "KG",
                        "value": 5.5
                    }
                }
            ],
            "packingGroupId": "pg1234abcd-1234-abcd-5678-1234abcd5678",
            "shipmentId": "sh1234abcd-1234-abcd-5678-1234abcd5678"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/inbound/fba/2024-03-20/inboundPlans//packingInformation' \
--header 'Content-Type: application/json' \
--data-raw '{
    "packageGroupings": [
        {
            "boxes": [
                {
                    "boxId": "FBA10ABC0YY100001",
                    "contentInformationSource": "BOX_CONTENT_PROVIDED",
                    "dimensions": {
                        "height": 5,
                        "length": 3,
                        "unitOfMeasurement": "CM",
                        "width": 4
                    },
                    "items": [
                        {
                            "expiration": "2024-01-01",
                            "labelOwner": "AMAZON",
                            "manufacturingLotCode": "manufacturingLotCode",
                            "msku": "Sunglasses",
                            "prepOwner": "AMAZON",
                            "quantity": 10
                        }
                    ],
                    "quantity": 2,
                    "weight": {
                        "unit": "KG",
                        "value": 5.5
                    }
                }
            ],
            "packingGroupId": "pg1234abcd-1234-abcd-5678-1234abcd5678",
            "shipmentId": "sh1234abcd-1234-abcd-5678-1234abcd5678"
        }
    ]
}'

返回响应

🟢202成功

application/json

设置打包信息 202 响应

Headers

x-amzn-RequestId

string

可选

唯一请求参考标识符。

x-amzn-RateLimit-Limit

string

可选

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

Body

`setPackingInformation` 响应。

operationId

string

必需

给定操作的 UUID。

>= 36 字符<= 38 字符

正则匹配:

^[a-zA-Z0-9-]*$

示例

{
    "operationId": "stringstringstringstringstringstring"
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

listPackingGroupItems

listPackingOptions