文档中心 > 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() 打印出来**/ } } }

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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

FAQ

返回
顶部