淘宝开放平台 - 文档中心

请求地址：

环境	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_create_dto	ItemCreateDto	可选	商品模型
└ ref_online_item_id Number 可选 100 关联线上渠道itemId └ biz_code String 可选 txp 业务编码 └ need_logistics Number 可选 100 needLogistics step_pay StepPayDto 可选分阶段商品模板 └ template_id String 可选 txp templateId └ agreement_path String 可选 txp 协议路径 └ guide_pic_path String 可选 txp 协议路径 └ need_full_payment String 可选 txp 允许一次性付款？一次性付款的这里填1，比如天猫全款预售 └ detail_list String [] 可选 {} 分阶段详情 └ template_name String 可选 txp 模板名称 └ media_urls String [] 可选 ["txp","txp"] 商品图片,首张为主图 └ ref_bpu_id Number 可选 100 关联bpuId └ sub_title String 可选 txp 商品子标题 └ category_name String 可选 txp 叶子类目名称 └ status_open Number 可选 100 scm商品审核状态, 枚举,创建新商品默认为审核通过 └ self_brand_name String 可选 txp scm品牌名称 └ name_space String 可选 0 正副本标识 └ self_category_id Number 可选 100 scm类目ID └ bar_code String 可选 txp 商品条码 └ sale_num30 String 可选 txp saleNum30 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 bizCode └ file_format String 可选 txp 文件类型 └ thumb_pic String 可选 txp 封面图 └ url String 可选 txp 视频url └ purchase_channel String 可选 {} 商品采购渠道 └ status Number 可选 100 商品状态 └ purchase_channel_id String 可选 txp 采购渠道的外部ID └ category_id Number 可选 100 叶子类目ID └ item_price Number 可选 100 商品一口价 └ promotion_price Number 可选 100 促销价 └ inventory_unit String 可选 txp 库存基本单位 └ self_brand_id Number 可选 100 scm品牌ID └ short_key String 可选 txp 商品子标题拼音首字母 └ store_id Number 可选 100 所属门店ID └ outer_id String 可选 txp 商家自定义商品编码 └ sc_item_id Number 可选 100 关联的货品ID └ gmt_modified Date 可选 2019-01-01 00:00:00 商品更新时间 └ sale_unit String 可选 txp 销售单位 └ ref_online_sku_id Number 可选 100 关联线上渠道skuId └ is_standard_good Number 可选 100 是否标品 └ location_id Number 可选 100 库存位置 └ sale_spec String 可选 txp 商品规格 └ extend_media_urls String [] 可选 ["txp","txp"] 商品扩展图片 └ title String 可选 txp title └ biz_codes String [] 可选 ["txp","txp"] bizCodes └ self_item_id Number 可选 100 scm商品id └ options Number 可选 100 商品标记位,垂直业务用于标记特殊 └ channel_states String 可选 {} 所有外部渠道的信息，包括开关，同步状态，同步时间，外部渠道商品ID └ channel_inventory_threshold String 可选 txp 渠道商品展示时的临时字段，从库存模块获取 └ pic_url String 可选 txp 商品主图 └ gmt_create Date 可选 2019-01-01 00:00:00 商品创建时间 └ self_sc_item_id Number 可选 100 关联的scm货品ID └ self_status Number 可选 100 scm商品状态{9:上架,-9:下架} └ origin String 可选 txp 产地 └ sku_list String [] 可选 {} skuList └ parent_item_id Number 可选 100 父商品ID └ ref_online_cat_name String 可选 txp 关联导购类目名称 └ detail_desc String 可选 txp 商品描述内容 └ item_id Number 可选 100 itemId └ is_grant Number 可选 100 商品是否授权 └ self_parent_item_id Number 可选 100 scm父商品ID └ sale_unit_rate Number 可选 100 销售单位和后端商品基本库存单位的比率，只能是整形, 默认为1 └ self_category_name String 可选 txp scm类目名称 └ sc_item_name String 可选 txp 关联的货品名称 └ inventory_id Number 可选 100 库存Id └ ref_online_cat_id Number 可选 100 关联导购类目id └ has_sku Boolean 可选 true 是否有sku信息,默认无sku └ attributes String 可选 {} 商品扩展属性 └ row_status Number 可选 100 scm商品管理状态
options	ItemCreateOptions	可选	门店商品创建可选项
└ need_grand Boolean 可选 true 是否需要授权 └ channel_switches String 可选 {} 需要同步的渠道列表,只用于商品发布、编辑时异步同步给饿了么等渠道 └ sync_store Boolean 可选 true 是否同步给门店,默认同步;只有连锁管理模式才会有效 └ create_sc_item Boolean 可选 true 是否需要创建货品 └ ic_options Number [] 可选 [1,2] 同步到ic的options,仅syncIC=true时有效 └ need_audit Boolean 可选 true 是否需要审核 └ store_id_list Number [] 可选 [1,2] 需要同步的门店ID列表,syncStore = true时，不能为空 └ sync_i_c Boolean 可选 true 是否同步到IC,默认同步 └ sync_item_state Boolean 可选 true 是否同步商品状态到IC └ use_item_do Boolean 可选 true 是否由门店中台准备好IC商品数据

名称	类型	示例值	描述
succ	Boolean	true	是否成功
data	ItemCreateDto	{}	商品信息
└ 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);
TmallNrItemItemCreateRequest req = new TmallNrItemItemCreateRequest();
TmallNrItemItemCreateRequest.ItemCreateDto obj1 = new TmallNrItemItemCreateRequest.ItemCreateDto();
obj1.setRefOnlineItemId(100L);
obj1.setBizCode("txp");
obj1.setNeedLogistics(100L);
TmallNrItemItemCreateRequest.StepPayDto obj2 = new TmallNrItemItemCreateRequest.StepPayDto();
obj2.setTemplateId("txp");
obj2.setAgreementPath("txp");
obj2.setGuidePicPath("txp");
obj2.setNeedFullPayment("txp");
obj2.setDetailList("{}");
obj2.setTemplateName("txp");
obj1.setStepPay(obj2);
obj1.setMediaUrls(""txp","txp"");
obj1.setRefBpuId(100L);
obj1.setSubTitle("txp");
obj1.setCategoryName("txp");
obj1.setStatusOpen(100L);
obj1.setSelfBrandName("txp");
obj1.setNameSpace("0");
obj1.setSelfCategoryId(100L);
obj1.setBarCode("txp");
obj1.setSaleNum30("txp");
TmallNrItemItemCreateRequest.VideoDto obj3 = new TmallNrItemItemCreateRequest.VideoDto();
obj3.setId(100L);
obj3.setBizCodes(""txp","txp"");
obj3.setDuaration("txp");
obj3.setState(100L);
obj3.setBizCode("txp");
obj3.setFileFormat("txp");
obj3.setThumbPic("txp");
obj3.setUrl("txp");
obj1.setVideo(obj3);
obj1.setPurchaseChannel("{}");
obj1.setStatus(100L);
obj1.setPurchaseChannelId("txp");
obj1.setCategoryId(100L);
obj1.setItemPrice(100L);
obj1.setPromotionPrice(100L);
obj1.setInventoryUnit("txp");
obj1.setSelfBrandId(100L);
obj1.setShortKey("txp");
obj1.setStoreId(100L);
obj1.setOuterId("txp");
obj1.setScItemId(100L);
obj1.setGmtModified(StringUtils.parseDateTime("2019-01-01 00:00:00"));
obj1.setSaleUnit("txp");
obj1.setRefOnlineSkuId(100L);
obj1.setIsStandardGood(100L);
obj1.setLocationId(100L);
obj1.setSaleSpec("txp");
obj1.setExtendMediaUrls(""txp","txp"");
obj1.setTitle("txp");
obj1.setBizCodes(""txp","txp"");
obj1.setSelfItemId(100L);
obj1.setOptions(100L);
obj1.setChannelStates("{}");
obj1.setChannelInventoryThreshold("txp");
obj1.setPicUrl("txp");
obj1.setGmtCreate(StringUtils.parseDateTime("2019-01-01 00:00:00"));
obj1.setSelfScItemId(100L);
obj1.setSelfStatus(100L);
obj1.setOrigin("txp");
obj1.setSkuList("{}");
obj1.setParentItemId(100L);
obj1.setRefOnlineCatName("txp");
obj1.setDetailDesc("txp");
obj1.setItemId(100L);
obj1.setIsGrant(100L);
obj1.setSelfParentItemId(100L);
obj1.setSaleUnitRate(100L);
obj1.setSelfCategoryName("txp");
obj1.setScItemName("txp");
obj1.setInventoryId(100L);
obj1.setRefOnlineCatId(100L);
obj1.setHasSku(true);
obj1.setAttributes("{}");
obj1.setRowStatus(100L);
req.setItemCreateDto(obj1);
TmallNrItemItemCreateRequest.ItemCreateOptions obj4 = new TmallNrItemItemCreateRequest.ItemCreateOptions();
obj4.setNeedGrand(true);
obj4.setChannelSwitches("{}");
obj4.setSyncStore(true);
obj4.setCreateScItem(true);
obj4.setIcOptions(new Long[] { 1,2 };
);
obj4.setNeedAudit(true);
obj4.setStoreIdList(new Long[] { 1,2 };
);
obj4.setSyncIC(true);
obj4.setSyncItemState(true);
obj4.setUseItemDo(true);
req.setOptions(obj4);
TmallNrItemItemCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallNrItemItemCreateRequest req = new TmallNrItemItemCreateRequest();
TmallNrItemItemCreateRequest.ItemCreateDtoDomain obj1 = new TmallNrItemItemCreateRequest.ItemCreateDtoDomain();
obj1.RefOnlineItemId = 100L;
obj1.BizCode = "txp";
obj1.NeedLogistics = 100L;
TmallNrItemItemCreateRequest.StepPayDtoDomain obj2 = new TmallNrItemItemCreateRequest.StepPayDtoDomain();
obj2.TemplateId = "txp";
obj2.AgreementPath = "txp";
obj2.GuidePicPath = "txp";
obj2.NeedFullPayment = "txp";
obj2.DetailList = "{}";
obj2.TemplateName = "txp";
obj1.StepPay= obj2;
obj1.MediaUrls = ""txp","txp"";
obj1.RefBpuId = 100L;
obj1.SubTitle = "txp";
obj1.CategoryName = "txp";
obj1.StatusOpen = 100L;
obj1.SelfBrandName = "txp";
obj1.NameSpace = "0";
obj1.SelfCategoryId = 100L;
obj1.BarCode = "txp";
obj1.SaleNum30 = "txp";
TmallNrItemItemCreateRequest.VideoDtoDomain obj3 = new TmallNrItemItemCreateRequest.VideoDtoDomain();
obj3.Id = 100L;
obj3.BizCodes = ""txp","txp"";
obj3.Duaration = "txp";
obj3.State = 100L;
obj3.BizCode = "txp";
obj3.FileFormat = "txp";
obj3.ThumbPic = "txp";
obj3.Url = "txp";
obj1.Video= obj3;
obj1.PurchaseChannel = "{}";
obj1.Status = 100L;
obj1.PurchaseChannelId = "txp";
obj1.CategoryId = 100L;
obj1.ItemPrice = 100L;
obj1.PromotionPrice = 100L;
obj1.InventoryUnit = "txp";
obj1.SelfBrandId = 100L;
obj1.ShortKey = "txp";
obj1.StoreId = 100L;
obj1.OuterId = "txp";
obj1.ScItemId = 100L;
obj1.GmtModified = DateTime.Parse(2019-01-01 00:00:00");
obj1.SaleUnit = "txp";
obj1.RefOnlineSkuId = 100L;
obj1.IsStandardGood = 100L;
obj1.LocationId = 100L;
obj1.SaleSpec = "txp";
obj1.ExtendMediaUrls = ""txp","txp"";
obj1.Title = "txp";
obj1.BizCodes = ""txp","txp"";
obj1.SelfItemId = 100L;
obj1.Options = 100L;
obj1.ChannelStates = "{}";
obj1.ChannelInventoryThreshold = "txp";
obj1.PicUrl = "txp";
obj1.GmtCreate = DateTime.Parse(2019-01-01 00:00:00");
obj1.SelfScItemId = 100L;
obj1.SelfStatus = 100L;
obj1.Origin = "txp";
obj1.SkuList = "{}";
obj1.ParentItemId = 100L;
obj1.RefOnlineCatName = "txp";
obj1.DetailDesc = "txp";
obj1.ItemId = 100L;
obj1.IsGrant = 100L;
obj1.SelfParentItemId = 100L;
obj1.SaleUnitRate = 100L;
obj1.SelfCategoryName = "txp";
obj1.ScItemName = "txp";
obj1.InventoryId = 100L;
obj1.RefOnlineCatId = 100L;
obj1.HasSku = true;
obj1.Attributes = "{}";
obj1.RowStatus = 100L;
req.ItemCreateDto_ = obj1;
TmallNrItemItemCreateRequest.ItemCreateOptionsDomain obj4 = new TmallNrItemItemCreateRequest.ItemCreateOptionsDomain();
obj4.NeedGrand = true;
obj4.ChannelSwitches = "{}";
obj4.SyncStore = true;
obj4.CreateScItem = true;
obj4.IcOptions = new long[] { 1,2 };
;
obj4.NeedAudit = true;
obj4.StoreIdList = new long[] { 1,2 };
;
obj4.SyncIC = true;
obj4.SyncItemState = true;
obj4.UseItemDo = true;
req.Options_ = obj4;
TmallNrItemItemCreateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallNrItemItemCreateRequest;
$item_create_dto = new ItemCreateDto;
$item_create_dto->ref_online_item_id="100";
$item_create_dto->biz_code="txp";
$item_create_dto->need_logistics="100";
$step_pay = new StepPayDto;
$step_pay->template_id="txp";
$step_pay->agreement_path="txp";
$step_pay->guide_pic_path="txp";
$step_pay->need_full_payment="txp";
$step_pay->detail_list="{}";
$step_pay->template_name="txp";
$item_create_dto->step_pay = $step_pay;
$item_create_dto->media_urls="[\"txp\",\"txp\"]";
$item_create_dto->ref_bpu_id="100";
$item_create_dto->sub_title="txp";
$item_create_dto->category_name="txp";
$item_create_dto->status_open="100";
$item_create_dto->self_brand_name="txp";
$item_create_dto->name_space="0";
$item_create_dto->self_category_id="100";
$item_create_dto->bar_code="txp";
$item_create_dto->sale_num30="txp";
$video = new VideoDto;
$video->id="100";
$video->biz_codes="[\"txp\",\"txp\"]";
$video->duaration="txp";
$video->state="100";
$video->biz_code="txp";
$video->file_format="txp";
$video->thumb_pic="txp";
$video->url="txp";
$item_create_dto->video = $video;
$item_create_dto->purchase_channel="{}";
$item_create_dto->status="100";
$item_create_dto->purchase_channel_id="txp";
$item_create_dto->category_id="100";
$item_create_dto->item_price="100";
$item_create_dto->promotion_price="100";
$item_create_dto->inventory_unit="txp";
$item_create_dto->self_brand_id="100";
$item_create_dto->short_key="txp";
$item_create_dto->store_id="100";
$item_create_dto->outer_id="txp";
$item_create_dto->sc_item_id="100";
$item_create_dto->gmt_modified="2019-01-01 00:00:00";
$item_create_dto->sale_unit="txp";
$item_create_dto->ref_online_sku_id="100";
$item_create_dto->is_standard_good="100";
$item_create_dto->location_id="100";
$item_create_dto->sale_spec="txp";
$item_create_dto->extend_media_urls="[\"txp\",\"txp\"]";
$item_create_dto->title="txp";
$item_create_dto->biz_codes="[\"txp\",\"txp\"]";
$item_create_dto->self_item_id="100";
$item_create_dto->options="100";
$item_create_dto->channel_states="{}";
$item_create_dto->channel_inventory_threshold="txp";
$item_create_dto->pic_url="txp";
$item_create_dto->gmt_create="2019-01-01 00:00:00";
$item_create_dto->self_sc_item_id="100";
$item_create_dto->self_status="100";
$item_create_dto->origin="txp";
$item_create_dto->sku_list="{}";
$item_create_dto->parent_item_id="100";
$item_create_dto->ref_online_cat_name="txp";
$item_create_dto->detail_desc="txp";
$item_create_dto->item_id="100";
$item_create_dto->is_grant="100";
$item_create_dto->self_parent_item_id="100";
$item_create_dto->sale_unit_rate="100";
$item_create_dto->self_category_name="txp";
$item_create_dto->sc_item_name="txp";
$item_create_dto->inventory_id="100";
$item_create_dto->ref_online_cat_id="100";
$item_create_dto->has_sku="true";
$item_create_dto->attributes="{}";
$item_create_dto->row_status="100";
$req->setItemCreateDto(json_encode($item_create_dto));
$options = new ItemCreateOptions;
$options->need_grand="true";
$options->channel_switches="{}";
$options->sync_store="true";
$options->create_sc_item="true";
$options->ic_options="[1,2]";
$options->need_audit="true";
$options->store_id_list="[1,2]";
$options->sync_i_c="true";
$options->sync_item_state="true";
$options->use_item_do="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.create' \
-d 'partner_id=apidoc' \
-d 'session=c45fac26-cc71-4b51-890e-abf5175d46f4' \
-d 'sign=9FC936F2F6F29B3FD9E9A845C6D03CAB' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-15+14%3A23%3A54' \
-d 'v=2.0' \
-d 'item_create_dto=null' \
-d 'options=null'

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

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

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

XML示例
JSON示例

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

{
    "tmall_nr_item_item_create_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.create (天鲜配商品新增)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ