# 查询订单状态

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

事件英文名:waybill_notify_query

微信在收到运力方的消息推送请求后会反查一次当前单的状态,如果与请求一致时则会推送

# 1. 消息参数

# 请求体 Request Payload

参数名类型说明
ToUserNamestring快递公司小程序UserName
FromUserNamestring微信团队的OpenID(固定值)
CreateTimenumber事件时间,Unix时间戳如1599823049
MsgTypestring消息类型,固定为event
Eventstring事件类型,固定为waybill_notify_query,不区分大小写
WaybillIdstring运单号
SenderPhonestring寄件人手机号
ReceiverPhonestring收件人手机号

# 2. 消息返回

# 返回体 Response Payload

参数名类型必填说明
ToUserNamestring原样返回请求中的FromUserName
FromUserNamestring快递公司小程序UserName
CreateTimenumber事件时间,Unix时间戳
MsgTypestring消息类型,固定为event
Eventstring事件类型,固定为waybill_notify_query,不区分大小写
ResultCodenumber处理结果错误码,成功时返回0,异常时由运力自定义
ResultMsgstring处理结果的详细信息,错误提示
Pathobjarray所有物流轨迹
WaybillCreateTimenumber运单创建时间,秒级时间戳如1599823049

# Res.Path(Array) Object Payload

所有物流轨迹

参数名类型必填说明
ActionTimenumber轨迹变化Unix时间戳,如1599823049
ActionTypenumber轨迹变化类型,与普通单保持一致,参见action_type定义
ActionMsgstring轨迹变化具体信息说明,展示在快递轨迹详情页中。若有手机号码,则直接写11位手机号码。使用UTF-8编码。
PickupCourierNamestring取件员姓名,当分配取件员成功时返回
PickupCourierPhonestring取件员电话,当分配取件员成功时返回
DeliveryCourierNamestring派件员姓名,当分配派件员成功时返回
DeliveryCourierPhonestring派件员电话,当分配派件员成功时返回

# 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>