taobao.scitem.query (查询后端商品)

查询后端商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_name String 可选 商品名称 商品名称
outer_code String 可选 yifu0002 商家给商品的一个编码
wms_code String 可选 仓库编码 仓库编码
bar_code String 可选 条形码 条形码
item_type Number 可选 1 ITEM类型(只允许输入以下英文或空) NORMAL 0:普通商品; COMBINE 1:是否是组合商品 DISTRIBUTION
page_index Number 可选 1 当前页码数
page_size Number 可选 1 分页记录个数,如果用户输入的记录数大于50,则一页显示50条记录

响应参数

名称 类型 示例值 描述
sc_item_list ScItem [] 1 List
  • └ 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.供应链组合主商品
  • └ is_area_sale
  • Number
  • 1
  • 1表示区域销售,0或是空是非区域销售
  • └ options
  • Number
  • 16
  • 后端商品options字段
total_page Number 50 商品条数
query_pagination QueryPagination 分页
  • └ page_index
  • Number
  • 1
  • 当前页码数
  • └ page_size
  • Number
  • 20
  • 分页记录个数,如果用户输入的记录数大于50,则一页显示50条记录

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ScitemQueryRequest req = new ScitemQueryRequest();
req.setItemName("商品名称");
req.setOuterCode("yifu0002");
req.setWmsCode("仓库编码");
req.setBarCode("条形码");
req.setItemType(1L);
req.setPageIndex(1L);
req.setPageSize(1L);
ScitemQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<scitem_query_response>
    <sc_item_list>
        <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>
            <is_area_sale>1</is_area_sale>
            <options>16</options>
        </sc_item>
    </sc_item_list>
    <total_page>50</total_page>
    <query_pagination>
        <page_index>1</page_index>
        <page_size>20</page_size>
    </query_pagination>
</scitem_query_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:20012 分页查询商品信息时,系统异常! 查询异常,请重试。

API工具

如何获得此API

FAQ

返回
顶部