logistics.onPathUpdate

本文档描述服务器端接收的消息或事件，详细说明参见消息推送。

运单轨迹更新事件。当运单轨迹有更新时，会产生如下数据包。收到事件之后，回复success或者空串即可。

消息参数

Object

属性类型说明
ToUserNamestring小程序的原始ID
FromUserNamestring发送者的openid
CreateTimenumber消息创建时间（整型）
MsgTypestring固定 event
Eventstring固定 add_express_path
DeliveryIDstring快递公司ID
WayBillIdstring运单ID
OrderIdstring订单ID
Versionnumber轨迹版本号（整型）
Countnumber轨迹节点数（整型）
ActionsArray.<Object>轨迹列表

Actions 的结构

属性类型说明
ActionTimenumber轨迹节点 Unix 时间戳
ActionTypenumber轨迹节点类型
ActionMsgstring轨迹节点详情

ActionType 的合法值

值说明最低版本
100001揽件阶段-揽件成功
100002揽件阶段-揽件失败
100003揽件阶段-分配业务员
200001运输阶段-更新运输轨迹
300002派送阶段-开始派送
300003派送阶段-签收成功
300004派送阶段-签收失败
400001异常阶段-订单取消
400002异常阶段-订单滞留

消息数据包示例

XML 格式

  1. <xml>
  2.   <ToUserName><![CDATA[toUser]]></ToUserName>
  3.   <FromUserName><![CDATA[fromUser]]></FromUserName>
  4.   <CreateTime>1546924844</CreateTime>
  5.   <MsgType><![CDATA[event]]></MsgType>
  6.   <Event><![CDATA[add_express_path]]></Event>
  7.   <DeliveryID><![CDATA[SF]]></DeliveryID>
  8.   <WayBillId><![CDATA[123456789]]></WayBillId>
  9.   <OrderId><![CDATA[123456]]></OrderId>
  10.   <Version>3</Version>
  11.   <Count>3</Count>
  12.   <Actions>
  13.     <ActionTime>1546924840</ActionTime>
  14.     <ActionType>100001</ActionType>
  15.     <ActionMsg><![CDATA[小哥A揽件成功]]></ActionMsg>
  16.   </Actions>
  17.   <Actions>
  18.     <ActionTime>1546924841</ActionTime>
  19.     <ActionType>200001</ActionType>
  20.     <ActionMsg><![CDATA[到达广州集包地]]></ActionMsg>
  21.   </Actions>
  22.   <Actions>
  23.     <ActionTime>1546924842</ActionTime>
  24.     <ActionType>200001</ActionType>
  25.     <ActionMsg><![CDATA[运往目的地]]></ActionMsg>
  26.   </Actions>
  27. </xml>

JSON 格式

  1. {
  2.   "ToUserName": "toUser",
  3.   "FromUserName": "fromUser",
  4.   "CreateTime": 1546924844,
  5.   "MsgType": "event",
  6.   "Event": "add_express_path",
  7.   "DeliveryID": "SF",
  8.   "WayBillId": "123456789",
  9.   "OrderId": "123456789",
  10.   "Version": 2,
  11.   "Count": 3,
  12.   "Actions": [
  13.     {
  14.       "ActionTime": 1546924840,
  15.       "ActionType": 100001,
  16.       "ActionMsg": "小哥A揽件成功"
  17.     },
  18.     {
  19.       "ActionTime": 1546924841,
  20.       "ActionType": 200001,
  21.       "ActionMsg": "到达广州集包地"
  22.     },
  23.     {
  24.       "ActionTime": 1546924842,
  25.       "ActionType": 200001,
  26.       "ActionMsg": "运往目的地"
  27.     }
  28.   ]
  29. }