简要描述:

  • 订单流水查询

接口说明:

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