简要描述:
接口说明:
- 1.1接口描述:向WMS查询入库单
- 1.2接口说明:ERP调用奇门接口,奇门调用该接口,FMS调用奇门接口向WMS查询入库单
- 1.3接口方法:taobao.qimen.deliveryorder.query
接口版本:
| 版本号 |
制定人 |
制定日期 |
修订日期 |
| 1.0.0 |
黄会准 |
2020-08-04 |
2020-08-04 |
请求URL:
请求方式:
请求头:
| 参数名 |
是否必须 |
类型 |
说明 |
| 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 作者:黄会准