# 查询订单状态
本文档描述服务器端接收的消息或事件,详细说明参见消息推送。
事件英文名:waybill_notify_query
微信在收到运力方的消息推送请求后会反查一次当前单的状态,如果与请求一致时则会推送
# 1. 消息参数
# 请求体 Request Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 快递公司小程序UserName |
| FromUserName | string | 微信团队的OpenID(固定值) |
| CreateTime | number | 事件时间,Unix时间戳如1599823049 |
| MsgType | string | 消息类型,固定为event |
| Event | string | 事件类型,固定为waybill_notify_query,不区分大小写 |
| WaybillId | string | 运单号 |
| SenderPhone | string | 寄件人手机号 |
| ReceiverPhone | string | 收件人手机号 |
# 2. 消息返回
# 返回体 Response Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ToUserName | string | 是 | 原样返回请求中的FromUserName |
| FromUserName | string | 是 | 快递公司小程序UserName |
| CreateTime | number | 是 | 事件时间,Unix时间戳 |
| MsgType | string | 是 | 消息类型,固定为event |
| Event | string | 是 | 事件类型,固定为waybill_notify_query,不区分大小写 |
| ResultCode | number | 是 | 处理结果错误码,成功时返回0,异常时由运力自定义 |
| ResultMsg | string | 是 | 处理结果的详细信息,错误提示 |
| Path | objarray | 是 | 所有物流轨迹 |
| WaybillCreateTime | number | 是 | 运单创建时间,秒级时间戳如1599823049 |
# Res.Path(Array) Object Payload
所有物流轨迹
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ActionTime | number | 是 | 轨迹变化Unix时间戳,如1599823049 |
| ActionType | number | 是 | 轨迹变化类型,与普通单保持一致,参见action_type定义 |
| ActionMsg | string | 是 | 轨迹变化具体信息说明,展示在快递轨迹详情页中。若有手机号码,则直接写11位手机号码。使用UTF-8编码。 |
| PickupCourierName | string | 否 | 取件员姓名,当分配取件员成功时返回 |
| PickupCourierPhone | string | 否 | 取件员电话,当分配取件员成功时返回 |
| DeliveryCourierName | string | 否 | 派件员姓名,当分配派件员成功时返回 |
| DeliveryCourierPhone | string | 否 | 派件员电话,当分配派件员成功时返回 |
# 3. 注意事项
本事件无特殊注意事项
# 4. 代码示例
请求示例
<xml>
<ToUserName>gh_ea48699fb159</ToUserName>
<FromUserName>oHt_80DRclK4qjKfdYnPg6RxxsNI</FromUserName>
<MsgType>event</MsgType>
<Event>waybill_notify_query</Event>
<CreateTime>1600152165</CreateTime>
<WaybillId>557007127498128</WaybillId>
<SenderPhone>13763357711</SenderPhone>
<ReceiverPhone>13763357711</ReceiverPhone>
</xml>
返回示例
<xml>
<ToUserName>gh_ea48699fb159</ToUserName>
<FromUserName>oHt_80DRclK4qjKfdYnPg6RxxsNI</FromUserName>
<MsgType>event</MsgType>
<Event>waybill_notify_query</Event>
<CreateTime>1600152165</CreateTime>
<ResultCode>0</ResultCode>
<ResultMsg>OK</ResultMsg>
<WaybillCreateTime>1600000000</WaybillCreateTime>
<Path>
<ActionType>300001</ActionType>
<ActionTime>1600000000</ActionTime>
<ActionMsg>派送中</ActionMsg>
<DeliveryCourierName>张三</DeliveryCourierName>
<DeliveryCourierPhone>10086</DeliveryCourierPhone>
</Path>
<Path>
<ActionType>100001</ActionType>
<ActionTime>1600000000</ActionTime>
<ActionMsg>已取件</ActionMsg>
</Path>
</xml>