文档中心 > API类目 > 菜鸟仓配API

taobao.wlb.wms.inventory.query (菜鸟商品库存查询)

支持按汇总(不分批次和渠道的总的库存数量)、渠道、批次三类方式查询商品实时库存

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 可选 25 每页多少条,最大50条
page_no Number 可选 2 分页的第几页
channel_code String 可选 OTHERS 渠道编码,type=3时字段传值有效。(TB 淘系, OTHERS 其他)
due_date Date 可选 2015-09-06 10:23:21 失效日期,type=2时字段传值有效。
produce_date Date 可选 2015-09-06 12:09:13 生产日期,type=2时字段传值有效。
batch_code String 可选 3434324324 库存批次号,type=2时字段传值有效。 商品设置为批次管理时,商品产生批次库存。当商品为批次管理时,此字段不传值,返回所有批次库存信息。
type Number 可选 2 库存查询类型 1- 汇总库存,不区分批次和渠道 2- 批次库存,库存按商品批次维度划分 3- 渠道库存,库存按渠道维度划分 (当前业务不支持批次库存和渠道库存共存,批次库存无渠道属性,渠道库存无批次属性)
inventory_type Number 可选 1 库存类型。 (1 正品 101 残次 102 机损 103 箱损 201 冻结库存 301 在途库存 )
store_code String 可选 STORE_3849 仓库编码
item_id String 可选 38438494 菜鸟商品ID

响应参数

名称 类型 示例值 描述
item_list WmsInventoryQueryItemlist [] 商品详情列表
  • item
  • WmsInventoryQueryItem
  • 商品详情
  • └ lock_quantity
  • Number
  • 1
  • 锁库存数量
  • └ quantity
  • Number
  • 123
  • 库存数量
  • └ due_date
  • Date
  • 2015-09-06 15:34:20
  • 失效日期,type=2时字段有返回值。
  • └ produce_date
  • Date
  • 2014-09-06 15:34:20
  • 生产日期,type=2时字段有返回值
  • └ batch_code
  • String
  • 8767868
  • 库存批次号,type=2时字段有返回值。
  • └ channel_code
  • String
  • TB
  • 渠道编码,type=3时字段有返回值。(TB 淘系,OTHERS 其他)
  • └ inventory_type
  • Number
  • 101
  • 库存类型(1 正品 101 残次 102 机损 103 箱损 201 冻结库存 301 在途库存 )
  • └ item_id
  • String
  • 234234234
  • 商品ID
  • └ store_code
  • String
  • KJ-0003
  • 仓库编码
total_count Number 122 总数
wl_error_code String B3098093 错误代码
wl_error_msg String wrong 错误信息
wl_success Boolean true 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WlbWmsInventoryQueryRequest req = new WlbWmsInventoryQueryRequest();
req.setPageSize(25L);
req.setPageNo(2L);
req.setChannelCode("OTHERS");
req.setDueDate(StringUtils.parseDateTime("2015-09-06 10:23:21"));
req.setProduceDate(StringUtils.parseDateTime("2015-09-06 12:09:13"));
req.setBatchCode("3434324324");
req.setType(2L);
req.setInventoryType(1L);
req.setStoreCode("STORE_3849");
req.setItemId("38438494");
WlbWmsInventoryQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<wlb_wms_inventory_query_response>
    <item_list>
        <wms_inventory_query_itemlist>
            <item>
                <lock_quantity>1</lock_quantity>
                <quantity>123</quantity>
                <due_date>2015-09-06 15:34:20</due_date>
                <produce_date>2014-09-06 15:34:20</produce_date>
                <batch_code>8767868</batch_code>
                <channel_code>TB</channel_code>
                <inventory_type>101</inventory_type>
                <item_id>234234234</item_id>
                <store_code>KJ-0003</store_code>
            </item>
        </wms_inventory_query_itemlist>
    </item_list>
    <total_count>122</total_count>
    <wl_error_code>B3098093</wl_error_code>
    <wl_error_msg>wrong</wl_error_msg>
    <wl_success>true</wl_success>
</wlb_wms_inventory_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>

错误码解释

错误码 错误描述 解决方案
MAC999 WHC服务过载限流 服务商稍后重试

API工具

如何获得此API

FAQ

返回
顶部