文档中心 > API类目 > 物流宝API

taobao.wlb.inventory.detail.get (查询库存详情)

查询库存详情,通过商品ID获取发送请求的卖家的库存详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 111 商品ID
inventory_type_list String [] 可选 VENDIBLE
  • 最大列表长度:20
  • 库存类型列表,值包括: VENDIBLE--可销售库存 FREEZE--冻结库存 ONWAY--在途库存 DEFECT--残次品库存 ENGINE_DAMAGE--机损 BOX_DAMAGE--箱损 EXPIRATION--过保
    store_code String 可选 abc 仓库编码

    响应参数

    名称 类型 示例值 描述
    inventory_list WlbInventory [] 1 库存详情对象。其中包括货主ID,仓库编码,库存,库存类型等属性
    • └ user_id
    • Number
    • 111
    • 货主ID
    • └ item_id
    • Number
    • 111
    • 商品ID
    • └ store_code
    • String
    • abc
    • 仓库编码,关联到仓库类型服务的编码非托管库存(卖家自己管理的库存,物流宝不可见又称自有库存)的所在仓库编码: STORE_SYS_PRIVATE
    • └ quantity
    • Number
    • 100
    • 可销库存数量(库存总数-拍下预扣数-占用数)
    • └ lock_quantity
    • Number
    • 20
    • 冻结(锁定)数量,用来跟踪库存的中间状态,比如前台销售了1件商品,这时lock加1,当商品出库的时候lock再减回去
    • └ reserve_quantity
    • Number
    • 1
    • 系统自动生成
    • └ occupy_quantity
    • Number
    • 1
    • 系统自动生成
    • └ type
    • String
    • VENDIBLE
    • VENDIBLE--可销售库存 FREEZE--冻结库存 ONWAY--在途库存 DEFECT--残次品库存
    item_id Number 111 入参的item_id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    WlbInventoryDetailGetRequest req = new WlbInventoryDetailGetRequest();
    req.setItemId(111L);
    req.setInventoryTypeList("VENDIBLE");
    req.setStoreCode("abc");
    WlbInventoryDetailGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <wlb_inventory_detail_get_response>
        <inventory_list>
            <wlb_inventory>
                <user_id>111</user_id>
                <item_id>111</item_id>
                <store_code>abc</store_code>
                <quantity>100</quantity>
                <lock_quantity>20</lock_quantity>
                <reserve_quantity>1</reserve_quantity>
                <occupy_quantity>1</occupy_quantity>
                <type>VENDIBLE</type>
            </wlb_inventory>
        </inventory_list>
        <item_id>111</item_id>
    </wlb_inventory_detail_get_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>

    错误码解释

    错误码 错误描述 解决方案
    isp.wlb-error:00002 系统异常 联系isp
    isv.wlb-error:00005 参数为空 检查入参并修改
    isv.wlb-error:20001 商品不存在 检查入参并修改
    isv.wlb-error:20002 无效仓库 检查入参并修改

    API工具

    如何获得此API

    FAQ

    返回
    顶部