淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	示例值	描述
succ	Boolean	true	是否成功
data	ScItemDto	true	货品模型
└ sc_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);
TmallNrItemScitemCreateRequest req = new TmallNrItemScitemCreateRequest();
TmallNrItemScitemCreateRequest.ScItemSaveDto obj1 = new TmallNrItemScitemCreateRequest.ScItemSaveDto();
obj1.setSupplierName("a");
obj1.setEffectiveDays(1L);
obj1.setStopProduction("a");
obj1.setBizCode("a");
obj1.setBrandName("a");
obj1.setBrandId(1L);
obj1.setMediaUrls(""12","12"");
obj1.setDeliveryUnit("a");
obj1.setFactoryScItemId("a");
obj1.setCategoryName("a");
obj1.setHeight(1L);
obj1.setStatusOpen(1L);
obj1.setPcs("a");
obj1.setSelfBrandName("a");
obj1.setCanSalesReturn(1L);
obj1.setUserId(1L);
obj1.setSalesNum2("a");
obj1.setScOuterBrandName("a");
obj1.setSalesNum1("a");
obj1.setSelfCategoryId(1L);
obj1.setNetContent("a");
obj1.setScItemPrice(1L);
obj1.setScOuterMainCategoryCode("a");
obj1.setPurchaseAgent("a");
obj1.setSalesNum30("a");
obj1.setPurchaseChannel("{}");
obj1.setSupplierId(1L);
obj1.setTaxRate("a");
obj1.setStatus(1L);
obj1.setStoreCondition("a");
obj1.setPurchaseChannelId("a");
obj1.setCategoryId(1L);
obj1.setWidth(1L);
obj1.setScItemType(1L);
obj1.setSelfBrandId(1L);
obj1.setStoreCode("a");
obj1.setScItemId(1L);
obj1.setGmtModified("a");
obj1.setWeight(1L);
obj1.setProducingArea("a");
obj1.setLocationId(1L);
obj1.setPurchaseUnitRate(1L);
TmallNrItemScitemCreateRequest.RtscItemSaveOption obj2 = new TmallNrItemScitemCreateRequest.RtscItemSaveOption();
obj2.setIsEnableOicInventorySynTag(true);
obj2.setIsEnableScmInventorySynTag(true);
obj2.setSyncToInventory(true);
obj2.setSyncToItemCenter(true);
obj1.setScItemSaveOption(obj2);
obj1.setScOuterMainCategoryName("z");
obj1.setDeliveryUnitRate(1L);
obj1.setCreator(1L);
obj1.setTaxIncomeRate("z");
obj1.setScOuterAllCategoryName("z");
obj1.setGmtCreated("z");
obj1.setTaxRateType("a");
obj1.setArea("a");
obj1.setBizCodes(""12","12"");
obj1.setScOuterAllCategoryCode("a");
obj1.setLength(1L);
obj1.setScOuterBrandId("a");
obj1.setAuditReason("a");
obj1.setOptions(1L);
obj1.setTags(new Long[] { 1,2 };
);
obj1.setSalesNum3("a");
obj1.setSalesNum15("a");
obj1.setSalesNum7("a");
obj1.setPurchaseUnit("a");
obj1.setStopProductionTime("a");
obj1.setScOuterChildCategoryName("a");
obj1.setTaxCode("a");
obj1.setScItemTitle("a");
obj1.setScOuterChildCategoryCode("a");
obj1.setUnit("a");
obj1.setUniqueScItemCodes(""a","a"");
obj1.setUniqueScItemCodesReal(true);
obj1.setCreatorName("a");
obj1.setSelfCategoryName("a");
obj1.setVolume(1L);
obj1.setInventoryId(1L);
obj1.setAttributes("{}");
obj1.setRowStatus(1L);
obj1.setScOuterId("a");
req.setScItemSaveDto(obj1);
TmallNrItemScitemCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

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

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallNrItemScitemCreateRequest;
$sc_item_save_dto = new ScItemSaveDto;
$sc_item_save_dto->supplier_name="a";
$sc_item_save_dto->effective_days="1";
$sc_item_save_dto->stop_production="a";
$sc_item_save_dto->biz_code="a";
$sc_item_save_dto->brand_name="a";
$sc_item_save_dto->brand_id="1";
$sc_item_save_dto->media_urls="[\"12\",\"12\"]";
$sc_item_save_dto->delivery_unit="a";
$sc_item_save_dto->factory_sc_item_id="a";
$sc_item_save_dto->category_name="a";
$sc_item_save_dto->height="1";
$sc_item_save_dto->status_open="1";
$sc_item_save_dto->pcs="a";
$sc_item_save_dto->self_brand_name="a";
$sc_item_save_dto->can_sales_return="1";
$sc_item_save_dto->user_id="1";
$sc_item_save_dto->sales_num2="a";
$sc_item_save_dto->sc_outer_brand_name="a";
$sc_item_save_dto->sales_num1="a";
$sc_item_save_dto->self_category_id="1";
$sc_item_save_dto->net_content="a";
$sc_item_save_dto->sc_item_price="1";
$sc_item_save_dto->sc_outer_main_category_code="a";
$sc_item_save_dto->purchase_agent="a";
$sc_item_save_dto->sales_num30="a";
$sc_item_save_dto->purchase_channel="{}";
$sc_item_save_dto->supplier_id="1";
$sc_item_save_dto->tax_rate="a";
$sc_item_save_dto->status="1";
$sc_item_save_dto->store_condition="a";
$sc_item_save_dto->purchase_channel_id="a";
$sc_item_save_dto->category_id="1";
$sc_item_save_dto->width="1";
$sc_item_save_dto->sc_item_type="1";
$sc_item_save_dto->self_brand_id="1";
$sc_item_save_dto->store_code="a";
$sc_item_save_dto->sc_item_id="1";
$sc_item_save_dto->gmt_modified="a";
$sc_item_save_dto->weight="1";
$sc_item_save_dto->producing_area="a";
$sc_item_save_dto->location_id="1";
$sc_item_save_dto->purchase_unit_rate="1";
$sc_item_save_option = new RtscItemSaveOption;
$sc_item_save_option->is_enable_oic_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_save_dto->sc_item_save_option = $sc_item_save_option;
$sc_item_save_dto->sc_outer_main_category_name="z";
$sc_item_save_dto->delivery_unit_rate="1";
$sc_item_save_dto->creator="1";
$sc_item_save_dto->tax_income_rate="z";
$sc_item_save_dto->sc_outer_all_category_name="z";
$sc_item_save_dto->gmt_created="z";
$sc_item_save_dto->tax_rate_type="a";
$sc_item_save_dto->area="a";
$sc_item_save_dto->biz_codes="[\"12\",\"12\"]";
$sc_item_save_dto->sc_outer_all_category_code="a";
$sc_item_save_dto->length="1";
$sc_item_save_dto->sc_outer_brand_id="a";
$sc_item_save_dto->audit_reason="a";
$sc_item_save_dto->options="1";
$sc_item_save_dto->tags="[1,2]";
$sc_item_save_dto->sales_num3="a";
$sc_item_save_dto->sales_num15="a";
$sc_item_save_dto->sales_num7="a";
$sc_item_save_dto->purchase_unit="a";
$sc_item_save_dto->stop_production_time="a";
$sc_item_save_dto->sc_outer_child_category_name="a";
$sc_item_save_dto->tax_code="a";
$sc_item_save_dto->sc_item_title="a";
$sc_item_save_dto->sc_outer_child_category_code="a";
$sc_item_save_dto->unit="a";
$sc_item_save_dto->unique_sc_item_codes="[\"a\",\"a\"]";
$sc_item_save_dto->unique_sc_item_codes_real="true";
$sc_item_save_dto->creator_name="a";
$sc_item_save_dto->self_category_name="a";
$sc_item_save_dto->volume="1";
$sc_item_save_dto->inventory_id="1";
$sc_item_save_dto->attributes="{}";
$sc_item_save_dto->row_status="1";
$sc_item_save_dto->sc_outer_id="a";
$req->setScItemSaveDto(json_encode($sc_item_save_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.create' \
-d 'partner_id=apidoc' \
-d 'session=e27ae250-3cf2-4681-9aeb-4d809c7d9687' \
-d 'sign=E39D9AA8F6A6429633BE42AED025632B' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-15+14%3A05%3A30' \
-d 'v=2.0' \
-d 'sc_item_save_dto=null'

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

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

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

XML示例
JSON示例

<tmall_nr_item_scitem_create_response>
    <succ>true</succ>
    <data>
        <sc_item_id>100</sc_item_id>
    </data>
    <sys_code>0</sys_code>
    <sys_message></sys_message>
</tmall_nr_item_scitem_create_response>

{
    "tmall_nr_item_scitem_create_response":{
        "succ":true,
        "data":{
            "sc_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.scitem.create (天鲜配货品新增)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ