快递鸟电子面单API接口使用指南

快递鸟电子面单使用手册V1.0目录1 服务介绍12 服务价值23 准备工作23.1申请电子面单客户号及单号23.1.1月结模式申请客户号33.1.1快递鸟模式直接打印43.2购买或充值单号53.3准备热敏打印纸及打印机54 对接流程54.1 自营商家对接流程54.2 系统商，电商平台商家对接流程105 常见问题101 服务介绍快递鸟电子面单API服务，是指由快递公司通过快递鸟电子面单API，向打单用户提供物流单号，实现种通过热敏纸打印输出纸质物流面单并发货的服务。现该服务已支持21家快递公司，57个官方承认模板（含隐私快递），有效提高打印速度4-6倍，一次开发即可接入所有支持快递公司。目前已支持：顺丰（SF）、EMS（EMS）、宅急送（ZJS）、圆通（YTO）、百世快递（HTKY）、中通（ZTO）、韵达（YD）、申通（STO）、德邦（DBL）、优速（UC）、京东（JD）、信丰（XFEX）、全峰（QFKD）、跨越速运（KYSY）、安能小包（ANE）、快捷快递（FAST）、国通（GTO）、天天快递（HHTT）、邮政快递包裹（YZPY）、中铁快运（ZTKY），后续更多的快递公司正在对接中。EMS电子面单模板展示2 服务价值打印速度提升：电子面单是普通纸质面单的4-6倍，平均每单打印只需花费1-2秒钟，高效率的打单大大缓解电商等客户的大批量打单压力，轻松应对大促。提高发货效率：传统发货模式，操作员需要将已打出的快递单和订单信息匹配后再发货，电子面单不需要把快递单和定单信息逐一匹配操作，在定单信息申请快递单号的时候就已完成了定单匹配；卖家无需再安排人员专门抽取“发货联”，操作效率进一步提升。 服务对比对比项快递鸟电子面单API快递公司自有账号申请直接向快递鸟统一申请 线下签订客户协议申请 打印模板支持2联，3联（发货人可留底）统一尺寸模板 大部分3联，各家尺寸不统一 单号结算客户与网点结算，部分快递公司无需预充值客户与网点结算余额提醒警戒值短信提醒 无 单号回收部分公司由快递鸟处理单号回收，提供对账明细表 部分公司不支持回收 系统对接一次对接21家，技术支持全程辅助使用一家快递则需要对接一次 支持快递公司支持主流21家快递公司各家支持自家 3 准备工作针对自营商家，以下工作可在对接过程中准备，以便对接完成后即可上线立即使用。平台及系统商可参考如下流程指导平台用户自行准备。3.1申请电子面单客户号及单号电子面单客户号即请求打印面单时的用户账号或月结编码或客户编码，不同物流服务商的叫法不同而已。为方便广大中小卖家，快递鸟与多家快递公司合作推出两种电子面单打印合作方案，快递公司原有月结模式、快递鸟模式。快递鸟电子面单支持快递公司列表：类型快递公司无需申请直接打单顺丰、EMS（限广东）、快捷快递、宅急送、邮政快递包裹、中铁快运月结账号直接打单德邦、EMS（全国）线上（快递鸟后台）申请账号百世快递、优速、韵达、圆通、远成、安能线下（网点）申请账号EMS、中通、申通、德邦、京东、信丰、全峰、跨越速运、国通、天天更新日期：2017年11月8日 3.1.1月结模式申请客户号方案一：已有账号若您已有电子面单客户号，则对接快递鸟电子面单API请求参数“电子面单客户号”输入您的客户号和密码通过验证即可打单。方案二：快递鸟后台申请快递鸟后台申请账号，现已支持韵达快递（YD），圆通快递（YT），百世汇通（HTKY）优速快递（UC），远程快运（YCWL），更多快递公司陆续接入中。申请流程：（1）登录快递鸟用户后台，进入电子面单模块，点击右上角【申请新的快递公司】按钮。（2）在跳转的页面，选择需要申请账号的快递公司，点击【申请】按钮。（3）在弹出的弹窗中输入发货地址及联系人。系统会根据所填写地址自动匹配发货网点，您也可以手动填写。点击提交完成申请，等待快递公司审核。建议主动联系当地网点以加快审核速度。（4）可在用户后台电子面单模块，【我的快递公司】查看申请的快递公司及进度。当状态对应显示为【审核通过】，表示快递公司审核结束，账号密码快递鸟会通过短信方式发送给您填写的联系电话。附：快递鸟韵达电子面单账号信息申请审核流程，其他快递公司的类似，如有疑问请登陆快递鸟官网咨询快递鸟技术支持获取操作指南文档。1、中心给网点的通知 2、快递鸟客户韵达信息审核（1）添加VIP客户编码首先添加VIP客户编码，流程：内部事务我的客户VIP客户管理客户添加；（2）客户信息审核其次在二维码系统进行客户信息审核，流程：内部事务我的订单二维码订单管理基础设置快递鸟客户信息审核（3）选中客户信息点击“审核”按钮，当选择审核通过时，指定一个VIP客户编码，然后点击审核；否则可直接选择“驳回”按钮，然后点击审核；方案三：网点直接申请需要月结的其他快递公司，您可以联系当地发货地址对应网点申请开通。如需帮助，请联系快递鸟技术支持，获取【电子面单申请流程】文档。3.1.1快递鸟模式直接打印如下快递公司支持无需账号直接打印，可通过快递鸟后台直接申请开通：顺丰（SF）、EMS（EMS）（仅支持广东省内发货）、快捷快递（FAST）、宅急送（ZJS）、邮政快递包裹（YZPY）、中铁快运（ZTKY）。3.2购买或充值单号使用加盟类快递公司，如中通，申通，汇通等电子面单，审核通过后需找网点购买（预充值）面单号，请联系您的发货网点办理。直营类快递公司，如顺丰，宅急送，EMS等，审核后无需预充值，随用随取。3.3准备热敏打印纸及打印机1.电子面单需专业的热敏打印纸，一般由您合作的快递网点提供，也可自行在网上购买。2.打印机需您自行购买，或与快递网点协商解决。如下打印机型号供参考：4 对接流程4.1 自营商家对接流程本流程针对在自有系统打单发货商家。提供打单服务的系统商对接流程请参见章节3.2。1.注册认证并购买会员套餐(1)进入快递鸟官网，点击右上角【免费注册】按钮，注册登录成功后进入快递鸟用户管理后台，点击左侧菜单栏【实名认证】,填写基本资料完成认证。(2)购买任意会员套餐（物流查询（免费版）套餐含电子面单永久免费）套餐开通后菜单栏将新增【我的产品服务】栏，选择【电子面单】，可查看或配置单子面单资源，包括账号申请，面单统计，运单详情等。2.对接电子面单API（1）官网下载接口技术文档，及电子面单参数配置对照表（提供部分快递测试账号），电子面单接口Demo，电子面单批量打印Demo，参考文档进行对接。调用成功后，返回信息会包含运单号，面单模板等内容。下载地址/documents(2)对接过程如有任何疑问，请加快递鸟API技术对6群询问帮助：。3.调用KDN打印组件快递鸟打印组件，适用于浏览器打印，兼容Chrome，火狐等主流浏览器可实现批量打印，批量控制打印端口，省去调试面单模板的工作。(1) 下载电子面单批量打印Demo（下载地址：/product-eorder-specific ）(2) 在如下代码段中配置您的打印订单号及打印机名称，以及是否需要预览。请确保使用自己的用户ID及订单号调用。（部分关键代码，以.net为例）（2）如选择预览，会进入预览页面，点击上下页进行翻页。（3）如选择不需要预览，将直接输出打印，根据打印出来的面单效果调试打印机。（4）如没有自己的系统，您也可以在完成电子面单API对接后，在快递鸟后台打印。打印地址：/UserCenter/ElectronicSheet/WaybillDetails.aspx4.调试打印机如遇到打印预览或打印结果有偏移，需调试打印机。(1)Windows系统打开设备与打印机。选择目标打印机右键，选择【打印首选项】。(2)点击【页面设置】模块，如图位置，选择需打印的纸张模板。点击确认。（3）如无所需尺寸，点击新建，在弹出的对话框创建所需打印模板。（4）调试后关闭原预览页面，重新调用，预览样式会发生变化，确认预览结果正确后，可尝打印。调试前后重新预览，模板适配纸张样式会发生变化。 （5）如打印结果与预览不一致，偏移或超出纸张等问题，请尝试点击【高级选项】，调整偏移量，一般默认为0。（6） 反复调试上述数据，直至打印出的面单在纸张上无偏移，无溢出。5.正式使用可在调试打印结束后，设置免预览直接打印，多台打印机并行打印等多种模式，以满足自身系统打印需要。4.2 系统商，电商平台商家对接流程1.重复流程1-2。2.调试各快递公司模板如平台有其他用户需使用此打单功能，需调节电子面单模板以适应自身系统。电子面单API会在返回单号同时返回官方模板，请根据系统需要自行调节。3.下载KDN打印组件（可选）可参考【自营商家对接流程】3.调用KDN打印组件，使用快递鸟打印组件给平台商家使用。4.其他准备工作可参考【3.1申请电子面单客户号及单号】引导平台商家和用户在使用打单功能前，提前去网点申请自己的电子面单账号。5 常见问题Q1：电子面单如何收费？A1：快递鸟电子面单接口完全免费。具体的单号，快递费用的结算需要用户和快递公司自行洽谈。Q2：电子面单接口的订单编号指的是什么？A2：电子面单接口是需要填入订单号，这个值是唯一的，由用户端进行设置。一般是您系统的订单编号。Q3：什么叫电子面单客户号？A4：电子面单客户号即请求打印面单时的用户账号或月结编码或客户编码，不同物流服务商的叫法不同而已。若您无需月结运费，电子面单API请求参数“电子面单客户号”无需填写可直接请求打单（部分快递公司不支持此模式，具体请参考电子面单API快递公司配置表），无需申请电子面单客户号。若您已有电子面单客户号，则对接快递鸟电子面单API请求参数“电子面单客户号”输入您的客户号和密码通过验证即可打单。Q4：电子面单运单号从哪来？A4：将订单号，收寄件地址等信息通过电子面单API传递给快递公司，快递公司会通过接口返回物流单号给到用户端，打印在面单上，就是面单上的运单号。加盟快递公司需要预先充值单号，请联系当地合作网点办理。直营类快递公司，如顺丰，宅急送，EMS等，审核后无需预充值，随用随取。Q5：如果平台有100个不同地区的商家，都需要用到电子面单，是不是需要技术对接100次？A5：只需要对接一次就好。每个商家可以使用自己的信息下单。平台商家需要有自己的电子面单账号，每个商家自行去快递公司申请账号后填入贵司平台，再转发给快递鸟即可。Q6：对于电商平台，平台上的商户需要分别去申请各个快递公司的帐号和密码，才能使用电子面单吗？A6：顺丰、广东省内EMS、宅急送可以直接使用快递鸟的账户请求电子面单接口。京东，德邦，中通，圆通，申通，百世快递，韵达，安能，优速，快捷等需要客户去当地物流快递网点申请电子面单账户，将相应的参数传入快递鸟电子面单接口进行电子面单请求。Q7：电子面单生成后可以取消吗