简要描述:

  • 库存查询(多条件)

接口说明:

  • 1.1接口描述:到WMS查询库存信息
  • 1.2接口说明:ERP通过奇门调用该接口,FMS调用奇门接口往WMS查询库存信息
  • 1.3接口方法: taobao.qimen.stock.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

参数名 字段 是否必须 类型 说明
仓库编码 warehouseCode String 仓库编码
货主编码 ownerCode String 货主编码
商品编码 itemCode String 商品编码
仓储系统商品ID itemId String 仓储系统商品ID
库存类型 inventoryType String 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;ZT=在途库存;默认为查所有类型的库存)
批次编码 batchCode String 批次编码
商品生产日期 productDate String 商品生产日期(YYYY-MM-DD)
商品过期日期 expireDate String 商品过期日期(YYYY-MM-DD)
当前页 page Number 当前页(从1开始)
每页条数 pageSize Number 每页条数(最多100条)
扩展属性 extendProps Map 扩展属性
备注 remark String 备注

返回参数:

response

参数名 类型 说明
flag String 响应结果:success
code String 响应码
message String 响应信息
totalCount Number 总数
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 生产批号
itemName String 商品名称
barCode String 产品的国际标准条码(69码)

请求示例(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>
    <totalCount>100</totalCount>
    <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>
            <itemName>天猫精灵</itemName>
            <barCode>69xxxxxxxxx</barCode>
        </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-07 14:49   作者:石明科