微信物流服务开放「手机号物流消息推送」功能,接入该能力的快递公司可对绑定了微信快递服务的用户推送物流变更消息,用户收到物流变更的消息后,进入消息详情页可收藏、分享,或跳转该快递公司的小程序。
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查模式流程
运力侧的主要逻辑为3-8步骤。首先用户可以在推送物流消息前对用户绑定状态进行查询,在存在绑定关系的情况下可以对轨迹变化进行通知。调用通知接口后微信会先进行一次反查,在确定状态无误的情况下微信会将物流轨迹推送至用户手机。
- 运力小程序appid(用于调用微信API,并接收微信回调)
3.1、主调
- 查询用户绑定关系(必需)
- 推送物流轨迹通知(必需)
3.2、被调
- 微信反查运单接口(必需)
4.1、action_type定义
4.2、callback接口
消息推送说明 https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/message-push.html 推荐选择加密模式
查询订单状态
- 描述:微信在收到运力方的消息推送请求后会反查一次当前单的状态,如果与请求一致时则会推送
- 请求参数
具体数据格式可能是json,也可能是xml,由小程序在mp平台配置的情况决定。 示例:
- 返回参数:
其中path的每一项的内容如下
示例:
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
- 请求参数
- 返回参数
- 示例
推送已绑定物流轨迹信息
- 描述:运力方可以调用此接口来推送物流轨迹消息
- 请求方法: POST application/json
- 请求地址:https://api.weixin.qq.com/cgi-bin/express/delivery/pathnotify?access_token=XXX
- 请求参数
其中sender与receiver的内容如下:
其中path的内容如下
- 返回参数
- 示例