# 微信物流服务-快递接口
# 一、 产品介绍
快递接口是微信官方为小程序提供的免费物流接口。接入后,你可使用本接口在多家快递公司获取电子面单单号等信息,再通过热敏打印机完成电子面单打印,即可将快件交给快递公司上门揽收。
# 二、接入快递接口有什么好处
- 可批量生成电子面单:已对接多家快递公司下单接口,使用本接口可在各快递公司批量生成电子面单;
- 可回传物流轨迹给你:经由快递接口下的单,微信会将物流轨迹返回给你,便于你实时掌握快件运输路径;
- 用户可收到物流通知:经由快递接口下的单,微信官方会通过服务通知推送快件状态给用户,提升用户体验;
- 完全免费的官方接口:快递接口为微信官方接口,统一对接多家物流公司,服务稳定,免费开放。
- 增加用户回流小程序入口:接入快递接口后,用户可通过两个方式回访你的小程序:
# 三、目前支持的快递公司
# 四、如何使用物流助手
前往「微信公众平台-物流服务」查看接入流程指引
# 步骤1:绑定签约的快递网点账号
在微信公众平台-小程序管理后台,点击【物流助手】→【去接入】→【去绑定】,选择和你签约过的物流公司,输入和网点签约时分配给你的账号密码,提交绑定;
绑定说明
- 若当前无账号密码,请先线下联系物流公司网点完成签约获得账号和密码,再进行绑定;
- 上述绑定账号即为调用快递接口Api下单时,选择物流公司后需填写的Bizid;
- 若事先没有和物流公司签约,准备发散单,则无需在该页面绑定物流公司,调用物流接口下单时填写现付的Bizid即可,下单成功后系统会通知快递员上门取件,运费现结。目前两家物流公司支持下散单,对应Bizid如下:
| 快递公司名称 | 快递公司ID | 现付的BizID |
|---|---|---|
| 顺丰速运 | SF | SF_CASH |
| 德邦快递 | DB | DB_CASH |
# 步骤2:对接快递接口(商家必看)Api
- 查看接口文档
- 开发接口文档:你可自行开发或授权服务商开发,遇到问题可前往微信开放社区提问;
- 测试下单:自行填写测试的收发货人信息和商品信息,看是否可成功调用本接口下单、成功生成电子面单、获取面单数据、打印面单和接收服务通知,全流程走通则说明接口已调通。
# 步骤3:打印电子面单
用快递接口Api下单后,可选择以下任一方式打印电子面单
- 使用微信物流助手对接的第三方打单软件打印面单,当前已支持的第三方打单软件为:
快递管家 点击获取对接指引
- 更多第三方持续对接中,请期待
- 使用物流公司接口或收件员上门打印电子面单;
- 使用 getOrder 拉取电子面单 html,使用热敏打印机打印(可能存在格式兼容问题,需调试);
- 使用 getOrder 拉取电子面单的waybill_data,自行构造面单并打印(可能存在格式兼容问题,需调试);
- 安装使用微信打单PC软件:目前支持 Windows XP 及以上版本。点此下载
# 步骤4:快递员上门揽件
快递员上门揽件后,商家即可通过物流助手Api接收物流轨迹,微信会给用户推送已揽件、派件中、已签收/签收异常的服务通知,便于用户了解运单轨迹。
# 五、 服务端接口
| 接口名称 | 请求路径 | 描述 |
|---|---|---|
| 绑定/解绑物流账号 | /cgi-bin/express/business/account/bind | 该接口用于绑定、解绑物流账号 |
| 获取所有绑定的物流账号 | /cgi-bin/express/business/account/getall | 该接口用于获取所有绑定的物流账号 |
| 获取支持的快递公司列表 | /cgi-bin/express/business/delivery/getall | 该接口用于获取支持的快递公司列表 |
| 取消运单 | /cgi-bin/express/business/order/cancel | 该接口用于取消运单 |
| 配置面单打印员 | /cgi-bin/express/business/printer/update | 该接口用于配置面单打印员,可以设置多个,若需要使用微信打单 PC 软件,才需要调用 |
| 获取电子面单余额 | /cgi-bin/express/business/quota/get | 该接口用于获取电子面单余额 |
| 获取运单数据 | /cgi-bin/express/business/order/get | 该接口用于获取运单数据 |
| 模拟更新订单状态 | /cgi-bin/express/business/test_update_order | 该接口用于模拟快递公司更新订单状态, 该接口只能用户测试 |
| 获取打印员 | /cgi-bin/express/business/printer/getall | 该接口用于获取打印员 |
| 查询运单轨迹 | /cgi-bin/express/business/path/get | 该接口用于查询运单轨迹 |
| 批量获取运单数据 | /cgi-bin/express/business/order/batchget | 该接口用于批量获取运单数据 |
| 生成运单 | /cgi-bin/express/business/order/add | 该接口用于生成运单 |
# 协议规则
商户接入物流助手,调用API必须遵循以下规则:
| 项目 | 规则说明 |
|---|---|
| 传输方式 | 为保证安全性,采用HTTPS传输 |
| 提交方式 | 采用POST方法提交 |
| 数据格式 | 提交和返回数据都为json格式 |
| 字符编码 | 统一采用UTF-8字符编码 |
# 快递接口已支持的快递公司信息如下
下列物流公司,商家在小程序后台→【物流助手】→【去接入】→【去绑定】,绑定和快递总部或网点签约时分配的账号密码,对接快递接口后即可下单
说明:下单的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 |