淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
cspu_input_dto_list	CspuInputDto []	必须		最大列表长度：20	录入商品信息列表（最大列表长度：20）
└ art_no String 可选 657984 货号 └ barcode String 必须 657984red37 商品条码 └ outer_id String 必须 657984red37 源id（供应商自己的唯一标识） properties PropertyDto [] 必须销售属性 └ p_alias String 可选 size 属性别名 └ p_custom_name String 可选规格自定义属性名称 └ p_id String 可选 56854 对应天猫属性Id └ p_name String 必须尺码对应天猫属性名称 └ v_alias String 可选 EU_37 属性值别名 └ v_custom_name String 可选 37 自定义value名称（优先展示此字段） └ v_id String 可选 578453 对应天猫属性Id └ v_name String 必须 37 对应天猫属性值名称（v_custom_name不传时展示此字段） └ img_url String 可选 http://img.taobao.com/img/549.jpg 花色图片 └ order Number 可选 0 顺序 └ property_type String 可选 sale 属性类型（sale, nonCritical, critical, tmallItem） spu_input_dto SpuInputDto 必须标准商品信息（款） └ barcode_str String 可选 657984red37 产品条码信息 └ brand_id String 必须 10129 银泰品牌Id └ brand_name String 可选阿迪达斯品牌名称 └ cat_name String 可选运动商品类目名称 └ cid String 可选 35875 商品类目ID.必须是叶子类目ID └ id String 可选 1000008331485 SPU ID └ is_new Boolean 可选 true 是否新品默认是true └ material String 可选 http://img.taobao.com/img/549.jpg 透明素材图 └ mdesc String 可选适合手机端展示的产品描述已废弃 └ pc_desc String 可选适合PC端展示的产品描述已废弃 └ pic_url String 可选 http://img.taobao.com/img/549.jpg 产品的主图片地址.(绝对地址,格式:http://host/image_path) └ price String 必须 150.00 吊牌价.单位为元. └ product_id String 可选 37 产品ID product_imgs ProductImgDto [] 可选产品的子图片.目前最多支持50张。 └ id Number 可选 4 图片ID └ position Number 可选 0 排序 └ url String 可选 http://img.taobao.com/img/549.jpg url地址（以http或https开头的绝对路径） props PropertyDto [] 可选产品参数描述，如：材质成分、裙长、年份季节等信息，最多50个属性 └ p_alias String 可选 size 属性别名 └ p_custom_name String 可选规格自定义属性名称 └ p_id String 可选 56854 对应天猫属性Id └ p_name String 可选尺码属性名称 └ v_alias String 可选 EU_37 属性值别名 └ v_custom_name String 可选 37 自定义value名称 └ v_id String 可选 578453 对应天猫属性值id └ v_name String 可选 37 属性值名称 └ img_url String 可选 http://img.taobao.com/img/549.jpg 花色图片 └ order Number 可选 0 顺序 └ property_type String 可选 sale 属性类型（sale, nonCritical, critical, tmallItem） └ sell_pt String 可选产品卖点描述产品卖点描述，长度限制20个汉字 └ style_no String 可选 657984 款号 └ sub_title String 可选阿迪达斯男士上衣子标题 └ tags String 可选 {"brand": "2342"} brand是银泰品牌Id，colorName（颜色名称）、colorCode(颜色编码)、sizeCode(尺码编码)、sizeName(尺码名称):商品销售属性，标签一些在属性里找不到id的属性存放在这里 └ title String 可选阿迪达斯运动上衣产品名称 └ tmall_brand_id String 可选 125898 天猫品牌Id └ desc_pic_list String [] 可选 ["https://img.alicdn.com/imgextra/i4/912277785/O1CN0127NZpzoccfnyRgl_!!912277785.jpg"] 详情图（最大列表长度：60） └ tmall_item_id Number 可选 1234 天猫ItemId └ sub_title String 可选阿迪达斯男士上衣子标题 └ tag_price String 必须 150.00 吊牌价 └ tags String 必须 {"colorCode": "U50","colorName": "牛仔蓝","sizeCode": "EU_37","sizeName": "EU_37","brand": "2342"} brand是银泰品牌Id，colorName（颜色名称）、colorCode(颜色编码)、sizeCode(尺码编码)、sizeName(尺码名称):商品销售属性，标签一些在属性里找不到id的属性存放在这里 └ title String 必须阿迪达斯男士运动上衣产品名称 └ tmall_sku_id Number 可选 1234 天猫Sku

名称	类型	示例值	描述
data	BulkInputCspuResult	true	返回数据
cspu_result_list InputCspuResult [] {} 录入结果对象 └ cspu_id String 10000005642 中台商品id └ message String 错误信息错误信息 └ outer_id String id 供应商商品id └ success Boolean true 是否录入成功，true：成功 false：失败

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosGoodsBulkinputcspuRequest req = new AlibabaMosGoodsBulkinputcspuRequest();
List<AlibabaMosGoodsBulkinputcspuRequest.CspuInputDto> list2 = new ArrayList<AlibabaMosGoodsBulkinputcspuRequest.CspuInputDto>();
AlibabaMosGoodsBulkinputcspuRequest.CspuInputDto obj3 = new AlibabaMosGoodsBulkinputcspuRequest.CspuInputDto();
list2.add(obj3);
obj3.setArtNo("657984");
obj3.setBarcode("657984red37");
obj3.setOuterId("657984red37");
List<AlibabaMosGoodsBulkinputcspuRequest.PropertyDto> list6 = new ArrayList<AlibabaMosGoodsBulkinputcspuRequest.PropertyDto>();
AlibabaMosGoodsBulkinputcspuRequest.PropertyDto obj7 = new AlibabaMosGoodsBulkinputcspuRequest.PropertyDto();
list6.add(obj7);
obj7.setPAlias("size");
obj7.setPCustomName("规格");
obj7.setPId("56854");
obj7.setPName("尺码");
obj7.setVAlias("EU_37");
obj7.setVCustomName("37");
obj7.setVId("578453");
obj7.setVName("37");
obj7.setImgUrl("http://img.taobao.com/img/549.jpg");
obj7.setOrder(0L);
obj7.setPropertyType("sale");
list4.setProperties(list6);
AlibabaMosGoodsBulkinputcspuRequest.SpuInputDto obj9 = new AlibabaMosGoodsBulkinputcspuRequest.SpuInputDto();
obj9.setBarcodeStr("657984red37");
obj9.setBrandId("10129");
obj9.setBrandName("阿迪达斯");
obj9.setCatName("运动");
obj9.setCid("35875");
obj9.setId("1000008331485");
obj9.setIsNew(true);
obj9.setMaterial("http://img.taobao.com/img/549.jpg");
obj9.setMdesc("适合手机端展示的产品描述");
obj9.setPcDesc("适合PC端展示的产品描述");
obj9.setPicUrl("http://img.taobao.com/img/549.jpg");
obj9.setPrice("150.00");
obj9.setProductId("37");
List<AlibabaMosGoodsBulkinputcspuRequest.ProductImgDto> list11 = new ArrayList<AlibabaMosGoodsBulkinputcspuRequest.ProductImgDto>();
AlibabaMosGoodsBulkinputcspuRequest.ProductImgDto obj12 = new AlibabaMosGoodsBulkinputcspuRequest.ProductImgDto();
list11.add(obj12);
obj12.setId(4L);
obj12.setPosition(0L);
obj12.setUrl("http://img.taobao.com/img/549.jpg");
obj9.setProductImgs(list11);
List<AlibabaMosGoodsBulkinputcspuRequest.PropertyDto> list14 = new ArrayList<AlibabaMosGoodsBulkinputcspuRequest.PropertyDto>();
AlibabaMosGoodsBulkinputcspuRequest.PropertyDto obj15 = new AlibabaMosGoodsBulkinputcspuRequest.PropertyDto();
list14.add(obj15);
obj15.setPAlias("size");
obj15.setPCustomName("规格");
obj15.setPId("56854");
obj15.setPName("尺码");
obj15.setVAlias("EU_37");
obj15.setVCustomName("37");
obj15.setVId("578453");
obj15.setVName("37");
obj15.setImgUrl("http://img.taobao.com/img/549.jpg");
obj15.setOrder(0L);
obj15.setPropertyType("sale");
obj9.setProps(list14);
obj9.setSellPt("产品卖点描述");
obj9.setStyleNo("657984");
obj9.setSubTitle("阿迪达斯男士上衣");
obj9.setTags("{\"brand\": \"2342\"}");
obj9.setTitle("阿迪达斯运动上衣");
obj9.setTmallBrandId("125898");
obj9.setDescPicList(""https://img.alicdn.com/imgextra/i4/912277785/O1CN0127NZpzoccfnyRgl_!!912277785.jpg"");
obj9.setTmallItemId(1234L);
list8.setSpuInputDto(obj9);
obj3.setSubTitle("阿迪达斯男士上衣");
obj3.setTagPrice("150.00");
obj3.setTags("{\"colorCode\": \"U50\",\"colorName\": \"牛仔蓝\",\"sizeCode\": \"EU_37\",\"sizeName\": \"EU_37\",\"brand\": \"2342\"}");
obj3.setTitle("阿迪达斯男士运动上衣");
obj3.setTmallSkuId(1234L);
req.setCspuInputDtoList(list2);
AlibabaMosGoodsBulkinputcspuResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaMosGoodsBulkinputcspuRequest req = new AlibabaMosGoodsBulkinputcspuRequest();
List<AlibabaMosGoodsBulkinputcspuRequest.CspuInputDtoDomain> list2 = new List<AlibabaMosGoodsBulkinputcspuRequest.CspuInputDtoDomain>();
AlibabaMosGoodsBulkinputcspuRequest.CspuInputDtoDomain obj3 = new AlibabaMosGoodsBulkinputcspuRequest.CspuInputDtoDomain();
list2.Add(obj3);
obj3.ArtNo = "657984";
obj3.Barcode = "657984red37";
obj3.OuterId = "657984red37";
List<AlibabaMosGoodsBulkinputcspuRequest.PropertyDtoDomain> list5 = new List<AlibabaMosGoodsBulkinputcspuRequest.PropertyDtoDomain>();
AlibabaMosGoodsBulkinputcspuRequest.PropertyDtoDomain obj6 = new AlibabaMosGoodsBulkinputcspuRequest.PropertyDtoDomain();
list5.Add(obj6);
obj6.PAlias = "size";
obj6.PCustomName = "规格";
obj6.PId = "56854";
obj6.PName = "尺码";
obj6.VAlias = "EU_37";
obj6.VCustomName = "37";
obj6.VId = "578453";
obj6.VName = "37";
obj6.ImgUrl = "http://img.taobao.com/img/549.jpg";
obj6.Order = 0L;
obj6.PropertyType = "sale";
obj3.Properties= list5;
AlibabaMosGoodsBulkinputcspuRequest.SpuInputDtoDomain obj7 = new AlibabaMosGoodsBulkinputcspuRequest.SpuInputDtoDomain();
obj7.BarcodeStr = "657984red37";
obj7.BrandId = "10129";
obj7.BrandName = "阿迪达斯";
obj7.CatName = "运动";
obj7.Cid = "35875";
obj7.Id = "1000008331485";
obj7.IsNew = true;
obj7.Material = "http://img.taobao.com/img/549.jpg";
obj7.Mdesc = "适合手机端展示的产品描述";
obj7.PcDesc = "适合PC端展示的产品描述";
obj7.PicUrl = "http://img.taobao.com/img/549.jpg";
obj7.Price = "150.00";
obj7.ProductId = "37";
List<AlibabaMosGoodsBulkinputcspuRequest.ProductImgDtoDomain> list9 = new List<AlibabaMosGoodsBulkinputcspuRequest.ProductImgDtoDomain>();
AlibabaMosGoodsBulkinputcspuRequest.ProductImgDtoDomain obj10 = new AlibabaMosGoodsBulkinputcspuRequest.ProductImgDtoDomain();
list9.Add(obj10);
obj10.Id = 4L;
obj10.Position = 0L;
obj10.Url = "http://img.taobao.com/img/549.jpg";
obj7.ProductImgs= list9;
List<AlibabaMosGoodsBulkinputcspuRequest.PropertyDtoDomain> list12 = new List<AlibabaMosGoodsBulkinputcspuRequest.PropertyDtoDomain>();
AlibabaMosGoodsBulkinputcspuRequest.PropertyDtoDomain obj13 = new AlibabaMosGoodsBulkinputcspuRequest.PropertyDtoDomain();
list12.Add(obj13);
obj13.PAlias = "size";
obj13.PCustomName = "规格";
obj13.PId = "56854";
obj13.PName = "尺码";
obj13.VAlias = "EU_37";
obj13.VCustomName = "37";
obj13.VId = "578453";
obj13.VName = "37";
obj13.ImgUrl = "http://img.taobao.com/img/549.jpg";
obj13.Order = 0L;
obj13.PropertyType = "sale";
obj7.Props= list12;
obj7.SellPt = "产品卖点描述";
obj7.StyleNo = "657984";
obj7.SubTitle = "阿迪达斯男士上衣";
obj7.Tags = "{\"brand\": \"2342\"}";
obj7.Title = "阿迪达斯运动上衣";
obj7.TmallBrandId = "125898";
obj7.DescPicList = ""https://img.alicdn.com/imgextra/i4/912277785/O1CN0127NZpzoccfnyRgl_!!912277785.jpg"";
obj7.TmallItemId = 1234L;
obj3.SpuInputDto= obj7;
obj3.SubTitle = "阿迪达斯男士上衣";
obj3.TagPrice = "150.00";
obj3.Tags = "{\"colorCode\": \"U50\",\"colorName\": \"牛仔蓝\",\"sizeCode\": \"EU_37\",\"sizeName\": \"EU_37\",\"brand\": \"2342\"}";
obj3.Title = "阿迪达斯男士运动上衣";
obj3.TmallSkuId = 1234L;
req.CspuInputDtoList_ = list2;
AlibabaMosGoodsBulkinputcspuResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaMosGoodsBulkinputcspuRequest;
$cspu_input_dto_list = new CspuInputDto;
$cspu_input_dto_list->art_no="657984";
$cspu_input_dto_list->barcode="657984red37";
$cspu_input_dto_list->outer_id="657984red37";
$properties = new PropertyDto;
$properties->p_alias="size";
$properties->p_custom_name="规格";
$properties->p_id="56854";
$properties->p_name="尺码";
$properties->v_alias="EU_37";
$properties->v_custom_name="37";
$properties->v_id="578453";
$properties->v_name="37";
$properties->img_url="http://img.taobao.com/img/549.jpg";
$properties->order="0";
$properties->property_type="sale";
$cspu_input_dto_list->properties = $properties;
$spu_input_dto = new SpuInputDto;
$spu_input_dto->barcode_str="657984red37";
$spu_input_dto->brand_id="10129";
$spu_input_dto->brand_name="阿迪达斯";
$spu_input_dto->cat_name="运动";
$spu_input_dto->cid="35875";
$spu_input_dto->id="1000008331485";
$spu_input_dto->is_new="true";
$spu_input_dto->material="http://img.taobao.com/img/549.jpg";
$spu_input_dto->mdesc="适合手机端展示的产品描述";
$spu_input_dto->pc_desc="适合PC端展示的产品描述";
$spu_input_dto->pic_url="http://img.taobao.com/img/549.jpg";
$spu_input_dto->price="150.00";
$spu_input_dto->product_id="37";
$product_imgs = new ProductImgDto;
$product_imgs->id="4";
$product_imgs->position="0";
$product_imgs->url="http://img.taobao.com/img/549.jpg";
$spu_input_dto->product_imgs = $product_imgs;
$props = new PropertyDto;
$props->p_alias="size";
$props->p_custom_name="规格";
$props->p_id="56854";
$props->p_name="尺码";
$props->v_alias="EU_37";
$props->v_custom_name="37";
$props->v_id="578453";
$props->v_name="37";
$props->img_url="http://img.taobao.com/img/549.jpg";
$props->order="0";
$props->property_type="sale";
$spu_input_dto->props = $props;
$spu_input_dto->sell_pt="产品卖点描述";
$spu_input_dto->style_no="657984";
$spu_input_dto->sub_title="阿迪达斯男士上衣";
$spu_input_dto->tags="{\"brand\": \"2342\"}";
$spu_input_dto->title="阿迪达斯运动上衣";
$spu_input_dto->tmall_brand_id="125898";
$spu_input_dto->desc_pic_list="[\"https://img.alicdn.com/imgextra/i4/912277785/O1CN0127NZpzoccfnyRgl_!!912277785.jpg\"]";
$spu_input_dto->tmall_item_id="1234";
$cspu_input_dto_list->spu_input_dto = $spu_input_dto;
$cspu_input_dto_list->sub_title="阿迪达斯男士上衣";
$cspu_input_dto_list->tag_price="150.00";
$cspu_input_dto_list->tags="{\"colorCode\": \"U50\",\"colorName\": \"牛仔蓝\",\"sizeCode\": \"EU_37\",\"sizeName\": \"EU_37\",\"brand\": \"2342\"}";
$cspu_input_dto_list->title="阿迪达斯男士运动上衣";
$cspu_input_dto_list->tmall_sku_id="1234";
$req->setCspuInputDtoList(json_encode($cspu_input_dto_list));
$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=alibaba.mos.goods.bulkinputcspu' \
-d 'partner_id=apidoc' \
-d 'session=a346e522-2af7-4172-97ed-03d28c5aea78' \
-d 'sign=C068EE6422015B8E95BF41D766EE40A2' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-23+03%3A33%3A08' \
-d 'v=2.0' \
-d 'cspu_input_dto_list=null'

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

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

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

XML示例
JSON示例

<alibaba_mos_goods_bulkinputcspu_response>
    <data>
        <cspu_result_list>
            <input_cspu_result>
                <cspu_id>10000005642</cspu_id>
                <message>错误信息</message>
                <outer_id>id</outer_id>
                <success>true</success>
            </input_cspu_result>
        </cspu_result_list>
    </data>
</alibaba_mos_goods_bulkinputcspu_response>

{
    "alibaba_mos_goods_bulkinputcspu_response":{
        "data":{
            "cspu_result_list":{
                "input_cspu_result":[
                    {
                        "cspu_id":"10000005642",
                        "message":"错误信息",
                        "outer_id":"id",
                        "success":true
                    }
                ]
            }
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案
500	应用逻辑错误	根据具体错误信息提示解决

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

银泰scm-openapi

alibaba.mos.goods.bulkinputcspu (批量录入商品信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ