简要描述:

  • 库存查询(多商品)

接口说明:

  • 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   作者:石明科