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

# 一、 产品介绍

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

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

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

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

# 四、如何使用物流助手

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

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

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

绑定说明

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

# 步骤2:对接快递接口(商家必看)Api

  1. 查看接口文档
  2. 开发接口文档:你可自行开发或授权服务商开发,遇到问题可前往微信开放社区提问;
  3. 测试下单:自行填写测试的收发货人信息和商品信息,看是否可成功调用本接口下单、成功生成电子面单、获取面单数据、打印面单和接收服务通知,全流程走通则说明接口已调通。

# 步骤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