getShipmentContentUpdatePreview

检索运输内容更新预览，提供所请求的运输内容更改摘要及变更的运输成本影响，只能在指定的到期日前确认。

使用计划：

速率（每秒请求数）	突发
2	30

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

请求参数

Path 参数

inboundPlanId

string

入境计划的标识符。

必需

>= 38 字符<= 38 字符

正则匹配:

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

shipmentId

string

必需

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

>= 38 字符<= 38 字符

正则匹配:

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

contentUpdatePreviewId

string

必需

内容更新预览的标识符。

>= 38 字符<= 38 字符

正则匹配:

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

返回响应

🟢200成功

application/json

获取货物内容更新预览 200 响应

Headers

x-amzn-RequestId

string

可选

唯一请求参考标识符。

x-amzn-RateLimit-Limit

string

可选

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

Body

将应用于货物的更改预览。

contentUpdatePreviewId

string

必需

内容更新预览的标识符。

>= 38 字符<= 38 字符

正则匹配:

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

expiration

string

必需

内容更新到期的ISO 8601格式日期。

正则匹配:

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

requestedUpdates

object (RequestedUpdates)

必需

在更新请求中包含的对象。

boxes

array[object (BoxUpdateInput) {6}]

可选

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

items

array[object (ItemInput) {6}]

可选

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

transportationOption

object (TransportationOption)

必需

包含与运输选项及相关承运人有关的信息。

示例值:

{"carrier":{"alphaCode":"ABCD","name":"Carrier Name"},"carrierAppointment":{"endTime":"2024-01-06T14:48:00.000Z","startTime":"2024-01-05T14:48:00.000Z"},"preconditions":["CONFIRMED_DELIVERY_WINDOW"],"quote":{"cost":{"amount":5.5,"code":"CAD"},"expiration":"2024-01-06T14:48:00.000Z","voidableUntil":"2024-01-05T14:48:00.000Z"},"shipmentId":"sh1234abcd-1234-abcd-5678-1234abcd5678","shippingMode":"GROUND_SMALL_PARCEL","shippingSolution":"AMAZON_PARTNERED_CARRIER","transportationOptionId":"to1234abcd-1234-abcd-5678-1234abcd5678"}

carrier

object (Carrier)

入境货物的承运人。

必需

carrierAppointment

object (CarrierAppointment)

可选

包含运输承运人预约的详细信息。此预约由亚马逊分包，是运输承运人接受待提取货物的指示。

preconditions

array[string]

必需

确定确认运输选项的先决条件列表。

quote

object (Quote)

可选

与运输选项相关的预计运费。

shipmentId

string

必需

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

>= 38 字符<= 38 字符

正则匹配:

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

shippingMode

string

必需

该选项提供的运输方式可以是：GROUND_SMALL_PARCEL，FREIGHT_LTL，FREIGHT_FTL_PALLET，FREIGHT_FTL_NONPALLET，OCEAN_LCL，OCEAN_FCL，AIR_SMALL_PARCEL，AIR_SMALL_PARCEL_EXPRESS。

>= 1 字符<= 1024 字符

shippingSolution

string

必需

运输方案选项可以是：AMAZON_PARTNERED_CARRIER，USE_YOUR_OWN_CARRIER。

>= 1 字符<= 1024 字符

transportationOptionId

string

必需

运输选项的标识符。运输选项代表了发送货物的一种选择。

>= 38 字符<= 38 字符

正则匹配:

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

示例

{
  "contentUpdatePreviewId": "stringstringstringstringstringstringst",
  "expiration": "string",
  "requestedUpdates": {
    "boxes": [
      {
        "contentInformationSource": "BOX_CONTENT_PROVIDED",
        "dimensions": {
          "height": 0,
          "length": 0,
          "unitOfMeasurement": "IN",
          "width": 0
        },
        "items": [
          {
            "expiration": "2024-01-01",
            "labelOwner": "AMAZON",
            "manufacturingLotCode": "manufacturingLotCode",
            "msku": "Sunglasses",
            "prepOwner": "AMAZON",
            "quantity": 10
          }
        ],
        "packageId": "stringstringstringstringstringstringst",
        "quantity": 1,
        "weight": {
          "unit": "LB",
          "value": 0
        }
      }
    ],
    "items": [
      {
        "expiration": "2024-01-01",
        "labelOwner": "AMAZON",
        "manufacturingLotCode": "manufacturingLotCode",
        "msku": "Sunglasses",
        "prepOwner": "AMAZON",
        "quantity": 10
      }
    ]
  },
  "transportationOption": {
    "carrier": {
      "alphaCode": "ABCD",
      "name": "Carrier Name"
    },
    "carrierAppointment": {
      "endTime": "2024-01-06T14:48:00.000Z",
      "startTime": "2024-01-05T14:48:00.000Z"
    },
    "preconditions": [
      "CONFIRMED_DELIVERY_WINDOW"
    ],
    "quote": {
      "cost": {
        "amount": 5.5,
        "code": "CAD"
      },
      "expiration": "2024-01-06T14:48:00.000Z",
      "voidableUntil": "2024-01-05T14:48:00.000Z"
    },
    "shipmentId": "sh1234abcd-1234-abcd-5678-1234abcd5678",
    "shippingMode": "GROUND_SMALL_PARCEL",
    "shippingSolution": "AMAZON_PARTNERED_CARRIER",
    "transportationOptionId": "to1234abcd-1234-abcd-5678-1234abcd5678"
  }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应