物流轨迹推送通知 | 微信开放文档

# 物流轨迹推送通知

# 接口说明

当电子面单对应的物流轨迹发生变化时，微信小店会通过该接口将消息通知给商家。

# 注意事项

回调url设置和消息推送规则需参考消息推送文档，如果设置的回调url无法访问，商户将无法收微信小店发送的通知；

# 请求参数说明

参数	类型	描述
ToUserName	string	UserName
FromUserName	string	OpenID
CreateTime	number	事件时间,Unix时间戳
MsgType	string	消息类型,固定为 event
Event	string	事件类型,本接口固定为 ewaybill_push_path
waybill_info	object WaybillInfo	事件主体，结构体详情请参考WaybillInfo

# 请求参数示例（解密后的明文JSON）

{
    "ToUserName": "gh_*",
    "FromUserName": "OpenID",
    "CreateTime": 1662480000,
    "MsgType": "event",
    "Event": "ewaybill_push_path",
    "waybill_info": {
       "ewaybill_order_id":123123123123123,
       "waybill_id":"xxxx",
       "update_time":1231231,
       "status":1,
       "desc":"您的快件已签收"
     }
}

# 返回参数示例

{
  "ToUserName": "oABCD",
  "FromUserName": "gh_abcdefg",
  "CreateTime": 1533042556,
  "MsgType": "event",
  "Event": "ewaybill_push_path",
  "ResultCode": 0,
  "ResultMsg": "success"
}

# 结构体

# WaybillInfo

事件主体

参数	类型	是否必填	描述
ewaybill_order_id	UINT64	是	电子面单订单id
waybill_id	String	是	运单号
update_time	UINT32	是	更新时间，单位秒
status	UINT32	是	轨迹节点状态，枚举值详情请参考status
desc	String	是	轨迹节点描述

# 枚举值

# status

轨迹节点状态状态

枚举值	描述
0	待揽件
1	揽收
2	运输中
3	派件
4	入柜
5	签收
6	退回
7	转寄
8	异常
9	出柜
99	其他未知