淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	描述
item_id	String	必须	12313	外部系统ID
store_code	String	可选	2011	仓库编码
name	String	可选	中粮可益康钙铁锌咀嚼片	商品名称
title	String	可选	demo	商品标题
category	String	可选	01	商品类别编码（外部系统类别）
category_name	String	可选	服装	商品类别名称
brand	String	可选	03	品牌编码
brand_name	String	可选	中粮	品牌名称
specification	String	可选	5盒装	规格
color	String	可选	黑色	颜色
size	String	可选	M	尺码
gross_weight	Number	可选	50	毛重，单位克
net_weight	Number	可选	40	净重，单位克
length	Number	可选	20	长度，单位毫米
width	Number	可选	40	宽度，单位毫米
height	Number	可选	30	高度，单位毫米
volume	Number	可选	24000	体积，单位立方厘米
pcs	Number	可选	12	箱规
origin_address	Number	可选	12	产地
approval_number	String	可选	32324213	批准文号
is_shelflife	Boolean	可选	false	是否启用保质期管理
lifecycle	Number	可选	360	商品保质期天数
reject_lifecycle	Number	可选	123	保质期禁收天数
lockup_lifecycle	Number	可选	123	保质期禁售天数
advent_lifecycle	Number	可选	123	保质期预警天数
is_sn_mgt	Boolean	可选	false	是否启用序列号管理
is_hygroscopic	Boolean	可选	false	是否易碎品
is_danger	Boolean	可选	false	是否危险品
tag_price	Number	可选	60	吊牌价，单位分
item_price	Number	可选	50	零售价，单位分
cost_price	Number	可选	30	成本价，单位分
is_batch_mgt	Boolean	可选	false	是否启用批次管理
use_yn	Boolean	必须	false	启用标识
extend_fields	String	可选	demo	拓展属性
bar_code	String	可选	BAR001;BAR002	条形码，多条码请用”;”分隔；条码更新只技术增量更新，已有条码无法修改，只能在原条码基础上增加新的条码。例：原商品条码为：BAR001，要增加一条新条码BAR002时，此字段内容应填写为：BAR001;BAR002
attribute	String	可选	383028202	商品属性编码
type	String	可选	NORMAL	商品类型:NORMAL-普通商品、 COMBINE-组合商品、 DISTRIBUTION-分销商品
is_area_sale	Boolean	可选	false	是否区域销售属性

名称	类型	示例值	描述
wl_error_msg	String	系统错误	错误信息
wl_error_code	String	S07	错误编码
wl_success	Boolean	false	是否成功

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WlbWmsSkuUpdateRequest req = new WlbWmsSkuUpdateRequest();
req.setItemId("12313");
req.setStoreCode("2011");
req.setName("中粮可益康钙铁锌咀嚼片");
req.setTitle("demo");
req.setCategory("01");
req.setCategoryName("服装");
req.setBrand("03");
req.setBrandName("中粮");
req.setSpecification("5盒装");
req.setColor("黑色");
req.setSize("M");
req.setGrossWeight(50L);
req.setNetWeight(40L);
req.setLength(20L);
req.setWidth(40L);
req.setHeight(30L);
req.setVolume(24000L);
req.setPcs(12L);
req.setOriginAddress(12L);
req.setApprovalNumber("32324213");
req.setIsShelflife(false);
req.setLifecycle(360L);
req.setRejectLifecycle(123L);
req.setLockupLifecycle(123L);
req.setAdventLifecycle(123L);
req.setIsSnMgt(false);
req.setIsHygroscopic(false);
req.setIsDanger(false);
req.setTagPrice(60L);
req.setItemPrice(50L);
req.setCostPrice(30L);
req.setIsBatchMgt(false);
req.setUseYn(false);
req.setExtendFields("demo");
req.setBarCode("BAR001;BAR002");
req.setAttribute("383028202");
req.setType("NORMAL");
req.setIsAreaSale(false);
WlbWmsSkuUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
WlbWmsSkuUpdateRequest req = new WlbWmsSkuUpdateRequest();
req.ItemId = "12313";
req.StoreCode = "2011";
req.Name = "中粮可益康钙铁锌咀嚼片";
req.Title = "demo";
req.Category = "01";
req.CategoryName = "服装";
req.Brand = "03";
req.BrandName = "中粮";
req.Specification = "5盒装";
req.Color = "黑色";
req.Size = "M";
req.GrossWeight = 50L;
req.NetWeight = 40L;
req.Length = 20L;
req.Width = 40L;
req.Height = 30L;
req.Volume = 24000L;
req.Pcs = 12L;
req.OriginAddress = 12L;
req.ApprovalNumber = "32324213";
req.IsShelflife = false;
req.Lifecycle = 360L;
req.RejectLifecycle = 123L;
req.LockupLifecycle = 123L;
req.AdventLifecycle = 123L;
req.IsSnMgt = false;
req.IsHygroscopic = false;
req.IsDanger = false;
req.TagPrice = 60L;
req.ItemPrice = 50L;
req.CostPrice = 30L;
req.IsBatchMgt = false;
req.UseYn = false;
req.ExtendFields = "demo";
req.BarCode = "BAR001;BAR002";
req.Attribute = "383028202";
req.Type = "NORMAL";
req.IsAreaSale = false;
WlbWmsSkuUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new WlbWmsSkuUpdateRequest;
$req->setItemId("12313");
$req->setStoreCode("2011");
$req->setName("中粮可益康钙铁锌咀嚼片");
$req->setTitle("demo");
$req->setCategory("01");
$req->setCategoryName("服装");
$req->setBrand("03");
$req->setBrandName("中粮");
$req->setSpecification("5盒装");
$req->setColor("黑色");
$req->setSize("M");
$req->setGrossWeight("50");
$req->setNetWeight("40");
$req->setLength("20");
$req->setWidth("40");
$req->setHeight("30");
$req->setVolume("24000");
$req->setPcs("12");
$req->setOriginAddress("12");
$req->setApprovalNumber("32324213");
$req->setIsShelflife("false");
$req->setLifecycle("360");
$req->setRejectLifecycle("123");
$req->setLockupLifecycle("123");
$req->setAdventLifecycle("123");
$req->setIsSnMgt("false");
$req->setIsHygroscopic("false");
$req->setIsDanger("false");
$req->setTagPrice("60");
$req->setItemPrice("50");
$req->setCostPrice("30");
$req->setIsBatchMgt("false");
$req->setUseYn("false");
$req->setExtendFields("demo");
$req->setBarCode("BAR001;BAR002");
$req->setAttribute("383028202");
$req->setType("NORMAL");
$req->setIsAreaSale("false");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.wlb.wms.sku.update' \
-d 'partner_id=apidoc' \
-d 'session=ebe8e43e-c762-44a8-bc5d-219c4071071a' \
-d 'sign=BE560023FEF62113CE2A5EF7EC8AF073' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-02+08%3A56%3A13' \
-d 'v=2.0' \
-d 'advent_lifecycle=123' \
-d 'approval_number=32324213' \
-d 'attribute=383028202' \
-d 'bar_code=BAR001%3BBAR002' \
-d 'brand=03' \
-d 'brand_name=%E4%B8%AD%E7%B2%AE' \
-d 'category=01' \
-d 'category_name=%E6%9C%8D%E8%A3%85' \
-d 'color=%E9%BB%91%E8%89%B2' \
-d 'cost_price=30' \
-d 'extend_fields=demo' \
-d 'gross_weight=50' \
-d 'height=30' \
-d 'is_area_sale=false' \
-d 'is_batch_mgt=false' \
-d 'is_danger=false' \
-d 'is_hygroscopic=false' \
-d 'is_shelflife=false' \
-d 'is_sn_mgt=false' \
-d 'item_id=12313' \
-d 'item_price=50' \
-d 'length=20' \
-d 'lifecycle=360' \
-d 'lockup_lifecycle=123' \
-d 'name=%E4%B8%AD%E7%B2%AE%E5%8F%AF%E7%9B%8A%E5%BA%B7%E9%92%99%E9%93%81%E9%94%8C%E5%92%80%E5%9A%BC%E7%89%87' \
-d 'net_weight=40' \
-d 'origin_address=12' \
-d 'pcs=12' \
-d 'reject_lifecycle=123' \
-d 'size=M' \
-d 'specification=5%E7%9B%92%E8%A3%85' \
-d 'store_code=2011' \
-d 'tag_price=60' \
-d 'title=demo' \
-d 'type=NORMAL' \
-d 'use_yn=false' \
-d 'volume=24000' \
-d 'width=40'

# -*- coding: utf-8 -*-
import top.api

req=top.api.WlbWmsSkuUpdateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.item_id="12313"
req.store_code="2011"
req.name="中粮可益康钙铁锌咀嚼片"
req.title="demo"
req.category="01"
req.category_name="服装"
req.brand="03"
req.brand_name="中粮"
req.specification="5盒装"
req.color="黑色"
req.size="M"
req.gross_weight=50
req.net_weight=40
req.length=20
req.width=40
req.height=30
req.volume=24000
req.pcs=12
req.origin_address=12
req.approval_number="32324213"
req.is_shelflife=false
req.lifecycle=360
req.reject_lifecycle=123
req.lockup_lifecycle=123
req.advent_lifecycle=123
req.is_sn_mgt=false
req.is_hygroscopic=false
req.is_danger=false
req.tag_price=60
req.item_price=50
req.cost_price=30
req.is_batch_mgt=false
req.use_yn=false
req.extend_fields="demo"
req.bar_code="BAR001;BAR002"
req.attribute="383028202"
req.type="NORMAL"
req.is_area_sale=false
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.wlb.wms.sku.update");
add_param(pRequest,"item_id","12313");
add_param(pRequest,"store_code","2011");
add_param(pRequest,"name","中粮可益康钙铁锌咀嚼片");
add_param(pRequest,"title","demo");
add_param(pRequest,"category","01");
add_param(pRequest,"category_name","服装");
add_param(pRequest,"brand","03");
add_param(pRequest,"brand_name","中粮");
add_param(pRequest,"specification","5盒装");
add_param(pRequest,"color","黑色");
add_param(pRequest,"size","M");
add_param(pRequest,"gross_weight","50");
add_param(pRequest,"net_weight","40");
add_param(pRequest,"length","20");
add_param(pRequest,"width","40");
add_param(pRequest,"height","30");
add_param(pRequest,"volume","24000");
add_param(pRequest,"pcs","12");
add_param(pRequest,"origin_address","12");
add_param(pRequest,"approval_number","32324213");
add_param(pRequest,"is_shelflife","false");
add_param(pRequest,"lifecycle","360");
add_param(pRequest,"reject_lifecycle","123");
add_param(pRequest,"lockup_lifecycle","123");
add_param(pRequest,"advent_lifecycle","123");
add_param(pRequest,"is_sn_mgt","false");
add_param(pRequest,"is_hygroscopic","false");
add_param(pRequest,"is_danger","false");
add_param(pRequest,"tag_price","60");
add_param(pRequest,"item_price","50");
add_param(pRequest,"cost_price","30");
add_param(pRequest,"is_batch_mgt","false");
add_param(pRequest,"use_yn","false");
add_param(pRequest,"extend_fields","demo");
add_param(pRequest,"bar_code","BAR001;BAR002");
add_param(pRequest,"attribute","383028202");
add_param(pRequest,"type","NORMAL");
add_param(pRequest,"is_area_sale","false");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.wlb.wms.sku.update', {
	'item_id':'12313',
	'store_code':'2011',
	'name':'中粮可益康钙铁锌咀嚼片',
	'title':'demo',
	'category':'01',
	'category_name':'服装',
	'brand':'03',
	'brand_name':'中粮',
	'specification':'5盒装',
	'color':'黑色',
	'size':'M',
	'gross_weight':'50',
	'net_weight':'40',
	'length':'20',
	'width':'40',
	'height':'30',
	'volume':'24000',
	'pcs':'12',
	'origin_address':'12',
	'approval_number':'32324213',
	'is_shelflife':'false',
	'lifecycle':'360',
	'reject_lifecycle':'123',
	'lockup_lifecycle':'123',
	'advent_lifecycle':'123',
	'is_sn_mgt':'false',
	'is_hygroscopic':'false',
	'is_danger':'false',
	'tag_price':'60',
	'item_price':'50',
	'cost_price':'30',
	'is_batch_mgt':'false',
	'use_yn':'false',
	'extend_fields':'demo',
	'bar_code':'BAR001;BAR002',
	'attribute':'383028202',
	'type':'NORMAL',
	'is_area_sale':'false'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<wlb_wms_sku_update_response>
    <wl_error_msg>系统错误</wl_error_msg>
    <wl_error_code>S07</wl_error_code>
    <wl_success>false</wl_success>
</wlb_wms_sku_update_response>

{
    "wlb_wms_sku_update_response":{
        "wl_error_msg":"系统错误",
        "wl_error_code":"S07",
        "wl_success":false
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

菜鸟仓配API

taobao.wlb.wms.sku.update (商品信息的更新)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ