简要描述:

  • 订单流水通知

接口说明:

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

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2026-06-17 09:44   作者:石明科