文档中心 > API类目 > 银泰开放平台

alibaba.mos.inventory.search (库存查询)

开放平台-库存查询 查询有延时,不能用于库存同步使用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
counter_no String 必须 HZ01-56885 专柜号
outer_ids String [] 必须 123456,67898
  • 最大列表长度:30
  • outer id,【注意】传入的outer id 最多不能超过30个
    warehouse_no String 可选 34996 仓号

    响应参数

    名称 类型 示例值 描述
    result ResultDo {} 返回结果
    • data
    • IsvInventoryPageQueryResultDto
    • {}
    • 返回数据
    • list
    • InventoryIsvDetailDto []
    • []
    • 返回的数据集合
    • └ available_qty
    • String
    • 10
    • 可售库存数(不含残品数量)
    • └ barcode
    • String
    • TM6155710299
    • 条码
    • └ category
    • String
    • 男士上衣
    • 类目
    • └ counter_name
    • String
    • 百丽
    • 专柜名
    • └ counter_no
    • String
    • 17312
    • 专柜号
    • └ defective_qty
    • String
    • 1
    • 返回残品数量
    • └ goods_status
    • String
    • 常销
    • 商品状态
    • └ goods_type
    • String
    • 普通商品
    • 商品类型
    • └ item_id
    • String
    • 10000019611903
    • item id
    • └ modified_time
    • String
    • 2021-05-12 01:03:43.000
    • 更新时间
    • └ occupy_qty
    • String
    • 1
    • 占库数量
    • └ presale_plan_qty
    • String
    • 120
    • 配置的预售数量
    • └ presale_remaining_qty
    • String
    • 10
    • 预售剩余数量
    • └ presale_status
    • String
    • 预售
    • 预售状态
    • └ quantity
    • String
    • 10
    • 在库数量
    • └ sale_property
    • String
    • 尺码:265*135*75MM/颜色:浅绿
    • 颜色/尺码/规格
    • └ sku_id
    • String
    • 10002122560254
    • sku id
    • └ sku_name
    • String
    • 时尚耐克男士上衣
    • 商品名称
    • └ store_name
    • String
    • 随州新世纪
    • 门店名称
    • └ store_no
    • String
    • E06
    • 门店号
    • └ style_no
    • String
    • 10018
    • 款号
    • └ warehouse_name
    • String
    • 随州新世纪(W随购)
    • 仓库名称
    • └ warehouse_number
    • String
    • 366985
    • 仓号
    • └ warehouse_type
    • String
    • 专柜仓
    • 仓库类型
    • └ outer_id
    • String
    • 12345678
    • outer id
    • └ total_count
    • Number
    • 11
    • 满足条件查询结果的总的数据条数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaMosInventorySearchRequest req = new AlibabaMosInventorySearchRequest();
    req.setCounterNo("HZ01-56885");
    req.setOuterIds("123456,67898");
    req.setWarehouseNo("34996");
    AlibabaMosInventorySearchResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_mos_inventory_search_response>
        <result>
            <data>
                <list>
                    <inventory_isv_detail_dto>
                        <available_qty>10</available_qty>
                        <barcode>TM6155710299</barcode>
                        <category>男士上衣</category>
                        <counter_name>百丽</counter_name>
                        <counter_no>17312</counter_no>
                        <defective_qty>1</defective_qty>
                        <goods_status>常销</goods_status>
                        <goods_type>普通商品</goods_type>
                        <item_id>10000019611903</item_id>
                        <occupy_qty>1</occupy_qty>
                        <presale_plan_qty>120</presale_plan_qty>
                        <presale_remaining_qty>10</presale_remaining_qty>
                        <presale_status>预售</presale_status>
                        <quantity>10</quantity>
                        <sale_property>尺码:265*135*75MM/颜色:浅绿</sale_property>
                        <sku_id>10002122560254</sku_id>
                        <sku_name>时尚耐克男士上衣</sku_name>
                        <store_name>随州新世纪</store_name>
                        <store_no>E06</store_no>
                        <style_no>10018</style_no>
                        <warehouse_name>随州新世纪(W随购)</warehouse_name>
                        <warehouse_number>366985</warehouse_number>
                        <warehouse_type>专柜仓</warehouse_type>
                        <outer_id>12345678</outer_id>
                    </inventory_isv_detail_dto>
                </list>
                <total_count>11</total_count>
            </data>
        </result>
    </alibaba_mos_inventory_search_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

    返回
    顶部