文档中心 > API类目 > 奇门仓储API

taobao.qimen.inventory.query (库存查询接口(多商品))

taobao.qimen.inventory.query

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request InventoryQueryRequest 可选
  • criteriaList
  • Criteria []
  • 可选
  • 查询准则
  • └ warehouseCode
  • String
  • 可选
  • W1234
  • 仓库编码
  • └ ownerCode
  • String
  • 可选
  • H1234
  • 货主编码
  • └ itemCode
  • String
  • 必须
  • I1234
  • 商品编码
  • └ itemId
  • String
  • 可选
  • C1234
  • 仓储系统商品ID
  • └ inventoryType
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;ZT=在途库存;默认为查所有类型的库存)
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ extendProps
  • Map
  • 可选
  • 扩展属性
  • └ remark
  • String
  • 可选
  • 备注
  • 备注

响应参数

名称 类型 示例值 描述
response InventoryQueryResponse
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息
  • items
  • Item []
  • 商品的库存信息列表
  • └ warehouseCode
  • String
  • C1234
  • 仓库编码
  • └ itemCode
  • String
  • I1234
  • 商品编码
  • └ itemId
  • String
  • W1234
  • 仓储系统商品ID
  • └ inventoryType
  • String
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS= 箱损;ZT=在途库存)
  • └ quantity
  • Number
  • 11
  • 未冻结库存数量
  • └ lockQuantity
  • Number
  • 1
  • 冻结库存数量
  • └ batchCode
  • String
  • P1234
  • 批次编码
  • └ productDate
  • String
  • 2017-09-09
  • 商品生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 2017-09-09
  • 商品过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • P1234
  • 生产批号

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenClient client = new DefaultQimenClient(url, appkey, secret);
InventoryQueryRequest req = new InventoryQueryRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
List<Criteria> list2 = new ArrayList<Criteria>();
Criteria obj3 = new Criteria();
list2.add(obj3);
obj3.setWarehouseCode("W1234");
obj3.setOwnerCode("H1234");
obj3.setItemCode("I1234");
obj3.setItemId("C1234");
obj3.setInventoryType("ZP");
obj3.setRemark("备注");
req.setCriteriaList(list2);
req.setRemark("备注");
InventoryQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
    <items>
        <item>
            <warehouseCode>C1234</warehouseCode>
            <itemCode>I1234</itemCode>
            <itemId>W1234</itemId>
            <inventoryType>ZP</inventoryType>
            <quantity>11</quantity>
            <lockQuantity>1</lockQuantity>
            <batchCode>P1234</batchCode>
            <productDate>2017-09-09</productDate>
            <expireDate>2017-09-09</expireDate>
            <produceCode>P1234</produceCode>
        </item>
    </items>
</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.http-connection-timeout
isp.http-read-timeout
parameter-error
http-service-unknown-error
isp.http-connection-refuse
isp.http-closed

API工具

如何获得此API

FAQ

返回
顶部