# 散单寄件

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

## 一、产品优势

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

## 二、接入流程

### 1. 邮件申请

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

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

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

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

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

### 2. 协议签署

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

### 3. 开发调试

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

### 4. 审核发布

接口开发完成，微信侧确认，通过性能和安全审核后发布。

发布后微信生态内用户可以向快递公司下散单。


## 三、接入前准备

### 1. 小程序

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

1. 快递轨迹详情页，路径可以参考 `pages/info/info?from=wx&no=12345678901234` 。微信做跳转时，会传入运单号。
2. 快递投诉页面

### 2. 小程序事件服务

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

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

|        配置信息        |                       释义                        |
| -------------------- | ----------------------------------------------- |
| 快递编码，英文大写字母 |             如：BEST、JDL、YUNDA、ZTO             |
|    快递公司中文名称    |            如：百世、京东、韵达、中通             |
|      小程序appid       |         用于接受事件推送消息的小程序appid         |
|        客服电话        |          用于接收用户反馈的官方客服电话           |
|          logo          |                     公司logo                      |
|      默认揽件规则      | 用于兜底的揽件规则 格式见下方默认揽件规则数据格式 |
|     支持的支付方式     |                      0@寄付                       | 1@到付           | 2@支付分                                                          |
|     支持的货物重量     |                        min                        | max 最小重量(kg) | 最大重量(kg)                                                      |
|      是否支持保价      |                0-不支持 1-策略支持                |
|      最大保价价值      |               如： 30000（单位元）                |
|      最小保价价值      |                  如：1（单位元）                  |
|     默认的保价策略     |             格式 value@type@fee/rate              | ...              | value@type@fee/rate，value单位元,type 1-固定费用 2-费率 如500@1@1 | 1000@1@2 | 300000@2@0.005表示 1-500元固定保价费用1元 501-1000固定保价费用2元 1001-300000为保价价值*0.005 |
|        支持等级        |    取值0-3 表示支持的接口优先级类型 表示P0-P3     |

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

| time  |      tips       |                 含义                 |
| ---|------------- | ----------------------------------|
|   9   | 今天11:00前上门 |  0:00-8:59下单展示"今天11:00前上门"  |
|  17   |   两小时上门    |   9:00-16:59下单时展示"两小时上门"   |
|  24   | 明天11:00前上门 | 17:00-23:59下单展示"明天11:00前上门" |


### 四、相关接口

#### 基础功能
- [下单(callback1)](/miniprogram/dev/server/event_push/express/provider/shipping_capacity_order.md)
- [取消订单(callback2)](/miniprogram/dev/server/event_push/express/provider/cancel_order.md)
- [通过收发件地址查询标准运费(callback3)](/miniprogram/dev/server/event_push/express/provider/check_standard_shipping.md)
- [查单(callback10)](/miniprogram/dev/server/event_push/express/provider/query_waybill.md)
- [运力更新订单状态(api1)](/miniprogram/dev/server/API/express/express-by-provider/api_scatterupdateorderstatus.md)
- [运力更新需支付的运费(api2)](/miniprogram/dev/server/API/express/express-by-provider/api_scatterupdateorderfee.md)
- [运力取消订单(api5)](/miniprogram/dev/server/API/express/express-by-provider/api_scatterdeliverycancel.md)
#### 催单功能
- [查询所在城市的预约时间段(callback9)](/miniprogram/dev/server/event_push/express/provider/check_reservation.md)
- [用户催单(callback11)](/miniprogram/dev/server/event_push/express/provider/User_reminder.md)
#### 在线支付
- [通知用户支付完成情况(callback5)](/miniprogram/dev/server/event_push/express/provider/payment_completion_notification.md)
- [运力更新需支付的运费(api2)](/miniprogram/dev/server/API/express/express-by-provider/api_scatterupdateorderfee.md)  
- [运力公司退款(api6)](/miniprogram/dev/server/API/express/express-by-provider/api_scatterdeliveryrefund.md) 
- [对账单下载(api7)](/miniprogram/dev/server/API/express/express-by-provider/api_scatter_get_bill.md)  
#### 反馈功能
- [给小哥评价(callback4)](/miniprogram/dev/server/event_push/express/provider/rate_my_brother.md)  
- [用户投诉(callback7)](/miniprogram/dev/server/event_push/express/provider/user_complaints.md)  
- [运力返回用户投诉处理结果(api3)](/miniprogram/dev/server/API/express/express-by-provider/api_scatterupdatecomplainresult.md)  

### 五、流程图

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

 ![](https://res.wx.qq.com/op_res/2W38i6unswvL3FScMw15-JOwnUXDgyTrVnjzQAjVOwmYH2cxKUKJj67OzIBD3GaMUZCspB8ZnERbLcSSD5kL6A)

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

 ![](https://res.wx.qq.com/op_res/DCY2Qng-Ye_-B0lh8CfDHWg1FImKVVAKFknjxonhVRY76KIhFg4eYLChC6EeXpFydx7cB2hWF8OvHaQNB-XTpg)

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

 ![](https://res.wx.qq.com/op_res/4m9D3NBh12MYDQmJt2IRi_Ki1gSPKmj6_FbWln6v5NHQoLG2GvRkndZCbo-_x-46HoL7Hbwz-1IWV1J3-5ACwA)

### 订单状态定义
|  值   | 说明                   |
| ---| --------------------- |
|   0   | 已下单待揽件           |
|   1   | 已揽件                 |
|   2   | 运输中                 |
|   3   | 派件中                 |
|   4   | 已签收                 |
|   5   | 异常                   |
|   6   | 代签收                 |
|   7   | 揽收失败               |
|   8   | 签收失败（拒收，超区） |
|  11   | 已取消                 |
|  13   | 退件中                 |
|  14   | 已退件                 |