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

submitInventoryUpdate

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/vendor/directFulfillment/inventory/v1/warehouses/{warehouseId}/items

Direct Fulfillment Inventory Updates

提交指定仓库的库存更新，可以是部分或完整的库存项数据。

使用计划：

速率（每秒请求次数）	峰值
10	10

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

请求参数

Path 参数

warehouseId

string

必需

用于更新库存的仓库标识符。

Body 参数application/json

`submitInventoryUpdate` 操作的请求主体。

inventory

object (InventoryUpdate)

可选

需要更新请求的仓库的部分或全部项目的库存详情。

sellingParty

object (PartyIdentification)

必需

集团的名称、地址和税务信息。

isFullUpdate

boolean

必需

当 true 时，此请求包含完整的供给。当 false 时，此请求包含部分供给。当发送完整的供给时，您必须发送仓库中所有项目的信息。任何不在完整供给中的项目将更新为不可用。当发送部分供给时，仅包括需要库存更新的项目。其他项目的状态将保持不变。

items

array[object (ItemDetails) {4}]

必需

包含更新详情的库存项目列表，包括可用数量。

示例

{
    "inventory": {
        "sellingParty": {
            "partyId": "string"
        },
        "isFullUpdate": true,
        "items": [
            {
                "buyerProductIdentifier": "string",
                "vendorProductIdentifier": "string",
                "availableQuantity": {
                    "amount": 0,
                    "unitOfMeasure": "string"
                },
                "isObsolete": true
            }
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/inventory/v1/warehouses//items' \
--header 'Content-Type: application/json' \
--data-raw '{
    "inventory": {
        "sellingParty": {
            "partyId": "string"
        },
        "isFullUpdate": true,
        "items": [
            {
                "buyerProductIdentifier": "string",
                "vendorProductIdentifier": "string",
                "availableQuantity": {
                    "amount": 0,
                    "unitOfMeasure": "string"
                },
                "isObsolete": true
            }
        ]
    }
}'

返回响应

🟢202成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`submitInventoryUpdate` 操作的响应架构。

payload

object (TransactionReference)

可选

包含交易 ID 的响应。

transactionId

string

可选

用于识别此事务的GUID。此值可以与事务状态API一起使用，以返回此事务的状态。

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

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

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

recordActionFeedback

getOrders