更新库存商品的数量

可以改变一个商品的库存数量信息。

在一次查询中最多可以改变100个商品。从一个卖家账号每分钟可以发送不超过80次请求。

只有当一个商品的状态改变为 price_sent 时，才有可能设置其可用性。

大件商品的库存只能在其指定的库存地点更新。

如果请求中同时包含参数 offer_id 和 product_id，系统将优先根据 offer_id 应用更改。为避免歧义，建议仅使用一个参数。

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

stocks

array[object (object) {4}]

仓库中商品的信息。

必需

offer_id

string

可选

卖家系统中的商品编号是 — 商品代码。

product_id

integer <int64>

必需

卖家系统中的商品标识符 — product_id。

stock

integer <int64>

必需

扣除预留库存后的可售商品数量。

warehouse_id

integer <int64>

必需

得出的仓库编号的方法 /v1/warehouse/list。

示例

{
    "stocks": [
        {
            "offer_id": "PH11042",
            "product_id": 313455276,
            "stock": 100,
            "warehouse_id": 22142605386000
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

更新的商品数量

Body

搜索结果。

result

array[object (object) {5}]

可选

errors

array[object (object) {2}]

可选

在搜索处理过程中发生的数组错误。

offer_id

string

可选

卖家系统中的商品编号是 — 商品代码。

product_id

integer <int64>

可选

卖家系统中的商品标识符 — product_id。

updated

boolean

可选

如果商品信息已被成功更新 — true。

warehouse_id

integer <int64>

仓库编号。

可选

示例

{
    "result": [
        {
            "warehouse_id": 22142605386000,
            "product_id": 118597312,
            "offer_id": "PH11042",
            "updated": true,
            "errors": []
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误