文档中心 > API文档

taobao.jst.astrolabe.storeinventory.itemquery (库存查询接口)

查询门店或电商仓库存,该接口一次可以同时查询多个门店或电商仓的多个商品的多种类型的库存

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
stores Store [] 可选
  • 最大列表长度:20
  • 门店信息
    • └ warehouse_id
    • String
    • 可选
    • 123456
    • 门店ID(商户中心) 或 电商仓ID
    • └ warehouse_type
    • String
    • 可选
    • WAREHOUSE
    • 库存来源
    • store_inventories
    • StoreInventory []
    • 可选
    • 门店库存
    • └ sku_id
    • Number
    • 可选
    • 1111
    • 商品的SKU编码
    • └ outer_id
    • String
    • 可选
    • 111
    • ISV系统中商品编码
    • └ item_id
    • Number
    • 可选
    • 111
    • 淘宝前端商品id

    响应参数

    名称 类型 示例值 描述
    flag String success 响应标示
    qimen_code String 200 响应编码
    message String 响应信息 message
    stores Store [] 门店列表 门店列表
    • store_inventories
    • StoreInventory []
    • 门店库存列表
    • 门店库存列表
    • └ item_id
    • String
    • 111
    • 淘宝前端商品id
    • └ outer_id
    • String
    • 111
    • ISV系统中商品编码
    • └ sku_id
    • String
    • 111
    • 商品的SKU编码
    • quantity_details
    • QuantityDetail []
    • 库存量详情列表
    • 库存量详情列表
    • └ inventory_type
    • String
    • CERTAINTY
    • 库存类型
    • └ quantity
    • Number
    • 1
    • 库存数量
    • └ occupy_quantity
    • Number
    • 1
    • 占用库存
    • └ warehouse_id
    • String
    • 12345
    • 门店ID(商户中心) 或 电商仓ID
    • └ warehouse_type
    • String
    • WAREHOUSE
    • 库存来源

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    JstAstrolabeStoreinventoryItemqueryRequest req = new JstAstrolabeStoreinventoryItemqueryRequest();
    List<JstAstrolabeStoreinventoryItemqueryRequest.Store> list2 = new ArrayList<JstAstrolabeStoreinventoryItemqueryRequest.Store>();
    JstAstrolabeStoreinventoryItemqueryRequest.Store obj3 = new JstAstrolabeStoreinventoryItemqueryRequest.Store();
    list2.add(obj3);
    obj3.setWarehouseId("123456");
    obj3.setWarehouseType("WAREHOUSE");
    List<JstAstrolabeStoreinventoryItemqueryRequest.StoreInventory> list6 = new ArrayList<JstAstrolabeStoreinventoryItemqueryRequest.StoreInventory>();
    JstAstrolabeStoreinventoryItemqueryRequest.StoreInventory obj7 = new JstAstrolabeStoreinventoryItemqueryRequest.StoreInventory();
    list6.add(obj7);
    obj7.setSkuId(1111L);
    obj7.setOuterId("111");
    obj7.setItemId(111L);
    list4.setStoreInventories(list6);
    req.setStores(list2);
    JstAstrolabeStoreinventoryItemqueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <jst_astrolabe_storeinventory_itemquery_response>
        <flag>success</flag>
        <qimen_code>200</qimen_code>
        <message>响应信息</message>
        <stores>
            <store>
                <store_inventories>
                    <store_inventory>
                        <item_id>111</item_id>
                        <outer_id>111</outer_id>
                        <sku_id>111</sku_id>
                        <quantity_details>
                            <quantity_detail>
                                <inventory_type>CERTAINTY</inventory_type>
                                <quantity>1</quantity>
                                <occupy_quantity>1</occupy_quantity>
                            </quantity_detail>
                        </quantity_details>
                    </store_inventory>
                </store_inventories>
                <warehouse_id>12345</warehouse_id>
                <warehouse_type>WAREHOUSE</warehouse_type>
            </store>
        </stores>
    </jst_astrolabe_storeinventory_itemquery_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

    返回
    顶部