文档中心 > API类目 > 天猫新零售

tmall.nr.seller.store.query (门店商品库存查询)

卖家根据ItemId,门店ID列表查询库存

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
store_codes String [] 可选 1839099322
  • 最大列表长度:20
  • 门店或仓库ID
    store_type Number 可选 6
  • 默认值:6
  • 门店类型,6:电商仓
    item_id String 必须 569313538589 商品ID

    响应参数

    名称 类型 示例值 描述
    result NrResult 返回结果
    • result_datas
    • NrItemStoreInventoryRespDto []
    • 返回结果
    • └ store_code
    • String
    • 1839099322
    • 门店ID
    • nr_sku_inventory_resp_d_t_o_list
    • NrSkuInventoryRespDto []
    • 对应的sku级别库存,如果没有sku,则属性sku为null
    • └ available_quantity
    • Number
    • 0
    • 可用库存
    • └ sellable_quantity
    • Number
    • 0
    • 可售库存
    • └ occupy_quantity
    • Number
    • 0
    • 占用库存
    • └ withholding_quantity
    • Number
    • 0
    • 预扣库存
    • └ in_bound_quantity
    • Number
    • 0
    • 采购入库库存
    • └ quantity
    • Number
    • 0
    • 物理库存
    • └ inventory_id
    • String
    • 123462456664
    • 库存ID
    • └ item_id
    • String
    • 45432345632
    • 后端库存商品ID
    • └ sku_id
    • String
    • 2435351
    • skuID
    • └ item_id
    • String
    • 569313538589
    • 商品ID
    • └ error_message
    • String
    • 错误信息
    • └ error_code
    • String
    • 错误编码
    • └ is_success
    • Boolean
    • 请求是否成功
    • └ inner_msg
    • String
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallNrSellerStoreQueryRequest req = new TmallNrSellerStoreQueryRequest();
    req.setStoreCodes("1839099322");
    req.setStoreType(6L);
    req.setItemId("569313538589");
    TmallNrSellerStoreQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_nr_seller_store_query_response>
        <result>
            <result_datas>
                <nr_item_store_inventory_resp_dto>
                    <store_code>1839099322</store_code>
                    <nr_sku_inventory_resp_d_t_o_list>
                        <nr_sku_inventory_resp_dto>
                            <available_quantity>0</available_quantity>
                            <sellable_quantity>0</sellable_quantity>
                            <occupy_quantity>0</occupy_quantity>
                            <withholding_quantity>0</withholding_quantity>
                            <in_bound_quantity>0</in_bound_quantity>
                            <quantity>0</quantity>
                            <inventory_id>123462456664</inventory_id>
                            <item_id>45432345632</item_id>
                            <sku_id>2435351</sku_id>
                        </nr_sku_inventory_resp_dto>
                    </nr_sku_inventory_resp_d_t_o_list>
                    <item_id>569313538589</item_id>
                </nr_item_store_inventory_resp_dto>
            </result_datas>
            <error_message></error_message>
            <error_code></error_code>
            <is_success></is_success>
            <inner_msg></inner_msg>
        </result>
    </tmall_nr_seller_store_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

    返回
    顶部