简要描述:
- 订单流水通知
接口说明:
- 1.1接口描述:WMS调用奇门的接口,将订单在仓库的状态回传给ERP
- 1.2接口说明:仓库仓内操作状态回传给ERP, 比如打包操作完成时, 回传一个打包完成的状态给到ERP, ERP自行决定如何处理
- 1.3接口方法: taobao.qimen.orderprocess.report
接口版本:
| 版本号 | 制定人 | 制定日期 | 修订日期 |
|---|---|---|---|
| 1.0.0 | 石明科 | 2020-08-07 | 2020-08-07 |
请求头:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 请求类型,统一是 application/xml |
请求参数:
公共请求参数
| 参数名 | 字段 | 是否必须 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
| appkey | app_key | 是 | String | 应用接入时申请的 appkey | |
| 接口方法 | method | 是 | String | ERP 相关的业务接口名称,如商品信息同步的请求,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
| 参数名 | 字段 | 是否必须 | 类型 | 说明 |
|---|---|---|---|---|
| 订单信息 | order | 否 | date | 订单信息 |
| 订单处理信息 | process | 否 | date | 订单处理信息 |
| 扩展属性 | extendProps | 否 | Map | 扩展属性 |
| 备注 | remark | 否 | String | 备注 |
order
| 参数名 | 字段 | 是否必须 | 类型 | 说明 |
|---|---|---|---|---|
| 单据号 | orderCode | 是 | String | 单据号 |
| 仓储系统单据号 | orderId | 否 | String | 仓储系统单据号 |
| 单据类型 | orderType | 否 | String | 单据类型(JYCK=一般交易出库单;HHCK=换货出库;BFCK=补发出库;PTCK=普通出库单;DBCK=调拨出库;B2BRK=B2B入 库;B2BCK=B2B出库;QTCK=其他出库;SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK= 调拨入库;QTRK= 其他入 库;XTRK= 销退入库;HHRK= 换货入库;CNJG= 仓内加工单) |
| 仓库编码 | warehouseCode | 否 | String | 仓库编码 |
| 备注 | remark | 否 | String | 备注 |
process
| 参数名 | 字段 | 是否必须 | 类型 | 说明 |
|---|---|---|---|---|
| 单据状态 | processStatus | 是 | String | 单据状态(ACCEPT=仓库接单;PARTFULFILLED-部分收货完成;FULFILLED=收货完成;PRINT = 打印;PICK=捡货;CHECK = 复核 ;PACKAGE= 打包;WEIGH= 称重;READY=待提货;DELIVERED=已发货;REFUSE=买家拒签;EXCEPTION =异常;CLOSED= 关闭;CANCELED= 取 消;REJECT=仓库拒单;SIGN=签收;TMSCANCELED=快递拦截;OTHER=其他;PARTDELIVERED=部分发货完成;TMSCANCELFAILED=快递拦截失败;只传英 文编码) |
| 操作员编码 | operatorCode | 否 | String | 当前状态操作员编码 |
| 操作员姓名 | operatorName | 否 | String | 当前状态操作员姓名 |
| 操作时间 | operateTime | 否 | String | 当前状态操作时间(YYYY-MM-DD HH:MM:SS) |
| 操作内容 | operateInfo | 否 | String | 操作内容 |
| 备注 | remark | 否 | String | 备注 |
| 运单号 | expressCode | 否 | String | 运单号 |
返回参数:
response
| 参数名 | 类型 | 说明 |
|---|---|---|
| flag | String | 响应结果:success |
| code | String | 响应码 |
| message | String | 响应信息 |
| requestId | String | 查询返回的唯一编码 |
请求示例(xml)
<?xml version="1.0" encoding="utf-8"?>
<request>
<order>
<orderCode>单据号, string (50) , 必填</orderCode>
<orderId>仓储系统单据号, string (50) ,条件必填 </orderId>
<orderType>单据类型, string (50) , JYCK= 一般交易出库单,HHCK= 换货出库 ,
BFCK= 补发出库,PTCK=普通出库单,DBCK=调拨出库 ,B2BRK=B2B 入库,
B2BCK=B2B 出库,QTCK=其他出库,SCRK=生产入库,LYRK=领用入库,CCRK=残次
品入库,CGRK=采购入库 ,DBRK= 调拨入库 ,QTRK= 其他入库 ,XTRK= 销退入库,
HHRK= 换货入库,CNJG= 仓内加工单,BIGTOBCK=大 B2B 出库</orderType>
<warehouseCode>仓库编码, string (50) </warehouseCode>
</order>
<process>
<processStatus>单据状态,string (50) , ACCEPT=仓库接单, PARTFULFILLED-部分收
货完成, FULFILLED-收货完成, PRINT = 打印, PICK=捡货, CHECK = 复核, PACKAGE=
打包, WEIGH= 称重, READY=待提货, DELIVERED=已发货, REFUSE=买家拒签,
EXCEPTION =异常 ,CLOSED= 关闭, CANCELED= 取消, REJECT=仓库拒单,SIGN=
签收,SENDTMS=下发配,TMSFINISH=配完结,TMSCANCELED=快递拦截,
OTHER=其他,PARTDELIVERED=部分发货完成, TMSCANCELFAILED=快递拦截失败,
必填 (只传英文编码) </processStatus>
<operatorCode>当前状态操作员编码, string (50) </operatorCode>
<operatorName>当前状态操作员姓名, string (50) </operatorName>
<expressCode>运单号, string (50) </expressCode>
<operateTime>当前状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS</operateTime>
<operateInfo>操作内容, string (500) </operateInfo>
</process>
<remark>备注, string (500) </remark>
<extendProps>扩展属性
<key1>value1</key1>
<key2>value2</key2>
</extendProps>
</request>返回示例(xml):
正确时返回:
<response>
<flag>success</flag>
<code>0</code>
<message>invalid appkey</message>
<requestId>8bde9c225ba9436abbfae303ecde91d1</requestId>
</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 作者:石明科