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

KJ-TD-KDN对外】接口技术文档 PAGE28 / NUMPAGES28 快递鸟电子面单接口说明文档 快递鸟 2017-04-25 版本 日期版本说明作者2017-04-252.0创建文档，第一版请参考《接口技术文档》V4.2.1第三章3.3电子面单 蒋雪姣 前言 业务背景 随着电子商务和物流信息化服务的迅猛发展，电子面单已经成为了商家快速发货并连接订单与物流的有力工具。快递鸟电子面单接口是快递鸟提供给独立电商、仓储管理系统、打单软件、物流供应链等物流系统平台使用的物流下单接口，满足商家在线发货需求并提供打印电子面单的服务。商家通过贵司系统选择物流公司发送请求通知快递公司有快递要发货，贵公司把数据通过此接口转发到快递鸟，由快递鸟为商家通知对应的快递公司快递员上门取件。电子面单成功下单后，快递鸟系统内将自动订阅，一旦轨迹发生变化时，快递鸟将调用贵司推送接收接口将物流信息反向推送至商家。同时若客户使用代收货款服务，快递鸟会将代收货款的货款状态独立推送给商家用户。 电子面单具有如下特点： 打印效率高 相比传统针式打印机套打模式，打印速度提升6-8倍，热敏打印机打印速度平均30-40张/分。 发货效率高 包裹出库时减少了抽底单的工序，降低了操作成本、提升操作效率，运单和订单即时绑定，无需人工再次扫描绑定发货。 目前商家在使用电子面单的过程中也存在一些情况导致部分用户无法顺畅使用，例如： 大电商有多家合作快递公司，各家快递公司的模板尺寸不一，需要使用多个打印机打印面单。 单号作废后回收机制不完善导致电商成本升高。 二联电子面单无底单，运费核账存在问题（部分商家货物重量以称重为准）。 打印时发现面单号余额不足，耽误发货。 小B电商发货量不够申请网点的电子面单服务。 快递鸟电子面单接口为解决客户以上问题，新增如下解决方案： 电子面单余量查询：可通过电子面单余量查询接口查询，并且在快递鸟官网可设置余额不足提醒值（后续会加上余额不足短信/邮件提醒功能） 电子面单取消/回收：可通过电子面单取消接口，回收部分加盟快递公司的面单号。 通用电子面单模板，含二联、三联模板 快递公司电子面单客户号在线申请 散户模式电子面单：部分快递公司无需申请电子面单客户号即可直接打印电子面单。 名词解释 1电子面单一种新型的快递面单。材料为热敏纸，有成本低、打印快、单号方便获取、管理等特点。2大客户与快递公司签订合作协议的客户，有快递公司客户号或月结账号。此类客户支持运费月结、到付、现付。3散户与快递公司无合作关系，无客户号，支持运费现付/到付运费。 快递鸟电子面单方案 编码规范 目前接口支持了：顺丰（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）、后续更多的快递公司正在对接中。 业务流程 商家需要做什么 商家使用流程 配置物料 电子面单需要使用热敏打印机，可与当地网点申请或自行通过淘宝、京东等电商平台购买，目前市场上支持的厂家和型号包括：斑马G886T、启锐、佳博等 打印纸：电子面单需要使用热敏纸，可与当地网点申请打印纸物料或者自行在淘宝等电商平台、线下文具店购买，打印纸尺寸需要根据打印模板尺寸购买或定制。 商家在线申请电子面单客户号 截图：申请服务商的界面截图 截图：申请服务商的提交界面截图 选择网点：网点为根据发货地址自动匹配，若有多个需您自行选择，快递公司总部审核通过后会分配正确的网点。 申请快递公司电子面单客户号说明： 电子面单客户号即请求打印面单时的用户账号或月结编码或客户编码，不同物流服务商的叫法不同而已。 若商家无需月结运费，电子面单API请求参数CustomerName “电子面单客户账号”无需填写可直接请求打单，无需申请电子面单客户号。支持快递公司：顺丰（SF）、EMS（EMS）（仅支持广东省内发货）、快捷快递（FAST）、宅急送（ZJS