简要描述:
- 库存查询(多商品)
接口说明:
- 1.1接口描述:到WMS查询库存信息
- 1.2接口说明:ERP通过奇门调用该接口,FMS调用奇门接口往WMS查询库存信息
- 1.3接口方法:taobao.qimen.inventory.query
接口版本:
| 版本号 | 制定人 | 制定日期 | 修订日期 |
|---|---|---|---|
| 1.0.0 | 石明科 | 2020-08-04 | 2020-08-04 |
请求头:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型,统一是 application/xml |
请求参数:
公共请求参数
| 参数名 | 字段 | 是否必须 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
| WMS 的appkey | app_key | 是 | String | 应用接入时申请的 appkey | |
| 接口方法 | method | 是 | String | WMS 相关的业务接口名称,如商品信息同步的请求,method= taobao.qimen.item.synchronize | |
| 协议版本号 | v | 是 | String | 版本号 默认请传3.0 | |
| content 格式 | format | 是 | String | 目前支持 XML | |
| 加密令牌 | sign | 是 | String | 根据 url 和密钥计算的结果 | |
| 加密方法 | sign_method | 是 | String | md5 | |
| 用户id | customerid | 是 | String | WMS 颁发给用户的 ID | |
| 请求时间 | timestamp | 是 | String | yyyy-MM-dd HH:mm:ss 格式 |
request
| 参数名 | 字段 | 是否必须 | 类型 | 说明 |
|---|---|---|---|---|
| 查询准则 | criteriaList | 是 | data[] | 查询准则 |
| 扩展属性 | extendProps | 否 | Map | 扩展属性 |
| 备注 | remark | 否 | String | 备注 |
criteria
| 参数名 | 字段 | 是否必须 | 类型 | 说明 |
|---|---|---|---|---|
| 仓库编码 | warehouseCode | 否 | String | warehouseCode |
| 货主编码 | ownerCode | 否 | String | 货主编码 |
| 商品编码 | itemCode | 是 | String | 商品编码 |
| 仓储系统商品ID | itemId | 否 | String | 仓储系统商品ID |
| 库存类型 | inventoryType | 否 | String | 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;ZT=在途库存;默认为查所有类型的库存) |
| 备注 | remark | 否 | String | 备注 |
返回参数:
response
| 参数名 | 类型 | 说明 |
|---|---|---|
| flag | String | 响应结果:success |
| code | String | 响应码 |
| message | String | 响应信息 |
| requestId | String | 查询返回的唯一编码 |
| items | data[] | 商品的库存信息列表 |
item
| 参数名 | 类型 | 说明 |
|---|---|---|
| warehouseCode | String | 仓库编码 |
| itemCode | String | 商品编码 |
| itemId | String | 仓储系统商品ID |
| inventoryType | String | 库存类型(ZP=正品;CC=残次;JS=机损;XS= 箱损;ZT=在途库存) |
| quantity | Number | 未冻结库存数量 |
| lockQuantity | Number | 冻结库存数量 |
| batchCode | String | 批次编码 |
| productDate | String | 商品生产日期(YYYY-MM-DD) |
| expireDate | String | 商品过期日期(YYYY-MM-DD) |
| produceCode | String | 生产批号 |
请求示例(xml)
<request>
<criteriaList>
<criteria>
<warehouseCode>仓库编码, string (50) </warehouseCode>
<ownerCode>货主编码,string(50)</ownerCode>
<itemCode>商品编码,string(50),必填</itemCode>
<itemId>仓储系统商品ID, string (50),条件必填</itemId>
<inventoryType>库存类型,string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存,DJ=冻结,默认为查所有类型的库存</inventoryType>
</criteria>
</criteriaList>
</request>返回示例(xml):
正确时返回:
<response>
<flag>success</flag>
<code>0</code>
<message>invalid appkey</message>
<requestId>8bde9c225ba9436abbfae303ecde91d1</requestId>
<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>错误时返回:
<error_response>
<code>50</code>
<msg>Remote service error</msg>
<sub_code>isv.invalid-parameter</sub_code>
<sub_msg>非法参数</sub_msg>
<requestId>8bde9c225ba9436abbfae303ecde91d1</requestId>
</error_response>备注:
- 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2020-08-04 09:59 作者:石明科