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

返回一个或多个入库计划，提供您创建一个或多个入库所需的信息，适用于您指定的一组商品。可能需要多个入库计划，以便能够在亚马逊的履行网络中优化商品的位置，例如，将库存置于离客户更近的位置。或者，如果两个入库计划需要不同的处理，则可以创建两个具有相同亚马逊履行中心目的地的入库计划，例如，需贴标签的商品必须与无标签的混合库存分开运输。

使用计划：

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

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

请求参数

Body 参数application/json

创建入库货物计划操作的请求schema。

ShipFromAddress

object (Address)

必需

识别地点的具体细节。

Name

string

个人或企业的名称。

必需

<= 50 字符

AddressLine1

string

街道地址信息。

必需

<= 180 字符

AddressLine2

string

可选

如有需要，附加的街道地址信息。

<= 60 字符

DistrictOrCounty

string

地区或县。

可选

<= 25 字符

City

string

城市。

必需

<= 30 字符

StateOrProvinceCode

string

必需

州或省代码。

如果您的市场使用州或省代码，建议您在请求中包含一个。这有助于亚马逊为您的入库运输计划选择最合适的亚马逊履行中心。

CountryCode

string

必需

国家代码采用两位字符的ISO 3166-1 alpha-2格式。

PostalCode

string

必需

邮政编码。

如果您的市场使用邮政编码，我们建议您在请求中包含一个。这有助于亚马逊选择最适合的亚马逊配送中心用于入库发货计划。

<= 30 字符

LabelPrepPreference

enum<string>

必需

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

枚举值:

SELLER_LABELAMAZON_LABEL_ONLYAMAZON_LABEL_PREFERRED

ShipToCountryCode

string

可选

发货国家的两位字符国家代码。

注意：不是必需的。指定 ShipToCountryCode 和 ShipToCountrySubdivisionCode 两者将返回错误。

值：

北美的 ShipToCountryCode 值：

CA – 加拿大

MX - 墨西哥

US - 美国

欧洲 MCI 卖家的 ShipToCountryCode 值：

DE – 德国

ES – 西班牙

FR – 法国

GB – 英国

IT – 意大利

默认：卖家所在市场的国家代码。

ShipToCountrySubdivisionCode

string

可选

两个字符的国家代码，后跟一个短横线，再加上最多三个字符表示入境货物要发送的国家的细分。例如，“IN-MH”。完整的ISO 3166-2格式。

注意：不是必需的。指定ShipToCountryCode和ShipToCountrySubdivisionCode都会返回错误。

InboundShipmentPlanRequestItems

array[object (InboundShipmentPlanRequestItem) {6}]

必需

入境货物运输计划请求列表

SellerSKU

string

必需

该商品的卖家SKU。

ASIN

string

必需

该商品的亚马逊标准识别号码（ASIN）。

Condition

enum<string>

物品的状况。

必需

枚举值:

NewItemNewWithWarrantyNewOEMNewOpenBoxUsedLikeNewUsedVeryGoodUsedGoodUsedAcceptableUsedPoorUsedRefurbishedCollectibleLikeNewCollectibleVeryGoodCollectibleGoodCollectibleAcceptableCollectiblePoorRefurbishedWithWarrantyRefurbishedClub

Quantity

integer <int32>

物品数量。

必需

QuantityInCase

integer <int32>

物品数量。

可选

PrepDetailsList

array[object (PrepDetails) {2}]

可选

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

示例

{
    "ShipFromAddress": {
        "Name": "string",
        "AddressLine1": "string",
        "AddressLine2": "string",
        "DistrictOrCounty": "string",
        "City": "string",
        "StateOrProvinceCode": "string",
        "CountryCode": "string",
        "PostalCode": "string"
    },
    "LabelPrepPreference": "SELLER_LABEL",
    "ShipToCountryCode": "string",
    "ShipToCountrySubdivisionCode": "string",
    "InboundShipmentPlanRequestItems": [
        {
            "SellerSKU": "string",
            "ASIN": "string",
            "Condition": "NewItem",
            "Quantity": 0,
            "QuantityInCase": 0,
            "PrepDetailsList": [
                {
                    "PrepInstruction": "Polybagging",
                    "PrepOwner": "AMAZON"
                }
            ]
        }
    ]
}

示例代码

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 (CreateInboundShipmentPlanResult)

可选

创建入库发货操作的结果

InboundShipmentPlans

array[object (InboundShipmentPlan) {6}]

可选

入境货物运输计划信息清单

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

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

details

string

可选

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

示例

{
    "payload": {
        "InboundShipmentPlans": [
            {
                "ShipmentId": "string",
                "DestinationFulfillmentCenterId": "string",
                "ShipToAddress": {
                    "Name": "string",
                    "AddressLine1": "string",
                    "AddressLine2": "string",
                    "DistrictOrCounty": "string",
                    "City": "string",
                    "StateOrProvinceCode": "string",
                    "CountryCode": "string",
                    "PostalCode": "string"
                },
                "LabelPrepType": "NO_LABEL",
                "Items": [
                    {
                        "SellerSKU": "string",
                        "FulfillmentNetworkSKU": "string",
                        "Quantity": 0,
                        "PrepDetailsList": [
                            {
                                "PrepInstruction": "Polybagging",
                                "PrepOwner": "AMAZON"
                            }
                        ]
                    }
                ],
                "EstimatedBoxContentsFee": {
                    "TotalUnits": 0,
                    "FeePerUnit": {
                        "CurrencyCode": "USD",
                        "Value": 0
                    },
                    "TotalFee": {
                        "CurrencyCode": "USD",
                        "Value": 0
                    }
                }
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障