增减库存

POST

/ark/open_api/v3/common_controller

	错误码	错误码描述
	-5009604	接口报错
	-5009501	不是有效的ObjectId
	-5009025	未找到ITEMID,请重新尝试
	-5009015	商品不属于本商家
	-5009001	找不到商家请重新尝试
	-5009202	库存总数不能小于0
	-5009030	暂时无法通过开放平台更新组合商品库存数，请使用新版编辑页进行更改
	-5009026	该商品不允许修改库存

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \
--header 'Content-Type: application/json;charset=utf-8' \
--data-raw ''

响应示例

{
  "skuId": "603c****0b0a",
  "skuStock": {
    "available": 100,
    "standalone": 100,
    "reserved": 100,
    "total": 300
  }
}

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

skuId

string

商品编号

必需

qty

integer

必需

同步库存数/增减库存数，同步库存时：qty是商品总库存数，可售库存+独立库存+保留库存，接口逻辑会用这个数 - 独立库存 - 保留库存，去设置可售库存；增减库存时：操作可售库存的增减

timestamp

string

必需

接口调用时的时间戳，即当前时间戳（时间戳：当前距离Epoch（1970年1月1日) 以秒计算的时间，即unix-timestamp

appId

string

必需

第三方获取到的appid

sign

string

输入参数的签名结果

必需

version

string

必需

版本号，采用oauth2授权后均填入2.0

method

string

具体调用方法

必需

accessToken

string

可选

业务接口鉴权。非必须，调用商家业务接口必须使用

示例

返回响应

🟢200成功

application/json

Body

skuId

string

商品编号

必需

skuStock

object

商品库存

必需

available

integer

可售库存

必需

standalone

integer

必需

独立库存，也叫预留库存，是用于特定渠道进行销售的库存

reserved

integer

必需

保留库存，也叫锁定库存，这部分库存被锁定，不可售

total

integer

总库存

必需

修改于 2023-08-01 08:08:36

同步库存

素材列表