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

createInboundPlan

北美(North America）

POST

https://sellingpartnerapi-na.amazon.com/inbound/fba/2024-03-20/inboundPlans

FBA inbound operations. 2024-03-20

创建入库计划。入库计划包含将货物发送至亚马逊履行网络所需的所有信息。

使用计划：

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

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

请求参数

Body 参数application/json

`createInboundPlan` 请求。

destinationMarketplaces

array[string]

必需

需要发货的市场。目前在此请求中只能选择一个市场。

>= 1 items<= 1 items

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

name

string

可选

入境计划的名称。如果没有提供，将提供一个默认名称。

>= 1 字符<= 40 字符

sourceAddress

object (AddressInput)

必需

识别地点的具体细节。

示例值:

{"addressLine1":"123 example street","addressLine2":"Floor 19","city":"Toronto","companyName":"Acme","countryCode":"CA","email":"email@email.com","name":"name","phoneNumber":"1234567890","postalCode":"M1M1M1","stateOrProvinceCode":"ON"}

addressLine1

string

街道地址信息。

必需

>= 1 字符<= 180 字符

addressLine2

string

附加街道地址信息。

可选

>= 1 字符<= 60 字符

city

string

城市。

必需

>= 1 字符<= 30 字符

companyName

string

企业名称。

可选

>= 1 字符<= 50 字符

countryCode

string

必需

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

>= 2 字符<= 2 字符

正则匹配:

^[A-Z]{2}$

string

电子邮箱地址。

可选

>= 1 字符<= 1024 字符

name

string

主要联系人姓名。

必需

>= 1 字符<= 50 字符

phoneNumber

string

电话号码。

必需

>= 1 字符<= 20 字符

postalCode

string

邮政编码。

必需

>= 1 字符<= 32 字符

stateOrProvinceCode

string

州或省代码。

可选

>= 1 字符<= 64 字符

示例

{
  "contactInformation": {
    "email": "email@email.com",
    "name": "name",
    "phoneNumber": "1234567890"
  },
  "destinationMarketplaces": [
    "ATVPDKIKX0DER"
  ],
  "items": [
    {
      "expiration": "2024-01-01",
      "labelOwner": "AMAZON",
      "manufacturingLotCode": "manufacturingLotCode",
      "msku": "Sunglasses",
      "prepOwner": "AMAZON",
      "quantity": 10
    }
  ],
  "name": "My inbound plan",
  "sourceAddress": {
    "addressLine1": "123 example street",
    "addressLine2": "Floor 19",
    "city": "Toronto",
    "companyName": "Acme",
    "countryCode": "CA",
    "email": "email@email.com",
    "name": "name",
    "phoneNumber": "1234567890",
    "postalCode": "M1M1M1",
    "stateOrProvinceCode": "ON"
  }
}

示例代码

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' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contactInformation": {
        "email": "email@email.com",
        "name": "name",
        "phoneNumber": "1234567890"
    },
    "destinationMarketplaces": [
        "ATVPDKIKX0DER"
    ],
    "items": [
        {
            "expiration": "2024-01-01",
            "labelOwner": "AMAZON",
            "manufacturingLotCode": "manufacturingLotCode",
            "msku": "Sunglasses",
            "prepOwner": "AMAZON",
            "quantity": 10
        }
    ],
    "name": "My inbound plan",
    "sourceAddress": {
        "addressLine1": "123 example street",
        "addressLine2": "Floor 19",
        "city": "Toronto",
        "companyName": "Acme",
        "countryCode": "CA",
        "email": "email@email.com",
        "name": "name",
        "phoneNumber": "1234567890",
        "postalCode": "M1M1M1",
        "stateOrProvinceCode": "ON"
    }
}'

返回响应

🟢202成功

application/json

创建入库计划 202 响应

Headers

x-amzn-RequestId

string

可选

唯一请求参考标识符。

x-amzn-RateLimit-Limit

string

可选

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

Body

`createInboundPlan` 响应。

inboundPlanId

string

入境计划的标识符。

必需

>= 38 字符<= 38 字符

正则匹配:

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

operationId

string

必需

给定操作的 UUID。

>= 36 字符<= 38 字符

正则匹配:

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

示例

{
  "inboundPlanId": "stringstringstringstringstringstringst",
  "operationId": "stringstringstringstringstringstring"
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2025-04-26 10:45:34

listInboundPlans

getInboundPlan