文档中心 > API类目 > 银泰开放平台

alibaba.mos.goods.open.cspu.create (单品信息录入)

创建单品信息（条码粒度）和outerId映射关系使用参考 public void create() { TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); AlibabaMosGoodsOpenCspuCreateResponse rsp = client.execute(req, sessionKey); if (rsp.isSuccess()) { /** * 数据新增成功并且 outerId 对应关系创建成功 * 或者数据已经存在仅创建对应关系 * todo: 相应的下一步操作 * 1、例如：入库 * 2、如果要更新商品内容请调用 update * */ } else { if (!"isv.data_existed".equals(rsp.getSubCode())) { /** 数据和ouerId 关系已经存在不做任何更改 * todo: 相应的下一步操作 * 1、如果要更新商品内容请调用 update * 2、如果是要入库可以和 isSuccess 一样对待 * */ } else { /**todo:失败 rsp.getSubMsg() 打印出来**/ } } }

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	更多限制	描述
open_cspu_create_dto	OpenCspuCreateDto	可选			单品创建入参
└ art_no String 必须 TM0001111 货号[条码款号货号长度只允许3-32位字符] └ barcode String 必须 TM000111111 条码[条码款号货号长度只允许3-32位字符] └ intime_brand_id Number 必须 11328 银泰品牌id └ outer_id String 必须 1010101101 商家单品id props GoodsPropertyDto [] 必须销售属性：【标准1】文本级销售属性【propertyName：valueCustomName】颜色：红，颜色编码：111，尺码，s，尺码编码：160 —————————————— 【标准2】天猫类目级销售属性规范格式1:pid:vid:别名;pid1:vid1:别名1。pid必传，如果没有vid的情况可以使用自定义文本例如：123:56:蓝色、123：红色 └ property_id String 可选 120627 属性id └ property_name String 必须颜色分类属性名称 └ property_sort_order Number 可选 1 属性排序 └ value_id String 可选 1211 属性值id └ value_name String 可选红色属性值名称 └ value_sort_order Number 可选 1 属性值排序 └ value_custom_name String 可选深红色属性值自定义名称 └ title String 必须测试标题标题 └ init_category_id Number 可选 1111 初始化类目 └ style_no String 必须 TM0001111 款号 └ tag_price Number 可选 1000 吊牌价-单位分 extended_fields ExtendedFieldVo [] 可选扩展字段 └ key String 可选 season key例:exampleImageUrl\year\season\sex └ value String 可选春季节 └ goods_type String 可选 NORMAL 目前只支持赠品(GIVEAWAY)和普通商品(NORMAL) 默认 NORMAL GIVEAWAY

响应参数

名称	类型	示例值	描述
data	Number	10002059220522	银泰共享单品(cspu)id

请求示例

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosGoodsOpenCspuCreateRequest req = new AlibabaMosGoodsOpenCspuCreateRequest();
AlibabaMosGoodsOpenCspuCreateRequest.OpenCspuCreateDto obj1 = new AlibabaMosGoodsOpenCspuCreateRequest.OpenCspuCreateDto();
obj1.setArtNo("TM0001111");
obj1.setBarcode("TM000111111");
obj1.setIntimeBrandId(11328L);
obj1.setOuterId("1010101101");
List<AlibabaMosGoodsOpenCspuCreateRequest.GoodsPropertyDto> list3 = new ArrayList<AlibabaMosGoodsOpenCspuCreateRequest.GoodsPropertyDto>();
AlibabaMosGoodsOpenCspuCreateRequest.GoodsPropertyDto obj4 = new AlibabaMosGoodsOpenCspuCreateRequest.GoodsPropertyDto();
list3.add(obj4);
obj4.setPropertyId("120627");
obj4.setPropertyName("颜色分类");
obj4.setPropertySortOrder(1L);
obj4.setValueId("1211");
obj4.setValueName("红色");
obj4.setValueSortOrder(1L);
obj4.setValueCustomName("深红色");
obj1.setProps(list3);
obj1.setTitle("测试标题");
obj1.setInitCategoryId(1111L);
obj1.setStyleNo("TM0001111");
obj1.setTagPrice(1000L);
List<AlibabaMosGoodsOpenCspuCreateRequest.ExtendedFieldVo> list6 = new ArrayList<AlibabaMosGoodsOpenCspuCreateRequest.ExtendedFieldVo>();
AlibabaMosGoodsOpenCspuCreateRequest.ExtendedFieldVo obj7 = new AlibabaMosGoodsOpenCspuCreateRequest.ExtendedFieldVo();
list6.add(obj7);
obj7.setKey("season");
obj7.setValue("春");
obj1.setExtendedFields(list6);
obj1.setGoodsType("NORMAL");
req.setOpenCspuCreateDto(obj1);
AlibabaMosGoodsOpenCspuCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<alibaba_mos_goods_open_cspu_create_response>
    <data>10002059220522</data>
</alibaba_mos_goods_open_cspu_create_response>

异常示例

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>

错误码解释

错误码	错误描述	解决方案
ID_MAPPING_EXISTED	crete接口报错: ID_MAPPING_EXISTED:商品已存在请调用Update接口 INVALID_PARAMETER:参数非法请检查其他值请参考 msg 字段	商品已存在请调用Update接口
INVALID_PARAMETER	crete接口报错: ID_MAPPING_EXISTED:商品已存在请调用Update接口 INVALID_PARAMETER:参数非法请检查其他值请参考 msg 字段	参数非法请检查
isv.data_existed	数据已存在不需要重复创建 1、如果要更新商品内容请调用 update 2、如果是要入库可以和 isSuccess 一样对待	1、如果要更新商品内容请调用 update 2、如果是要入库可以和 isSuccess 一样对待
isv.brand_unauthorized	品牌未授权	请联系下工作人员

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部