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

返回一个新的入境货运，基于通过 createInboundShipmentPlan 操作返回的指定 shipmentId。

使用计划：

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

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

请求参数

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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服务器故障