淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
sc_item_update_dto	ScItemUpdateDto	可选			货品模型
└ update_category Boolean 可选 true updateCategory └ supplier_name String 可选 txp 供应商名称 └ effective_days Number 可选 100 有效期 └ stop_production String 可选 txp 是否停售 └ biz_code String 可选 txp 业务编码 └ brand_name String 可选 txp 品牌名称 └ brand_id Number 可选 100 品牌id └ media_urls String [] 可选 ["t","t"] 图片 └ delivery_unit String 可选 txp 配送单位 └ factory_sc_item_id String 可选 txp 厂方货号 └ category_name String 可选 txp 类别名称 └ height Number 可选 100 高 └ status_open Number 可选 100 状态（0:新档，1:待审核，2:已审核） └ pcs String 可选 txp 包装规格 └ self_brand_name String 可选 txp scm品牌名称 └ can_sales_return Number 可选 100 是否可退给供应商 1：是，0:否。默认都可退 └ user_id Number 可选 100 用户id └ sales_num2 String 可选 txp sales_num2 └ sc_outer_brand_name String 可选 txp 外部品牌名称 └ sales_num1 String 可选 txp sales_num2 └ self_category_id Number 可选 100 scm类目ID └ net_content String 可选 txp 净含量 └ sc_item_price Number 可选 100 价格 └ purchase_agent String 可选 txp 三级外部类目 └ sc_outer_main_category_code String 可选 txp 采购员 └ sales_num30 String 可选 txp sales_num30 └ purchase_channel String 可选 {} 采购渠道 └ supplier_id Number 可选 100 供应商id └ tax_rate String 可选 txp 价格税率 └ status Number 可选 100 状态 └ store_condition String 可选 txp 存放条件 └ purchase_channel_id String 可选 txp 外部供货渠道ID └ category_id Number 可选 100 类目id └ width Number 可选 100 宽 └ sc_item_type Number 可选 100 货品类型 └ self_brand_id Number 可选 100 scm品牌ID └ store_code String 可选 txp 仓库编码 └ sc_item_id Number 可选 100 IC货品ID └ gmt_modified String 可选 txp 修改时间 └ weight Number 可选 100 重量 └ producing_area String 可选 txp 产地 └ location_id Number 可选 100 库存位置 └ purchase_unit_rate Number 可选 100 采购N个基本单位 sc_item_save_option RtscItemSaveOption 可选选项 └ is_enable_o_ic_inventory_syn_tag Boolean 可选 true OIC库存标 └ is_enable_scm_inventory_syn_tag Boolean 可选 true OIC库存标 └ sync_to_inventory Boolean 可选 true syncToInventory └ sync_to_item_center Boolean 可选 true syncToItemCenter └ sc_outer_main_category_name String 可选 txp 三级外部类目 └ delivery_unit_rate Number 可选 100 配送N个基本单位 └ creator Number 可选 100 创建人的scm账户id └ tax_income_rate String 可选 txp 进项税率 └ sc_outer_all_category_name String 可选 txp 三级外部类目 └ gmt_created String 可选 txp 创建时间 └ tax_rate_type String 可选 txp 税率类型 └ area String 可选 txp 地区 └ biz_codes String [] 可选 ["2","1"] 业务编码 └ sc_outer_all_category_code String 可选 txp 三级外部类目 └ length Number 可选 100 长度 └ sc_outer_brand_id String 可选 txp scOuterBrandId └ audit_reason String 可选 txp 审核不通过原因 └ options Number 可选 100 商品标记位,垂直业务用于标记特殊 └ tags Number [] 可选 [1,2] 商品标 └ sales_num3 String 可选 txp sales_num3 └ sales_num15 String 可选 txp sales_num15 └ sales_num7 String 可选 txp sales_num7 └ purchase_unit String 可选 txp 采购单位 └ stop_production_time String 可选 txp 停售时间 └ sc_outer_child_category_name String 可选 txp scOuterChildCategoryName └ tax_code String 可选 txp 税收编码 └ sc_item_title String 可选 txp 货品名称 └ sc_outer_child_category_code String 可选 txp scOuterChildCategoryCode └ unit String 可选 txp 库存单位 └ unique_sc_item_codes String [] 可选 ["r","r"] 条形码 └ unique_sc_item_codes_real Boolean 可选 true 附加字段，表示条码是否是外部输入的，如果外部没有输入条码，则把outerId作为条码，同时此字段置为false └ creator_name String 可选 txp 创建人的scm账户名 └ append_attributes Boolean 可选 true scm类目名称 └ self_category_name String 可选 txp 类目名称 └ volume Number 可选 100 体积 └ inventory_id Number 可选 100 ic货品库存ID └ attributes String 可选 {} 货品扩展属性 └ row_status Number 可选 100 是否删除 └ sc_outer_id String 可选 txp 此属性表示供应链上的外部货品ID

名称	类型	示例值	描述
succ	Boolean	true	是否成功
sys_code	String	0	错误码
sys_message	String		错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrItemScitemUpdateRequest req = new TmallNrItemScitemUpdateRequest();
TmallNrItemScitemUpdateRequest.ScItemUpdateDto obj1 = new TmallNrItemScitemUpdateRequest.ScItemUpdateDto();
obj1.setUpdateCategory(true);
obj1.setSupplierName("txp");
obj1.setEffectiveDays(100L);
obj1.setStopProduction("txp");
obj1.setBizCode("txp");
obj1.setBrandName("txp");
obj1.setBrandId(100L);
obj1.setMediaUrls(""t","t"");
obj1.setDeliveryUnit("txp");
obj1.setFactoryScItemId("txp");
obj1.setCategoryName("txp");
obj1.setHeight(100L);
obj1.setStatusOpen(100L);
obj1.setPcs("txp");
obj1.setSelfBrandName("txp");
obj1.setCanSalesReturn(100L);
obj1.setUserId(100L);
obj1.setSalesNum2("txp");
obj1.setScOuterBrandName("txp");
obj1.setSalesNum1("txp");
obj1.setSelfCategoryId(100L);
obj1.setNetContent("txp");
obj1.setScItemPrice(100L);
obj1.setPurchaseAgent("txp");
obj1.setScOuterMainCategoryCode("txp");
obj1.setSalesNum30("txp");
obj1.setPurchaseChannel("{}");
obj1.setSupplierId(100L);
obj1.setTaxRate("txp");
obj1.setStatus(100L);
obj1.setStoreCondition("txp");
obj1.setPurchaseChannelId("txp");
obj1.setCategoryId(100L);
obj1.setWidth(100L);
obj1.setScItemType(100L);
obj1.setSelfBrandId(100L);
obj1.setStoreCode("txp");
obj1.setScItemId(100L);
obj1.setGmtModified("txp");
obj1.setWeight(100L);
obj1.setProducingArea("txp");
obj1.setLocationId(100L);
obj1.setPurchaseUnitRate(100L);
TmallNrItemScitemUpdateRequest.RtscItemSaveOption obj2 = new TmallNrItemScitemUpdateRequest.RtscItemSaveOption();
obj2.setIsEnableOIcInventorySynTag(true);
obj2.setIsEnableScmInventorySynTag(true);
obj2.setSyncToInventory(true);
obj2.setSyncToItemCenter(true);
obj1.setScItemSaveOption(obj2);
obj1.setScOuterMainCategoryName("txp");
obj1.setDeliveryUnitRate(100L);
obj1.setCreator(100L);
obj1.setTaxIncomeRate("txp");
obj1.setScOuterAllCategoryName("txp");
obj1.setGmtCreated("txp");
obj1.setTaxRateType("txp");
obj1.setArea("txp");
obj1.setBizCodes(""2","1"");
obj1.setScOuterAllCategoryCode("txp");
obj1.setLength(100L);
obj1.setScOuterBrandId("txp");
obj1.setAuditReason("txp");
obj1.setOptions(100L);
obj1.setTags(new Long[] { 1,2 };
);
obj1.setSalesNum3("txp");
obj1.setSalesNum15("txp");
obj1.setSalesNum7("txp");
obj1.setPurchaseUnit("txp");
obj1.setStopProductionTime("txp");
obj1.setScOuterChildCategoryName("txp");
obj1.setTaxCode("txp");
obj1.setScItemTitle("txp");
obj1.setScOuterChildCategoryCode("txp");
obj1.setUnit("txp");
obj1.setUniqueScItemCodes(""r","r"");
obj1.setUniqueScItemCodesReal(true);
obj1.setCreatorName("txp");
obj1.setAppendAttributes(true);
obj1.setSelfCategoryName("txp");
obj1.setVolume(100L);
obj1.setInventoryId(100L);
obj1.setAttributes("{}");
obj1.setRowStatus(100L);
obj1.setScOuterId("txp");
req.setScItemUpdateDto(obj1);
TmallNrItemScitemUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallNrItemScitemUpdateRequest req = new TmallNrItemScitemUpdateRequest();
TmallNrItemScitemUpdateRequest.ScItemUpdateDtoDomain obj1 = new TmallNrItemScitemUpdateRequest.ScItemUpdateDtoDomain();
obj1.UpdateCategory = true;
obj1.SupplierName = "txp";
obj1.EffectiveDays = 100L;
obj1.StopProduction = "txp";
obj1.BizCode = "txp";
obj1.BrandName = "txp";
obj1.BrandId = 100L;
obj1.MediaUrls = ""t","t"";
obj1.DeliveryUnit = "txp";
obj1.FactoryScItemId = "txp";
obj1.CategoryName = "txp";
obj1.Height = 100L;
obj1.StatusOpen = 100L;
obj1.Pcs = "txp";
obj1.SelfBrandName = "txp";
obj1.CanSalesReturn = 100L;
obj1.UserId = 100L;
obj1.SalesNum2 = "txp";
obj1.ScOuterBrandName = "txp";
obj1.SalesNum1 = "txp";
obj1.SelfCategoryId = 100L;
obj1.NetContent = "txp";
obj1.ScItemPrice = 100L;
obj1.PurchaseAgent = "txp";
obj1.ScOuterMainCategoryCode = "txp";
obj1.SalesNum30 = "txp";
obj1.PurchaseChannel = "{}";
obj1.SupplierId = 100L;
obj1.TaxRate = "txp";
obj1.Status = 100L;
obj1.StoreCondition = "txp";
obj1.PurchaseChannelId = "txp";
obj1.CategoryId = 100L;
obj1.Width = 100L;
obj1.ScItemType = 100L;
obj1.SelfBrandId = 100L;
obj1.StoreCode = "txp";
obj1.ScItemId = 100L;
obj1.GmtModified = "txp";
obj1.Weight = 100L;
obj1.ProducingArea = "txp";
obj1.LocationId = 100L;
obj1.PurchaseUnitRate = 100L;
TmallNrItemScitemUpdateRequest.RtscItemSaveOptionDomain obj2 = new TmallNrItemScitemUpdateRequest.RtscItemSaveOptionDomain();
obj2.IsEnableOIcInventorySynTag = true;
obj2.IsEnableScmInventorySynTag = true;
obj2.SyncToInventory = true;
obj2.SyncToItemCenter = true;
obj1.ScItemSaveOption= obj2;
obj1.ScOuterMainCategoryName = "txp";
obj1.DeliveryUnitRate = 100L;
obj1.Creator = 100L;
obj1.TaxIncomeRate = "txp";
obj1.ScOuterAllCategoryName = "txp";
obj1.GmtCreated = "txp";
obj1.TaxRateType = "txp";
obj1.Area = "txp";
obj1.BizCodes = ""2","1"";
obj1.ScOuterAllCategoryCode = "txp";
obj1.Length = 100L;
obj1.ScOuterBrandId = "txp";
obj1.AuditReason = "txp";
obj1.Options = 100L;
obj1.Tags = new long[] { 1,2 };
;
obj1.SalesNum3 = "txp";
obj1.SalesNum15 = "txp";
obj1.SalesNum7 = "txp";
obj1.PurchaseUnit = "txp";
obj1.StopProductionTime = "txp";
obj1.ScOuterChildCategoryName = "txp";
obj1.TaxCode = "txp";
obj1.ScItemTitle = "txp";
obj1.ScOuterChildCategoryCode = "txp";
obj1.Unit = "txp";
obj1.UniqueScItemCodes = ""r","r"";
obj1.UniqueScItemCodesReal = true;
obj1.CreatorName = "txp";
obj1.AppendAttributes = true;
obj1.SelfCategoryName = "txp";
obj1.Volume = 100L;
obj1.InventoryId = 100L;
obj1.Attributes = "{}";
obj1.RowStatus = 100L;
obj1.ScOuterId = "txp";
req.ScItemUpdateDto_ = obj1;
TmallNrItemScitemUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallNrItemScitemUpdateRequest;
$sc_item_update_dto = new ScItemUpdateDto;
$sc_item_update_dto->update_category="true";
$sc_item_update_dto->supplier_name="txp";
$sc_item_update_dto->effective_days="100";
$sc_item_update_dto->stop_production="txp";
$sc_item_update_dto->biz_code="txp";
$sc_item_update_dto->brand_name="txp";
$sc_item_update_dto->brand_id="100";
$sc_item_update_dto->media_urls="[\"t\",\"t\"]";
$sc_item_update_dto->delivery_unit="txp";
$sc_item_update_dto->factory_sc_item_id="txp";
$sc_item_update_dto->category_name="txp";
$sc_item_update_dto->height="100";
$sc_item_update_dto->status_open="100";
$sc_item_update_dto->pcs="txp";
$sc_item_update_dto->self_brand_name="txp";
$sc_item_update_dto->can_sales_return="100";
$sc_item_update_dto->user_id="100";
$sc_item_update_dto->sales_num2="txp";
$sc_item_update_dto->sc_outer_brand_name="txp";
$sc_item_update_dto->sales_num1="txp";
$sc_item_update_dto->self_category_id="100";
$sc_item_update_dto->net_content="txp";
$sc_item_update_dto->sc_item_price="100";
$sc_item_update_dto->purchase_agent="txp";
$sc_item_update_dto->sc_outer_main_category_code="txp";
$sc_item_update_dto->sales_num30="txp";
$sc_item_update_dto->purchase_channel="{}";
$sc_item_update_dto->supplier_id="100";
$sc_item_update_dto->tax_rate="txp";
$sc_item_update_dto->status="100";
$sc_item_update_dto->store_condition="txp";
$sc_item_update_dto->purchase_channel_id="txp";
$sc_item_update_dto->category_id="100";
$sc_item_update_dto->width="100";
$sc_item_update_dto->sc_item_type="100";
$sc_item_update_dto->self_brand_id="100";
$sc_item_update_dto->store_code="txp";
$sc_item_update_dto->sc_item_id="100";
$sc_item_update_dto->gmt_modified="txp";
$sc_item_update_dto->weight="100";
$sc_item_update_dto->producing_area="txp";
$sc_item_update_dto->location_id="100";
$sc_item_update_dto->purchase_unit_rate="100";
$sc_item_save_option = new RtscItemSaveOption;
$sc_item_save_option->is_enable_o_ic_inventory_syn_tag="true";
$sc_item_save_option->is_enable_scm_inventory_syn_tag="true";
$sc_item_save_option->sync_to_inventory="true";
$sc_item_save_option->sync_to_item_center="true";
$sc_item_update_dto->sc_item_save_option = $sc_item_save_option;
$sc_item_update_dto->sc_outer_main_category_name="txp";
$sc_item_update_dto->delivery_unit_rate="100";
$sc_item_update_dto->creator="100";
$sc_item_update_dto->tax_income_rate="txp";
$sc_item_update_dto->sc_outer_all_category_name="txp";
$sc_item_update_dto->gmt_created="txp";
$sc_item_update_dto->tax_rate_type="txp";
$sc_item_update_dto->area="txp";
$sc_item_update_dto->biz_codes="[\"2\",\"1\"]";
$sc_item_update_dto->sc_outer_all_category_code="txp";
$sc_item_update_dto->length="100";
$sc_item_update_dto->sc_outer_brand_id="txp";
$sc_item_update_dto->audit_reason="txp";
$sc_item_update_dto->options="100";
$sc_item_update_dto->tags="[1,2]";
$sc_item_update_dto->sales_num3="txp";
$sc_item_update_dto->sales_num15="txp";
$sc_item_update_dto->sales_num7="txp";
$sc_item_update_dto->purchase_unit="txp";
$sc_item_update_dto->stop_production_time="txp";
$sc_item_update_dto->sc_outer_child_category_name="txp";
$sc_item_update_dto->tax_code="txp";
$sc_item_update_dto->sc_item_title="txp";
$sc_item_update_dto->sc_outer_child_category_code="txp";
$sc_item_update_dto->unit="txp";
$sc_item_update_dto->unique_sc_item_codes="[\"r\",\"r\"]";
$sc_item_update_dto->unique_sc_item_codes_real="true";
$sc_item_update_dto->creator_name="txp";
$sc_item_update_dto->append_attributes="true";
$sc_item_update_dto->self_category_name="txp";
$sc_item_update_dto->volume="100";
$sc_item_update_dto->inventory_id="100";
$sc_item_update_dto->attributes="{}";
$sc_item_update_dto->row_status="100";
$sc_item_update_dto->sc_outer_id="txp";
$req->setScItemUpdateDto(json_encode($sc_item_update_dto));
$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.scitem.update' \
-d 'partner_id=apidoc' \
-d 'session=bcb50720-3c7c-415d-a4de-a709e0ec727f' \
-d 'sign=85E7B189CFF61C807E208F2439E96B11' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-22+16%3A11%3A53' \
-d 'v=2.0' \
-d 'sc_item_update_dto=null'

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

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

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

XML示例
JSON示例

<tmall_nr_item_scitem_update_response>
    <succ>true</succ>
    <sys_code>0</sys_code>
    <sys_message></sys_message>
</tmall_nr_item_scitem_update_response>

{
    "tmall_nr_item_scitem_update_response":{
        "succ":true,
        "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.scitem.update (天鲜配货品编辑)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ