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

合集下载

快递物流寄件下单api接口调用对接

快递物流寄件下单api接口调用对接为了让你对接更简单，我会分享源代码，把源码复制到你的项目上，就能快速完成电商售后退货快递寄件下单预约快递员上门取件接口对接，调用快递鸟提供的上门取件API标准接口，成功调用后，快递员会准时上门取件，同时支持快递单号物流轨迹查询，快递鸟物流单号查询api接口不区分开发语言，支持Java，C#，PHP，Python，ObjectC等开发语言的程序调用。

1 接口规范说明1.1 接口规范及说明1.1.1 报文及报文编码报文格式：Json格式请求方法的编码格式(utf-8)：交互协议上统一用UTF-8，避免传递中文数据出现乱码。

1.1.2 接口数据包结构图例- 数据包结构(系统级{数据})1.1.3 JSON示例1.1.4 系统级参数*快递所有接口统一使用此系统级参数，根据不同的请求接口指令接入不同的接口。

1.1.5 流程示意图1.1.6 名词定义1.2 签名说明1.2.1 关于签名快递鸟和第三方电子商务公司系统进行对接，有一定的安全机制。

采用IP认证加签名的方式对接，具体方案如下：1. 防止数据被篡改2. 注：DataSign生成后，对方接收到数据后，以同样的算法进行签名(推送接口RequestType为101/102不需要进行URL编码)，生成摘要，对比两者的摘要是否相同，如果不同，说明传递过程中发生数据篡改。

2.调用接口的身份认证注册成为快递鸟用户后，会生成对应的用户ID和APIKey，用户ID相当于用户名，APIKey相当于密码。

举例：1.假设2.那么DataSign签名的内容为3.接收方收到数据后，获得EBusinessID 和RequestData和DataSign等这几个数据。

4.接收方对EBusinessID得到APIKey，RequestData+APIKey的数据进行md5和base64后的内容就为OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE=5.接收方判断签名后的数据跟传递过来的DataSign是否一致，如果一致进行业务操作，如果不一致返回错误。

php快递鸟单号查询api接口免费对接调用

php快递鸟单号查询api接⼝免费对接调⽤快递鸟集成快递单号查询API接⼝，可以同时对接顺丰快递查询，中通、申通、圆通、韵达、百世、EMS等国内外418家物流快递公司接⼝查询等。

这些快递物流企业，提供了快递单号⾃动识别接⼝，快递单号查询接⼝等快递物流服务。

对于电商企业，ERP服务企业，集成此接⼝到⾃⼰的软件中，增加了企业的竞争⼒。

⼀、接⼝应⽤场景1.在电商平台购物后，通过购物订单跟踪物流时，调⽤此API获取物流信息详情2.处理运费对账时，⼀键获取运单物流状态3.批量跟踪及获取运单物流信息对接流程快递鸟⽹站申请接⼝KEY并认证-对接接⼝-调试-上线使⽤三、技术对接快递鸟提供的快递查询接⼝，⽀持418家快递物流查询，涵盖了国内外主流快递服务企业的单号查询，信息及时，数据完整。

登录快递鸟官⽹⽀持多种开发语⾔对接，包括JAVA，C#，PHP等。

根据您的开发语⾔，选择参考对应的代码⽰例，下⾯以PHP代码为例：<?php//电商IDdefined('EBusinessID') or define('EBusinessID', '123456');//电商加密私钥，快递鸟提供，注意保管，不要泄漏defined('AppKey') or define('AppKey', '1234567890');//请求url：测试地址//defined('ReqURL') or define('ReqURL', ':8080/kdniaosandbox/gateway/exterfaceInvoke.json');//请求url：正式地址defined('ReqURL') or define('ReqURL', '/Ebusiness/EbusinessOrderHandle.aspx');$kgs = "JD";//快递公司简称，官⽅有⽂档$number = "12345678";//快递单号//调⽤查询物流轨迹//---------------------------------------------$logisticResult=getOrderTracesByJson($kgs,$number);echo$logisticResult;//解析数据$data = json_decode($logisticResult,true);if($data['Success'] == true){//返回信息成功$str = "";if(isset($data['Traces']) && !empty($data['Traces'])){for($i=0;$i<count($data['Traces']);$i++){$str .= "时间：".$data['Traces'][$i]['AcceptTime']."<br/>地址：".$data['Traces'][$i]['AcceptStation']."<br/>";}}echo "您查询的单号是：".$data['LogisticCode']."<br/>物流信息：<br/>".$str."";}//---------------------------------------------/*** Json⽅式查询订单物流轨迹*/function getOrderTracesByJson($kgs,$number){$requestData= "{'OrderCode':'','ShipperCode':'$kgs','LogisticCode':'$number'}";$datas = array('EBusinessID' => EBusinessID,'RequestType' => '1002','RequestData' => urlencode($requestData) ,'DataType' => '2',);$datas['DataSign'] = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);//根据公司业务处理返回的信息......return$result;}/*** post提交数据* @param string $url 请求Url* @param array $datas 提交的数据* @return url响应返回的html*/function sendPost($url, $datas) {$temps = array();foreach ($datas as$key => $value) {$temps[] = sprintf('%s=%s', $key, $value);}$post_data = implode('&', $temps);$url_info = parse_url($url);if(empty($url_info['port'])){$url_info['port']=80;}$httpheader = "POST " . $url_info['path'] . " HTTP/1.0\r\n"; $httpheader.= "Host:" . $url_info['host'] . "\r\n";$httpheader.= "Content-Type:application/x-www-form-urlencoded\r\n"; $httpheader.= "Content-Length:" . strlen($post_data) . "\r\n"; $httpheader.= "Connection:close\r\n\r\n";$httpheader.= $post_data;$fd = fsockopen($url_info['host'], $url_info['port']);fwrite($fd, $httpheader);$gets = "";$headerFlag = true;while (!feof($fd)) {if (($header = @fgets($fd)) && ($header == "\r\n" || $header == "\n")) {break;}}while (!feof($fd)) {$gets.= fread($fd, 128);}fclose($fd);return$gets;}/*** 电商Sign签名⽣成* @param data 内容* @param appkey Appkey* @return DataSign签名*/function encrypt($data, $appkey) {return urlencode(base64_encode(md5($data.$appkey)));}>。

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

快递鸟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 控件中显示就行，不同快递公司电子面单模板不一样。

快递鸟API查询快递接口

1.申请一个快递鸟的帐号获取授权申请/reg快递鸟的帐号使永久免费的，且申请了立即就能用的，也不需要审核。

2.按照单号识别接口和即时查询接口封装好数据3.获取返回的 json 数据输出import jsonimport urllibimport urllib.requestimport hashlibimport base64import urllib.parse# 此处为快递鸟官网申请的帐号和密码APP_id = "1266271"APP_key = "7526a46e-3a2a-4f5b-8659-d72f361e3386"def encrypt(origin_data, appkey):"""数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码""" m = hashlib.md5()m.update((origin_data+appkey).encode("utf8"))encodestr = m.hexdigest()base64_text = base64.b64encode(encodestr.encode(encoding='utf-8'))return base64_textdef sendpost(url, datas):"""发送post请求"""postdata = urllib.parse.urlencode(datas).encode('utf-8')header = {"Accept": "application/x-www-form-urlencoded;charset=utf-8","Accept-Encoding": "utf-8"}req = urllib.request.Request(url, postdata, header)get_data = (urllib.request.urlopen(req).read().decode('utf-8'))return get_datadef get_company(logistic_code, appid, appkey, url):"""获取对应快递单号的快递公司代码和名称"""data1 = {'LogisticCode': logistic_code}d1 = json.dumps(data1, sort_keys=True)requestdata = encrypt(d1, appkey)post_data = {'RequestData': d1,'EBusinessID': appid,'RequestType': '2002','DataType': '2','DataSign': requestdata.decode()}json_data = sendpost(url, post_data)sort_data = json.loads(json_data)return sort_datadef get_traces(logistic_code, shipper_code, appid, appkey, url):"""查询接口支持按照运单号查询(单个查询)"""data1 = {'LogisticCode': logistic_code, 'ShipperCode': shipper_code}d1 = json.dumps(data1, sort_keys=True)requestdata = encrypt(d1, appkey)post_data = {'RequestData': d1, 'EBusinessID': appid, 'RequestType': '1002', 'DataType': '2','DataSign': requestdata.decode()}json_data = sendpost(url, post_data)sort_data = json.loads(json_data)return sort_datadef recognise(expresscode):"""输出数据"""url = ':8081/Ebusiness/EbusinessOrderHandle.aspx' data = get_company(expresscode, APP_id, APP_key, url)if not any(data['Shippers']):print("未查到该快递信息,请检查快递单号是否有误！")else:print("已查到该", str(data['Shippers'][0]['ShipperName'])+"("+str(data['Shippers'][0]['ShipperCode'])+")", expresscode)trace_data = get_traces(expresscode, data['Shippers'][0]['ShipperCode'], APP_id, APP_key, url)if trace_data['Success'] == "false" or not any(trace_data['Traces']): print("未查询到该快递物流轨迹！")else:str_state = "问题件"if trace_data['State'] == '2':str_state = "在途中"if trace_data['State'] == '3':str_state = "已签收"print("目前状态： "+str_state)trace_data = trace_data['Traces']item_no = 1for item in trace_data:print(str(item_no)+":", item['AcceptTime'],item['AcceptStation'])item_no += 1print("\n")returnwhile True:code = input("请输入快递单号(Esc退出)：")code = code.strip()if code == "esc":breakrecognise(code)【疑问解答】1、问题：快递鸟接口有并发要求吗？快递鸟即时查询接口并发不超过10次/秒,物流跟踪接口订阅不超过30次/秒,电子面单接口下单不超过20次/秒。

免费快递查询接口文档

免费快递查询接口文档-快递鸟API1.报文及报文编码接口提供：快递鸟报文格式：Json 格式请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"交互协议上统一用UTF-8，避免传递中文数据出现乱码。

2.应用场景（1）电商网站用户打开“我的订单”时调用此API显示物流信息详情。

（2）电商管理后台的物流系统，客服在对账前查询所有运单的签收状态，并追踪问题。

（3）每日调用次数限制不超过3000次，如超过该限制，可对接物流跟踪API。

（4）全流程的物流状态跟踪I3.关于签名采用IP 认证加签名的方式对接，具体方案如下：1)防止数据被篡改在POST 请求中会传递 5 个必须(R)参数RequestData==数据内容(URL 编码:UTF-8)EBusinessID==用户IDRequestType=请求指令类型DataSign== 数据内容签名：把(请求内容(未编码)+ApiKey)进行MD5 加密，然后Base64编码，最后进行URL(utf-8)编码DataType==返回数据类型(2-json)注：DataSign 生成后，对方接收到数据后，以同样的算法进行签名，生成摘要，对比两者的摘要是否相同，如果不同，说明传递过程中发生数据篡改。

2)调用接口的身份认证注册成为接口用户后，会生成对应的用户ID 和APIKey，用户ID 相当于用户名，APIKey 相当于密码。

4.接入步骤1)接口网注册账号成为用户;提供的用户ID 是调用接口服务的身份证明，不可更改、不可转用，API Key 是应用访问API 的签名附加密钥，必须妥善保存。

两者关系类似于用户名和密码，两者都会在签名和业务参数中使用。

2)登陆用户后台，登陆用户后台，进行实名认证，并开通会员服务;3)根据技术文档进行开发并在调试平台测试联调；根据技术文档进行开发并在调试平台测试联调；API 接口的DEMO(包括：.Net 版本、Java 版本、PHP 版本)供开发参考。

快递查询和电子面单数据服务接口(API)

PART.15 谁在使用我们？
PART.16 关于快金数据
深圳市快金数据技术服务有限公司致力于物流数据的采集和应用服务，提供统一快递接口、快递订单质押的物流金融服务。
公司团队由电商、金融、物流行业专业人才组建。经过三年经营，其交付问题（交货+付款=交付）系统性解决方案已经被众多电商ERP系统、仓储系统、电商平台、跨境电商和快递公司使用，有效的解决了物流信息化问题，帮助电商建立支付、物流、金融三大模块。
提供批量物流轨迹数据管理、在线发件、电子面单等快递物流接口服务
问题2：缺少物流和金融模块
如何提供妥投报表？如何提升物流管理用户体验？阿里有蚂蚁金服提供金融服务其他中小电商怎么办？
快递鸟帮助ERP为电商建立线下支付、物流管理、金融三大服务模块
PART.4 我们的解决方案是什么？
目前
商品管理模块
7 刷卡签收/货款直退给平台或卖家
7 现金收款
寄件人/卖家
1 发货
收件员
10 发放现金
2 录单
寄件网点
9 货款对冲
8 交回现金
派件员
派件网点
5 派货
收件人/买家
6 签收
3 物流
快递中心
4 物流
传统流程：6步，T+7返款，现金优化后流程：1步，12小时返款，刷卡
PART.6 物流管理产品方案
目前
ERP系统
快金数据
提前返款加速资金周转 7 刷卡回款
11 现金返款
寄件人/卖家
1 发货
收件员
10 发放现金
2 录单
寄件网点
9 货款对冲
传统流程6步，T+7返款，现金新方案流程1步，4小时放款，刷卡

快递鸟电子面单模板说明

模板说明文档目录1.宅急送电子面单 (4)1.1.接口返回参数值 (4)1.2.电子面单模板180cm (4)1.3.电子面单模板100cm (5)2.德邦电子面单 (5)2.1.接口返回参数值 (5)2.2.电子面单模板180cm (6)3.安能电子面单 (6)3.1.接口返回参数值 (6)3.2.电子面单模板180cm (7)4.EMS电子面单 (7)4.1.接口返回参数值 (7)4.2.电子面单模板150cm (8)5.快捷电子面单 (8)5.1.接口返回参数值 (8)5.2.电子面单模板180cm (9)6.国通电子面单 (9)6.1.接口返回参数值 (9)6.2.电子面单模板180cm (10)7.天天电子面单 (10)7.1.接口返回参数值 (10)7.2.电子面单模板180cm (11)8.汇通电子面单 (11)8.1.接口返回参数值 (11)8.2.电子面单模板180cm (12)9.京东电子面单 (12)9.1.接口返回参数值 (12)9.2.电子面单模板100cm (13)10.跨越电子面单 (13)10.1.接口返回参数值 (13)10.2电子面单模板150cm (14)11.全峰电子面单 (14)11.1.接口返回参数值 (14)11.2.电子面单模板180cm (15)12.申通电子面单 (15)12.1.接口返回参数值 (15)12.2.电子面单模板180cm (16)12.3.电子面单模板150cm (17)13.优速电子面单 (17)13.1.接口返回参数值 (17)13.2.电子面单模板180cm (18)14.信丰电子面单 (18)14.1.接口返回参数值 (18)14.2.电子面单模板150cm (19)15.远成电子面单 (19)15.1.接口返回参数值 (19)15.2.电子面单模板180cm (20)16.韵达电子面单 (20)16.1.接口返回参数值 (20)16.2.电子面单模板210cm (21)16.3.电子面单模板150cm (22)17.圆通电子面单 (22)17.1.接口返回参数值 (22)17.2.电子面单模板180cm (23)17.3.电子面单模板(默认模板) (24)18.邮政平邮电子面单 (24)18.1.接口返回参数值 (24)18.2.电子面单模板180cm (25)19.中通电子面单 (25)19.1.接口返回参数值 (25)19.2.电子面单模板180cm (26)20.中铁快运电子面单 (26)20.1.接口返回参数值 (26)20.2.电子面单模板150cm (27)1.宅急送电子面单1.1.接口返回参数值1.2.电子面单模板180cm2.德邦电子面单2.1.接口返回参数值3.安能电子面单3.1.接口返回参数值4.EMS电子面单4.1.接口返回参数值5.快捷电子面单5.1.接口返回参数值6.国通电子面单6.1.接口返回参数值7.天天电子面单7.1.接口返回参数值8.汇通电子面单8.1.接口返回参数值9.京东电子面单9.1.接口返回参数值10.跨越电子面单10.1.接口返回参数值11.全峰电子面单11.1.接口返回参数值12.申通电子面单12.1.接口返回参数值13.优速电子面单13.1.接口返回参数值14.信丰电子面单14.1.接口返回参数值15.远成电子面单15.1.接口返回参数值16.韵达电子面单16.1.接口返回参数值17.圆通电子面单17.1.接口返回参数值17.3.电子面单模板(默认模板)18.邮政平邮电子面单18.1.接口返回参数值19.中通电子面单19.1.接口返回参数值20.中铁快运电子面单20.1.接口返回参数值。

接口技术文档doc

快递鸟接口(API)技术文档版本日期版本说明作者2014-12-01 3.0 重新整理，根据功能分类，部分有调整杨文胜2014-01-11 3.1 对接口的说明进行了注释，提高可读性杨汉汶2014-01-13 3.2 新增推送接口杨汉汶2015-03-11 3.3 新增批量订阅推送接口，删除3.2版本推送接口杨文胜2015-10-12 3.4 新增订单分发接口，整理电子面单接口曹强2016-01-19 3.5 重新调整在线下单接口曹强2016-03-01 3.6 增加智选物流接口曹强2016-03-01 3.7 分发及订阅接口更新任海洋2016-04-07 3.7.1 推送接口更新任海洋2016-05-11 3.7.2 电子面单新增通知快递员上门字段，推送接口新增货款状态推送詹益伟2016-07-01 4.0 全新4.0接口，新增单号识别接口、智选物流接口、更新物流轨迹接口（订阅查询）詹益伟2016-9-26 4.0.1 推送接口新增DataSign字段、订阅2.0新增仓库标识ID、智选物流接口新增字段胡蕾蕾2016-11-03 4.1 新增在途监控（增值服务）曹强2016-12-13 4.1.1 电子面单新增第三方订单号ThrOrderCode胡蕾蕾2017-1-10 4.2 新增隐私快递胡蕾蕾2017-2-16 4.2.1 新增代收货款业务胡蕾蕾2017-4-13 4.3 1、即时查询接口中轨迹状态新增0-无轨迹2、普通回调接口中删除201状态3、修改智选物流接口文档4、电子面单接口添加特殊字符提示陈爱2017-4-25 4.4 1、新增申请电子面单客户号接口2、新增电子面单余额查询接口3、新增电子面单单号回收接口4、新增申请客户号信息推送接口陈爱2017-6-22 4.5 新增短信接口李旭安2017-7-14 4.6 电子面单接口新增支持邮政快递包裹吴明名词定义必须要求说明R 必填（Required）。

快递鸟电子面单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申请电子面单客户号及单号电子面单客户号即请求打印面单时的用户账号或月结编码或客户编码，不同物流服务商的叫法不同而已。

京东快递电子面单API对接文档

BufferedReader in = null;
StringBuilder result = new StringBuilder();
try {
URL realUrl = new URL(url);
HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection();
conn.setRequestProperty("connection", "Keep-Alive");
conn.setRequestProperty("user-agent",
"Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
{
return base64(MD5(content + keyValue, charset), charset);
}
return base64(MD5(content, charset), charset);
}
/**
* 向指定 URL发送POST方法的请求
* @param url发送请求的 URL
sb.append("0");
}
sb.append(Integer.toHexString(val));
}
return sb.toString().toLowerCase();
}

快递鸟物流接口技术文档

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

本文档就各个API接口进行详细的说明，方便快递鸟的用户快速对接，方便快捷使用快递鸟服务。

2概述2.1用户使用流程图快递鸟API全流程服务（电商）流程图基于电商现有的服务流程，快递鸟为电商、电商平台、ERP系统、仓储系统等系统在用户下单、选择物流、下单、打单、轨迹跟踪等关键节点，均提供了专业、高效的API接口，方便各个平台实现一次接入，便可使用国内外主流物理公司的服务。

快递鸟API全流程服务（工具）流程图对于物流工具，基于用户的操作习惯，只需要输入单号，快递鸟即可完成后续的物流公司识别、查询轨迹等工作，为工具类用户提供一站式的服务。

2.2接口规范及说明2.2.1报文及报文编码Json格式。

编码格式：UTF-8交互协议上统一用UTF-8，避免传递中文数据出现乱码。

2.2.2接入步骤注册成为快递鸟用户(注：注册成功后进行实名认证，申请开通接口，后续会再对用户的注册信息进行审批)。

注册成功后，登录用户管理后台就可以查看到用户所属唯一的商户ID和APIkey。

按照快递鸟官网提示进行注册申请，注册成功后登录用户管理后台，您将得到由快递鸟提供的一组商户ID和APIKey。

商户ID是调用接口服务的身份证明，不可更改、不可转用，APIKey是应用访问API的签名附加密钥，必须妥善保存。

两者关系类似于登录帐号和密码，两者都会在签名和业务参数中使用。

注册成功登录用户管理后台可以查看商户ID和APIKey，需实名认证后才能申请开通接口。

(1)开发服务开发自身业务的服务，服务需遵循接口的定义规则。

(2)查看接口调用的DEMO快递鸟物流技术接口提供调用快递鸟物流接口的DEMO(.Net版本，Java 版本，PHP版本)，包括网上在线订单下单、物流轨迹查询等物流行业标准化的下单操作流程与数据查询格式。

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

快递鸟电子面单使用手册V1.0目录1 服务介绍..................................................................................................... 错误！未指定书签。

2 服务价值..................................................................................................... 错误！未指定书签。

3 准备工作..................................................................................................... 错误！未指定书签。

3.1申请电子面单客户号及单号........................................................... 错误！未指定书签。

3.1.1月结模式申请客户号.................................................................... 错误！未指定书签。

3.1.1快递鸟模式直接打印.................................................................... 错误！未指定书签。

3.2购买或充值单号............................................................................... 错误！未指定书签。

3.3准备热敏打印纸及打印机............................................................... 错误！未指定书签。

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

快递鸟接口调试平台使用指南版本目录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页。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

快递鸟接口(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接口服务，满足不同用户的物流管理需求。

快递单号查询快递鸟API接口-京东快运

快递单号查询快递鸟API接⼝-京东快运调⽤快递鸟提供的快递查询API标准接⼝，快速对接100多家快递公司的物流轨迹查询，本篇⽂章实现<京东快运>的快递单号查询。

⾸先我们准备好需要⽤到的资源，这⾥推荐⼤家去爱奇艺查看视频教程：测试商户ID：test1617571测试API key：554343b2-7252-439b-b4eb-1af42c8f2175(此Key仅限测试环境使⽤)API测试地址：接下来，我们讲解⼀下请求参数⼀、接⼝描述/说明请求系统级参数说明：参数名称类型说明必须要求RequestData String请求内容需进⾏URL(utf-8)编码。

请求内容JSON格式，须和DataType⼀致。

REBusinessID String商户ID，请在我的服务页⾯查看。

RRequestType String请求指令类型：1002RDataSign String 数据内容签名：把(请求内容(未编码)+AppKey)进⾏MD5加密，然后Base64编码，最后进⾏URL(utf-8)编码。

详细过程请查看Demo。

RDataType String请求、返回数据类型：2-json；O备注：R-必填（Required），O-可选（Optional），C-报⽂中该参数在⼀定条件下可选（Conditional）这⾥提到了系统级参数，也相当于是公⽤参数，这些参数是调⽤每个接⼝都是必须要传参的。

⼆、接⼝参数请求内容字段定义：参数名称类型说明必须要求OrderCode String订单编号OShipperCode String快递公司编码RLogisticCode String物流单号RCustomerName String寄件⼈或收件⼈的⼿机号后四位数字R接⼝参数，也叫业务参数，请求的业务接⼝不同，参数的字段，内容也不同，是跟着业务变化的，这⾥我们实现的是即时查询接⼝，请求指令类型：1002，快递鸟官⽹要求必须传递快递公司编码和物流单号，京东快运的编码是JD如要查看其他快递公司的编码，点击此链接：我们⽤京东快运的真实单号（JDVD00215296905）来完成快递单号查询接⼝的调⽤，请求的完整报⽂（URL编码以后）：RequestData=%0d%0a++++++++++++%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27JD%27%2c%27LogisticCode%27%3a%27JDVD00215296905%27%2c%27CustomerNURL解码的请求报⽂：{'OrderCode':'','ShipperCode':'JD','LogisticCode':'JDVD00215296905','CustomerName':'12333'}&EBusinessID=1264783&RequestType=1002&DataSign=M2QzMmVmMzUwNmNkNDFhODc2MmZmMWY5OWNkODU0NmQ=&DataType=2窗体顶端窗体底端返回参数定义：参数名称类型说明必须要求EBusinessID String⽤户ID ROrderCode String订单编号OShipperCode String快递公司编码RLogisticCode String物流运单号OSuccess Bool成功与否RReason String失败原因OState String物流状态：2-在途中,3-签收,4-问RState String物流状态：2-在途中,3-签收,4-问R题件TracesAcceptTime StringAcceptStation StringRemark String返回报⽂信息-{ "LogisticCode" : "JDVD00215296905", "ShipperCode" : "JD", "Traces" : [ { "AcceptStation" : "货物已交付京东物流", "AcceptTime" : "2019-10-07 13:47:08" }, { "AcceptStation" : "配送员杨海滨已经揽收完成", "AcceptTime" : "2019-10-07 13:47:08" }, { "AcceptStation" : "受国庆假期影响，您的快递可能会延迟配送，请您耐⼼等待;", "AcceptTime" : "2019-10-07 13:47:12" }, { "AcceptStation" : "货物已到达【成都枢纽中⼼】", "AcceptTime" : "2019-10-07 20:21:41" }, { "AcceptStation" : "货物已完成分拣，离开【成都枢纽中⼼】", "AcceptTime" : "2019-10-07 23:24:14" }, { "AcceptStation" : "货物已完成分拣，离开【南充中转场】", "AcceptTime" : "2019-10-08 08:30:49" }, { "AcceptStation" : "货物已分配，等待配送", "AcceptTime" : "2019-10-08 08:42:27" }, { "AcceptStation" : "配送员开始配送，请您准备收货，配送员，张少虎，⼿机号，188********", "AcceptTime" : "2019-10-08 10:04:23" }, { "AcceptStation" : "货物已由本⼈签收，感谢您选择京东物流！", "AcceptTime" : "2019-10-08 15:46:50" } ], "State" : "3", "EBusinessID" : "1264783", "Success" : true }附上详细的接⼝⽂档给⼤家：提供源码下载：调⽤第三⽅物流接⼝，替换⾃⼰的key就能直接使⽤，主要实现了物流在线轨迹查询，订单订阅，轨迹推送，⽀持上百家家的快递查询接⼝，包括主流的四通⼀达，⽀持上门取件服务，其他接⼝调⽤，修改调⽤指令和参数就能实现。

快递鸟API电商平台物流及快递数据接口解决方案

1专注于货物流通全流程数据及货款、⻦融服务致⻦于实现发货者与快递物流的跨⻦业信息连接成为物流快递跨⻦业信息化连接第⻦服务商官⻦：2未来可能的物流困难现在的物流困难仓库发货效⻦户隐私信息保护率提升、快递成本和审单成本控制快递⻦电商平台物流与数据⻦案售后问题件、退件跟踪处理签收时效保障智选物流电⻦⻦单隐私快递预约取件在途监控3企业物流模块-业务流程与需求物流订单流转全过程相关增值服务解决⻦案订单ERP ／WMS ／CRM商家电商平台买家预约后的物流单号物流订单服务快递⻦智选物流电⻦⻦单隐私快递预约取件在途监控物流短信解决⻦案关键点：⻦户提交订单时根据智选物流选择推荐的物流公司或预计送达的时效；根据商家选择，包括退货、返修服务等产品，在线下单预约物流服务；在商户后台提供物流管理模块，使⻦快递⻦电⻦⻦单接⻦打单，对账；根据⻦户选择使⻦隐私快递的订单，商家选⻦快递⻦隐私快递功能下单；电商平台接⻦快递⻦物流轨迹功能，为客户和商家提供物流轨迹展示、物流节点提醒、问题件、妥投率报表等服务；1. 2. 3. 4. 5. 快递公司发货及监控管理（⻦营商城类）快递⻦提供的解决⻦案⻦营商城具备物流服务能⻦：1、服务于买家、商家（⻦身）2、具备买家物流选择服务、查询功能并及时获得物流状态推送3、商城（卖家）具备物流订单的打单发货、监控管理能⻦。

买家下单流程买家收货流程买家退货险隐私快递货到付款智选物流买家查件物流跟踪状态推送短信通知物流评价退货取件快递柜订单审核打单发货线下配送商家物流管理商城发货智选物流电⻦⻦单预约取件隐私⻦单物流跟踪短信服务短信提醒服务客服物流监控财务对账结算仓库物流体检物流评价发货及监控管理模块（电商系统/电商平台类）快递⻦提供的解决⻦案买家下单流程买家收货流程买家退货险买家查件物流跟踪状态推送短信通知智选物流退货取件物流评价隐私快递货到付款快递柜/驿站订单审核打单发货线下配送商家物流管理商家平台智选物流电⻦⻦单预约取件隐私⻦单物流跟踪短信服务短信提醒服务客服物流监控财务对账结算仓库物流体检物流评价电商平台具备物流服务能⻦：1、⻦持服务于买家、商家、平台（⻦身）买家查件虚假发货验证物流体检物流跟踪监控 2、具备买家物流选择服务、查询功能并及时获得物流状态推送； 3、具备卖家打单发货、物流监控管理能⻦及平台物流监控管理；退货险多维验证为⻦户推荐最适合的物流公司，在超区、时效均保证的前提下，为⻦户节省快递费⻦。

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

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);