简要描述:

  • 订单流水通知

接口说明:

  • 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   作者:石明科