快递鸟电子面单API对接方法?

之前说了一下快递公司、菜鸟和快递鸟的电子面单接口，很多人不知道快递鸟要怎么对接，现在为大家讲解一下。快递鸟是全球物流接口服务商，为电商 ERP、电商平台、仓储、清关公司提供物流跟踪、电子面单、智选物流、物流金融、在线下单等服务，解决电商的物流管理模块和金融模块。现就对快递鸟电子面单API做基本描述，并提供电子面单接口的对接方式。

一.接口介绍

快递鸟电子面单接口支持四通一达、顺丰、EMS、宅急送、德邦、优速等15家国内常用快递的面单打印。通过快递鸟接口在线打印电子运单，即时生成运单号，无需录单，提高发货效率，提升送达时效。打印速度提升 4-6 倍、省去录单环节、取消抽单环节、充当捡货单、提升送达时效。

电子面单VS传统面单：

二.PHP对接方式

（1）电子面单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口。

（2）为客户解决在线发货需求，商户通过网络选择快递公司发送请求通知快递公司有快递要发货。

（3） 客户把数据通过此接口转发到快递鸟，由快递鸟为您安排快递员上门取件的服务。

（4）订单编号（OrderCode）不可重复提交，重复提交系统会返回具体错误代码。

（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。

（6）请求系统级参数说明：

参数名称	类型	说明	必须要求
RequestData	String	请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。	R
EBusinessID	String	商户ID，请在我的服务页面查看。	R
RequestType	String	请求指令类型：1007	R
DataSign	String	数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo。	R
DataType	String	请求、返回数据类型：只支持JSON格式	O

备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）。

（7）接口地址：

API测试地址：http://testapi.kdniao.cc:8081/api/EOrderService

API正式地址：http://api.kdniao.cc/api/EOrderService

（8）请求内容字段定义

参数名称		类型	说明	是否必须
CallBack		String	用户自定义回调信息	O
MemberID		String	会员标识	O
CustomerName		String	电子面单客户账号（与快递网点申请）	O
CustomerPwd		String	电子面单密码	O
SendSite		String	收件网点标识	O
ShipperCode		String	快递公司编码	R
LogisticCode		String	快递单号	O
OrderCode		String	订单编号	R
MonthCode		String	月结编码	C
PayType		Int	邮费支付方式:1-现付，2-到付，3-月结，4-第三方支付	R
ExpType		String	快递类型：1-标准快件	R
IsNotice		Int	是否通知快递员上门揽件：0-不通知；1-通知；不填则默认为1	O
Cost		Double	寄件费（运费）	O
OtherCost		Double	其他费用	O
Receiver	Company	String	收件人公司	O
	Name	String	收件人	R
	Tel	String	电话与手机，必填一个	R
	Mobile	String
	PostCode	String	收件人邮编	O
	ProvinceName	String	收件省（如广东省，不要缺少“省”）	R
	CityName	String	收件市（如深圳市，不要缺少“市”）	R
	ExpAreaName	String	收件区（如福田区，不要缺少“区”或“县”）	O
	Address	String	收件人详细地址	R
Sender	Company	String	发件人公司	O
	Name	String	发件人	R
	Tel	String	电话与手机，必填一个	R
	Mobile	String
	PostCode	String	发件人邮编	O
	ProvinceName	String	发件省（如广东省，不要缺少“省”）	R
	CityName	String	发件市（如深圳市，不要缺少“市”）	R
	ExpAreaName	String	发件区（如福田区，不要缺少“区”或“县”）	O
	Address	String	发件人详细地址	R
StartDate		String	上门取货时间段:"yyyy-MM-dd HH:mm:ss"格式化，本文中所有时间格式相同	O
EndDate		String		O
Weight		Double	物品总重量kg	O
Quantity		Int	件数/包裹数	O
Volume		Double	物品总体积m3	O
Remark		String	备注	O
AddServices
AddService	Name	String	增值服务名称	O
	Value	String	增值服务值	O
	CustomerID	String	客户标识（选填）	O
Commoditys
Commodity	GoodsName	String	商品名称	R
	GoodsCode	String	商品编码	O
	Goodsquantity	Int	商品数量	O
	GoodsPrice	Double	商品价格	O
	GoodsWeight	Double	商品重量kg	O
	GoodsDesc	String	商品描述	O
	GoodsVol	Double	商品体积m3	O
IsReturnPrintTemplate		String	返回电子面单模板：0-不需要；1-需要	O

（9）返回参数定义

参数名称		类型	说明	必须要求
EBusinessID		String	用户ID	R
Order	OrderCode	String	订单编号	R
	ShipperCode	String	快递公司编码	R
	LogisticCode	String	快递单号	R
	MarkDestination	String	大头笔	O
	OriginCode	String	始发地区域编码	O
	OriginName	String	始发地/始发网点	O
	DestinatioCode	String	目的地区域编码	O
	DestinatioName	String	目的地/到达网点	O
	SortingCode	String	分拣编码	O
	PackageCode	String	集包编码	O
Success		Bool	成功与否	R
ResultCode		String	错误编码	R
Reason		String	失败原因	O
UniquerRequestNumber		String	唯一标识	R
PrintTemplate		String	面单打印模板	O
EstimatedDeliveryTime		String	订单预计到货时间yyyy-mm-dd	O
Callback		String	用户自定义回调信息	O

（10）PHP 代码案例

<?php
/**
 *
 * 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   $array      要转换的数组
 *  @return string      转换得到的json字符串
 *  @access public
 *
 *************************************************************/
function JSON($array) {
    arrayRecursive($array, 'urlencode', true);
    $json = json_encode($array);
    return urldecode($json);
}
?>