# 手机号物流消息推送

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

## 一、产品优势

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 查模式流程

![](http://mmbiz.qpic.cn/mmbiz_png/T6hQ3lkukBtOCI7icI9byCQ7ibT2yOzqMncnj5icp82nLF8BMRS735V2QpgItRh0wGvkwATP0K0dqepget8yKuXQQ/0?wx_fmt=png)

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

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

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

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

#### 3.1 主调

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

#### 3.2 被调

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

### 4. 接口

- [查询订单状态](/miniprogram/dev/server/event_push/express/provider/check_order_status.md)
- [用户手机状态查询](/miniprogram/dev/server/API/weixin-express/msgpush/api_deliveryuserquery.md)
- [推送已绑定物流轨迹信息](/miniprogram/dev/server/API/weixin-express/msgpush/api_deliverypathnotify.md)

### 5. 测试流程

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