文档中心 > API类目 > 零售终端API

tmall.nr.item.query (商品域商品查询接口)

商品域商品查询接口;首次开放(目前使用方:天鲜配)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query ItemQueryDto 必须 查询参数
  • └ biz_code
  • String
  • 必须
  • txp
  • biz_code
  • └ page_num
  • Number
  • 可选
  • 1
  • page_num
  • └ bar_code
  • String
  • 可选
  • 12321
  • bar_code条码
  • └ page_size
  • Number
  • 可选
  • 1
  • page_size
  • └ store_id
  • Number
  • 可选
  • 12
  • 门店id
  • └ outer_id
  • String
  • 可选
  • 12312
  • 外部id
  • └ sc_item_id
  • Number
  • 可选
  • 123321
  • scm 商品id
  • └ query_d_b
  • Boolean
  • 可选
  • false
  • 是否查询DB
  • └ item_id
  • Number
  • 可选
  • 234234
  • 商品id

响应参数

名称 类型 示例值 描述
result ResultDo 返回结果
  • └ succ
  • Boolean
  • 结果状态
  • └ code
  • String
  • 0
  • 错误码
  • └ msg
  • String
  • 描述
  • data
  • PaginationDo
  • 数据体
  • data_list
  • ItemDto []
  • 商品列表
  • └ title
  • String
  • 商品名称
  • └ outer_id
  • String
  • 商家自定义商品编码
  • └ bar_code
  • String
  • 条码
  • └ store_id
  • Number
  • 门店id
  • └ item_id
  • Number
  • 商品id
  • └ pic_url
  • String
  • 主图
  • └ sc_item_name
  • String
  • 货品名称
  • └ sc_item_id
  • Number
  • 货品id
  • └ item_price
  • Number
  • 一口价
  • └ sale_spec
  • String
  • 销售规格
  • └ sale_unit
  • String
  • 销售单位
  • └ media_urls
  • String []
  • 商品图片,首张为主图
  • └ is_standard_good
  • Number
  • 0
  • 是否标品{0:非标品,1:标品}
  • └ status
  • Number
  • 1
  • 商品状态->(同IC的auction_status,必填)
  • attributes
  • Attributes
  • 属性集合
  • └ special_price_buy
  • Boolean
  • 是否特殊购买
  • └ store_condition
  • String
  • 存放条件
  • └ net_content
  • String
  • 净含量
  • └ spec_scale
  • String
  • 规格比例
  • └ need_logistics
  • Number
  • 需要配送
  • └ extend_media_urls
  • String []
  • 详情图片
  • └ self_status
  • Number
  • scm商品状态{9:上架,-9:下架},枚举

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrItemQueryRequest req = new TmallNrItemQueryRequest();
TmallNrItemQueryRequest.ItemQueryDto obj1 = new TmallNrItemQueryRequest.ItemQueryDto();
obj1.setBizCode("txp");
obj1.setPageNum(1L);
obj1.setBarCode("12321");
obj1.setPageSize(1L);
obj1.setStoreId(12L);
obj1.setOuterId("12312");
obj1.setScItemId(123321L);
obj1.setQueryDB(false);
obj1.setItemId(234234L);
req.setQuery(obj1);
TmallNrItemQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nr_item_query_response>
    <result>
        <succ></succ>
        <code>0</code>
        <msg></msg>
        <data>
            <data_list>
                <item_dto>
                    <title></title>
                    <outer_id></outer_id>
                    <bar_code></bar_code>
                    <store_id></store_id>
                    <item_id></item_id>
                    <pic_url></pic_url>
                    <sc_item_name></sc_item_name>
                    <sc_item_id></sc_item_id>
                    <item_price></item_price>
                    <sale_spec></sale_spec>
                    <sale_unit></sale_unit>
                    <media_urls>
                        <string></string>
                    </media_urls>
                    <is_standard_good>0</is_standard_good>
                    <status>1</status>
                    <attributes>
                        <special_price_buy></special_price_buy>
                        <store_condition></store_condition>
                        <net_content></net_content>
                        <spec_scale></spec_scale>
                        <need_logistics></need_logistics>
                        <extend_media_urls>
                            <string></string>
                        </extend_media_urls>
                    </attributes>
                    <self_status></self_status>
                </item_dto>
            </data_list>
        </data>
    </result>
</tmall_nr_item_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部