# logistics.onPathUpdate

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

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

# 消息参数

# Object

属性 类型 说明
ToUserName string 小程序的原始ID
FromUserName string 发送者的openid
CreateTime number 消息创建时间(整型)
MsgType string 固定 event
Event string 固定 add_express_path
DeliveryID string 快递公司ID
WayBillId string 运单ID
OrderId string 订单ID
Version number 轨迹版本号(整型)
Count number 轨迹节点数(整型)
Actions Array.<Object> 轨迹列表

Actions 的结构

属性 类型 说明
ActionTime number 轨迹节点 Unix 时间戳
ActionType number 轨迹节点类型
ActionMsg string 轨迹节点详情

ActionType 的合法值

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

# 消息数据包示例

XML 格式

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1546924844</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[add_express_path]]></Event>
  <DeliveryID><![CDATA[SF]]></DeliveryID>
  <WayBillId><![CDATA[123456789]]></WayBillId>
  <OrderId><![CDATA[123456]]></OrderId>
  <Version>3</Version>
  <Count>3</Count>
  <Actions>
    <ActionTime>1546924840</ActionTime>
    <ActionType>100001</ActionType>
    <ActionMsg><![CDATA[小哥A揽件成功]]></ActionMsg>
  </Actions>
  <Actions>
    <ActionTime>1546924841</ActionTime>
    <ActionType>200001</ActionType>
    <ActionMsg><![CDATA[到达广州集包地]]></ActionMsg>
  </Actions>
  <Actions>
    <ActionTime>1546924842</ActionTime>
    <ActionType>200001</ActionType>
    <ActionMsg><![CDATA[运往目的地]]></ActionMsg>
  </Actions>
</xml>

JSON 格式

{
  "ToUserName": "toUser",
  "FromUserName": "fromUser",
  "CreateTime": 1546924844,
  "MsgType": "event",
  "Event": "add_express_path",
  "DeliveryID": "SF",
  "WayBillId": "123456789",
  "OrderId": "123456789",
  "Version": 2,
  "Count": 3,
  "Actions": [
    {
      "ActionTime": 1546924840,
      "ActionType": 100001,
      "ActionMsg": "小哥A揽件成功"
    },
    {
      "ActionTime": 1546924841,
      "ActionType": 200001,
      "ActionMsg": "到达广州集包地"
    },
    {
      "ActionTime": 1546924842,
      "ActionType": 200001,
      "ActionMsg": "运往目的地"
    }
  ]
}