简要描述:

  • 入库单查询接口

接口说明:

  • 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>

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2020-08-04 13:42   作者:黄会准