简要描述:
- 订单流水查询
接口说明:
- 1.1接口描述:到WMS查询订单流水信息
- 1.2接口说明:ERP通过奇门调用该接口,FMS调用奇门接口往WMS查询订单流水信息
- 1.3接口方法: taobao.qimen.orderprocess.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
| 参数名 | 字段 | 是否必须 | 类型 | 说明 |
|---|---|---|---|---|
| 单据类型 | orderType | 否 | String | 单据类型(JYCK=一般交易出库单;HHCK=换货出库;BFCK=补发出库;PTCK=普通出库单;DBCK=调拨出库;QTCK=其他出库;B2BRK=B2B入库;B2BCK=B2B出库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;XTRK=销退入库;HHRK=换货入库;CNJG=仓内加工单) |
| 单据号 | orderCode | 是 | String | 单据号 |
| 仓储系统单据号 | orderId | 否 | String | 仓储系统单据号 |
| 仓库编码 | warehouseCode | 否 | String | 仓库编码 |
| 扩展属性 | extendProps | 否 | Map | 扩展属性 |
| 备注 | remark | 否 | String | 备注 |
| 交易单号 | orderSourceCode | 否 | String | 交易单号 |
| 货主编码 | ownerCode | 否 | String | 货主编码 |
返回参数:
response
| 参数名 | 类型 | 说明 |
|---|---|---|
| flag | String | 响应结果:success |
| code | String | 响应码 |
| message | String | 响应信息 |
| requestId | String | 查询返回的唯一编码 |
| orderProcess | data | 订单处理流程 |
orderProcess
| 参数名 | 类型 | 说明 |
|---|---|---|
| orderCode | String | 单据号 |
| orderId | String | 仓储系统单据号 |
| orderType | String | 单据类型(JYCK=一般交易出库单;HHCK=换货出库;BFCK=补发出库;PTCK=普通出库单;DBCK=调拨出库;QTCK=其他出库;B2BRK=B2B入库;B2BCK=B2B出库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;XTRK=销退入库;HHRK=换货入库;CNJG=仓内加工单) |
| warehouseCode | String | 仓库编码 |
| processes | data[] | 处理流程 |
processes
| 参数名 | 类型 | 说明 |
|---|---|---|
| processStatus | String | 单据状态(NEW=新增;ACCEPT=仓库接单;PRINT=打印;PICK=捡货;CHECK=复核;PACKAGE=打包;WEIGH=称重;READY=待提货;DELIVERED=已发货;EXCEPTION=异常;CLOSED=关闭;CANCELED=取消;REJECT=仓库拒单;REFUSE=客户拒签;CANCELEDFAIL=取消失败;SIGN=签收;TMSCANCELED=快递拦截;PARTFULFILLED=部分收货完成;FULFILLED=收货完成;PARTDELIVERED=部分发货完成;OTHER=其他;只传英文编码) |
| operatorCode | String | 该状态操作员编码 |
| operatorName | String | 该状态操作员姓名 |
| operateTime | String | 该状态操作时间(YYYY-MM-DD HH:MM:SS) |
| operateInfo | String | 操作内容 |
| remark | String | 备注 |
请求示例(xml)
<request>
<orderType>单据类型, string (50) ,JYCK= 一般交易出库单,HHCK= 换货出
库 ,BFCK= 补发出库,PTCK=普通出库单,DBCK=调拨出库 ,QTCK=其他出库,
B2BRK=B2B 入库,B2BCK=B2B 出库,CGRK=采购入库 ,DBRK= 调拨入库 ,QTRK=
其他入库 ,XTRK= 销退入库,HHRK= 换货入库,CNJG= 仓内加工单</orderType>
<orderCode>单据号, string (50) , 必填</orderCode>
<orderId>仓储系统单据号, string (50) ,条件必填 </orderId>
<warehouseCode>仓库编码, string (50)</warehouseCode>
<ownerCode>货主编码, string (50) </ownerCode>
</request>返回示例(xml):
正确时返回:
<response>
<flag>success</flag>
<code>0</code>
<message>invalid appkey</message>
<requestId>8bde9c225ba9436abbfae303ecde91d1</requestId>
<orderProcess>
<orderCode>O1234</orderCode>
<orderId>WS1234</orderId>
<orderType>JYCK</orderType>
<warehouseCode>WO1234</warehouseCode>
<processes>
<process>
<processStatus>NEW</processStatus>
<operatorCode>BI1234</operatorCode>
<operatorName>老王</operatorName>
<operateTime>2016-10-09 12:00:00</operateTime>
<operateInfo>操作出库</operateInfo>
<remark>备注信息</remark>
</process>
</processes>
</orderProcess>
</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 作者:石明科