更新SKU信息

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

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

一、请求参数

请求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,	忽略警告提示.

二、请求示例代码

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);

    }

三、返回结果

{
  "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