简要描述:

  • 入库单查询接口

接口说明:

  • 1.1接口描述:向WMS查询入库单
  • 1.2接口说明:ERP调用奇门接口,奇门调用该接口,FMS调用奇门接口向WMS查询入库单
  • 1.3接口方法:taobao.qimen.deliveryorder.query

接口版本:

版本号 制定人 制定日期 修订日期
1.0.0 黄会准 2020-08-04 2020-08-04

请求URL:

环境 HTTP地址
测试环境 http://apitest.yptcgroup.com/thirdpart/dispatcher
预发布环境 http://apiuat.yptcgroup.com/thirdpart/dispatcher
正式环境 http://api.yptcgroup.com/thirdpart/dispatcher

请求方式:

  • POST

请求头:

参数名 是否必须 类型 说明
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 格式

请求参数:

参数名 字段 是否必须 类型 说明
货主编码 ownerCode 否 String 货主编码
仓库编码 warehouseCode 否 String 仓库编码
入库单编码 entryOrderCode 是 String 入库单编码
仓储系统入库单ID entryOrderId 否 String 仓储系统入库单ID
交易单号 orderSourceCode 否 String 交易单号
当前页 page 是 Number 当前页
每页条数 pageSize 是 Number 每页orderLine条数(最多100条)
扩展属性 extendProps 否 Map 扩展属性

请求参数示例

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <ownerCode>O1234</ownerCode>
    <warehouseCode>CK1234</warehouseCode>
    <entryOrderCode>EK1234</entryOrderCode>
    <entryOrderId>RK1234</entryOrderId>
    <remark>remark</remark>
    <extendProps>
        <xzz>111</xzz>
        <hhz>222</hhz>
    </extendProps>
</request>

返回示例:

正确时返回:

<?xml version="1.0" encoding="utf-8"?>
<response>
    <flag>success|failure</flag>
    <code>响应码</code>
    <message>响应信息</message>
    <totalLines>orderLines 总条数,int,必填</totalLines>
    <entryOrder>
        <entryOrderCode>入库单编码, string (50) , 必填</entryOrderCode>
        <ownerCode>货主编码, string (50) </ownerCode>
        <warehouseCode>仓库编码, string (50),必填 </warehouseCode>
        <entryOrderId>仓储系统入库单 ID, string (50) , 条件必填</entryOrderId>
        <entryOrderType>入库单类型 ,SCRK=生产入库,LYRK=领用入库,CCRK=残次品
入库,CGRK=采购入库, DBRK=调拨入库, QTRK=其他入库,B2BRK=B2B 入库
</entryOrderType>
        <status>入库单状态, string (50) , 必填 (NEW-未开始处理, ACCEPT-仓库接单 , 
PARTFULFILLED-部分收货完成, FULFILLED-收货完成, EXCEPTION-异常, CANCELED-
取消, CLOSED-关闭, REJECT-拒单, CANCELEDFAIL-取消失败) , (只传英文编码) 
</status>
        <operateTime>操作时间, string (19) , YYYY-MM-DD HH:MM:SS,(当
status=FULFILLED, operateTime 为入库时间) </operateTime>
    </entryOrder>
    <orderLines>
        <orderLine>
            <orderLineNo>单据行号,string(50)</orderLineNo>
            <itemCode>商品编码, string (50) , 必填</itemCode>
            <itemId>仓储系统商品 ID, string (50) , 条件必填</itemId>
            <itemName>商品名称, string (200) </itemName>
            <inventoryType>库存类型,string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,
默认为 ZP, (收到商品总数=正品数+残品数+机损数+箱损数) 
</inventoryType>
            <planQty>应收数量, int</planQty>
            <actualQty>实收数量, int,必填</actualQty>
            <batchCode>批次编码, string (50) </batchCode>
            <productDate>商品生产日期,string(10), YYYY-MM-DD</productDate>
            <expireDate>商品过期日期,string(10),YYYY-MM-DD</expireDate>
            <produceCode>生产批号, string (50) </produceCode>
            <remark>备注, string (500) </remark>
        </orderLine>
    </orderLines>
</response>

错误时返回:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response>
    <flag>failure</flag>
    <code>failure</code>
    <message>请求奇门接口失败</message>
    <subCode>100002</subCode>
    <subMessage>请求WMS奇门接口失败,错误原因:{"code":"TOP29","flag":"failure","message":"Invalid app Key","success":false}</subMessage>
    <requestId>ace95ef4cb9a4b42b2e6812a50745b64</requestId>
</response>

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2026-06-17 09:44   作者:黄会准