快递鸟电子面单模板说明

合集下载

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

快递鸟电子面单接口说明文档快递鸟2017-04-25版本一、前言1、业务背景随着电子商务和物流信息化服务的迅猛发展，电子面单已经成为了商家快速发货并连接订单与物流的有力工具。

快递鸟电子面单接口是快递鸟提供给独立电商、仓储管理系统、打单软件、物流供应链等物流系统平台使用的物流下单接口，满足商家在线发货需求并提供打印电子面单的服务。

商家通过贵司系统选择物流公司发送请求通知快递公司有快递要发货，贵公司把数据通过此接口转发到快递鸟，由快递鸟为商家通知对应的快递公司快递员上门取件。

电子面单成功下单后，快递鸟系统内将自动订阅，一旦轨迹发生变化时，快递鸟将调用贵司推送接收接口将物流信息反向推送至商家。

同时若客户使用代收货款服务，快递鸟会将代收货款的货款状态独立推送给商家用户。

电子面单具有如下特点：●打印效率高相比传统针式打印机套打模式，打印速度提升6-8倍，热敏打印机打印速度平均30-40张/分。

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

目前商家在使用电子面单的过程中也存在一些情况导致部分用户无法顺畅使用，例如：●大电商有多家合作快递公司，各家快递公司的模板尺寸不一，需要使用多个打印机打印面单。

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

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

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

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

快递鸟电子面单接口为解决客户以上问题，新增如下解决方案：●电子面单余量查询：可通过电子面单余量查询接口查询，并且在快递鸟官网可设置余额不足提醒值（后续会加上余额不足短信/邮件提醒功能）●电子面单取消/回收：可通过电子面单取消接口，回收部分加盟快递公司的面单号。

●通用电子面单模板，含二联、三联模板●快递公司电子面单客户号在线申请●散户模式电子面单：部分快递公司无需申请电子面单客户号即可直接打印电子面单。

快递鸟API电子面单接口参数配置对照表

备注：调用电子面单时IsNotice参数可控制是否通知快递员上门揽件（*0-通知；1-不通知；不填则默认为0）表中帐号和密码指的是向快递公司网点申请开通电子面单权限后，快递公司提供的电子面单帐号和密码申通电子面单不支持测试环境，只能在正式环境下使用中通电子面单账号开通流程圆通电子面单账号开通流程快递鸟电子面单接口常见问题问题：什么是电子面单？相比传统面单而言它有什么优势？电子面单是一种新型的快递面单。

材料为热敏纸，有成本低、打印快、单号方便获取、管理等特点。

在行业内也被称为热敏纸快递标签、经济型面单，二维码面单等。

它与传统面单相比主要有如下区别和优势。

a. 效率更高n 提升打印效率：电子面单的打印效率是普通纸质面单的4-6倍，平均每单打印只需花费1-2秒钟，高效率的打单大大缓解电商等客户的大批量打单压力，轻松应对大促；n 提高发货效率：电子面单不需要把快递单和定单信息逐一匹配操作，在订单信息申请快递单号的时候就已完成了定单匹配；卖家无需再安排人员专门抽取“发货联”，操作效率进一步提升；减少了手写“大头笔”等动作，提高了分拣效率；提高了分拣的准确性；n 支持多种电商增值业务，无需人肉绑定面单（例如：货到付款，预约配送）。

b. 成本更低n 电子面单的纸张是0.1元/张，成本比传统纸质面单0.2-0.3元降低了一大半；n 降低快递公司作业成本，如取消抽单和手写大头笔，单位时间内的揽货可以提升一倍以上；c. 数据信息完整实效n 在申请电子面单运单号的时候，就匹配到具体的“大头笔”信息，既减少人工操作的成本并又可以提高准确率和效率；商家在使用电子面单的时候就会自动将数据同步给快递公司，可以在申请面单的时候就拿到第一手数据，更加真实并且提高速度。

问题：快递鸟电子面单接口如何对接？1、注册快递鸟APIkey /reg2、加技术问题交流群：200121393 在群文件中下载技术接口文档3、请贵司技术根据技术文档开发后测试（需快递网点账号）4、上线问题：各快递公司编码是什么？电子面单账号如何开通？需要提供什么？顺丰（SF）百世快递（HTKY）百世快运（BTWL）申通（STO）中通（ZTO）圆通（YTO）韵达（YD）EMS（EMS）宅急送（ZJS）德邦（DBL）全峰（QFKD）如风达（RFD）优速快递（UC）龙邦（LB）增益（ZENY）华航快递（HHKD）运通快递（YTKD）希优特（XYT）民邦物流（MB）长沙创一（CSCY）安能物流（ANE）精英速运（JYSY）问题：快递鸟电子面单接口返回的html模板包含什么内容呢?打印出来的实际效果是什么样的？针对每个快递公司，模版都会有变化嘛还是采用统一的模版样式？返回的是快递公司官方认可的html模板，电子面单接口会返回包含收件人和寄件人以及商品信息等数据的模板，用户可以直接将该电子面单模板进行打印，将返回的数据放在HTML 控件中显示就行，不同快递公司电子面单模板不一样。

菜鸟电子面单统一模板操作说明

KIS旗舰版V4.0菜鸟电子面单统一模板使用说明一、开通菜鸟电子面单服务：首先，要使用统一模板必须要开通菜鸟电子面单服务。

如果有非淘系平台共用淘宝网店的面单服务需要做好授权设置；此处不再熬述，详情可参考《KIS旗舰版3.0菜鸟电子面单操作说明文档》；二、下载补丁、安装组件：金蝶KIS旗舰版V4.0的用户首先要在金蝶KIS软件左上角【我要反馈】-【下载特性包】下载并正确安装功能八月份整合补丁（前置）并打上PT099210（菜鸟电子面单统一模板补丁包或者双11、12保障补丁）后，再安装补丁包中的菜鸟打印组件，或者可从以下地址自行下载，安装后即可开始使用电子面单统一模板功能。

具体操作详见以下描述，如有任何疑问，可咨询金蝶旺旺号：金蝶kis01。

请先安装菜鸟打印控件菜鸟打印控件下载地址：三、打印机设置：因菜鸟统一模板的纸张大小都为100*180(mm)，所以需要将打印机的默认纸张设置为100*180，打开打印机管理-右键打印机选项-选项，将打印纸张大小设置为100*180四、使用说明：1、打开KIS旗舰版，在【电商管理】-【公用设置】打开【菜鸟物流面单设置】即可看到菜鸟统一模板的启用和设计界面：（是否启用统一模板可选）2、勾选【统一模板】来启用所选物流公司的统一模板；只有启用了菜鸟电子面单服务的物流公司才能启用统一模板：3、点击【下载产品类型】即可下载物流公司的产品类型，并可在物流公司中选择产品类型来打印:4、【只预览首个打印任务】，菜鸟组件在批量生成打印任务时候，为了保证性能，默认10个订单生成一个打印任务，预览时候可选择是否依次显示所有打印任务还是只显示第一个10单的打印任务。

勾选项，勾选则在预览时只显示首个打印任务，不勾选则多次显示所有所选单据生成的打印任务；5、根据所有热敏纸张上是否有物流公司logo来选择是否打印物流公司logo （热敏纸没有物流公司logo的请务必勾选，否则无法在面单上识别是哪个物流公司的单）:6、点击【模板设计】即可调用菜鸟打印组件对统一模板进行设计，选中某个物流公司点击模板设计将会调出该物流公司的统一模板设计界面：关于统一模板设计的说明：1、点击【模板设计】之前光标定位哪个物流公司，即会加载哪个物流公司的设计界面；2、模板分为固定区域和自定义区域；固定区域只传值，商家和软件开发方都不允许修改；商家自定义区域由商家自行定义修改；3、右侧候选集勾选后可在商家自定义区进行字段添加和设置；按ctrl+delete删除该字段；4、打印机设置、打印偏移量设置以及候选集字段设置，都将受到【应用到所有物流公司】的影响：勾选后保存，所有的这些设置都将对所有物流公司进行保存；反之设置只会保存到当前物流公司；5、关于打印商品：菜鸟官方说明自定义区可以打印最多5个商品，如果无法打印那么多，请将字体调小至9pt，长度10个汉字。

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

电子面单成功下单后，快递鸟系统内将自动订阅，一旦轨迹发生变化时，快递鸟将调用贵司推送接收接口将物流信息反向推送至商家。

同时若客户使用代收货款服务，快递鸟会将代收货款的货款状态独立推送给商家用户。

电子面单具有如下特点：●打印效率高相比传统针式打印机套打模式，打印速度提升6-8倍，热敏打印机打印速度平均30-40张/分。

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

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

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

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

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

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

快递鸟电子面单使用手册V1.0目录1 服务介绍 (1)2 服务价值 (2)3 准备工作 (2)3.1申请电子面单客户号及单号 (2)3.1.1月结模式申请客户号 (3)3.1.1快递鸟模式直接打印 (9)3.2购买或充值单号 (9)3.3准备热敏打印纸及打印机 (9)4 对接流程 (10)4.1 自营商家对接流程 (10)4.2 系统商，电商平台商家对接流程 (15)5 常见问题 (15)1服务介绍快递鸟电子面单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秒钟，高效率的打单大大缓解电商等客户的大批量打单压力，轻松应对大促。

提高发货效率：传统发货模式，操作员需要将已打出的快递单和订单信息匹配后再发货，电子面单不需要把快递单和定单信息逐一匹配操作，在定单信息申请快递单号的时候就已完成了定单匹配；卖家无需再安排人员专门抽取“发货联”，操作效率进一步提升。

3准备工作针对自营商家，以下工作可在对接过程中准备，以便对接完成后即可上线立即使用。

平台及系统商可参考如下流程指导平台用户自行准备。

3.1申请电子面单客户号及单号电子面单客户号即请求打印面单时的用户账号或月结编码或客户编码，不同物流服务商的叫法不同而已。

快递鸟接口调试平台使用指南

快递鸟接口调试平台使用指南版本目录1、前言 (4)2、使用指南 (4)2.1登陆调试平台 (4)2.2即时查询 (6)2.3订阅推送接口 (7)2.3.1订阅接口 (8)2.3.2推送接口 (9)2.3.3推送地址修改 (14)2.4电子面单 (16)2.5单号识别 (19)3、技术支持...................................................................................... 错误！未定义书签。

1、前言快递鸟API旨在为电商、电商平台、物流工具、仓储系统等系统提供专业、稳定、优质的物流服务，为不同的用户量身定做了专业的API 接口服务，供不同的用户各取所需。

接口申请：快递鸟官网注册账号后，在后台获取私有接口秘钥，对接接口并使用。

为了方便用户接入快递鸟接口，我们提供了调试平台供用户使用。

用户可以通过调试平台进行接口测试与校验，以及推送地址自助配置。

本文档就快递鸟调试平台的使用进行详细讲解。

2、使用指南2.1登陆调试平台1、使用快递鸟账户登陆官网：2、点击左侧菜单栏【调试平台】选项3、进入调试平台。

调试平台目前包含：即时查询、订阅推送、电子面单、单号识别等接口调试功能，下面分接口进行使用详解。

2.2即时查询1、点击左侧【即时查询】菜单栏进入即时查询调试界面。

2、在ShipperCode和LogisticCode中填快递公司编码和快递单号，点击【生成】按钮后会自动在【系统级参数报文】和【应用级参数报文(RequestData)】的文本框中生成请求报文。

用户可将调试平台上生成的报文与自己程序生成的报文进行比较，校验程序生成报文是否正确。

4、点击【调用】按钮，提交请求。

【应用级参数报文】文本框中显示的就是快递鸟返回的轨迹信息。

2.3订阅推送接口点击菜单栏【订阅推送】选项进入订阅推送接口调试界面。

该页面包括【订阅】、【推送】两个tab页。

淘宝卖家使用菜鸟电子面单图文教程

淘宝卖家使用菜鸟电子面单图文教程
电子面单已成为快递单未来主流趋势，而菜鸟也成为电子面单的主流阵容之一。

菜鸟电子面单已经越来越开放给普罗大众卖家使用，今天我们来介绍一下如何借助第三方软件（快递助手）使用菜鸟电子面单。

步骤一：填写快递单发件人信息
步骤二：添加快递单模板
如您添加的面单样式为“自由”型，需要在快递单上打印出发货信息的，请先在模板中添加“发货信息”内容框，步骤如下（“菜鸟”样式的模板可直接进入步骤三）
步骤三：绑定打印机
步骤四：设置发货信息
步骤五：勾选订单打印。

电子面单服务使用手册

电子面单服务使用手册（网点操作版）总部营销中心-李超2016年3月7日电子面单服务使用手册 (1)1、电子面单服务介绍 (2)2、服务价值 (4)3、合作客户分类 (5)4. 网点开通电子面单流程（淘宝、天猫客户） ............. 错误！未定义书签。

一、淘宝商家后台申请使用电子面单操作流程： (5)二、网点使用流程 (7)5. 网点开通电子面单流程（线下客户）.................................................... 10-14一、客商平台开通、订单导入，面单打印流程：............................. 15-17二、电子面单一票多件操作使用流程：.............................................. 17-206. 处罚制度................................................................... 错误！未定义书签。

1-237. 常见问题................................................................... 错误！未定义书签。

3-251、电子面单服务介绍电子面单是指通过快递信息系统自动产生快递单号，具体实现流程是由快递公司向菜鸟预发物流单号，在快递公司预发的物流单号范围内，快递公司授权菜鸟向开通此项服务并通过物流宝系统向菜鸟申请物流单号的卖家下发物流单号。

当卖家产生销售订单并产生物流需求时，卖家可在绑定物流面单号后，生成物流面单信息，并利用热敏打印技术使用热敏纸按系统预先设置的格式打印的面单。

热敏纸打印依靠热感应显示文字，打印速度是普通针式打印机的4-6倍；大头笔（目的站）信息可自动打出，既节省人力成本又减少了人工误差，打印过程中损坏的面单可在订单打印状态信息回传系统前，重新打印减少面单的损耗。

关于快递鸟平台在线申请安能电子面单---操作流程20171101

用户通过快递鸟官网在线申请安能电子面单服务，待安能审核通过后，向用户分配账号。

同时，用户需线下联系安能网点充值单号数量，充值成功后，即可通过快递鸟接口实时打单、获取运单号。

客户与网点产生的单号与运费双方自行结算，相关费用快递鸟不参与结算。

申请流程
一、注册快递鸟账号
登录快递鸟官网：，使用手机号进行在线注册
二、申请快递鸟会员套餐
使用注册时的手机号码进行登录，申请会员套餐（免费、收费均可）
三、申请安能电子面单服务：
可通过如下方式申请“安能”电子面单账号：
1、快递鸟官网申请（推荐）：
A、登录快递鸟官网后台→电子面单→我的快递公司→申请新的快递公司→安能
B、填写发货地址(必需填写完整省市区以及详细地址，系统才能自动匹配出对应的揽件网点（申请页面下拉框选择）--建议客户最好先了解清楚与自己合作的线下网点的名称，方便申请时选择)及联系人（用于短信接收电子面单账号）。

2、通过对接快递鸟接口文档：
对接“申请电子面单客户号”及“申请客户号信息推送”接口，具体参数详见技术文档3.5、3.6。

四、安能反馈审核结果
由安能网点联系客户确认信息并审核（提交信息是否有误及是否需要发货），开通时效约“1-2”个工作日。

如审核通过，安能通过接口及时回传“账号（快递鸟已有，只需安能审核通过）”于快递鸟，如审核不通过，亦通过接口回传，快递鸟通过如下3种方式将审核结果同步給客户：
1 快递鸟系统短信通知到客户联系人手机（提交服务申请时预留的号码）。

重点推荐
A:审核通过
2、快递鸟后台系统—电子面单—账号信息A:审核通过
3、开发”申请客户号信息推送接口“用于接收账号图片略。

圆通快递电子面单接口对接说明全

圆通快递电子面单接口对接说明〔全〕.接口类型说明〕接口支持的消息接收方式：〕请求方法的编码格式()：""〕地址：〕接口提供：快递鸟〕快递编码：.请求系统级参数备注：必填〔〕，可选〔〕，报文中该参数在一定条件下可选〔〕。

.接口参数〕请求内容字段定义〕返回参数定义. 例如〕请求例如{"": "","": "","": ,"": ,"": ,"": ,"": {"": "","": "","": "","": "上海","": "上海","": "青浦区","": "明珠路号"},"": {"": "","": "","": "","": "北京","": "北京","": "朝阳区","": "三里屯街道雅秀大厦" },"": [{"": "鞋子","": ,"":}],"": [{"": "","": ""}],"": ,"": ,"": ,"": "小心轻放",""}〕返回例如失败：{"": "","": "","": "订单号已存在，请勿重复操作"，"":""}成功：{"": "","": {"": "","": "","": "","": "京朝阳(京)","": "","": "上海分拨中心","": "北京"},"":"此处省略打印模板内容","":"","":"调用时传入的","": ,"": "","": "成功"}对接源码;;;;;;;;;;;;**** 和请到官网申请：*{电商"请申请";电商加密私钥，注意保管，不要泄漏"请申请";请求, 正式环境地址："";*** 方式电子面单**() {"{'': '',""'':'',""'',""'',""'',""'':""{""'':'','':'','':'','':'上海','':'上海','':'青浦区','':'明珠路号'},""'':""{""'':'','':'','':'','':'北京','':'北京','':'朝阳区','':'三里屯街道雅秀大厦'},""'':""[{""'':'鞋子','',''}],""'',""'',""'',""'':'小心轻放',""''}";<, > <, >();("", (, ""));("", );("", "");(, , "");("", (, ""));("", "");(, );根据公司业务处理返回的信息......;}*** 加密* 内容* 编码方式**("")( , ) {("");(());[] ();();[] ;( < ) {("");}(());}()();}*** 编码* 内容* 编码方式**( , ) {(());;}("")( , ) {(, );;}*** 电商签名生成* 内容** 编码方式** 签名*("")( , , ) ,{( ){(( , ), );}((, ), );}*** 向指定发送方法的请求* 发送请求的* 请求的参数集合* 远程资源的响应结果*("")( , <, > ) {;;();{();() ();发送请求必须设置如下两行();();方法("");设置通用的请求属性("", "**");("", "");(""," (; ; )");("", "");();获取对象对应的输出流((), "");发送请求参数( ) {();(<, > : ()) {(()>){("");}(());("");(());(()":"());}(":"());(());}输出流的缓冲();定义输入流来读取的响应(((), ""));;(( ()) ) {();}} ( ) {();}使用块来关闭输出流、输入流{{(){();}(){();}}( ){();}}();}}对接源码<电商('') ('', '请申请');电商加密私钥，注意保管，不要泄漏('') ('', '请申请');请求，接口正式地址：('') ('', '');调用获取物流轨迹构造电子面单提交信息$ [];$[""] "";$[""] "";$[""] ;$[""] ;$ [];$[""] "李先生";$[""] "";$[""] "李先生";$[""] "深圳市";$[""] "福田区";$[""] "赛格广场";$ [];$[""] "李先生";$[""] "";$[""] "李先生";$[""] "深圳市";$[""] "福田区";$[""] "赛格广场";$ [];$[""] "其他";$ [];$[] $;$[""] $;$[""] $;$[""] $;调用电子面单$ ($, );$ ($)兼容〔含〕以下"电子面单接口提交内容：<>".$; $ ($);"<><>电子面单提交结果:<>".$;解析电子面单返回结果$ ($, );"<><>返回码:".$[""]; ($[""] "") {"<>是否成功:".$[""];}{"<>电子面单下单失败";}*** 方式查询订单物流轨迹*($){$ ('' > ,'' > '','' > ($) ,'' > '',);$[''] ($, );$(, $);根据公司业务处理返回的信息......$;}*** 提交数据* $ 请求* $ 提交的数据* 响应返回的*($, $) {$ ();($ $ > $) {$[] ('', $, $);}$ ('', $);$ ($);($['']''){$[''];}$[''];$ " " . $[''] . " \\";$ ":" . $[''] . "\\";$ "\\";$ ":" . ($) . "\\";$ "\\\\";$ $;$ ($[''], $['']);($, $);$ "";$ ;(($)) {(($ ($)) ($ "\\" $ "\")) {;}}(($)) {$ ($, );}($);$;}*** 电商签名生成* 内容** 签名*($, $) {((($.$)));}************************************************************** ** 使用特定对数组中所有元素做处理* $ 要处理的字符串* $ 要执行的函数* $ 是否也应用到上*************************************************************** ($, $, $ ){$ ;($ > ) {(' ');}($ $ > $) {(($)) {($[$], $, $);} {$[$] $($);}($ ($)) {$ $($);($ $) {$[$] $[$];($[$]);}}}$;}************************************************************** ** 将数组转换为字符串〔兼容中文〕* $ 要转换的数组* 转换得到的字符串*************************************************************** ($) {($, '', );$ ($);($);}>。

电子面单模板

电子面单模板电子面单是指通过电子方式生成的运输单据，用于记录货物的发货、收货等信息。

相比传统的纸质面单，电子面单更加便捷、环保，同时也更容易实现信息的实时更新和管理。

为了方便使用电子面单，我们可以利用电子面单模板来规范化和标准化运输单据的格式，从而提高工作效率和准确性。

首先，电子面单模板需要包括基本的运输单据信息，如发货人信息、收货人信息、货物信息、运输方式、运费等。

发货人信息包括发货人姓名、联系方式、地址等；收货人信息包括收货人姓名、联系方式、地址等；货物信息包括货物名称、数量、重量、体积等；运输方式包括运输方式的选择，如快递、物流等；运费包括运输费用的计算方式和金额等。

这些基本信息的准确记录对于货物的运输和交付至关重要，因此电子面单模板需要清晰地呈现这些信息，并且方便填写和管理。

其次，电子面单模板还需要考虑到不同运输方式和不同货物类型的特殊要求。

例如，对于不同的快递公司，他们可能有不同的运输单据格式和要求；对于不同类型的货物，可能需要不同的信息记录和标识。

因此，电子面单模板需要具有一定的灵活性，能够根据实际情况进行调整和定制，以满足不同运输方式和货物类型的需求。

另外，电子面单模板的设计也需要考虑到信息的可视性和易读性。

在填写和查看电子面单时，用户需要能够清晰地看到各项信息，并且能够快速准确地理解。

因此，电子面单模板的布局和字体选择需要尽可能简洁明了，避免信息混乱和不清晰的情况发生。

同时，合理的颜色搭配和标识符号的运用也能够提高电子面单的可视性和易读性。

最后，电子面单模板的使用也需要考虑到信息的安全性和保密性。

在电子面单中涉及到发货人和收货人的个人信息、货物的价值和性质等敏感信息，因此在设计电子面单模板时，需要做好信息加密和权限管理，防止信息泄露和不当使用。

综上所述，电子面单模板是电子商务时代不可或缺的工具之一，它能够规范化和标准化运输单据的格式，提高工作效率和准确性。

在设计电子面单模板时，需要考虑基本信息的完整性、灵活性、可视性和信息安全性，以满足不同运输方式和货物类型的需求，提高用户体验和信息管理的效果。

快递鸟电子面单接口-德邦电子面单模板预览效果

快递鸟电⼦⾯单接⼝-德邦电⼦⾯单模板预览效果快递鸟现在能⽀持所有常⽤快递公司电⼦⾯单打印，四通⼀达，顺丰，邮政等，⼤部分电商需要⽤到这个接⼝，在实际对接快递鸟电⼦⾯单的时候很多⼈都会有疑问:如何解析接⼝返回的⼀⼤段json字符串，使它呈现为我们打印效果的电⼦⾯单图⽚效果？下⾯我以德邦电⼦⾯单请求为例，跟⼤家分享⼀下我的经验。

请求电⼦⾯单接⼝成功后，会返回图⼀数据，PrintTemplate参数中包含了电⼦⾯单模板的信息，我们要做的就是处理printTemplate参数中的数据，使其以html的⾯单样式显⽰。

PrintTemplate内容：<!DOCTYPE html><html lang="zh-CN"><head><meta charset="utf-8"/><style>* {margin: 0;padding: 0;}.print_paper {font-size: 14px;font-family: "微软雅⿊";border: none;border-collapse: collapse;width: 375px;margin-top: -1px;table-layout: fixed;}.print_paper td {border: solid #000 1px;padding: 0 5px;overflow: hidden;}.x-table {border-collapse: collapse;border-spacing: 0;border: 1px solid #000;width: 375px;}.x-table td {border: 1px solid #000;padding: 0 5px;}.table_first {margin-top: 0;}.print_paper .x1 {font-size: 32px;font-weight: bold;text-align: center;letter-spacing: 5px;line-height: 0.95;font-family: "微软雅⿊";}.print_paper .x4 {font-size: 20px;font-weight: bold;font-family: "微软雅⿊";}.print_paper .xx8 {font-size: 8px;}.print_paper .xx10 {font-size: 12px;}.print_paper .xx12 {font-size: 12px;font-weight: bold;}.print_paper .xx14 {font-size: 12px;font-family: "微软雅⿊";}.print_paper .xx16 {font-size: 16px;font-weight: bold;font-family: "微软雅⿊";}.print_paper .xx18 {font-size: 8px;font-weight: bold;font-family: "微软雅⿊";text-align: right;}.print_paper .xx48 {font-size: 40px;font-weight: bold;text-align: center;font-family: "微软雅⿊";}.no_border {width: 100%;height: 100%;font-size: 14px;}.no_border td {border: none;vertical-align: top;}.fwb {font-weight: bold;}</style></head><body><table class="x-table"><tr height="34"><td><img height="30" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAG0AAAAuCAMAAAAV6memAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYW </body></html>这⾥提供两个⽅法供⼤家参考:1、使⽤C#开发语⾔，将printTemplate内容放在html页⾯的div层中显⽰：(1)、在显⽰信息的*.aspx页⾯中定义⼀个id为“printHTML”的div层。

快递鸟接口技术文档说明书

快递鸟接口(API)技术文档1前言 (5)2接口规范说明 (5)2.1接口规范及说明 (5)2.1.1报文及报文编码 (5)2.1.2接口数据包结构 (5)2.1.3JSON示例 (6)2.1.4系统级参数 (6)2.1.5流程示意图 (7)2.2签名说明 (7)2.2.1关于签名 (7)2.2.2(C#)DataSign签名加密代码 (9)3下单类接口 (10)3.1接入步骤 (10)3.2预约取件接口 (11)3.2.1功能说明 (11)3.2.2基本信息 (11)3.2.3接口规则 (12)3.2.4支持情况 (12)3.2.5应用级参数 (12)3.2.6返回参数 (17)3.3预约取件取消接口 (17)3.3.1功能说明 (17)3.3.2基本信息 (17)3.3.3接口规则 (18)3.3.4支持情况 (18)3.3.5应用场景 (18)3.3.6应用级参数 (18)3.3.7返回参数 (19)3.4电子面单接口 (19)3.4.1功能说明 (19)3.4.2基本信息 (19)3.4.3应用场景 (20)3.4.4接口规则 (20)3.4.6应用场景 (21)3.4.7应用级参数 (21)3.4.8返回参数 (30)3.5电子面单取消接口 (35)3.5.1功能说明 (35)3.5.2基本信息 (36)3.5.3接口规则 (36)3.5.4支持情况 (36)3.5.5应用级参数 (36)3.5.6返回参数 (37)3.6电子面单追加子单接口 (37)3.6.1功能说明 (37)3.6.2基本信息 (37)3.6.3应用级参数 (38)3.6.4返回参数 (38)3.7获取电子面单文件接口 (39)3.7.1功能说明 (39)3.7.2基本信息 (39)3.7.3应用级参数 (39)3.7.4返回参数 (40)4轨迹查询类接口 (42)4.1即时查询接口 (42)4.1.1功能说明 (42)4.1.2基本信息 (42)4.1.3接口规则 (42)4.1.4支持情况 (42)4.1.5应用场景 (42)4.1.6应用级参数 (42)4.1.7返回参数 (43)4.2物流跟踪 (45)4.2.1轨迹订阅接口 (45)4.3单号识别接口 (64)4.3.1功能说明 (64)4.3.2基本信息 (64)4.3.3接口规则 (64)4.3.4应用级参数 (64)4.3.5返回参数 (65)5增值类接口 (66)5.1在途监控-国内版 (66)5.1.1即时查询接口(增值版) (66)5.1.2物流跟踪接口(增值版) (72)5.2快递查询接口 (78)5.2.1功能说明 (78)5.2.2基本信息 (78)5.2.3接口规则 (78)5.2.4支持情况 (78)5.2.5应用场景 (78)5.2.6应用级参数 (78)5.2.7返回参数 (79)5.3在途监控-国际版 (84)5.3.1物流跟踪接口(国际版) (84)5.4物流查询地图接口 (86)5.4.1即时查询接口(地图版) (87)5.4.2物流跟踪接口(地图版) (95)5.5短信服务 (100)5.5.1短信模板接口 (101)5.5.2短信发送接口 (103)5.5.3短信黑名单接口 (105)5.6智能地址解析接口 (106)5.6.1功能说明 (106)5.6.2基本信息 (106)5.6.3应用级参数 (106)5.6.4返回参数 (107)6附录 (109)6.1对接相关资料 (109)6.2电子面单模板规格 (109)6.3返回编码列表 (116)7技术支持 (117)1前言快递鸟API旨在为电商、电商平台、物流工具、打单工具、仓储系统、移动APP等系统提供专业、稳定、优质的API接口服务，满足不同用户的物流管理需求。

快递鸟电子面单批量打印以及模板设置

最后发布上线，这就对接成功可以使用啦。电子面单接口调用成功后接口会直接返回HTML电子面单模板，可以直接使用浏览器打印，或者使用HTML控件进行打印。
批量打印的流程： 1、先调用电子面单打印接口获得必须字段：OrderCode(订单号) 2、拼接组合打印的数据data：格式json_encode([0=>['OrderCode' => '订单号1', 'PortName' => '打印机名称']]); 3、签名所需参数：（1）、第二部拼接好的data，如下图：
//调用获取物流轨迹 //-------------------------------------------------------------
//构造电子面单提交信息 $eorder = []; $eorder["ShipperCode"] = "SF"; $eorder["OrderCode"] = "PM201604062341"; $eorder["PayType"] = 1; $eorder["ExpType"] = 1;
'EBusinessID' => EBusinessID, 'RequestType' => '1007', 'RequestData' => urlencode($requestData) , 'DataType' => '2', ); $datas['DataSign'] = encrypt($requestData, AppKey); $result=sendPost(ReqURL, $datas);

圆通电子面单申请及对接打印说明

String
R
电商用户ID
Order
OrderCode
String
R
订单编号
ShipperCode
String
R
快递公司编码
LogisticCode
String
R
快递单号
MarkDestination
String
O
大头笔
OriginCode
String
O
始发地区域编码
OriginName
String
O
备注
AddService
Name
String
0
增值服务名称
Value
String
0
增值服务值
CustomerID
String
0
客户标识(选填)
Commodity
GoodsName
String
R
商品名称
GoodsCode
String
O
商品编码
Goodsquantity
Int
O
件数
GoodsPrice
"'IsReturnPrintTemplate':1}";
Map<String, String> params = new HashMap<String, String>();
params.put("Requቤተ መጻሕፍቲ ባይዱstData", urlEncoder(requestData, "UTF-8"));
params.put("EBusinessID", EBusinessID);