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

1、快递鸟电子面单接口说明文档快递鸟2017-04-25版本日期版本说明作者2017-04-252.0创建文档，第一版请参考接口技术文档V4.2.1第三章3.3电子面单蒋雪姣刖言1、业务背景随着电子商务和物流信息化服务的迅猛发展，电子面单已经成为了商家快速发货并连 接订单与物流的有力工具。快递鸟电子面单接口是快递鸟提供给独立电商、仓储管理系统、 打单软件、物流供应链等物流系统平台使用的物流下单接口，满足商家在线发货需求并提供打印电子面单的服务。商家通过贵司系统选择物流公司发送请求通知快递公司有快递要发货， 贵公司把数据通过此接口转发到快递鸟，由快递鸟为商家通知对应的快递公司快递员上门取件。电子面单

2、成功下单后，快递鸟系统内将自动订阅，一旦轨迹发生变化时，快递鸟将调用 贵司推送接收接口将物流信息反向推送至商家。同时若客户使用代收货款服务，快递鸟会将代收货款的货款状态独立推送给商家用户。电子面单具有如下特点：打印效率高相比传统针式打印机套打模式，打印速度提升6-8倍，热敏打印机打印速度平均30-40张/分。发货效率高包裹出库时减少了抽底单的工序，降低了操作成本、提升操作效率，运单和订单即时绑定，无需人工再次扫描绑定发货。目前商家在使用电子面单的过程中也存在一些情况导致部分用户无法顺畅使用，例如： 大电商有多家合作快递公司，各家快递公司的模板尺寸不一，需要使用多个打印机 打印面单。单号作废后回

3、收机制不完善导致电商成本升高。二联电子面单无底单，运费核账存在问题（部分商家货物重量以称重为准）。打印时发现面单号余额不足，耽误发货。小B电商发货量不够申请网点的电子面单服务。快递鸟电子面单接口为解决客户以上问题，新增如下解决方案：电子面单余量查询： 可通过电子面单余量查询接口查询，并且在快递鸟官网可设置余额不足提醒值（后续会加上余额不足短信/邮件提醒功能）电子面单取消/回收：可通过电子面单取消接口， 回收部分加盟快递公司的面单号。 通用电子面单模板，含二联、三联模板 快递公司电子面单客户号在线申请散户模式电子面单：部分快递公司无需申请电子面单客户号即可直接打印电子面单。2、名词解释1电子面单

4、一种新型的快递面单。材料为热敏纸，有成本低、打印快、单号方便获取、管理等特点。2大客户与快递公司签订合作协议的客户，有快递公司客户号或月结账号。此类客户支持运费月结、到付、现付。3散户与快递公司无合作关系，无客户号，支持运费现付/到付运费。快递鸟电子面单方案1、编码规范目前接口支持了：顺丰（SF）、EMS（EMS、宅急送（ZJS）、圆通（YTO、百世快递（HTKY、 中通（ZTO、韵达（YD）、申通（STC）、德邦（DBL）、优速（U0、京东（JD）、信丰（XFEX、 全峰（QFKD、跨越速运（KYSY、安能小包（ANE）、快捷快递（FAST、国通（GTO、天天 快递（HHTT,后续更多的快递

5、公司正在对接中。散户模式（无需电子面单客户号）支持快递公司：顺丰（SF）、EMS（EMS （仅支持广东省内发货）、快捷快递（FAST、宅急送（ZJS），后续更多的快递公司正在对接中。电子面单客户号在线申请支持快递公司：优速（UC、后续更多的快递公司正在对接中。余量查询接口支持快递公司：中通（ZTO、韵达（YD、优速（UC）、后续更多的快递公司正在对接中。面单回收接口支持快递公司：优速（UC、后续更多的快递公司正在对接中。2、业务流程商家需要做什么商家使用流程配置物料f O 1s J厂1鮭：淮凿打印他理磋审!17印砥.3畢!j国兩敏天:、）a）电子面单需要使用热敏打印机，可与当地网点申请或自行通

6、过淘宝、京东等电商平台购买，目前市场上支持的厂家和型号包括：斑马G886T、启锐、佳博等b）打印纸：电子面单需要使用热敏纸，可与当地网点申请打印纸物料或者自行在淘宝等电商平台、线下文具店购买，打印纸尺寸需要根据打印模板尺寸购买或定制。商家在线申请电子面单客户号 截图：申请服务商的界面截图截图：申请服务商的提交界面截图快丑公司：此熊必M祐iifFfi可韦亘区订毎同r:尸蒂k；中咱月薛仔侍EiS蹴九列可百ISFiiE.匸无刑不的JH,待网点除番幵iii*选择网点：网点为根据发货地址自动匹配，若有多个需您自行选择， 快递公司总部审核通过后会分配正确的网点。申请快递公司电子面单客户号说明：a）电子面单

7、客户号即请求打印面单时的用户账号或月结编码或客户编码，不同物流服务商的叫法不同而已。b）若商家无需月结运费，电子面单API请求参数CustomerName "电子面单客户账号” 无需填写可直接请求打单， 无需申请电子面单客户号。 支持快递公司：顺丰（SF）、 EMS（EMS （仅支持广东省内发货）、快捷快递（FAST、宅急送（ZJS），后续更多 的快递公司正在对接中。c）若商家已有电子面单客户号，则对接快递鸟电子面单API请求参数 CustomerName“电子面单客户号”输入商家的客户号和密码通过验证即可打单。d）在线申请客户号说明：因为物流快递商运营模式的不同（分为加盟和直营），

8、加盟型运营商是以网点为单位进行账户核算，所以您需要和每个快递网点建立合作，通过快递鸟申请服务后，网点会联系您审核并且办理单量充值。而直营型服务商由快递总部与发货人绑定运费结算关系，无需再联系快递公司充值单号，直营快递公司审核通过后即可打单。目前支持在线申请客户号的快递公司：优速（uo,后续更多的快递公司正在对接中。电子面单余量提醒值设置快递鸟官网-用户管理后台-电子面单-账户信息-批量设置余量不足提醒值。系统对接需要做什么快递鸟接口对接通用流程：8注lu歸 一 0橋謬 一 0強;m +験爾试 一 珈fl电子面单接口对接流程:a)注册快递鸟ID:b)实名认证:V缎半ffiPTawE台smn

9、87;APlfflWBmH冒運卡W霍U讣辑干丄丙 白円豊茅，快蛀串SPS® : 荒药昌© :Ml号U4leidiinAPI keSc6cb7d6-ci61 d-4fi lc-bc-irfdlacedblSc SSSSSZtv«®«f用鬥咎砥vttnspjhiiiTsftPWV9w)n.»E.刊EiSaskooe:B2C至工立用EftPUTZM毛E轉B2BX<t3O2OMwsr腊北尹右旬RDCMS : !&27rU*0 斛F号吕OW : S2ISS742CM 貝旨丹HIWC8 !葩他6®虫 Clli 十一;Ijj

10、l*K醫«er<QXWhAPPc）申请电子面单 API:在快递鸟用户管理后台-申请API页面，点击申请电子面单API，快递鸟审核通过后即可开始对接。d)对接联合注册接口： 若贵司平台系统有多家发货商家， 建议同时对接联合注册接口， 以 便区分您平台用户，并实现各发货商家独立使用代收货款服务。接口文档参考：快递鸟代收货款-1.1用户注册接口。 非必需接入。e）对接电子面单接口：请参考第三章：接口说明f）前端界面开发：您需要为商家增加打印电子面单的组件，包括：添加电子面单打印模板（模板保存在系统本地或通过接口即时在线获取均可）、商家绑定电子面单客户账号（账号、密码、取件网点等信息，

11、具体参考快递鸟电子面单参数配置对照表，建议在商家选择快递公司打印模板时让商家输入提交保存。 ）、打印界面和控件调试（偏移调试）。3、系统设计规范添加电子面单打印模板/添加快递公司界面示例:时：时 .EM5 .快麻溝瑶人面单叶号fcnacw Qi罠応 W) * O QQrrm " 1 $ >nrS：寻匡丸可为空林 I l MWI 44|WMM111 mi mm v訂畑當丰玄芒瓦(ZTOntTiftl ' I J SHIfi商家需要绑定电子面单账号信息，建议根据快递鸟电子面单参数配置对照表显示各家快jimiiiniiiii1 ”. |Ui 1*#*. ._ <n .

12、d-irv 料J * 一 *a.M 4 m!'!1D - 121 - 739I II I rii'iIIIIMIIIIIIIIM l_r "XrU _,-R.« ：1 = 4T递公司需要输入的字段。4、应用场景说明下单+打印a）商家操作发货时同步订单的发/收件人信息、货物信息，通过接口直接发送到 快递公司获取电子面单单号、大头笔、电子面单打印模板等信息。通过浏览 器或CS结构客户端打印工具进行打印电子面单。筛单a）电子面单下单时快递公司需要确认订单是否在收派范围之内，故需要将订单信息的收件地址和寄件地址进行筛单校验。取消/回收单号a）已生成电子面单运单号的面

13、单，在快递公司未揽件前可申请取消面单。b) 面单号取消后，加盟型快递公司大客户号的面单会按每家快递公司规则回收，余量对应加1。c) 每个面单号只支持取消一次。d) 每个客户号取消的单号总量不能超过获取单号数量的20%e) 快递公司回收单号机制配置表如下：快递公司手动取消自动取消/回收EMS不支持不支持顺丰不支持不支持圆通不支持每月10日左右回收往前两个月一整月浪费 面单号。如当前月为 4月，则回收2月整月 已拉取无物流路由信息的电子面单单号，返 款给站点，由站点与商家结算回收单号。百世支持单号获取后2个月内无路由信息，自动回收 单号，返款给站点，由站点与商家结算回收 单号。中通快递鸟暂不支持快

14、递鸟暂不支持韵达支持单号获取后 30天无路由信息，自动回收单 号，单号可以再次使用。申通快递鸟暂不支持不支持德邦快递鸟暂不支持单号获取后 30天无路由信息，自动回收单 号优速请求取消后15天无路由 信息回收单号单号获取后 30天无路由信息，自动回收单号宅急送不支持不支持京东不支持不支持信丰不支持不支持全峰不支持不支持跨越速运不支持不支持安能不支持单号获取后 30天无路由信息，自动回收单 号。快捷不支持不支持天天快递鸟暂不支持快递鸟暂不支持国通快递鸟暂不支持不支持电子丙单取消；同戊活祚幻单球(+快丘弓型:晌血早芒恨虔上司走扭底件鮭耐已羸夢片弋囂&吋砂吕也選取吕自成 臣习，习皐nr?肚耳击

15、空_一罡舌常主凹牧. _r覷購”/ J、 出才可十1rt Jta! . -FtoTW余量查询a) 与网点预充值单量情况下才需要查询余量。散户模式无需查询余量。b) 直营快递公司无需查询余量。C) 单量查询快递公司配置表。快递公司是否支持EMS不支持顺丰不支持圆通快递鸟暂不支持，请至官网查询百世快递鸟暂不支持，请至官网查询中通支持韵达支持申通快递鸟暂不支持，请至官网查询德邦快递鸟暂不支持，请至官网查询优速支持宅急送快递鸟暂不支持，请至官网查询京东快递鸟暂不支持，请至官网查询信丰快递鸟暂不支持，请至官网查询全峰快递鸟暂不支持，请至官网查询跨越速运快递鸟暂不支持，请至官网查询安能快递鸟暂不支持，请至

16、官网查询快捷快递鸟暂不支持，请至官网查询天天快递鸟暂不支持，请至官网查询国通快递鸟暂不支持，请至官网查询三、接口说明1.1电子面单功能说明电子面单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口，满足客户在线发货需求并提供打印面单的服务，客户通过网络选择物流公司发送请求通知贵公司有快递要发货，贵公司把数据通过此接口转发到快递鸟，由快递鸟为您通知对应的快递公司快递员上门取件。电子面单成功下单后，快递鸟系统内将自动订阅，一旦轨迹发生变化时，快递鸟将调 用客户方推送接收接口。同时若客户使用代收货款服务，快递鸟会将代收货款的货款状态独立推送给用户。接口规贝y、只支持Js

17、on格式。接口指令1007。（2）、订单编号（OrderCode）不可重复提交，重复提交系统会返回具体错误代码。（3）、目前接口支持了 ：顺丰（ SF）、EMS（ EMS、宅急送（ZJS）、圆通（YTO、百世快 递（HTKY、中通（ZTC）、韵达（YD）、申通（STQ、德邦（DBL） 优速（UQ、京东（JD）、 信丰（XFEX、全峰（QFKD、跨越速运（KYSY、安能小包（ANE）、快捷快递（FAST、国 通（GTO、天天快递（HHTT,后续更多的快递公司正在对接中。散户模式（无需电子面单客户号）支持快递公司：顺丰（SF）、EMS（ EMS （仅支持广东省内发货）、优速（UC、快捷快递（FAS

18、T、宅急送（ZJS）,后续更多的快递公司正在对 接中。（4）、测试地址：（5）、正式地址：（6）、请求报文中不允许岀现以下特殊字符：'"# & + < >系统级和应用级输入参数系统级输入参数应用级输入参数类型是否必须描述RequestData （必填CallBackStri ngO用户自定义回调信参数，请求内容， JSON格式，须和DataType 致）MemberlDStri ng O会员标识平台方与快递鸟统一用户标识的商家ID电子面单客户账号CustomerNameStri ngCustomerPwdStri ng OSen dSiteStri ng

19、OShipperCodeStringRLogisticCodeStri ng OThrOrderCodeStri ngOrderCodeStri ngMon thCodeStri ngPayTypeIntExpTypeStri ngIsNoticeIntOCostDoubleOtherCostDouble OeceiverCompa nyStri ng O（与快递网点申请或通过快递鸟官网申请或通过申请电子面单客户号申请）电子面单密码收件网点标识快递公司编码快递单号第三方订单号订单编号月结编码邮费支付方式：1-现付，2-到付，3-月结，4-第三方支付快递类型：1-标准快件是否通知快递员上门揽件：

20、0-通知；1-不通知；不填则默认为1寄件费（运费）其他费用收件人公司NameStri ngR收件人TelStri ngR电话与手机，必填一个MobileStri ngPostCodeStri ngO收件人邮编Provi nceNameStri ngR收件省（如广东省，不要缺少“省”）CityNameStri ngR收件市（如深圳市，不要缺少“市”）ExpAreaNameStri ngO收件区（如福田区，不要缺少“区”或“县”）AddressStri ngR收件人详细地址SenderCompa nyStri ngO发件人公司NameStri ngR发件人TelStri ngR电话与手机，必填一个

21、lMobileStri ngPostCodeStri ngO发件人邮编Provi nceNameStri ngR发件省（如广东省，不要缺少“省”）CityNameStri ngR发件市（如深圳市，不要缺少“市”）Stri ngO发件区（如福田区，不要缺少“区”或“县”）ExpAreaNameAaddressStri ngR发件详细地址StartDateStri ngO上门取货时间段："yyyy-MM-ddHH:mm:ss"格式化，本文中所有时间格En dDateStri ngO式相同WeightDoubleO物品总重量kgQuan tityIntO件数/包裹数VolumeD

22、oubleO物品总体积m3RemarkStri ngO备注NameStri ng0增值服务名称AddServiceValueStri ng0增值服务值CustomerIDStri ng0客户标识（选填）CommodityGoodsNameStri ngR商品名称GoodsCodeStri ngO商品编码Goodsqua ntityIntO件数GoodsPriceDoubleO商品价格GoodsWeightDoubleO商品重量kgGoodsDescStri ngO商品描述GoodsVolDoubleO商品体积m3IsReturnPri ntTemplateStri ngO返回电子面单模板：0-

23、不需要；1-需要TemplateSizeStri ngO模板尺寸EBus in essIDStri ngR商户IDRequestTypeStri ngR请求指令类型：1007DataSig nStri ngR数据内容签名DataTypeStri ngR请求、返回数据类型：2-jso n返回结果参数同步返回参数名称类型必须要求说明EBus in essIDStri ngR电商用户IDOrderOrderCodeStri ngR订单编号ShipperCodeStri ngR快递公司编码LogisticCodeStri ngR快递单号MarkDesti natio nStri ngO大头笔Origi

24、 nCodeStri ngO始发地区域编码Origi nN ameStri ngO始发地/始发网点Desti natioCodeStri ngO目的地区域编码Dest in atioNameStri ngO目的地/到达网点Sort in gCodeStri ngO分拣编码PackageCodeStri ngO集包编码SuccessBoolR成功与否ResultCodeStri ngRI错误编码ReasonStri ngO失败原因Uni querRequestNumberStri ngR唯一标识Prin tTemplateStri ngO面单打印模板EstimatedDeliveryTimeSt

25、ri ngO订单预计到货时间 yyyy-mm-ddCallbackStri ngO用户自定义回调信息SubCou ntIntO子单数量SubOrdersStri ngO子单号SubPri ntTemplatesStri ngO子单模板ReceiverSafePh oneStri ngO收件人安全电话Sen derSafePh oneStri ng0寄件人安全电话DialPageStri ngR拨号页面网址（转换成二维码可扫描拨号）1.2电子面单余量查询接口功能说明用户查询客户号在快递公司的单号剩余量。接口规贝y(1) 、接口只支持Json格式参数，接口指令1127。只支持POST青求方式，ut

26、f-8编码。(2) 、目前支持快递公司：优速，后续更多的快递公司正在对接中。系统级和应用级输入参数系统级输入参数类型应用级输入 参数必须要求描述RequestData (必 填参数，请求内 容，JSON格式,须禾口 DataType 一致)Stri ngShipperCodeR快递公司编码Stri ngCustomerNameR电子面单账号Stri ngCustomerPwdO电子面单密码Stri ngStatio nCodeO网点编码Stri ngStati on NameO网点EBus in essIDStri ngR电商IDRequestTypeStri ngR请求指令类型：1127Da

27、taSig nStri ngR数据内容签名DataTypeStri ngR请求、返回数据类型：2-json ;返回结果参数参数名称类型必须要求说明Ebus in essIDStr ingR用户IDSuccessBoolR成功与否：true,falseReasonStr ingO原因ResultCodeStr ingR返回结果编号EorderBala neeTotalNumIntO累计充值数量，电子面单总 量（包含已使用/未使用）AvailableNumIntO可用量（剩余量）"ShipperCode": "UC","CustomerName&q

28、uot;: "80238728","CustomerPwd": "c0bfe0ba86b66bae5426303c53db0a81","Statio nCode": "3001","StationName":"福田网点”1.2.5 JSON请求示例1.2.6 JSON返回示例"EBusi nessID": "1261602", "Success": true,"Reaso n":&quo

29、t;", "ResultCode": "100", "EorderBala nee": "AvailableNum": 0, "TotalNum": 01.3电子面单单号取消功能说明快递鸟通用接口提交快递公司编码、快递单号，则可以取消提交单号。 仅支持未揽件状态快递单进行取消，取消后的回收规则以快递公司为准。接口规则(1) 、接口指令 1147。(2) 、目前支持快递公司：优速，后续更多的快递公司正在对接中。系统级和应用级输入参数系统级输入参数类型应用级输入参数必须要求描述Reques

30、tData (必 填参数，请求内 容，JSON格式,须 和 DataType 一致)Stri ngShipperCodeR快递公司编码Stri ngExpNoR运单号Stri ngCustomerNameR客户号Stri ngCustomerPwdO客户号密码EBus in essIDStri ngR电商IDRequestTypeStri ngR请求指令类型：1147DataSignStri ngR数据内容签名DataTypeStri ngR请求、返回数据类型：2-json ；返回结果参数参数名称类型必须要求说明Ebus in essIDStri ngR用户IDSuccessBoolR成功与否

31、：true,falseResultCodeStri ngO结果编码ReasonStri ngO原因1.3.5 Json请求示例"ShipperCode": "UC","ExpNo": "9","CustomerName": "80238728","CustomerPwd": "c0bfe0ba86b66bae5426303c53db0a8b"1.3.6 Json请求返回示例"EBusi nessID": "

32、1261602", "Success": true, "ResultCode": "100"1.4申请电子面单客户号功能说明客户通过快递鸟平台向快递公司申请客户号接口规贝y(1)、接口只支持Json格式参数，接口指令1107。只支持POST请求方式，utf-8编码。(2)、测试地址：/ap i/apiservice(3) 、正式地址：/api/apiservice(4) 、目前支持快递公司： 优速，后续更多的快递公司正在对接中。系统级和应用级输入参数系统级输入参 数类型应用级输入 参数必须要求描述RequestData（必填

33、参数，请 求内容，JSON 格式,须和DataType 一 致）stri ngShipperCodeR快递公司编码Statio nCodeR网点编码Stati onN ameR网点ApplyIDO申请ID （用户记录在快递公司的标识）Compa nyO公司NameR联系人TelC电话MobileC手机Provi nceNameR省份Proiv nceCodeO省编码CityNameR城市CityCodeO城市编码ExpAreaNameR区县ExpAreaCodeO区县编码AddressR详细地址EBus in essIDStri ngR电商IDRequestTypeStri ngR请求指令类型

34、：1107DataSig nStri ngR数据内容签名DataTypeStri ngR请求、返回数据类型：2-json ;返回结果参数参数名称类型是否必须描述Ebus in essIDStri ngR用户IDSuccessBoolR成功与否：true,falseResultCodeStri ngO结果编码ReasonStri ngO原因1.4.5 Json请求示例"ShipperCode": "UC", "Compa ny": "XXX", "ApplylD":"",&qu

35、ot;Name": "hoo123","Tel":"","Mobile": "156", "ProvinceName":"广东省", "Proivn ceCode": "440000", "CityName":"深圳市", "CityCode": "440300", "ExpAreaName":"宝

36、安区", "ExpAreaCode": "440306", "Address":"西乡","StationCode":"西乡网点", "StationName":"西乡网点” 1.4.6 Json请求返回示例"EBusi nessID": "1261602", "Success": true,"Reaso n":"提交申请成功 "Resu

37、ltCode": "100"1.5申请客户号信息推送功能说明将审核通过客户号信息发送到用户配置的接收地址。接口规则(1) 、接口指令 1117。(2) 目前支持快递公司：优速，后续更多的快递公司正在对接中。系统级和应用级输入参数系统级输入参数类型应用级输入参 数必须要求描述PushData (请求内 容，JSON格式，须和DataType 一致)Stri ngCustomerNameR客户号Stri ngCustomerPwdR客户号密码Stri ngStatio nCodeR网点编号Stri ngStati onN ameR网点名称EBus in essIDSt

38、ri ngR用户标识RequestTypeStri ngR请求指令类型：1117PushTimeStri ngR推送时间返回结果参数参数名称类型必须要求说明EBus in essIDStri ngR请求用户标识RequestTypeStri ngR请求指令SuccessBoolR成功与否MessageStri ngO返回消息1.5.5 Json请求示例RequestData="CustomerName": "80237910","CustomerPwd": "c0bfe0ba86b66bae5426303c53db0a8b&

39、quot;,"StationCode":"闵行八部","StationName":"闵行八部"&EBusi nesslD=1261602&PushTime=2017-04-18 23:34:29&RequestType=11171.5.6 Json请求返回示例"EBusi nessID": "1261602", "Message":"成功", "RequestType": "1117", "Success": true1.6增值服务列表名称代码说明备注普通代收 货款CODValue为货款，保留3位小数。快递公司自有代收货 款业务货款直退CODBA