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

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

请求参数

Path 参数

shipmentId

string

必需

由 createInboundShipmentPlan 操作最初返回的装运标识符。

Body 参数application/json

入境货物的请求架构。

InboundShipmentHeader

object (InboundShipmentHeader)

必需

入境货物信息用于创建和更新入境货物。

ShipmentName

string

必需

货物的名称。使用一种命名规则，以帮助区分不同时间的货物，例如货物创建的日期。

ShipFromAddress

object (Address)

必需

识别地点的具体细节。

DestinationFulfillmentCenterId

string

必需

要将货物运输到的履行中心的标识符。该值来自创建入库计划操作返回的 InboundShipmentPlan 对象的响应。

AreCasesRequired

boolean

可选

指示入境货物是否包含整箱包装的盒子。注意：货物必须仅包含所有整箱包装的盒子或所有单独包装的盒子。

可能的值：

true - 货物中的所有盒子必须是整箱包装。

false - 货物中的所有盒子必须是单独包装。

注意：如果入境货物的 AreCasesRequired = true，则货物中每个项目的 QuantityInCase 值必须大于零。否则，服务将返回错误。

ShipmentStatus

enum<string>

必需

指示入库货物的状态。在使用 createInboundShipment 操作时，WORKING 是唯一有效的值。在使用 updateInboundShipment 操作时，可能的值有 WORKING、SHIPPED 或 CANCELLED。

枚举值:

WORKINGSHIPPEDRECEIVINGCANCELLEDDELETEDCLOSEDERRORIN_TRANSITDELIVEREDCHECKED_IN

LabelPrepPreference

enum<string>

必需

对入境货物进行标签准备的偏好。

枚举值:

SELLER_LABELAMAZON_LABEL_ONLYAMAZON_LABEL_PREFERRED

IntendedBoxContentsSource

enum<string>

可选

卖家打算如何提供运输的箱内物品信息。如果此字段留空，则相当于选择“无”，如果卖家未提供箱内物品信息将会产生费用。

枚举值:

NONEFEED2D_BARCODE

InboundShipmentItems

array[object (InboundShipmentItem) {8}]

必需

一个入境货物项目信息的清单。

ShipmentId

string

可选

由 createInboundShipmentPlan 操作最初返回的装运标识符。

SellerSKU

string

必需

该商品的卖家SKU。

FulfillmentNetworkSKU

string

可选

亚马逊履行网络的商品SKU。

QuantityShipped

integer <int32>

物品数量。

必需

QuantityReceived

integer <int32>

物品数量。

可选

QuantityInCase

integer <int32>

物品数量。

可选

ReleaseDate

string <date>

可选

包含字符串格式日期的类型

PrepDetailsList

array[object (PrepDetails) {2}]

可选

准备说明的清单以及谁负责该准备工作。

MarketplaceId

string

必需

市场标识符。指定产品将存储的市场。

示例

{
    "InboundShipmentHeader": {
        "ShipmentName": "string",
        "ShipFromAddress": {
            "Name": "string",
            "AddressLine1": "string",
            "AddressLine2": "string",
            "DistrictOrCounty": "string",
            "City": "string",
            "StateOrProvinceCode": "string",
            "CountryCode": "string",
            "PostalCode": "string"
        },
        "DestinationFulfillmentCenterId": "string",
        "AreCasesRequired": true,
        "ShipmentStatus": "WORKING",
        "LabelPrepPreference": "SELLER_LABEL",
        "IntendedBoxContentsSource": "NONE"
    },
    "InboundShipmentItems": [
        {
            "ShipmentId": "string",
            "SellerSKU": "string",
            "FulfillmentNetworkSKU": "string",
            "QuantityShipped": 0,
            "QuantityReceived": 0,
            "QuantityInCase": 0,
            "ReleaseDate": "2019-08-24",
            "PrepDetailsList": [
                {
                    "PrepInstruction": "Polybagging",
                    "PrepOwner": "AMAZON"
                }
            ]
        }
    ],
    "MarketplaceId": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request PUT 'https://sellingpartnerapi-na.amazon.com/fba/inbound/v0/shipments/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "InboundShipmentHeader": {
        "ShipmentName": "string",
        "ShipFromAddress": {
            "Name": "string",
            "AddressLine1": "string",
            "AddressLine2": "string",
            "DistrictOrCounty": "string",
            "City": "string",
            "StateOrProvinceCode": "string",
            "CountryCode": "string",
            "PostalCode": "string"
        },
        "DestinationFulfillmentCenterId": "string",
        "AreCasesRequired": true,
        "ShipmentStatus": "WORKING",
        "LabelPrepPreference": "SELLER_LABEL",
        "IntendedBoxContentsSource": "NONE"
    },
    "InboundShipmentItems": [
        {
            "ShipmentId": "string",
            "SellerSKU": "string",
            "FulfillmentNetworkSKU": "string",
            "QuantityShipped": 0,
            "QuantityReceived": 0,
            "QuantityInCase": 0,
            "ReleaseDate": "2019-08-24",
            "PrepDetailsList": [
                {
                    "PrepInstruction": "Polybagging",
                    "PrepOwner": "AMAZON"
                }
            ]
        }
    ],
    "MarketplaceId": "string"
}'

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

此操作的响应模式。

payload

object (InboundShipmentResult)

入境货物操作的结果

可选

ShipmentId

string

必需

请求中提交的装运标识符。

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个识别所发生错误类型的错误代码。

message

string

必需

一种以人类可读的形式描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

示例

{
    "payload": {
        "ShipmentId": "string"
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障