更新SKU信息
- 更新一个sku的数据
- 需要更新的sku通过属性properties进行匹配查找
- 商品的数量和价格必须大于等于0
- sku记录会更新到指定的num_iid对应的商品中
- num_iid对应的商品必须属于当前的会话用户
此接口需要在商家授权的30分钟内有效,否则商家需要重新授权(退出应用再重新登录)。
1.请求参数
请求URL:
基本参数
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
sign | String | 接口签名 | 如何计算生成见示例代码 |
业务参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
num_iid | Number | true | 123456 | Sku所属商品数字id,可通过 taobao.item.get 获取 |
properties | String | true | 1627207:28326;1630696:3266779 | Sku属性串。格式:pid:vid;pid:vid,如: 1627207:3232483;1630696:3284570,表示机身颜色:军绿色;手机套餐:一电一充。 如果包含自定义属性,则格式为pid:vid;pid2:vid2;$pText:vText , 其中$pText:vText为自定义属性。限制:其中$pText的’$’前缀不能少,且pText和vText文本中不可以存在 冒号:和分号;以及逗号, |
quantity | Number | false | 3 | Sku的库存数量。sku的总数量应该小于等于商品总数量(Item的NUM),sku数量变化后item的总数量也会随着变化。取值范围:大于等于零的整数 |
price | Price | false | 207.02 | Sku的销售价格。精确到2位小数;单位:元。如:200.07,表示:200元7分。修改后的sku价格要保证商品的价格在所有sku价格所形成的价格区间内(例如:商品价格为6元,sku价格有5元、10元两种,如果要修改5元sku的价格,那么修改的范围只能是0-6元之间;如果要修改10元的sku,那么修改的范围只能是6到无穷大的区间中) |
outer_id | String | false | 123456 | Sku的商家外部id |
lang | String | false | zh_CN | Sku文字的版本。可选值:zh_HK(繁体),zh_CN(简体);默认值:zh_CN |
item_price | Price | false | 204 | sku所属商品的价格。当用户更新sku,使商品价格不属于sku价格之间的时候,用于修改商品的价格,使sku能够更新成功 |
ignorewarning | String | false | ,ifd_warning,FakeCredit_Warning, | 忽略警告提示. |
2. 请求示例代码(Java)
@Test
public void TaobaoItemSkuUpdate() throws Exception {
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("tb_seller_nick", Config.TBSellerNick);
data.put("num_iid", "880911307285");
data.put("properties", "1627207:21008473472;20509:28314");
data.put("quantity", "2999");
data.put("price", "3999");
data.put("sign", Utils.Sign(data,Config.AppSecret));
doHttpRequest(Config.TaobaoItemSkuUpdateUrl ,data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"iid": "880911307285",
"num_iid": 880911307285,
"modified": "2025-01-25 23:26:08",
"sku_id": 5888261154954
},
"trace_id": ""
}
说明: code为0表示成功, 如果失败,msg会包含失败原因。 返回的字段说明
名称 | 类型 | 示例 | 描述 |
---|---|---|---|
iid | String | asdf12323adfaa | sku所属商品id(注意:iid近期即将废弃,请用num_iid参数) |
num_iid | Number | 12345 | sku所属商品数字id |
modified | String | 2009-11-04 15:24:43 | sku最后修改日期 时间格式:yyyy-MM-dd HH:mm:ss |
sku_id | Number | 123 | sku的id |
文档更新时间: 2025-03-27 14:14 作者:admin