淘宝开放平台 - 文档中心

请求地址：

环境	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_extend_update_dto	ItemExtendUpdateDto	可选	扩展字段模型
└ channel_safe String 可选 {} 外部渠道库存安全状态 └ reason String 可选 txp 审核不通过原因 └ effective_days Number 可选 100 保质期 └ stop_production String 可选 txp 是否停售 └ biz_code String 可选 txp bizCode └ need_logistics Number 可选 100 是否需要配送 └ pack String 可选 txp 包装 └ is_need_design String 可选 txp 图纸设计,是/否可选商品字段（0:不需要,1:需要） └ sub_title String 可选 txp 商品短标题 └ height String 可选 txp 高度 └ name_space String 可选 {} 正副本 └ net_content String 可选 txp 净含量 video VideoDto 可选视频 └ id Number 可选 100 视频id └ biz_codes String [] 可选 ["txp","txp"] bizCodes └ duaration String 可选 txp 视频时长 └ state Number 可选 100 媒资状态：等待转码（1），转码中（2），转码失败（3），等待审核（4），未通过审核（5），通过审核（6），已删除（7） └ biz_code String 可选 txp 业务编码 └ file_type String 可选 txp 文件类型 └ thumb_pic String 可选 txp 封面图 └ url String 可选 txp 视频url └ purchase_method String 可选 txp 购买方式 └ tax_rate String 可选 txp 税率 └ store_condition String 可选 txp 存放条件 └ item_position String 可选 txp 店内 ->商品陈列 └ width String 可选 txp 宽 └ safe_inventory_threshold Number 可选 100 渠道安全库存阈值 └ drug_category String 可选 txp 药品分类 └ is_customized String 可选 txp 是否定制化商品是/否可选商品字段(默认否) └ commodity_model String 可选 txp 商品型号,可选商品型号 └ vending_media_urls String 可选 txp 贩卖机网络要求新增一个图片字段一共三种图片字段 └ short_key String 可选 txp 商品短标题 └ store_id Number 可选 100 所属门店ID,主商品storeId = 0 └ purchase_price String 可选 txp 采购价,单位:分 └ sale_unit String 可选 txp 销售单位 └ weight String 可选 txp 重量 └ is_install String 可选 txp 是否安装,是/否可选商品字段(0:不需要,1:需要) └ remove_tag_list String [] 可选 [100,200] 删除tags列表 └ extend_media_urls String 可选 txp 扩展媒体地址,全量更新 └ sync_state Number 可选 100 外部渠道同步状态 └ area String 可选 txp 面积 └ biz_codes String [] 可选 ["txp","txp"] bizCodes └ spec_scale String 可选 txp 尺寸比例 └ style String 可选 txp 风格 └ length String 可选 txp 长度 └ tax_rate_num String 可选 txp 税率编码 └ bar_title String 可选 txp 条码秤标题 └ special_price_buy Boolean 可选 true 是否一元购商品 └ item_type String 可选 txp 商品类型 └ origin String 可选 txp 产地 └ approval_number String 可选 txp 国药准字号 └ stop_production_time String 可选 txp 停售时间 └ add_tag_list String [] 可选 [100,200] 新增tags列表 └ is_measurement String 可选 txp 测量方式,一次精量；粗量+精量可选商品字段 └ item_id Number 可选 100 itemId └ item_user_price String 可选 txp 商品核销价 └ material String 可选 txp 材质 └ is_grant Number 可选 100 是否授权 └ color String 可选 txp 颜色 └ is_need_machining String 可选 txp 是否加工,是/否可选商品字段（0:不需要,1:需要） └ volume String 可选 txp 体积 └ commision_ratio String 可选 txp 佣金比例 └ display_category String 可选 txp 展示类目 └ performing_template_id String 可选 txp 履约模板模板id └ is_cloud_item String 可选 txp 是否云商品 └ attributes String 可选 {} 扩展属性 └ channel String 可选 {} 外部渠道名称
options	ItemUpdateOptions	可选	门店商品更新可选项
└ use_item_update_do Boolean 可选 true 更新ic商品时,是否以门店中台为主 └ update_target_category_id Boolean 可选 true 修改状态 └ channel_switches String 可选 {} 需要同步的渠道列表,只用于商品发布、编辑时异步同步给饿了么等渠道 └ sync_store Boolean 可选 true 是否同步给门店,默认同步;只有连锁管理模式才会有效 └ ic_options Number [] 可选 [1,2] 同步到ic的options,仅syncIC=true时有效 └ extends_map String 可选 {} 额外的扩展信息 └ update_status Boolean 可选 true 修改状态 └ only_update_child_item Boolean 可选 true 是否更新子商品 └ scene String 可选 txp 价格更新场景透传给异步任务使用 └ store_id_list Number [] 可选 [1,2] 需要同步的门店ID列表,syncStore = true时，不能为空 └ sync_ic Boolean 可选 true 是否同步到IC,默认同步 └ sync_item_state Boolean 可选 true 是否同步商品状态到IC

名称	类型	示例值	描述
succ	Boolean	true	是否成功
data	ItemExtendUpdateDto	{}	商品扩展信息模型
└ item_id Number 100 商品id
sys_code	String	0	错误码
sys_message	String		错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrItemItemUpdateextendRequest req = new TmallNrItemItemUpdateextendRequest();
TmallNrItemItemUpdateextendRequest.ItemExtendUpdateDto obj1 = new TmallNrItemItemUpdateextendRequest.ItemExtendUpdateDto();
obj1.setChannelSafe("{}");
obj1.setReason("txp");
obj1.setEffectiveDays(100L);
obj1.setStopProduction("txp");
obj1.setBizCode("txp");
obj1.setNeedLogistics(100L);
obj1.setPack("txp");
obj1.setIsNeedDesign("txp");
obj1.setSubTitle("txp");
obj1.setHeight("txp");
obj1.setNameSpace("{}");
obj1.setNetContent("txp");
TmallNrItemItemUpdateextendRequest.VideoDto obj2 = new TmallNrItemItemUpdateextendRequest.VideoDto();
obj2.setId(100L);
obj2.setBizCodes(""txp","txp"");
obj2.setDuaration("txp");
obj2.setState(100L);
obj2.setBizCode("txp");
obj2.setFileType("txp");
obj2.setThumbPic("txp");
obj2.setUrl("txp");
obj1.setVideo(obj2);
obj1.setPurchaseMethod("txp");
obj1.setTaxRate("txp");
obj1.setStoreCondition("txp");
obj1.setItemPosition("txp");
obj1.setWidth("txp");
obj1.setSafeInventoryThreshold(100L);
obj1.setDrugCategory("txp");
obj1.setIsCustomized("txp");
obj1.setCommodityModel("txp");
obj1.setVendingMediaUrls("txp");
obj1.setShortKey("txp");
obj1.setStoreId(100L);
obj1.setPurchasePrice("txp");
obj1.setSaleUnit("txp");
obj1.setWeight("txp");
obj1.setIsInstall("txp");
obj1.setRemoveTagList("100,200");
obj1.setExtendMediaUrls("txp");
obj1.setSyncState(100L);
obj1.setArea("txp");
obj1.setBizCodes(""txp","txp"");
obj1.setSpecScale("txp");
obj1.setStyle("txp");
obj1.setLength("txp");
obj1.setTaxRateNum("txp");
obj1.setBarTitle("txp");
obj1.setSpecialPriceBuy(true);
obj1.setItemType("txp");
obj1.setOrigin("txp");
obj1.setApprovalNumber("txp");
obj1.setStopProductionTime("txp");
obj1.setAddTagList("100,200");
obj1.setIsMeasurement("txp");
obj1.setItemId(100L);
obj1.setItemUserPrice("txp");
obj1.setMaterial("txp");
obj1.setIsGrant(100L);
obj1.setColor("txp");
obj1.setIsNeedMachining("txp");
obj1.setVolume("txp");
obj1.setCommisionRatio("txp");
obj1.setDisplayCategory("txp");
obj1.setPerformingTemplateId("txp");
obj1.setIsCloudItem("txp");
obj1.setAttributes("{}");
obj1.setChannel("{}");
req.setItemExtendUpdateDto(obj1);
TmallNrItemItemUpdateextendRequest.ItemUpdateOptions obj3 = new TmallNrItemItemUpdateextendRequest.ItemUpdateOptions();
obj3.setUseItemUpdateDo(true);
obj3.setUpdateTargetCategoryId(true);
obj3.setChannelSwitches("{}");
obj3.setSyncStore(true);
obj3.setIcOptions(new Long[] { 1,2 };
);
obj3.setExtendsMap("{}");
obj3.setUpdateStatus(true);
obj3.setOnlyUpdateChildItem(true);
obj3.setScene("txp");
obj3.setStoreIdList(new Long[] { 1,2 };
);
obj3.setSyncIc(true);
obj3.setSyncItemState(true);
req.setOptions(obj3);
TmallNrItemItemUpdateextendResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallNrItemItemUpdateextendRequest req = new TmallNrItemItemUpdateextendRequest();
TmallNrItemItemUpdateextendRequest.ItemExtendUpdateDtoDomain obj1 = new TmallNrItemItemUpdateextendRequest.ItemExtendUpdateDtoDomain();
obj1.ChannelSafe = "{}";
obj1.Reason = "txp";
obj1.EffectiveDays = 100L;
obj1.StopProduction = "txp";
obj1.BizCode = "txp";
obj1.NeedLogistics = 100L;
obj1.Pack = "txp";
obj1.IsNeedDesign = "txp";
obj1.SubTitle = "txp";
obj1.Height = "txp";
obj1.NameSpace = "{}";
obj1.NetContent = "txp";
TmallNrItemItemUpdateextendRequest.VideoDtoDomain obj2 = new TmallNrItemItemUpdateextendRequest.VideoDtoDomain();
obj2.Id = 100L;
obj2.BizCodes = ""txp","txp"";
obj2.Duaration = "txp";
obj2.State = 100L;
obj2.BizCode = "txp";
obj2.FileType = "txp";
obj2.ThumbPic = "txp";
obj2.Url = "txp";
obj1.Video= obj2;
obj1.PurchaseMethod = "txp";
obj1.TaxRate = "txp";
obj1.StoreCondition = "txp";
obj1.ItemPosition = "txp";
obj1.Width = "txp";
obj1.SafeInventoryThreshold = 100L;
obj1.DrugCategory = "txp";
obj1.IsCustomized = "txp";
obj1.CommodityModel = "txp";
obj1.VendingMediaUrls = "txp";
obj1.ShortKey = "txp";
obj1.StoreId = 100L;
obj1.PurchasePrice = "txp";
obj1.SaleUnit = "txp";
obj1.Weight = "txp";
obj1.IsInstall = "txp";
obj1.RemoveTagList = "100,200";
obj1.ExtendMediaUrls = "txp";
obj1.SyncState = 100L;
obj1.Area = "txp";
obj1.BizCodes = ""txp","txp"";
obj1.SpecScale = "txp";
obj1.Style = "txp";
obj1.Length = "txp";
obj1.TaxRateNum = "txp";
obj1.BarTitle = "txp";
obj1.SpecialPriceBuy = true;
obj1.ItemType = "txp";
obj1.Origin = "txp";
obj1.ApprovalNumber = "txp";
obj1.StopProductionTime = "txp";
obj1.AddTagList = "100,200";
obj1.IsMeasurement = "txp";
obj1.ItemId = 100L;
obj1.ItemUserPrice = "txp";
obj1.Material = "txp";
obj1.IsGrant = 100L;
obj1.Color = "txp";
obj1.IsNeedMachining = "txp";
obj1.Volume = "txp";
obj1.CommisionRatio = "txp";
obj1.DisplayCategory = "txp";
obj1.PerformingTemplateId = "txp";
obj1.IsCloudItem = "txp";
obj1.Attributes = "{}";
obj1.Channel = "{}";
req.ItemExtendUpdateDto_ = obj1;
TmallNrItemItemUpdateextendRequest.ItemUpdateOptionsDomain obj3 = new TmallNrItemItemUpdateextendRequest.ItemUpdateOptionsDomain();
obj3.UseItemUpdateDo = true;
obj3.UpdateTargetCategoryId = true;
obj3.ChannelSwitches = "{}";
obj3.SyncStore = true;
obj3.IcOptions = new long[] { 1,2 };
;
obj3.ExtendsMap = "{}";
obj3.UpdateStatus = true;
obj3.OnlyUpdateChildItem = true;
obj3.Scene = "txp";
obj3.StoreIdList = new long[] { 1,2 };
;
obj3.SyncIc = true;
obj3.SyncItemState = true;
req.Options_ = obj3;
TmallNrItemItemUpdateextendResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallNrItemItemUpdateextendRequest;
$item_extend_update_dto = new ItemExtendUpdateDto;
$item_extend_update_dto->channel_safe="{}";
$item_extend_update_dto->reason="txp";
$item_extend_update_dto->effective_days="100";
$item_extend_update_dto->stop_production="txp";
$item_extend_update_dto->biz_code="txp";
$item_extend_update_dto->need_logistics="100";
$item_extend_update_dto->pack="txp";
$item_extend_update_dto->is_need_design="txp";
$item_extend_update_dto->sub_title="txp";
$item_extend_update_dto->height="txp";
$item_extend_update_dto->name_space="{}";
$item_extend_update_dto->net_content="txp";
$video = new VideoDto;
$video->id="100";
$video->biz_codes="[\"txp\",\"txp\"]";
$video->duaration="txp";
$video->state="100";
$video->biz_code="txp";
$video->file_type="txp";
$video->thumb_pic="txp";
$video->url="txp";
$item_extend_update_dto->video = $video;
$item_extend_update_dto->purchase_method="txp";
$item_extend_update_dto->tax_rate="txp";
$item_extend_update_dto->store_condition="txp";
$item_extend_update_dto->item_position="txp";
$item_extend_update_dto->width="txp";
$item_extend_update_dto->safe_inventory_threshold="100";
$item_extend_update_dto->drug_category="txp";
$item_extend_update_dto->is_customized="txp";
$item_extend_update_dto->commodity_model="txp";
$item_extend_update_dto->vending_media_urls="txp";
$item_extend_update_dto->short_key="txp";
$item_extend_update_dto->store_id="100";
$item_extend_update_dto->purchase_price="txp";
$item_extend_update_dto->sale_unit="txp";
$item_extend_update_dto->weight="txp";
$item_extend_update_dto->is_install="txp";
$item_extend_update_dto->remove_tag_list="[100,200]";
$item_extend_update_dto->extend_media_urls="txp";
$item_extend_update_dto->sync_state="100";
$item_extend_update_dto->area="txp";
$item_extend_update_dto->biz_codes="[\"txp\",\"txp\"]";
$item_extend_update_dto->spec_scale="txp";
$item_extend_update_dto->style="txp";
$item_extend_update_dto->length="txp";
$item_extend_update_dto->tax_rate_num="txp";
$item_extend_update_dto->bar_title="txp";
$item_extend_update_dto->special_price_buy="true";
$item_extend_update_dto->item_type="txp";
$item_extend_update_dto->origin="txp";
$item_extend_update_dto->approval_number="txp";
$item_extend_update_dto->stop_production_time="txp";
$item_extend_update_dto->add_tag_list="[100,200]";
$item_extend_update_dto->is_measurement="txp";
$item_extend_update_dto->item_id="100";
$item_extend_update_dto->item_user_price="txp";
$item_extend_update_dto->material="txp";
$item_extend_update_dto->is_grant="100";
$item_extend_update_dto->color="txp";
$item_extend_update_dto->is_need_machining="txp";
$item_extend_update_dto->volume="txp";
$item_extend_update_dto->commision_ratio="txp";
$item_extend_update_dto->display_category="txp";
$item_extend_update_dto->performing_template_id="txp";
$item_extend_update_dto->is_cloud_item="txp";
$item_extend_update_dto->attributes="{}";
$item_extend_update_dto->channel="{}";
$req->setItemExtendUpdateDto(json_encode($item_extend_update_dto));
$options = new ItemUpdateOptions;
$options->use_item_update_do="true";
$options->update_target_category_id="true";
$options->channel_switches="{}";
$options->sync_store="true";
$options->ic_options="[1,2]";
$options->extends_map="{}";
$options->update_status="true";
$options->only_update_child_item="true";
$options->scene="txp";
$options->store_id_list="[1,2]";
$options->sync_ic="true";
$options->sync_item_state="true";
$req->setOptions(json_encode($options));
$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=tmall.nr.item.item.updateextend' \
-d 'partner_id=apidoc' \
-d 'session=8fe9129f-8522-46f3-97ce-e2f6f8f66f3a' \
-d 'sign=7DF465B75009F13444E6958291396A05' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-15+14%3A30%3A12' \
-d 'v=2.0' \
-d 'item_extend_update_dto=null' \
-d 'options=null'

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

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

req.item_extend_update_dto=""
req.options=""
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,"tmall.nr.item.item.updateextend");
add_param(pRequest,"item_extend_update_dto","数据结构JSON示例");
add_param(pRequest,"options","数据结构JSON示例");
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('tmall.nr.item.item.updateextend', {
	'item_extend_update_dto':'数据结构JSON示例',
	'options':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tmall_nr_item_item_updateextend_response>
    <succ>true</succ>
    <data>
        <item_id>100</item_id>
    </data>
    <sys_code>0</sys_code>
    <sys_message></sys_message>
</tmall_nr_item_item_updateextend_response>

{
    "tmall_nr_item_item_updateextend_response":{
        "succ":true,
        "data":{
            "item_id":100
        },
        "sys_code":"0",
        "sys_message":""
    }
}

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

tmall.nr.item.item.updateextend (天鲜配商品扩展字段编辑)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ