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

generatePlacementOptions

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions

FBA inbound operations. 2024-03-20

为入站计划生成配置选项。

使用计划：

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

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

请求参数

Path 参数

inboundPlanId

string

入境计划的标识符。

必需

>= 38 字符<= 38 字符

正则匹配:

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

Body 参数application/json

`generatePlacementOptions` 请求。

customPlacement

array[object (CustomPlacementInput) {2}]

可选

将向计划中添加自定义投放选项。

items

array[object (ItemInput) {6}]

必需

创建入境计划时包含的项目。

>= 1 items<= 2000 items

warehouseId

string

仓库ID。

必需

>= 1 字符<= 1024 字符

示例

{
    "customPlacement": [
        {
            "items": [
                {
                    "expiration": "2024-01-01",
                    "labelOwner": "AMAZON",
                    "manufacturingLotCode": "manufacturingLotCode",
                    "msku": "Sunglasses",
                    "prepOwner": "AMAZON",
                    "quantity": 10
                }
            ],
            "warehouseId": "YYZ14"
        }
    ]
}

示例代码

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//placementOptions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customPlacement": [
        {
            "items": [
                {
                    "expiration": "2024-01-01",
                    "labelOwner": "AMAZON",
                    "manufacturingLotCode": "manufacturingLotCode",
                    "msku": "Sunglasses",
                    "prepOwner": "AMAZON",
                    "quantity": 10
                }
            ],
            "warehouseId": "YYZ14"
        }
    ]
}'

返回响应

🟢202成功

application/json

生成放置选项 202 响应

Headers

x-amzn-RequestId

string

可选

唯一请求参考标识符。

x-amzn-RateLimit-Limit

string

可选

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

Body

`generatePlacementOptions` 的响应。

operationId

string

必需

给定操作的 UUID。

>= 36 字符<= 38 字符

正则匹配:

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

示例

{
    "operationId": "stringstringstringstringstringstring"
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

listPlacementOptions

confirmPlacementOption