# 查询订单状态

> 本文档描述服务器端接收的消息或事件，详细说明参见[消息推送](/miniprogram/dev/framework/server-ability/message-push.md)。

事件英文名：waybill_notify_query

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

## 1. 消息参数

### 请求体 `Request Payload`

```json
[
  {
    "参数名": "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`

```json
[
  {
    "参数名": "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`

所有物流轨迹

```json
[
  {
    "参数名": "ActionTime",
    "类型": "number",
    "必填": "是",
    "说明": "轨迹变化Unix时间戳，如1599823049"
  },
  {
    "参数名": "ActionType",
    "类型": "number",
    "必填": "是",
    "说明": "轨迹变化类型，与普通单保持一致，参见action_type定义"
  },
  {
    "参数名": "ActionMsg",
    "类型": "string",
    "必填": "是",
    "说明": "轨迹变化具体信息说明，展示在快递轨迹详情页中。若有手机号码，则直接写11位手机号码。使用UTF-8编码。"
  },
  {
    "参数名": "PickupCourierName",
    "类型": "string",
    "必填": "否",
    "说明": "取件员姓名,当分配取件员成功时返回"
  },
  {
    "参数名": "PickupCourierPhone",
    "类型": "string",
    "必填": "否",
    "说明": "取件员电话,当分配取件员成功时返回"
  },
  {
    "参数名": "DeliveryCourierName",
    "类型": "string",
    "必填": "否",
    "说明": "派件员姓名,当分配派件员成功时返回"
  },
  {
    "参数名": "DeliveryCourierPhone",
    "类型": "string",
    "必填": "否",
    "说明": "派件员电话,当分配派件员成功时返回"
  }
]
```

## 3. 注意事项

本事件无特殊注意事项

## 4. 代码示例

请求示例

```xml
<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
<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>
```