返回
最新动态
# 散单寄件
2024-12-31 18:55

「散单寄件功能」开放快递公司接入，应用在“微信快递服务”寄快递、发货组件发货、退货组件退货等场景，用户无需快递公司结算账号，即可直接在微信移动端完成下单至快递公司，实现快递员上门取件、支付运费。

  1. 承接微信生态内散单场景寄快递需求；
  2. 无需申请快递公司结算账号，一键下单，在线支付；
  3. 提升用户回访：关键物流状态会通过微信服务通知发送给用户，用户点击后可回访快递公司小程序查看该运单的物流状态或进行后续操作。

1.邮件申请

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

【邮件标题】 快递公司名称 - 散单寄件接入申请

【邮件内容】 快递公司名称、快递公司logo、小程序appid（小程序需要完成微信认证）、对接人微信号/手机号

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

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

2.协议签署

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

3.开发调试

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

4.审核发布

接口开发完成，微信侧确认，通过性能和安全审核后发布。 发布后微信生态内用户可以向快递公司下散单。

1.小程序

用户收到轨迹更新消息后，可以间接跳转到快递小程序的轨迹详情页。至少需要提供两个页面：

  1. 快递轨迹详情页，路径可以参考 。微信做跳转时，会传入运单号。
  2. 快递投诉页面

2.小程序事件服务

事件服务用于接收微信的推送，目前有下单、取消运单等事件。

3.接入运力公司配置信息

默认揽件规则数据格式： 提供time与tips两列数据，案例如下

1.接口概览
2.运力接口

  • 2.1 基础功能
          2.1.1 通过收发件地址查询标准运费(callback3)
          2.1.2 下单(callback1)
          2.1.3 取消订单(callback2)
          2.1.4 查单(callback10)
          2.1.5 运力更新订单状态(api1)
          2.1.6 运力更新需支付的运费(api2)
          2.1.7 运力取消订单(api5)
  • 2.2 催单功能
          2.2.1 查询所在城市的预约时间段(callback9)
          2.2.2 催单接口(callback11)
  • 2.3 在线支付
          2.3.1 通知用户支付完成情况(callback5)
          2.3.2 运力更新需支付的运费(api2)
          2.3.3 运力公司退款(api6)
          2.3.4 对账单下载(api7)
  • 2.4 反馈功能
          2.4.1 给小哥评价(callback4)
          2.4.2 用户投诉(callback7)
          2.4.3 运力返回用户投诉处理结果(api3)

1.接口概览

【微信快递服务散单接入】在线支付-微信支付普通支付

【微信快递服务散单接入】在线支付-微信支付分后付

【微信快递服务散单接入】线下支付

2.运力接口

2.1 基础功能

callback接口需要在mp页面里设置服务器地址。

https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/message-push.html

2.1.1 通过收发件地址查询标准运费(callback3)

用户在下单页面选择收发货地址时进行查询

  • 请求参数
  • 返回参数
2.1.2 下单(callback1)
  • 请求参数
  • Addr结构
  • GoodDetail结构
  • 物品类型Special字段说明
  • Insured结构
  • 返回参数
2.1.3 取消订单(callback2)
  • 请求参数
  • CancelID定义
  • 返回参数
2.1.4 查单(callback10)
  • 请求参数
  • 返回参数
  • Addr结构
  • GoodDetail结构
  • 物品类型Special字段说明
  • Insured结构
  • Path结构
  • PathInfo结构（每一项结构相同）
2.1.5 运力更新订单状态(api1)

  • 请求地址

    POST https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/update?access_token=ACCESS_TOKEN

  • 请求参数

  • 返回参数
2.1.6 运力更新需支付的运费(api2)

支付分订单更新运费接口，须保证该订单状态不是待揽件状态。正常流程是：用户下支付分订单，运力公司调用更新订单状态接口，然后再调用更新运费接口。

  • 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/fee?access_token=ACCESS_TOKEN

  • 请求方法： POST application/json

    • 请求参数
  • 返回参数
2.1.7 运力取消订单(api5)

运力公司取消订单

  • 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/cancel_order?access_token=ACCESS_TOKEN

  • 请求方法： POST application/json

    • 请求参数
  • 返回参数
2.2 催单功能
2.2.1 查询所在城市的预约时间段(callback9)
  • 请求参数
  • 返回参数

TimeRange

2.2.2 催单接口(callback11)
  • 请求参数
  • 返回参数
2.3 在线支付
2.3.1 通知用户支付完成情况(callback5)

当用户在线支付完成后通知

  • 请求参数
  • 返回参数
2.3.2 运力更新需支付的运费(api2)

支付分订单更新运费接口，须保证该订单状态不是待揽件状态。正常流程是：用户下支付分订单，运力公司调用更新订单状态接口，然后再调用更新运费接口。