同步库存

当商品的物流模式为“Red Express”,“Red Post” 和"国内贸易", 不支持同步库存和增减库存。

接口描述

同步小红书系统中的商品库存。该操作等同于直接设置在小红书后台的库存数量。

用户在小红书APP上只要下单就会扣减后台库存,此时库存处于被占用状态,但是订单可能未付款或者未被系统确认,占用库存数可通过订单接口中的即时订单列表接口内的未确认订单中获取到。如需使用该接口做全量更新,请先获取库存得到当前可售库存后再调用,保证实际库存=当前可售库存+占用库存。 或使用“增减库存接口”做增量更新操作。

URL

/ark/open_api/v0/inventories/{barcode}

/ark/open_api/v0/inventories/item/{item_id}

URL 参数

字段名称 类型 说明
barcode String 商品条码

字段名称 类型 说明
item_id String 商品ID

请求方法

PUT

请求body (content-type:application/json;charset=utf8)

{
   "qty" : 12
}

请求body 参数

字段名称 类型 必填 说明
qty Int 库存目标值

返回示例 状态码 200 (content-type: application/json; charset=utf8)

{
   "success": true
}