taobao.scitem.add (发布后端商品)

发布后端商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_name String 必须 宝贝 商品名称
outer_code String 必须 商家编码 商家编码
item_type Number 可选 0
  • 默认值:0
  • 0.普通供应链商品 1.供应链组合主商品
    properties String 可选 111:222;333:444 商品属性格式是 p1:v1,p2:v2,p3:v3
    bar_code String 可选 条形码 条形码
    wms_code String 可选 仓储商编码 仓储商编码
    is_friable Number 可选 0 是否易碎 0:不是 1:是
    is_dangerous Number 可选 0 是否危险 0:不是 1:是
    is_costly Number 可选 0 是否是贵重品 0:不是 1:是
    is_warranty Number 可选 0 是否保质期:0:不是 1:是
    weight Number 可选 1 重量 单位:g
    length Number 可选 1 长度 单位:mm
    width Number 可选 1 宽 单位:mm
    height Number 可选 1 高 单位:mm
    volume Number 可选 1 体积:立方厘米
    price Number 可选 1 价格 单位:分
    remark String 可选 remark remark
    matter_status Number 可选 0 0:液体,1:粉体,2:固体
    brand_id Number 可选 1 品牌id
    brand_name String 可选 brand_Name brand_Name
    spu_id Number 可选 1234 spuId或是cspuid
    is_area_sale Number 可选 1
  • 默认值:0
  • 1表示区域销售,0或是空是非区域销售

    响应参数

    名称 类型 示例值 描述
    sc_item ScItem 1 后台商品信息
    • └ weight
    • Number
    • 1000
    • 重量.单位:克
    • └ bar_code
    • String
    • NMB12341
    • 条形码
    • └ remark
    • String
    • 备注
    • 备注
    • └ width
    • Number
    • 1000
    • 宽 单位:mm
    • └ brand_id
    • Number
    • 111
    • 品牌id
    • └ properties
    • String
    • height:20;length:5
    • 商品属性格式是 p1:v1,p2:v2,p3:v3
    • └ brand_name
    • String
    • 品牌名称
    • 品牌名称
    • └ wms_code
    • String
    • 仓储商编码
    • 仓储商编码,可以支持多个,格式wmsname:code
    • └ is_friable
    • Boolean
    • true
    • 是否易碎 false :不是 true:是
    • └ is_warranty
    • Boolean
    • true
    • 是否保质期:false:不是 true:是
    • └ price
    • Number
    • 1000
    • 价格:分(吊牌价)
    • └ height
    • Number
    • 1000
    • 高 单位:mm
    • └ is_dangerous
    • Boolean
    • true
    • 是否危险 false:不是 true:是
    • └ item_name
    • String
    • 秋装款式1
    • 商品名称
    • └ item_id
    • Number
    • 12345678
    • 商品id
    • └ is_costly
    • Boolean
    • true
    • 贵重品:false:不是 true:是
    • └ outer_code
    • String
    • GLY111222
    • 商家编码
    • └ volume
    • Number
    • 1000
    • 体积:立方厘米
    • └ length
    • Number
    • 1000
    • 长度 单位:mm
    • └ matter_status
    • String
    • LIQUID
    • LIQUID:液体,1:粉体,SOLID:固体
    • └ item_type
    • Number
    • 1
    • 1.普通供应链商品 2.供应链组合主商品

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ScitemAddRequest req = new ScitemAddRequest();
    req.setItemName("宝贝");
    req.setOuterCode("商家编码");
    req.setItemType(0L);
    req.setProperties("111:222;333:444");
    req.setBarCode("条形码");
    req.setWmsCode("仓储商编码");
    req.setIsFriable(0L);
    req.setIsDangerous(0L);
    req.setIsCostly(0L);
    req.setIsWarranty(0L);
    req.setWeight(1L);
    req.setLength(1L);
    req.setWidth(1L);
    req.setHeight(1L);
    req.setVolume(1L);
    req.setPrice(1L);
    req.setRemark("remark");
    req.setMatterStatus(0L);
    req.setBrandId(1L);
    req.setBrandName("brand_Name");
    req.setSpuId(1234L);
    req.setIsAreaSale(1L);
    ScitemAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <scitem_add_response>
        <sc_item>
            <weight>1000</weight>
            <bar_code>NMB12341</bar_code>
            <remark>备注</remark>
            <width>1000</width>
            <brand_id>111</brand_id>
            <properties>height:20;length:5</properties>
            <brand_name>品牌名称</brand_name>
            <wms_code>仓储商编码</wms_code>
            <is_friable>true</is_friable>
            <is_warranty>true</is_warranty>
            <price>1000</price>
            <height>1000</height>
            <is_dangerous>true</is_dangerous>
            <item_name>秋装款式1</item_name>
            <item_id>12345678</item_id>
            <is_costly>true</is_costly>
            <outer_code>GLY111222</outer_code>
            <volume>1000</volume>
            <length>1000</length>
            <matter_status>LIQUID</matter_status>
            <item_type>1</item_type>
        </sc_item>
    </scitem_add_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.scitem-error:20001 插入商品信息系统异常! 联系技术人支持同学查看原因
    isv.scitem-error:20002 插入商品重量为空! 重量属性不能为空
    isp.scitem-error:20111 商品userId+商家编码(outCode)或是spuid+barcode为空! 按提示检查入参
    isv.scitem-error:20003 商品重量必须在1-500000克范围之内! 重量超出范围
    isv.scitem-error:CHECK0003 入参异常 检查入参

    API工具

    如何获得此API

    FAQ

    返回
    顶部