# 手机号物流消息推送

微信物流服务开放「手机号物流消息推送」功能，接入该能力的快递公司可对绑定了微信快递服务的用户推送物流变更消息，用户收到物流变更的消息后，进入消息详情页可收藏、分享，或跳转该快递公司的小程序。

# 产品优势

1、授权微信快递服务的用户，可查收该用户手机号名下快递运单详情和变更消息；

2、快递公司可以节省快递状态变更通知用户的短信成本。

# 接入流程

# 1.邮件申请

发送申请邮件至wxwuliu@tencent.com

【邮件标题】 快递公司名称 - 手机号物流消息推送接入申请

【邮件内容】 每日运单量、小程序appid（小程序需要完成微信认证）

【邮件附件】《营业执照》、《快递业务经营许可证》扫描件

我们会在收到邮件后的1个工作日内进行反馈。

# 2.协议签署

符合接入要求的快递公司，会收到邮件回复，包含接入指引和《合作协议》。

# 3.开发调试

• 按照本接口文档设计和开发，其中部分信息需要由微信协助配置
• 以邮件和微信群形式沟通

# 4.审核发布

接口开发完成，微信侧确认，通过性能和安全审核后发布，发布后的页面所有用户可以扫码查看。

# 接入前准备

# 1.快递信息查询接口

用以微信前端通过JsonP 方式获取运单的信息

# 2.落地页Cell信息

快递公司需要提供一组 Cell 的信息，每个 Cell 包括:

• “Key”：Cell 的标识码，快递公司自定义, 不超过 20 字符
• “Name”：Cell 展示的名称，如“支付运单”
• “Link”：Cell 点击外跳的 url 地址

# 接口开发文档

# 1.流程

# 1.1查模式流程

运力侧的主要逻辑为3-8步骤。首先用户可以在推送物流消息前对用户绑定状态进行查询，在存在绑定关系的情况下可以对轨迹变化进行通知。调用通知接口后微信会先进行一次反查，在确定状态无误的情况下微信会将物流轨迹推送至用户手机。

# 2.运力侧接入需要提供的内容

• 运力小程序appid（用于调用微信API，并接收微信回调）

# 3.运力侧需要开发的内容

# 3.1、主调

• 查询用户绑定关系（必需）
• 推送物流轨迹通知（必需）

# 3.2、被调

• 微信反查运单接口（必需）
  

# 4.接口

# 4.1、action_type定义

# 4.2、callback接口

消息推送说明 https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/message-push.html 推荐选择加密模式

# 查询订单状态

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

具体数据格式可能是json，也可能是xml，由小程序在mp平台配置的情况决定。 示例：

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

• 返回参数：

其中path的每一项的内容如下

示例：

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

# 5.3、api接口

# 接口鉴权

微信api接口默认使用access_token进行接口鉴权。因此需要在所有的api接口地址后加上参数access_token。 例如： 原始调用地址为：https://api.weixin.qq.com/cgi-bin/test/api 最终实际的调用地址需要加上access_token参数，即： https://api.weixin.qq.com/cgi-bin/test/api?access_token=xxxxxx 其中access_token的生成与管理方法见：后台接口调用凭证说明 https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getAccessToken.html

# 用户手机状态查询

• 描述：运力方可以调用此接口来获取某手机号是否绑定
• 请求方法： POST application/json
• 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/userquery?access_token=XXX
• 请求参数

• 返回参数

• 示例

{
"phone":"13800138000"
}

# 推送已绑定物流轨迹信息

• 描述：运力方可以调用此接口来推送物流轨迹消息
• 请求方法： POST application/json
• 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/pathnotify?access_token=XXX
• 请求参数

其中sender与receiver的内容如下：

其中path的内容如下

• 返回参数

• 示例

{
"path": {
  "action_time": 1597396101,
  "action_type": 200001,
  "action_msg": "快件到达 【泉州磁灶集散中心】",
  "pickup_courier_name":"",
  "pickup_courier_phone":"",
  "delivery_courier_name":"",
  "delivery_courier_phone":""
 },
 "receiver": {
  "area": "晋江市",
  "address": "庄宅北区158-6",
  "province": "福建省",
  "city": "泉州市",
  "phone": "13800138000",
  "name": "李四"
 },
 "sender": {
  "area": "柯桥区",
  "address": "纺都路137号",
  "province": "浙江省",
  "city": "绍兴市",
  "phone": "13800138001",
  "name": "张三"
 },
 "waybill_id": "1234567890"
 }

# 5、测试流程

• 绑定（测试阶段微信号+手机号提供给微信进行绑定，项目上线后可以直接通过微信侧的小程序绑定）
• 调用查询API
• 已绑定时调用绑定推送API，确认返回errcode为0 1、检查是否收到微信消息（目前只有派件300002及签收300003两个actiontype会下发消息通知） 2、点击消息确认能够跳到轨迹详情页，查看详情页的轨迹信息是否正确
• 未绑定时调用未绑定推送API，确认返回errcode为0

# 6、API错误码定义