快递鸟电⼦⾯单批量打印流程与注意事项

最新推荐文章于 2023-06-06 10:34:38 发布

快递鸟

最新推荐文章于 2023-06-06 10:34:38 发布

阅读量1.1k

点赞数

分类专栏：文档文章标签：物联网 java python c# 交通物流

原文链接：https://blog.51cto.com/KDapi/5226720

版权

文档专栏收录该内容

28 篇文章 0 订阅

订阅专栏

快递鸟作为全球最⼤的第三⽅物流接⼝服务商，电⼦⾯单可⼀次性对接40家主流快递快运公司接⼝，免费试用，调⽤接⼝时快递鸟会向物流公司请求单号，并实时返回，可直接打印电⼦⾯单发货。

一、支持快递快运公司编码

快递鸟⽀持EMS(EMS)、顺丰速运(SF)、邮政国内标快(YZBK)、邮政快递包裹(YZPY)、宅急送(ZJS)、联昊通速递(LHT)、全⼀快递

(UAPEX)、申通快递(STO)、德邦快递(DBL)、京东快递(JD)、信丰物流(XFEX)、天天快递(HHTT)、速尔快递(SURE)、跨越速运(KYSY)、

品骏快递(PJ)、承诺达(CND)、中通快递(ZTO)、韵达速递(YD)、百世快递(HTKY)、圆通速递(YTO)、远成快运(YCWL)、优速快递(UC)、安

能快递(ANE)、天地华宇(HOAU)、腾林物流(TLWL)、德邦快运(DBLKY)、安能快运(ANEKY)、京东快运(JDKY)、龙邦快运(LB)、百世快运

(HTKYKY)、中通快运(ZTOKY)、佳吉快运(CNEX)、韵达快运(YDKY)、顺⼼捷达(SX)电⼦⾯单接⼝。

二、注册、认证

官网免费注册获取ID与Key.——实名认证——开通需要的会员服务（http://www.kdniao.com/reg?from=CSDN）

三、批量电子面单打印流程

1、开发对接前要下载技术说明⽂档

（1）接⼝开发可以下载电⼦⾯单接⼝DEMO

（2）进⾏参考，快递公司对应的编码可以下载“快递公司编码

列表⽂档”“电⼦⾯单客户号参数对照表”“快递公司快递业务类型”进⾏查看

使⽤电⼦⾯单接⼝还需要电⼦⾯单账号获取单号，每家快递公司电⼦⾯单账号需要传的字段不同，详情参考“电⼦⾯单客户号参数对照表”，

电⼦⾯单获取单号需要在快递鸟官⽹注册账号，可以在线申请部分快递公司电⼦⾯单客户号，不⽀持的可以线下联系当地⽹点申请，申请到

后，需联系⽹点预先充值单号，通过快递鸟电⼦⾯单API下单即可获取到快递单号和⼤头笔信息，使⽤电⼦⾯单接⼝还需要电⼦⾯单账号，测试环境：必须使⽤快递鸟提供的测试账号，在快递鸟官⽹-帮助与⽂档下载，“快递鸟电⼦⾯单参数配置对照表”查看相应账号和接⼝请求对应的字段名；

2、正式环境

⽆需电⼦⾯单账号直接下单：顺丰，EMS（⼴东省内发全国），宅急送，快捷，邮政快递包裹、中铁快运、全⼀快递；

线上（快递鸟后台）申请账号：优速、中通、韵达、圆通、远成快运、安能、百世；

（申请路径：快递鸟官⽹—电⼦⾯单—我的快递公司—申请新的快递公司）；其他的快递公司您需要和当地的快递⽹点线下申请账号（预存单号）才可以使⽤。

接⼊过程中如有疑问可以加技术⽀持qq群进⾏咨询，具体对接⽂档在QQ群⽂件可以下载，开发完成后在测试环境测试，测试环境只是提供

给⽤户调通接⼝使⽤，每家快递公司逻辑相同，测通⼀家快递公司说明接⼝已调通，正式环境下，有些快递公司⽆需电⼦⾯单账号直接下单

打单，有些快递公司需要在快递鸟后台申请账号，有的快递公司您需要和当地的快递⽹点线下申请账号（预存单号）才可以使⽤。电⼦⾯单

批量打印是可下载电⼦⾯单批量打印demo（http://www.kdniao.com/api-eorder）进⾏参考。

3、对接中要注意：

（1）确保接⼝中电商ID、密钥(AppKey)与⽤户管理后台的商户ID、密钥完全⼀致。

（2）OrderCode必须是快递鸟电⼦⾯单

下单接⼝正式环境下单的订单号；PortName是打印机名称，必须与本地打印机名称⼀致。

（3）确保接⼝demo中GetIp()⽅法获取到的IP和⽤户连接打印机的电脑IP⼀致。

（4）安装快递鸟打印控件C-Lodop (Print)，调⽤快递鸟批量打印demo后会提⽰下载或在快递鸟⽹站下载。

最后发布上线，这就对接成功可以使⽤啦。电⼦⾯单接⼝调⽤成功后接⼝会直接返回HTML电⼦⾯单模板，可以直接使⽤浏览器打印，或者

使⽤HTML控件进⾏打印。

4、批量打印的流程

（1）先调⽤电⼦⾯单打印接⼝获得必须字段：OrderCode(订单号)

（2）拼接组合打印的数据data：格式json_encode([0=>['OrderCode' => '订单号1', 'PortName' => '打印机名称']]);

（3）签名

所需参数：

（4）第⼆部拼接好的data，如下图：

打印的数据

（5）连接打印机的主机外⽹ip

（6）⽤户申请的快递鸟的APIKey

注意：（2）、（3）结合⽅式：ip . data ⽣产新的data，并⽤签名函数⽣成签名，如下图

签名代码如下:

以上流程，官⽅给的demo中都有，主要需要注意的点是如果快递鸟批量打印接⼝中返回错误总是提⽰数据验证不通过的话，需要注意的是

客户端ip地址的获取，签名的数据拼接及表单数据的拼接⽅式，⽤户的appkey和商户ID是否正确等等;

四、电子面单批量打印注意事项

1、连接打印机的ip获取是否有误？

（1）如果是在本地做测试，那么官⽅提供的获取本机ip地址是不⾏的，需要使⽤⼀下代码：

获取本机外⽹ip

（2）若是正式环境的话，则直接⽤官⽅demo就可以了，代码如下：

<?php

/**

* 快递鸟电⼦⾯单接⼝

* @技术QQ: 4009633321

* @技术QQ群: 200121393

* @see: http://www.kdniao.com/MiandanAPI.aspx

* @copyright: 深圳市快⾦数据技术服务有限公司

* ID和Key请到官⽹申请：http://www.kdniao.com/ServiceApply.aspx

//电商ID

defined('EBusinessID') or define('EBusinessID', '请到快递鸟官⽹申请http://www.kdniao.com/ServiceApply.aspx');

//电商加密私钥，快递鸟提供，注意保管，不要泄漏

defined('AppKey') or define('AppKey', '请到快递鸟官⽹申请http://www.kdniao.com/ServiceApply.aspx');

//请求url，接⼝正式地址：http://api.kdniao.cc/api/Eorderservice

defined('ReqURL') or define('ReqURL', 'http://testapi.kdniao.cc:8081/api/Eorderservice');

//调⽤获取物流轨迹

//-------------------------------------------------------------

//构造电⼦⾯单提交信息

$eorder = [];

$eorder["ShipperCode"] = "SF";

$eorder["OrderCode"] = "PM201604062341";

$eorder["PayType"] = 1;

$eorder["ExpType"] = 1;

$sender = [];

$sender["Name"] = "李先⽣";

$sender["Mobile"] = "18888888888";

$sender["ProvinceName"] = "李先⽣";

$sender["CityName"] = "深圳市";

$sender["ExpAreaName"] = "福⽥区";

$sender["Address"] = "赛格⼴场5401AB";

$receiver = [];

$receiver["Name"] = "李先⽣";

$receiver["Mobile"] = "18888888888";

$receiver["ProvinceName"] = "李先⽣";

$receiver["CityName"] = "深圳市";

$receiver["ExpAreaName"] = "福⽥区";

$receiver["Address"] = "赛格⼴场5401AB";

$commodityOne = [];

$commodityOne["GoodsName"] = "其他";

$commodity = [];

$commodity[] = $commodityOne;

$eorder["Sender"] = $sender;

$eorder["Receiver"] = $receiver;

$eorder["Commodity"] = $commodity;

//调⽤电⼦⾯单

$jsonParam = json_encode($eorder, JSON_UNESCAPED_UNICODE);

//$jsonParam = JSON($eorder);//兼容php5.2（含）以下

echo "电⼦⾯单接⼝提交内容：<br/>".$jsonParam;

$jsonResult = submitEOrder($jsonParam);

echo "<br/><br/> 电⼦⾯单提交结果:<br/>".$jsonResult;

//解析电⼦⾯单返回结果

$result = json_decode($jsonResult, true);

echo "<br/><br/> 返回码:".$result["ResultCode"];

if($result["ResultCode"] == "100") {

echo "<br/>是否成功:".$result["Success"];

}

else {

echo "<br/>电⼦⾯单下单失败";

}

//-------------------------------------------------------------

/**

* Json⽅式查询订单物流轨迹

function submitEOrder($requestData){

$datas = array(

'EBusinessID' => EBusinessID,

'RequestType' => '1007',

'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($url_info['port']=='')

{

$url_info['port']=80;

}

echo $url_info['port'];

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

}

/**************************************************************

* 使⽤特定function对数组中所有元素做处理

* @param string &$array

* @param string $function

要处理的字符串

要执⾏的函数

* @return boolean $apply_to_keys_also

是否也应⽤到key上

* @access public

*************************************************************/

function arrayRecursive(&$array, $function, $apply_to_keys_also = false)

{

static $recursive_counter = 0;

if (++$recursive_counter > 1000) {

die('possible deep recursion attack');

}

foreach ($array as $key => $value) {

if (is_array($value)) {

arrayRecursive($array[$key], $function, $apply_to_keys_also);

} else {

$array[$key] = $function($value);

}

if ($apply_to_keys_also && is_string($key)) {

$new_key = $function($key);

if ($new_key != $key) {

$array[$new_key] = $array[$key];

unset($array[$key]);

}

$recursive_counter--;

}

/**************************************************************

* 将数组转换为JSON字符串（兼容中⽂）

* @param array

* @return string

* @access public

$array

要转换的数组

转换得到的json字符串

*************************************************************/

function JSON($array) {

arrayRecursive($array, 'urlencode', true);

$json = json_encode($array);

return urldecode($json);

}

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<title>Insert title here</title>

$(function(){

$.getJSON('/kdPrintOrderDemo/printOrder', function(data){

$("#EBusinessID").val(data.EBusinessID)

$("#RequestData").val(data.RequestData)

$("#IsPreview").val(data.IsPreview)

$("#DataSign").val(data.DataSign)

form1.submit()

})

});

</script>

</head>

<body>

</div>

</form>

</body>

</html>

四、电⼦⾯单批量打印对接注意事项：

（1）确保接⼝中电商ID、密钥(AppKey)与⽤户管理后台的商户ID、密钥完全⼀致；

（2）OrderCode必须是快递鸟电⼦⾯单下单接⼝正式环境下单的订单号；PortName是打印机名称，必须与客户端本地打印机名称⼀致；

（3）确保接⼝demo中GetIp()⽅法获取到的IP和⽤户服务器外⽹IP（百度搜索IP138）的⼀致。

（4）安装快递鸟打印控件C-Lodop (Print)

安装⽅式1、调⽤快递鸟批量打印demo后会提⽰下载。

安装⽅式2、在快递鸟官⽹下载，下载地址：

需要特别注意：

1、如授权商家修改主账号密码，则授权码（Access token）随之失效，需重新授权。主账号密码不允许修改；

2、应⽤授权token有效期为⼀年。

3、token和CustomerPwd事业部编码要唯⼀绑定。

最终，快递鸟⽤户，需要将以下对应信息，复制提供给快递鸟技术⽀持进⾏配置：

EBusinessID快递鸟ID：

AppKey：

App Secret：

token：

CustomerName商家编码/青龙编码：

CustomerPwd事业部编码：

WareHouseID发货仓编码：

寄件⼈简称：

五、获取签名时，数据的拼接是否有误？

原来的代码中是⽤urlencode的形式将data数据进⾏编码再签名的，后期貌似不⽤进⾏url编码，且提交表单中的请求数据必须加转义字符

快递鸟

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
快递鸟电⼦⾯单批量打印流程与注意事项

快递鸟作为全球最⼤的第三⽅物流接⼝服务商，电⼦⾯单可⼀次性对接40家主流快递快运公司接⼝，免费试用，调⽤接⼝时快递鸟会向物流公司请求单号，并实时返回，可直接打印电⼦⾯单发货。
复制链接

扫一扫

专栏目录