# 微信物流服务-快递接口

## 一、产品介绍

快递接口是微信官方为小程序提供的免费物流接口。接入后，你可使用本接口在多家快递公司获取电子面单单号等信息，再通过热敏打印机完成电子面单打印，即可将快件交给快递公司上门揽收。

## 二、接入快递接口有什么好处

- **可批量生成电子面单**：已对接多家快递公司下单接口，使用本接口可在各快递公司批量生成电子面单；
- **可回传物流轨迹给你**：经由快递接口下的单，微信会将物流轨迹返回给你，便于你实时掌握快件运输路径；
- **用户可收到物流通知**：经由快递接口下的单，微信官方会通过服务通知推送快件状态给用户，提升用户体验；
- **完全免费的官方接口**：快递接口为微信官方接口，统一对接多家物流公司，服务稳定，免费开放。
- **增加用户回流小程序入口**：接入快递接口后，用户可通过两个方式回访你的小程序：

## 三、目前支持的快递公司

![](https://res.wx.qq.com/op_res/WdhfmE7ZhtPF5Emrs-mSMi3fIx7cMcfP6_i55Y6-n7nTqQO0x4lLqagwWEyR4XzhX6pDTGSi5MsGkLX6sgyBvA)

## 四、如何使用物流助手

前往「微信公众平台-物流服务」查看接入流程指引

![](https://res8.wxqcloud.qq.com.cn/wxdoc/e36a8e00-835b-4c16-86bb-7b0c7935b6cf.png)

### 步骤1：绑定签约的快递网点账号

在微信公众平台-小程序管理后台，点击【物流助手】→【去接入】→【去绑定】，选择和你签约过的物流公司，输入和网点签约时分配给你的账号密码，提交绑定；

**绑定说明**

1. 若当前无账号密码，请先线下联系物流公司网点完成签约获得账号和密码，再进行绑定；
2. 上述绑定账号即为调用快递接口 API 下单时，选择物流公司后需填写的 Bizid;
3. 若事先没有和物流公司签约，准备发散单，则无需在该页面绑定物流公司，调用物流接口下单时填写现付的 Bizid 即可，下单成功后系统会通知快递员上门取件，运费现结。目前两家物流公司支持下散单，对应 Bizid 如下：

| 快递公司名称 | 快递公司ID | 现付的BizID |
| :----------: | :--------: | :---------: |
|   顺丰速运   |     SF     |   SF_CASH   |
|   德邦快递   |     DB     |   DB_CASH   |

### 步骤2：对接快递接口（商家必看）API

1. 查看[接口文档](/miniprogram/dev/server/API/express/express-by-business/README.md)
2. 开发接口文档：你可自行开发或授权服务商开发，遇到问题可前往[微信开放社区](https://developers.weixin.qq.com)提问；
3. 测试下单：自行填写测试的收发货人信息和商品信息，看是否可成功调用本接口下单、成功生成电子面单、获取面单数据、打印面单和接收服务通知，全流程走通则说明接口已调通。

### 步骤3：打印电子面单

用快递接口 API 下单后，可选择以下任一方式打印电子面单

- 使用微信物流助手对接的第三方打单软件打印面单，当前已支持的第三方打单软件为：
  - ![](https://mmbiz.qpic.cn/mmbiz_png/rSd8GBjYBVApDus39FaABhJ0ZWPwa5vSQb4ic9ic5Lld3wYfz2ox6Mc5slVicva9BRYZHoIxSt5KLC7l8BEdea5Iw/0?wx_fmt=png)快递管家 [点击获取对接指引](https://developers.weixin.qq.com/community/develop/article/doc/000ac4abfc85986fe7a8023ce5b413)
  - 更多第三方持续对接中，请期待
- 使用物流公司接口或收件员上门打印电子面单；
- 使用 getOrder 拉取电子面单 html，使用热敏打印机打印（可能存在格式兼容问题，需调试）；
- 使用 getOrder 拉取电子面单的waybill_data，自行构造面单并打印（可能存在格式兼容问题，需调试）；
- 安装使用微信打单PC软件：目前支持 Windows XP 及以上版本。[点此下载](express-download)

### 步骤4：快递员上门揽件

快递员上门揽件后，商家即可通过物流助手 API 接收物流轨迹，微信会给用户推送已揽件、派件中、已签收/签收异常的服务通知，便于用户了解运单轨迹。

## 五、服务端接口

| 接口名称 | 请求路径 | 描述 |
| --- | --- | --- |
| [绑定/解绑物流账号](/miniprogram/dev/server/API/express/express-by-business/api_bindaccount.md) | /cgi-bin/express/business/account/bind | 该接口用于绑定、解绑物流账号 |
| [获取所有绑定的物流账号](/miniprogram/dev/server/API/express/express-by-business/api_getallaccount.md) | /cgi-bin/express/business/account/getall | 该接口用于获取所有绑定的物流账号 |
| [获取支持的快递公司列表](/miniprogram/dev/server/API/express/express-by-business/api_getalldelivery.md) | /cgi-bin/express/business/delivery/getall | 该接口用于获取支持的快递公司列表 |
| [取消运单](/miniprogram/dev/server/API/express/express-by-business/api_cancelorder.md) | /cgi-bin/express/business/order/cancel | 该接口用于取消运单 |
| [配置面单打印员](/miniprogram/dev/server/API/express/express-by-business/api_updateprinter.md) | /cgi-bin/express/business/printer/update | 该接口用于配置面单打印员，可以设置多个，若需要使用微信打单 PC 软件，才需要调用 |
| [获取电子面单余额](/miniprogram/dev/server/API/express/express-by-business/api_getquota.md) | /cgi-bin/express/business/quota/get | 该接口用于获取电子面单余额 |
| [获取运单数据](/miniprogram/dev/server/API/express/express-by-business/api_getorder.md) | /cgi-bin/express/business/order/get | 该接口用于获取运单数据 |
| [模拟更新订单状态](/miniprogram/dev/server/API/express/express-by-business/api_testupdateorder.md) | /cgi-bin/express/business/test_update_order | 该接口用于模拟快递公司更新订单状态, 该接口只能用户测试 |
| [获取打印员](/miniprogram/dev/server/API/express/express-by-business/api_getprinter.md) | /cgi-bin/express/business/printer/getall | 该接口用于获取打印员 |
| [查询运单轨迹](/miniprogram/dev/server/API/express/express-by-business/api_getpath.md) | /cgi-bin/express/business/path/get | 该接口用于查询运单轨迹 |
| [批量获取运单数据](/miniprogram/dev/server/API/express/express-by-business/api_batchgetorder.md) | /cgi-bin/express/business/order/batchget | 该接口用于批量获取运单数据 |
| [生成运单](/miniprogram/dev/server/API/express/express-by-business/api_addorder.md) | /cgi-bin/express/business/order/add | 该接口用于生成运单 |

### 协议规则

商户接入物流助手，调用API必须遵循以下规则：

| 项目     | 规则说明                    |
| -------- | --------------------------- |
| 传输方式 | 为保证安全性，采用HTTPS传输 |
| 提交方式 | 采用POST方法提交            |
| 数据格式 | 提交和返回数据都为json格式  |
| 字符编码 | 统一采用UTF-8字符编码       |

### 快递接口已支持的快递公司信息如下

下列物流公司，商家在[小程序后台](https://mp.weixin.qq.com)→【物流助手】→【去接入】→【去绑定】，绑定和快递总部或网点签约时分配的账号密码，对接快递接口后即可下单

> 说明：下单的Bizid即为绑定物流公司时填写的账号信息。

| 快递公司名称  | 快递公司ID | 服务类型ID及名称 |经营模式|
| ------------- | ------------- | ------------- | ------------- |
| 圆通速递  | YTO  | 0(普通快递)  
1(圆准达)| 加盟  |
| 中通快递  |ZTO | 0(标准快件)   | 加盟|
| 百世快递  | BEST |1(普通快递)  |加盟  |
| 韵达快递  | YUNDA |0(标准快件)   |加盟|
| 顺丰速运 | SF  | 0（标准快递）
自动选择可用的服务类型，若无特殊指定类型，请选0

1（顺丰即日）
2（顺丰特快）
3（顺丰标快）
4（顺丰标快（协议））  |直营 |
| 中国邮政速递物流  | EMS | 6（标准快递）
9（快递包裹）| 直营  |
| 品骏快递 |PJ |  1(普通快递)  | 直营 |
| 德邦快递  | DB | 1（大件快递3.60）
2（特准快件）| 直营 |
|申通快递  |STO | 1（标准快递）  | 加盟  |
|安能物流 | ANE |  95（MINI小包）
22（特准快运） | 加盟  |
|优速快递 | UCE |  0（大包裹） | 加盟  |
|京东快递 | JDL |  0（特惠送） | 直营 |
|天天快递 | HHTT |  0（标准快递） | 加盟 |
|极兔快递 | JTSD |  0（标准快递） | 加盟 |

下列物流公司，商家可不签约通过快递接口下现付单，无需在小程序后台绑定账号密码，对接完快递接口后，下单时填写如下Bizid即可。

| 快递公司名称  |快递公司ID | 服务类型ID及名称 |现付的BizID|
| ------------- | ------------- | ------------- | ------------- | 
| 顺丰速运 | SF  | 0（标准快递）
自动选择可用的服务类型，若无特殊指定类型，请选0

1（顺丰即日）
2（顺丰特快）
3（顺丰标快）|SF_CASH |
| 德邦快递  | DB | 1（大件快递3.60）
2（特准快件）| DB_CASH |