我们以电商平台为例来说明：根据订单开具电子发票。其他加油站、快递、物流、O2O物业等行业都可以参考这个对接 电子发票：
以京东商城Web端、App端开票演示：
1、调用 “获取accessToken” API接口
https://（这是接口根地址）api2.easyapi.com/（访问令牌）token



appKey和appSecret在EasyAPI服务中心获取
2、如果嵌入Web端，参考京东在订单确认页面，添加修改发票信息按钮或链接，点击弹框嵌入“订单对接Web端页面”


https://fapiao-order-modal.easyapi.com/web（网页端）.html?taxNumber=91310117MA1J34GU08（税号）&username=13656171020（用户标识）&accessToken=




如果嵌入App端/手机H5端，参考京东在订单确认页面，添加修改发票信息按钮或链接，点击弹框嵌入“订单对接手机端页面”


https://fapiao-order-modal.easyapi.com/mobile（移动端）.html?taxNumber=91310117MA1J34GU08（税号）&username=13656171020（用户标识）&accessToken=
参数同上
备注：如果客户需要自定义嵌入页面的风格，可以下载源码，自行修改，源码查看下图


3、可调用 “获取开票用户默认抬头信息” API接口获取用户刚刚保存的开票信息
https://（这是接口跟地址）fapiao-api.easyapi.com/invoice/company/（这是用户标识）{username}/default
显示在如下的标红框位置：


4、当用户确认下单，调用 “创建订单开票申请信息” API接口
https://（这是接口根地址）fapiao-api.easyapi.com
接口文档参见 https://www.easyapi.com/api/view/166693?documentId=17044（文档id）&themeId=（团队id可不填）&categoryId=38811（接口分类id）


5、当用户付款后，或者用户确认收货后，商户自行选择，调用“根据商户订单号,确认开具发票” API接口实际开票
https://（这是接口根地址）fapiao-api.easyapi.com
接口文档参见 https://www.easyapi.com/api/view/166695?documentId=17044（文档id）&themeId=（团队id可不填）&categoryId=38811（接口分类id）


6、订单详情页接入，可增加按钮“查看电子发票”，跳转到发票PDF，获取发票PDF，通过接口“根据商户订单号获取发票地址”
接口文档参见 https://www.easyapi.com/api/view/167098?documentId=17044（文档id）&themeId=（团队id可不填）&categoryId=38811（接口分类id）


7、订单退货，调用发票红冲接口
https://（这是接口根地址）fapiao-api.easyapi.com
接口文档参见 https://www.easyapi.com/api/view/167135?documentId=17044（文档id）&themeId=（团队id可不填）&categoryId=38811（接口分类id）


8、如果需要在界面显示申请的开票信息，调用接口“根据商户订单号获取开票请求信息”
https://（这是接口根地址）fapiao-api.easyapi.com
接口文档参见 https://www.easyapi.com/api/view/166689?documentId=17044（文档id）&themeId=（团队id可不填）&categoryId=38811（接口分类id）


联系小编可以提供标准嵌入页面。也就是前段页面，可以节省您的开发时间

一、接口描述/说明

（1）在线下单接口（预约取件接口）是提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口。

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

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

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

（5）接口地址： API测试地址：http://testapi.kdniao.cc:8081/api/OOrderService

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

（6）接口使用：在快递鸟网站申请接口KEY
一、接口参数：

详见快递鸟官网对接文档
二、示例

请求示例 JSON
{
"OrderCode": "012657018199",
"ShipperCode": "SF",
"PayType": 1,
"MonthCode": "7553045845",
"ExpType": 1,
"Cost": 1.0,
"OtherCost": 1.0,
"Sender": {
  "Company": "LV",
  "Name": "Taylor",
  "Mobile": "15018442396",
  "ProvinceName": "上海",
  "CityName": "上海",
  "ExpAreaName": "青浦区",
  "Address": "明珠路"
},
"Receiver": {
  "Company": "GCCUI",
  "Name": "Yann",
  "Mobile": "15018442396",
  "ProvinceName": "北京",
  "CityName": "北京",
  "ExpAreaName": "朝阳区",
  "Address": "三里屯街道"
},
"Commodity": [
  {
    "GoodsName": "鞋子",
    "Goodsquantity": 1,
    "GoodsWeight": 1.0
  }
],
"AddService": [
  {
    "Name": "COD",
    "Value": "1020"
  }
],
"Weight": 1.0,
"Quantity": 1,
"Volume": 0.0,
"Remark": "小心轻放"
}


返回示例 JSON
失败：
{
    "EBusinessID": "1237100",
    "Success": false,
    "ResultCode": "105",
    "Reason": "该订单已经存在，请勿重复操作",
    "UniquerRequestNumber":"451d3c7c-b428-490a-a4ed-e368f15f6c74"
}


成功：
{
    "EBusinessID": "1237100",
    "Success": true,
    "Order": {
        "OrderCode": "012657018199",
        " ShipperCode ": " SF ",
        " LogisticCode ": ""
    },
    "ResultCode": "100",
    "Reason": ""
}


三、demo-PHP
<?php

//电商ID
defined('EBusinessID') or define('EBusinessID', '请申请');
//电商加密私钥，注意保管，不要泄漏
defined('AppKey') or define('AppKey', '请申请');
//请求url，接口正式地址：http://api.kdniao.cc/api/eorderservice    测试环境地址：http://testapi.kdniao.cc:8081/api/oorderservice
defined('ReqURL') or define('ReqURL', 'http://testapi.kdniao.cc:8081/api/oorderservice');

echo "在线下单";

//构造在线下单提交信息
$eorder = [];
$eorder["ShipperCode"] = "SF";
$eorder["OrderCode"] = "PM201605078947";
$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);
echo "在线下单接口提交内容：<br/>".$jsonParam;
$jsonResult = submitOOrder($jsonParam);

//解析在线下单返回结果
$result = json_decode($jsonResult, true);
echo "<br/><br/>返回码:".$result["ResultCode"];
if($result["ResultCode"] == "100") {
	echo "<br/>是否成功:".$result["Success"];
}
else {
	echo "<br/>在线下单失败";
}
//-------------------------------------------------------------


/**
 * Json方式 提交在线下单
 */
function submitOOrder($requestData){
	$datas = array(
        'EBusinessID' => EBusinessID,
        'RequestType' => '1001',
        '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);
    $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)));
}

?>

.支持自定义预约时间，不遗漏订单

.已支持三通一达（申通不支持）、顺丰、EMS、宅急送、德邦、优速等物流公司

.快递公司会在两小时内联系发件人并上门揽件

.PC端，移动端均能对接使用

一、预约快递API接口

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

（2）可通过网络选择快递公司发送请求通知快递公司有快递要发货。

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

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

（5）接口使用：在快递鸟网站申请接口KEY

二、示例

请求示例 JSON

{
"OrderCode": "012657018199",
"ShipperCode": "SF",
"PayType": 1,
"MonthCode": "7553045845",
"ExpType": 1,
"Cost": 1.0,
"OtherCost": 1.0,
"Sender": {
  "Company": "LV",
  "Name": "Taylor",
  "Mobile": "15018442396",
  "ProvinceName": "上海",
  "CityName": "上海",
  "ExpAreaName": "青浦区",
  "Address": "明珠路"
},
"Receiver": {
  "Company": "GCCUI",
  "Name": "Yann",
  "Mobile": "15018442396",
  "ProvinceName": "北京",
  "CityName": "北京",
  "ExpAreaName": "朝阳区",
  "Address": "三里屯街道"
},
"Commodity": [
  {
    "GoodsName": "鞋子",
    "Goodsquantity": 1,
    "GoodsWeight": 1.0
  }
],
"AddService": [
  {
    "Name": "COD",
    "Value": "1020"
  }
],
"Weight": 1.0,
"Quantity": 1,
"Volume": 0.0,
"Remark": "小心轻放"
}

返回示例 JSON
失败：
{
    "EBusinessID": "1237100",
    "Success": false,
    "ResultCode": "105",
    "Reason": "该订单已经存在，请勿重复操作",
    "UniquerRequestNumber":"451d3c7c-b428-490a-a4ed-e368f15f6c74"
}
成功：
{
    "EBusinessID": "1237100",
    "Success": true,
    "Order": {
        "OrderCode": "012657018199",
        " ShipperCode ": " SF ",
        " LogisticCode ": ""
    },
    "ResultCode": "100",
    "Reason": ""
}


三、demo-PHP

<?php

//电商ID
defined('EBusinessID') or define('EBusinessID', '请申请');
//电商加密私钥，注意保管，不要泄漏
defined('AppKey') or define('AppKey', '请申请');
//请求url，接口正式地址：http://api.kdniao.cc/api/eorderservice    测试环境地址：http://testapi.kdniao.cc:8081/api/oorderservice
defined('ReqURL') or define('ReqURL', 'http://testapi.kdniao.cc:8081/api/oorderservice');

echo "在线下单";

//构造在线下单提交信息
$eorder = [];
$eorder["ShipperCode"] = "SF";
$eorder["OrderCode"] = "PM201605078947";
$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);
echo "在线下单接口提交内容：<br/>".$jsonParam;
$jsonResult = submitOOrder($jsonParam);

//解析在线下单返回结果
$result = json_decode($jsonResult, true);
echo "<br/><br/>返回码:".$result["ResultCode"];
if($result["ResultCode"] == "100") {
	echo "<br/>是否成功:".$result["Success"];
}
else {
	echo "<br/>在线下单失败";
}
//-------------------------------------------------------------


/**
 * Json方式 提交在线下单
 */
function submitOOrder($requestData){
	$datas = array(
        'EBusinessID' => EBusinessID,
        'RequestType' => '1001',
        '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);
    $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)));
}

?>


 

 

电商平台及 ISV 商家对物流 API 接口的需求有很多，今天我们主要分享的就是快递鸟快递单号查询接口的对接指南，快递单号查询接口对接的应用场景有很多，很多场景会遇到，最主要的就是电商网站用户打开“我的订单”时调用此 API 显示物流信息详情，电商管理后台的物流系统，客服在对账前查询所有运单的签收状态，并追踪问题，电商平台对商家物流管控，要求必须在多久快递必须发出要看到揽件状态，多久必须收到货物看到签收状态，根据这些状态对商家管控从而提升用户的整体满意度。
阅读全文: http://gitbook.cn/gitchat/activity/5d5119fa57c16a654309f2f7
您还可以下载 CSDN 旗下精品原创内容社区 GitChat App ，阅读更多 GitChat 专享技术内容哦。