快递鸟API电子面单接口说明文档

快递鸟电子面单接口说明文档

快递鸟

2017-04-25

版本

一、前言

1、业务背景

随着电子商务和物流信息化服务的迅猛发展，电子面单已经成为了商家快速发货并连接订单与物流的有力工具。快递鸟电子面单接口是快递鸟提供给独立电商、仓储管理系统、打单软件、物流供应链等物流系统平台使用的物流下单接口，满足商家在线发货需求并提供打印电子面单的服务。商家通过贵司系统选择物流公司发送请求通知快递公司有快递要发货，贵公司把数据通过此接口转发到快递鸟，由快递鸟为商家通知对应的快递公司快递员上门取件。电子面单成功下单后，快递鸟系统内将自动订阅，一旦轨迹发生变化时，快递鸟将调用贵司推送接收接口将物流信息反向推送至商家。同时若客户使用代收货款服务，快递鸟会将代收货款的货款状态独立推送给商家用户。

电子面单具有如下特点：

●打印效率高

相比传统针式打印机套打模式，打印速度提升6-8倍，热敏打印机打印速度平均30-40张/分。

●发货效率高

包裹出库时减少了抽底单的工序，降低了操作成本、提升操作效率，运单和订单即时绑定，无需人工再次扫描绑定发货。

目前商家在使用电子面单的过程中也存在一些情况导致部分用户无法顺畅使用，例如：

●大电商有多家合作快递公司，各家快递公司的模板尺寸不一，需要使用多个打印机

打印面单。

●单号作废后回收机制不完善导致电商成本升高。

●二联电子面单无底单，运费核账存在问题（部分商家货物重量以称重为准）。

●打印时发现面单号余额不足，耽误发货。

●小B电商发货量不够申请网点的电子面单服务。

快递鸟电子面单接口为解决客户以上问题，新增如下解决方案：

●电子面单余量查询：可通过电子面单余量查询接口查询，并且在快递鸟官网可设置

余额不足提醒值（后续会加上余额不足短信/邮件提醒功能）

●电子面单取消/回收：可通过电子面单取消接口，回收部分加盟快递公司的面单号。

●通用电子面单模板，含二联、三联模板

●快递公司电子面单客户号在线申请

●散户模式电子面单：部分快递公司无需申请电子面单客户号即可直接打印电子面单。

二、快递鸟电子面单方案

1、编码规范

目前接口支持了：顺丰（SF）、EMS（EMS）、宅急送（ZJS）、圆通（YTO）、百世快递（HTKY）、中通（ZTO）、韵达（YD）、申通（STO）、德邦（DBL）、优速（UC）、京东（JD）、信丰（XFEX）、全峰（QFKD）、跨越速运（KYSY）、安能小包（ANE）、快捷快递（FAST）、国通（GTO）、天天快递（HHTT），后续更多的快递公司正在对接中。

散户模式（无需电子面单客户号）支持快递公司：顺丰（SF）、EMS（EMS）（仅支持广东省内发货）、快捷快递（FAST）、宅急送（ZJS），后续更多的快递公司正在对接中。

电子面单客户号在线申请支持快递公司：优速（UC）、后续更多的快递公司正在对接中。

余量查询接口支持快递公司：中通（ZTO）、韵达（YD）、优速（UC）、后续更多的快递公司正在对接中。

面单回收接口支持快递公司：优速（UC）、后续更多的快递公司正在对接中。

2、业务流程

⏹商家需要做什么

●商家使用流程

●配置物料

a)电子面单需要使用热敏打印机，可与当地网点申请或自行通过淘宝、京东等电商平

台购买，目前市场上支持的厂家和型号包括：斑马G886T、启锐、佳博等

b)打印纸：电子面单需要使用热敏纸，可与当地网点申请打印纸物料或者自行在淘宝

等电商平台、线下文具店购买，打印纸尺寸需要根据打印模板尺寸购买或定制。

●商家在线申请电子面单客户号

截图：申请服务商的界面截图

截图：申请服务商的提交界面截图

选择网点：网点为根据发货地址自动匹配，若有多个需您自行选择，快递公司总部审核通过后会分配正确的网点。

●申请快递公司电子面单客户号说明：

a)电子面单客户号即请求打印面单时的用户账号或月结编码或客户编码，不同物流服

务商的叫法不同而已。

b)若商家无需月结运费，电子面单API请求参数CustomerName“电子面单客户账号”

无需填写可直接请求打单，无需申请电子面单客户号。支持快递公司：顺丰（SF）、

EMS（EMS）（仅支持广东省内发货）、快捷快递（FAST）、宅急送（ZJS），后续更多

的快递公司正在对接中。

c)若商家已有电子面单客户号，则对接快递鸟电子面单API请求参数CustomerName

“电子面单客户号”输入商家的客户号和密码通过验证即可打单。

d)在线申请客户号说明：因为物流快递商运营模式的不同（分为加盟和直营），加盟

型运营商是以网点为单位进行账户核算，所以您需要和每个快递网点建立合作，通

过快递鸟申请服务后，网点会联系您审核并且办理单量充值。而直营型服务商由快

递总部与发货人绑定运费结算关系，无需再联系快递公司充值单号，直营快递公司

审核通过后即可打单。

目前支持在线申请客户号的快递公司：优速（UC），后续更多的快递公司正在对接中。

●电子面单余量提醒值设置

快递鸟官网-用户管理后台-电子面单-账户信息-批量设置余量不足提醒值。

⏹系统对接需要做什么

●快递鸟接口对接通用流程：

电子面单接口对接流程：

a)注册快递鸟ID：

b)实名认证：

c)申请电子面单API：在快递鸟用户管理后台--申请API页面，点击申请电子面单API，快

递鸟审核通过后即可开始对接。

d)对接联合注册接口：若贵司平台系统有多家发货商家，建议同时对接联合注册接口，以

便区分您平台用户，并实现各发货商家独立使用代收货款服务。接口文档参考：《快递鸟代收货款》-1.1 用户注册接口。非必需接入。

e)对接电子面单接口：请参考第三章：接口说明

f)前端界面开发：您需要为商家增加打印电子面单的组件，包括：添加电子面单打印模板

（模板保存在系统本地或通过接口即时在线获取均可）、商家绑定电子面单客户账号（账号、密码、取件网点等信息，具体参考《快递鸟电子面单参数配置对照表》，建议在商家选择快递公司打印模板时让商家输入提交保存。）、打印界面和控件调试（偏移调试）。

3、系统设计规范

添加电子面单打印模板/添加快递公司界面示例：