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

generateShipmentContentUpdatePreviews

北美(North America）

POST

https://sellingpartnerapi-na.amazon.com/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/contentUpdatePreviews

FBA inbound operations. 2024-03-20

生成装运内容更新预览，给定一组预期的箱子和/或用于确认承运人的装运项。装运内容更新预览将在确认之前可查看更新后的费用和内容。

使用计划：

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

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

请求参数

Path 参数

inboundPlanId

string

入境计划的标识符。

必需

>= 38 字符<= 38 字符

正则匹配:

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

shipmentId

string

必需

货物的识别码。货物包含正在入库的箱子和单位。

>= 38 字符<= 38 字符

正则匹配:

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

Body 参数application/json

`生成发货内容更新预览`请求。

boxes

array[object (BoxUpdateInput) {6}]

必需

更新后将出现在发货中的盒子列表。

>= 1 items<= 5000 items

contentInformationSource

enum<string>

必需

关于箱内内容提供方式的说明。

枚举值:

BOX_CONTENT_PROVIDEDMANUAL_PROCESSBARCODE_2D

dimensions

object (Dimensions)

包裹尺寸测量。

必需

items

array[object (ItemInput) {6}]

可选

箱内物品及其数量。如果箱子的 contentInformationSource 是 BARCODE_2D 或 MANUAL_PROCESS，则此项必须为空。

packageId

string

可选

主键用于唯一标识一个盒子包裹。如果意图是更新一个现有盒子，则必须提供 PackageId。添加一个新盒子不需要提供此值。任何未提供的现有 PackageIds 将被视为待删除。

>= 38 字符<= 38 字符

正则匹配:

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

quantity

integer

必需

所有其他属性（如重量或尺寸）相同的集装箱数量。

>= 1<= 10000

weight

object (Weight)

包裹的重量。

必需

items

array[object (ItemInput) {6}]

必需

更新后货物中将包含的所有物品列表。

>= 1 items<= 2000 items

expiration

string

可选

MSKU的到期日期采用ISO 8601格式。具有不同到期日期的相同MSKU不能放入同一个箱子中。

正则匹配:

^([0-9]{4})-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$

labelOwner

enum<string>

必需

指定谁将标记物品。选项包括 AMAZON、SELLER 或 NONE。

枚举值:

AMAZONSELLERNONE

manufacturingLotCode

string

生产批次代码。

可选

>= 1 字符<= 256 字符

msku

string

商家SKU。

必需

>= 1 字符<= 40 字符

prepOwner

enum<string>

必需

在某些情况下，物品需要特殊准备，此字段反映了准备的所有者。选项包括 AMAZON、SELLER 或 NONE。

枚举值:

AMAZONSELLERNONE

quantity

integer

必需

将要发货的指定MSKU数量。

>= 1<= 10000

示例

{
  "boxes": [
    {
      "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
        }
      ],
      "packageId": "pk1234abcd-1234-abcd-5678-1234abcd5678",
      "quantity": 2,
      "weight": {
        "unit": "KG",
        "value": 5.5
      }
    }
  ],
  "items": [
    {
      "expiration": "2024-01-01",
      "labelOwner": "AMAZON",
      "manufacturingLotCode": "manufacturingLotCode",
      "msku": "Sunglasses",
      "prepOwner": "AMAZON",
      "quantity": 10
    }
  ]
}

示例代码

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//shipments//contentUpdatePreviews' \
--header 'Content-Type: application/json' \
--data-raw '{
    "boxes": [
        {
            "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
                }
            ],
            "packageId": "pk1234abcd-1234-abcd-5678-1234abcd5678",
            "quantity": 2,
            "weight": {
                "unit": "KG",
                "value": 5.5
            }
        }
    ],
    "items": [
        {
            "expiration": "2024-01-01",
            "labelOwner": "AMAZON",
            "manufacturingLotCode": "manufacturingLotCode",
            "msku": "Sunglasses",
            "prepOwner": "AMAZON",
            "quantity": 10
        }
    ]
}'

返回响应

🟢202成功

application/json

生成运输内容更新预览 202 响应

Headers

x-amzn-RequestId

string

可选

唯一请求参考标识符。

x-amzn-RateLimit-Limit

string

可选

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

Body

`GenerateShipmentContentUpdatePreviews` 响应。

operationId

string

必需

给定操作的 UUID。

>= 36 字符<= 38 字符

正则匹配:

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

示例

{
  "operationId": "stringstringstringstringstringstring"
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2025-03-15 12:29:09

listShipmentContentUpdatePreviews

getShipmentContentUpdatePreview