电子面单接口应用指南

一、 文档目的

便于快递鸟用户理解电子面单接口作用并正确应用到实际场景。

二、 接口作用

用于向快递/快运/物流公司下发订单并获取快递单号，再打单发货。

三、 应用场景

可应用于电商平台、自营商城、ERP、打单工具、楼宇/物业收派系统、WMS仓储系统、云打印、微信小程序/公众号、APP、OA等需要发货的场景。

四、 接口逻辑

说明：

1、 快递鸟接口作为数据中转站，不对数据内容做处理，只对数据字段做转换;

2、 电子面单账号密码是否正确、地址是否可送达、单号是否充足、省市区详细地址传值是否规范等，由快递公司接口做判断，快递鸟负责返回响应的结果(对响应失败的结果内容做统一处理，返回更为方便理解的描述);

3、 返回的快递单号号段，取决用户充值单号时网点分配的单号号段，不需要充值单号的快递公司，返回的号段由快递公司自动分配。

五、 应用实例

1、 页面前端的地址设计：省市区栏，系统上做成选择项，由用户选择，不允许输入，很大程度上保证地址规范性(省市区街道列表可在网上下载);

针对技术能力较强，希望更好提升客户体验的，可对地址做智能识别功能，识别出省市区信息，甚至包含联系人和手机号码。

2、 电子面单账号保存：因各个快递公司对电子面单账号的传值参数及字段数不一致，在用户配置电子面单账号密码数据时，系统上只显示需配置项，不显示非配置项;

3、 电子面单模板：各快递公司模板样式、尺寸规格不一致，接入时每家快递公司都需要调试。

间接打单用户(平台性/工具类用户)

因其系统使用商家较多，同一模板无法满足所有商家需求，推荐根据商家需求自行设计面单模板。

优势：灵活性高，不受快递鸟模板修改的影响，对商家体验更好

劣势：对用户技术能力有一定要求

直接打单用户(直接发货商家)

A、 对模板无要求，快递鸟接口返回的模板已能满足的商家，可直接使用。

优势：接入成本低，方便易用，可使用快递鸟批量打印功能

劣势：灵活性不高

B、 对模板有一定要求，快递鸟接口返回的模板无法完全满足的商家，可对返回的模板按自身需求进行处理，或自行设计面单模板。

对返回的模板按自身需求进行处理：

优势：接入成本较低，方便快捷

劣势：对用户技术能力稍有技术要求

4、 打印控件：如果使用快递鸟接口返回的面单模板，不做任何修改处理，可使用快递鸟提供的批量打印功能;如果对模板有其他需求，需要处理返回的模板或者自己设计的模板，可使用第三方打印控件打印，如lodop等。

5、 打印机品牌：电子面单模板对打印机品牌、型号等没有要求，只要是热敏打印机即可，常见品牌如：斑马、得力、快麦、汉印、佳博等。