更新SKU信息

  • 更新一个sku的数据
  • 需要更新的sku通过属性properties进行匹配查找
  • 商品的数量和价格必须大于等于0
  • sku记录会更新到指定的num_iid对应的商品中
  • num_iid对应的商品必须属于当前的会话用户

此接口需要在商家授权的30分钟内有效,否则商家需要重新授权(退出应用再重新登录)。

1.请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/item/sku/update

基本参数

参数名 类型 说明 示例
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