宝贝/SKU库存修改
提供按照全量或增量形式修改宝贝/SKU库存的功能
1.请求参数:
请求URL:
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
sign | String | 接口签名 | 如何计算生成见示例代码 |
num_iid | number | 必填, 商品数字ID | |
sku_id | number | 可选, 要操作的SKU的数字ID, 如果不填默认修改宝贝的库存,如果填上则修改该SKU的库存 | |
outer_id | String | 可选, SKU的商家编码, 如果不填则默认修改宝贝的库存,如果填了则按照商家编码搜索出对应的SKU并修改库存。当sku_id和本字段都填写时以sku_id为准搜索对应SKU | |
quantity | number | 必填 , 库存修改值, 当全量更新库存时,quantity必须为大于等于0的正整数;当增量更新库存时,quantity为整数,可小于等于0。若增量更新时传入的库存为负数,则负数与实际库存之和不能小于0。比如当前实际库存为1,传入增量更新quantity=-1,库存改为0 | |
type | number | 可选 , 库存更新方式, 1为全量更新,2为增量更新。如果不填,默认为全量更新 |
2. 请求示例代码(Java)
@Test
public void itemUpdateStock() throws Exception {
String tb_seller_nick = Config.TBSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("tb_seller_nick", tb_seller_nick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
// 商品Id , 必填
data.put("num_iid", "544876335798");
// 要操作的SKU的数字ID,可选。如果不填默认修改宝贝的库存,如果填上则修改该SKU的库存
// data.put("sku_id", "22222");
// SKU的商家编码,可选参数。如果不填则默认修改宝贝的库存,如果填了则按照商家编码搜索出对应的SKU并修改库存。当sku_id和本字段都填写时以sku_id为准搜索对应SKU
//data.put("outer_id", "white35");
// 库存修改值,必选。当全量更新库存时,quantity必须为大于等于0的正整数;当增量更新库存时,quantity为整数,
// 可小于等于0。若增量更新时传入的库存为负数,则负数与实际库存之和不能小于0。比如当前实际库存为1,传入增量更新quantity=-1,库存改为0
data.put("quantity", "100");
// 库存更新方式,可选。1为全量更新,2为增量更新。如果不填,默认为全量更新
data.put("type", "1");
// 签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoItemUpdateStockUrl ,data);
}
3. 返回结果如下:
返回更新后的库存情况
{
"code": 0,
"message": "ok",
"data": {
"item": {
"iid": "544876335798",
"modified": "2020-12-22 14:54:49",
"num": 4470, // 总数量
"num_iid": 544876335798, // 商品Id
"skus": {
"sku": [
{
"modified": "2019-09-20 14:38:55",
"quantity": 0, // 当前库存数量
"sku_id": 3977338583164 // SKU的数字ID
},
{
"modified": "2020-12-22 14:55:52",
"quantity": 200,
"sku_id": 3977338583166
},
{
"modified": "2019-07-05 17:12:49",
"quantity": 40,
"sku_id": 3977338583163
},
{
"modified": "2019-07-05 17:12:49",
"quantity": 4230,
"sku_id": 3977338583165
}
]
}
},
"request_id": "xsq6dwsuuzwv"
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
文档更新时间: 2024-04-02 18:53 作者:admin