目錄
1.完成前期準備工作
2.API接口
3.請求參數（Headers）
4.請求完整報文（示例）
5.成功返回報文（示例）
6.失敗返回報文（示例）
7.分步講解（C#版本）
8.順豐電子面單打印模板內容（HTML）
9.關於簽名
前言
豐密面單，就是隱藏了用戶個人信息的順豐快遞面單。該面單可將寄、收件人名字、手機、地址等部分信息隱藏，讓個人信息不再直接暴露。
我們先看2張面單效果圖。
圖一
圖一是一張二聯150MM的電子面單模板，寄件人和收件人手機是可見的。
圖二
圖二也是一張二聯150MM的電子面單模板，寄件人和收件人手機是標星不看見的。這樣的面單安全可靠，主要是保護客戶隱私，強烈推薦客戶使用，下面我們就來講解實現過程。
1.完成前期準備工作
1.1,去快遞鳥免費註冊一個對接賬號
1.2,免費獲得一個apiKey(接口權限驗證需要)
1.3,完成實名認證流程
1.4,訂購一個免費套餐
1.5,申請順豐速運月結賬號
順豐月結賬號需要線下與當地順豐分部簽訂收派合同，簽定後順豐會提供10位數字的順豐月結賬號，用於發貨結算運費；
注：快遞鳥官網後臺顯示的信息和狀態（如：“我的物流服務商”頁面不顯示順豐或順豐月結賬號）並不影響接口的使用，也不需要在後臺添加要使用的客戶號，直接通過接口傳值下單即可；
1.6,準備打印機、打印紙
- 打印機：
電子面單模板對打印機品牌、型號等沒有要求，只要是熱敏打印機即可，常見品牌如：斑馬、得力、快麥、漢印、佳博等。
打印機可由快遞網點提供或者在淘寶京東上購買，安裝打印機及驅動程序聯繫打印機提供方；
- 打印紙：
順豐速運使用的打印紙有100mm*150mm（切點90/60）、100mm*180mm（切點110/70）、100mm*210mm（切點90/60/60）三種，
打印紙可由快遞網點提供或者在淘寶京東上購買，購買時可選擇全白熱敏 紙。
2.API接口
2.1,測試調用地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
2.2,正式調用地址：http://api.kdniao.com/api/EOrderService
2.3,請求方式：POST
2.4,編碼格式(utf-8)：application/x-www-form-urlencoded;charset=utf-8
2.5,返回類型：JSON
2.6,調試頁面：http://kdniao.com/UserCenter/v2/SandBox/TrackQuery.aspx
2.7,調試工具：去調試（使用快遞鳥賬號登錄）
3.請求參數（Headers）
參數名稱類型說明必須要求RequestDataString請求內容需進行URL(utf-8)編碼,請求內容JSON格式，須和DataType一致必填EBusinessIDString用戶ID，查看用戶ID和ApiKey必填RequestTypeString請求指令類型：1007必填
DataSignString簽名數據，(Body+ApiKey)進行MD5加密，再進行Base64編碼，最後進行URL(utf-8)編碼必填DataTypeString求、返回數據類型：2-json ，默認Json選填
4.請求報文（示例）
<code>{
"OrderCode": "012657018199",
"ShipperCode": "SF",
"PayType": 1,
"MonthCode": "1234567890",
"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
},
{
"GoodsName": "衣服",
"GoodsQuantity": 1,
"GoodsWeight": 1.0
},
],
"AddService": [
{
"Name": " INSURE ",
"Value": "1000"
},
{
"Name": "COD",
"Value": "1020"
" CustomerID ": "1234567890"
}
],
"Weight": 1.0,
"Quantity": 1,
"Volume": 0.0,
"Remark": "小心輕放"
}/<code>5.成功返回報文（示例）
<code> {
"EBusinessID": "1237100",
"Order": {
"OrderCode": "012657700387",
"ShipperCode": "HTKY",
"LogisticCode": "50002498503427",
"MarkDestination": "京-朝陽(京-1)",
"OriginCode": "200000",
"OriginName": "上海分撥中心",
"PackageCode": "北京"
},
"PrintTemplate":"打印模板HTML內容後面單獨列出",
"EstimatedDeliveryTime":"2016-03-06",
"Success": true,
"ResultCode": "100",
"Reason": "成功"
}/<code>6.失敗返回報文（示例）
<code> {
"EBusinessID": "1237100",
"ResultCode": "106",
"Reason": "該訂單號已下單成功"，
"UniquerRequestNumber":"5e66486b-8fbc-4131-b875-9b13d2ad1354"
}/<code>說明：未實名認證，未訂購套餐，套餐可用查詢量已經用完 都會返回此報文信息去實名認證 / 瞭解套餐詳情
7.分步講解（C#版本）
9.1，請求數據包結構
9.2,C#調用代碼示例
<code>技術支持：QQ:510997342
//電商ID
string eEBusinessID = "test1617571";
//電商加密私鑰，快遞鳥提供，注意保管，不要洩漏
string appKey= "554343b2-7252-439b-b4eb-1af42c8f2175";
//請求url
string reqURL = "http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json";
//請求指令
string reqType="1007";
//2-json
string dataType = "2";
//字符編碼採用UTF-8
string charset = "UTF-8";
//JSON字符串string
string jsonStr =
"{
\"OrderCode\": \"012657018199\",\"ShipperCode\": \"SF\",\"PayType\": 1,\"MonthCode\": \"1234567890\",\"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},{\"GoodsName\": \"衣服\",\"GoodsQuantity\": 1,\"GoodsWeight\": 1.0},],\"AddService\": [{\"Name\": \" INSURE \",\"Value\": \"1000\"},{\"Name\": \"COD\",\"Value\": \"1020\"\" CustomerID \": \"1234567890\"}],\"Weight\": 1.0,\"Quantity\": 1,\"Volume\": 0.0,\"Remark\": \"小心輕放\"}" ;
//把md5Str 進行Base64編碼
string base64Str=base64(md5Str,charset);
//進行URL編碼 (utf-8)
string datasign = HttpUtility.UrlEncode(base64Str, charset);
//請求報文參數
string postStr = "RequestType=reqType&EBusinessID= eEBusinessID&RequestData=jsonStr
&DataSign= datasign&DataType=dataType";
//通訊協議使用Http協議Post請求方式 返回軌跡數據
string post = SendPost(reqURL, postStr);
//獲取到的post數據就是快遞鳥返回的完整報文，接下來自己寫一個解析json的方法就能獲取到裡面的字段信息。//把(jsonStr+APIKey)進行MD5加密string md5Str=MD5(jsonStr + apiKey, charset);//把md5Str 進行Base64編碼string base64Str=base64(md5Str,charset);//進行URL編碼 (utf-8)string datasign = HttpUtility.UrlEncode(base64Str, charset); //請求報文參數 string postStr = "RequestType=reqType&EBusinessID= eEBusinessID&RequestData=jsonStr &DataSign= datasign&DataType=dataType"; //通訊協議使用Http協議Post請求方式 返回軌跡數據string post = SendPost(reqURL, postStr);//獲取到的post數據就是快遞鳥返回的完整報文，接下來自己寫一個解析json的方法就能獲取到裡面的字段信息。/<code>
<code>9.3,C#調用方法/<code>
<code>///<summary>
/// 字符串MD5加密
////<summary>
///<param>要加密的字符串
///<param>編碼方式
///<returns>密文/<returns>
private string MD5(string str, string charset)
{
byte[] buffer = System.Text.Encoding.GetEncoding(charset).GetBytes(str);
try
{
System.Security.Cryptography.MD5CryptoServiceProvider check;
check = new System.Security.Cryptography.MD5CryptoServiceProvider();
byte[] somme = check.ComputeHash(buffer);
string ret = "";
foreach (byte a in somme)
{
if (a < 16)
ret += "0" + a.ToString("X");
else
ret += a.ToString("X");
}
return ret.ToLower();
}
catch
{
throw;
}
}
/// <summary>
/// base64編碼
/// /<summary>
/// <param>內容
/// <param>編碼方式
/// <returns>
private string base64(String str, String charset)
{
return Convert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));
}
/// <summary>
/// Post方式提交數據，返回網頁的源代碼
/// /<summary>
/// <param>發送請求的 URL
/// <param>請求報文參數
/// <returns>遠程資源的響應結果/<returns>
private string SendPost(string url, string postData)
{
string result = "";
byte[] byteData = Encoding.GetEncoding("UTF-8").GetBytes(postData.ToString());
try
{
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
request.ContentType = "application/x-www-form-urlencoded";
request.Referer = url;
request.Accept = "*/*";
request.Timeout = 30 * 1000;
request.UserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 2.0.50727; .NET CLR 3.0.04506.648; .NET CLR 3.0.4506.2152;
.NET CLR 3.5.30729)";
request.Method = "POST";
request.ContentLength = byteData.Length;
Stream stream = request.GetRequestStream();
stream.Write(byteData, 0, byteData.Length);
stream.Flush();
stream.Close();
HttpWebResponse response = (HttpWebResponse)request.GetResponse();
Stream backStream = response.GetResponseStream();
StreamReader sr = new StreamReader(backStream, Encoding.GetEncoding("UTF-8"));
result = sr.ReadToEnd();
sr.Close();
backStream.Close();
response.Close();
request.Abort();
}
catch (Exception ex)
{
result = ex.ToString();
}
return result;
}/<code>
8.順豐電子面單打印模板內容（HTML）
<code>
<table>
<table>
class="lazy" data-original="data:image/png;base64,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" />
style="font-weight: bold;">
class="lazy" data-original="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKAAAAA8CAMAAADWtUEnAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAABhQTFRFIiIi1NTUjo6OsbGxYWFh7u7uAAAA////lVpTKwAABPNJREFUeNrsWYvO8yYM9Y30/d94NgZig5t+0/5NlfZFqpKcgDm+gA2F15df8Evwl+D3EUQi0YuIv5MgClx+CX8fQRaBye+6AITaVxFEufaLzj7UW0n8kvstoUyuLSUpNTrlAuFbggwHvwtksyHdn/CZIAZxsMKlRtPgcchIEAt+1jzxS1TwkSCXrqjRoHdWHXYViA6aUaGNCf6c4NTmRygUBN1+tOmyxSEvz1Cybu+7zyfWeGq3ceQJhfky3EgnwT624GGO5GS57UbRAF3qPpk4exUeUL7HaZBMuB6aLOJtd/KK5Ra1g8A9u+VcK65KgYBGbaUmSGHs04QpUvC1C2ofCEpJUHaCr+P5Jjis5uvy2yj0Dy2y7S/4E4LwgAZZPshhQQzObPJuqSkI4h2/H1wsD2jb/XdMEg5M+HommPzNeZHY8kD0JT+htGYf1csMhXUJi3wSOVEcgI6YOFKPFOv9gY5XX4WLhZqi+NPF0IInoIWgOAnOxhmnKllGVK7HVEfRm2fOm2PKitSZOguCt1loOb4V2Tyjd+SnMu8kaE4+VsKpEz5WOzjTJJ6FRWnBgFK1rBWTZARAf4UHm6zPOfQRUnMqQ7NCh/lGDIYgLAh2f6oHhaRIdnynl1zQFFkt23UrPW+0pczOeUCoSi1TC9XMy2VxCrYOarmK7/PXtiY3qGrfiMZelDwDR4gmC4+pANXuhD+lh2Cu6xnlzCnVSXU1vQKmmwvKnYmUOwIoaX9AUwJ4Q3CvOTlYForsMDyEfyOr/UOC2+IHbO1bN6y8LQCOL1TutFrp4htNvdpVEzxKBCBmeRuBKZRp09IriK3OHZO0QjFmA0k6QrVjv/fFB79RDGyZVOXxitgJ84auwqdA7ww1dr4rXcLzrviwX510y7zIZUVUo0dypXJffNrw8G9dFJRbPS4TdI3uW3J6c7LQ9q07yDZN6/1yWSlgqSe+0T66Lxpln1kcjVgczfCMPtoOxGYuTWXLjMl0UFajK/lBhovTLeUAeolUxfF3HGAi64Xt9fpWgr9HwL8Efwn+CYKWndo3E9RNi3y1BQH+axezpVHREg8vzXc43ynAsxIExLwZBXtBKx9IK1BNQ55Q5RIrSMXTv6VbWbdZ+1ltYf37aYCNDCyhiI/1oMkClUSXJlzqQ+lYEXZ+ICBN7E+UVbxqYtRB7QeqitEVq/SkJ22FxWFFcd6cn8kyla09W6ljD1eXdrpYzWYtzFzUbxdjH3LBLpR6CR1cDKavvjcznbg6vV1/6xqqoGZ3buM2FDPPdaVeNiS7vSVIh7TL0KIEYAylN3unCA8P9xrMXntxx20UP617vw3pOHXieUAGftQB68RDxpGz71a0F7tm/IYgmytoBp0+QPdFhOduZOiI9q8jNvOwSDdWbxQIoou1Pyd78KmtcYXY8HRzyZ8JvqzIUrn+X4R6VuMDMrwotuzi5YPuLZtiLzc+jsm3qlK5bzOqb4U+ERSbbHC5VLU7uUFu2DyvltItcSJo4zWxYAefWTaloU+SHgzaHYGbzlN1w7qBRac+y+ivrT4RJI9Rj4irn75QgtFZXymM55aHOydwZbyNE5zHuxBvONefzn60/0SwSV+tfFdoM4Fkg+0PSpb1eNtQpGmT3o5sVnsb9iMUFF+RxHOP33r/+YW8vZ1YaScM0v+VdPAnk8z/kyDRbz34PddfAgwAfP7m2QIPxogAAAAASUVORK5CYII=" />
/<table>
/<table>
<table>
class="lazy" data-original="data:image/gif;base64,R0lGODlh+gAtAPAAAAAAAP///ywAAAAA+gAtAEAI/wADCBxIsKDBgQASAhCYkKBChQ4hFnzIUCJFhAsxXmwYgGNEjxg/Zqy48WFGkBdJjuxoMmJFlRxTalwJ86RNkAdz6ty5s6RIlBJFqhwacmZMmwZlvpz586bFlTKjtix6tCROlldNIsVKk6fXrwd9GoUalClXoktrLs1aNu3ZsWpZCjUbd63Tql2Vcj2KFqzfv2Lrvp1rlWxTu0nbyqW79+7WvlKl2i2cmK1YvX8z6wzceC7hp0APL7aclyzQwnwZRy6bWmvf151HK9ZMe+JT0bApD14cN7XnopCnuua9e3Vo2bp/93Zau3nY23AZE01OfLhv6dVZC9/+27hh5KBLk/9uPds5bc7Dc4cPLvq6+u7b0Ws/rX3yetvjt2I2r1n+6srMFWcadKQlBh9qjwlI33F44QUggORdxV9/0Amml26SRefebm55t9yBAzLomHr52Tehef7NJ16AGX5I3HuqxVehgiF+12CAysXm4InNpUjfg2+1qGOCMAaHYIcq4ibbcgXiR2B5PH7l44BAUregfisaGOOR2f0YHWJDNtkejlFmNmWOGNanIZEcdlmji0a+SdWIbV7IXZtlSjljenXeJ6R1bNoJ4o1IemkhltSR+KSEefJ0JnZpHueimMDRSKibg9pIp50lgteomXtOpeh0ak6apW2ZwkmjkhHeh+ad+33/mtOjowZZ6pBuFWnpplRuqealnK7Yqqx+0drnjn/CeqpLvgLba5wiMrnsmrARO2uo/zlJqqS4vthnqt3GySqirkKqLKPWauumoWZZKeeGgjbLK4jj2rfjq5dBmW67ctbq7pi5fiuvqtkeai+Zig67b0/YJqnuv9R6Gy+08/paL3j3mpsvugvbOm6TEJsKJLMUE+ywwRgjfOyiXXXM78enhtwtpYW+e6e4Xy4Z5rSmcrywscFu+53I6pK8q8ns8tlqxgmT6/K11ymtWKRDz8wzpmumCC6YgNJstc/7Aj21n7cCGvDER4e7as5Lqxyswk8/3O/KQhtttsRjg3s3zig7/+v13bF2LDbI5V4J5qt637x237z+fW7LTw8ec+E2n533wGoXHBvXMo4cceA/N8xu3QICjDdbiWuNOeeJrgx33C+zPTayZSvrec1jql7ynNLe/jXkLkteJeWmO556w1vr3PXVgOsbetSi0m0rt837nrSM0F+fod/MPw673DAPn7HhOiOO+d6Lb65850V/7nzYoj/L7/iVn17a8dnLL/XBtRb/frrCkxv9/Gc9/WEvQZrbX8r65z6wATB++GJR7fJVQPwh8GTqaxsDewY8wUFQYxKknu3ah7usIW9162vd25z2vdgdinADdF8Fz6e4BEZPg9LznwOtFcDPxJBo5tsd+klsuL3GdW9jHXzeBTVHumRRkIRYk1b+kofDoDnpdd/r4fzIRD54XU6INcSgArlXQCS20IUZnF0Iq1Y9KGovPFNEYRXVCCEWOicgADs=" /> style="font-size: 11px;display: none">1 / 1
子單號 555555555
母單號 888888888888
運單號 5622033142418
籤回單號 3552033142418
順丰標快
目的地：
010
/<table>
<table>
收方:
/<table>
<table>
月結帳號：3434555
支付方式：寄付月結
代收貨款：￥0元
卡號：
運費：-
費用合計：-
/<table>
<table>
寄方:
原寄地：339
收件員：
寄件日期：2020-02-05 11:34:24
收方簽署:
日期：
/<table>
<table>
class="lazy" data-original="data:image/png;base64,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"
alt="" />class="lazy" data-original="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKAAAAA8CAMAAADWtUEnAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAABhQTFRFIiIi1NTUjo6OsbGxYWFh7u7uAAAA////lVpTKwAABPNJREFUeNrsWYvO8yYM9Y30/d94NgZig5t+0/5NlfZFqpKcgDm+gA2F15df8Evwl+D3EUQi0YuIv5MgClx+CX8fQRaBye+6AITaVxFEufaLzj7UW0n8kvstoUyuLSUpNTrlAuFbggwHvwtksyHdn/CZIAZxsMKlRtPgcchIEAt+1jzxS1TwkSCXrqjRoHdWHXYViA6aUaGNCf6c4NTmRygUBN1+tOmyxSEvz1Cybu+7zyfWeGq3ceQJhfky3EgnwT624GGO5GS57UbRAF3qPpk4exUeUL7HaZBMuB6aLOJtd/KK5Ra1g8A9u+VcK65KgYBGbaUmSGHs04QpUvC1C2ofCEpJUHaCr+P5Jjis5uvy2yj0Dy2y7S/4E4LwgAZZPshhQQzObPJuqSkI4h2/H1wsD2jb/XdMEg5M+HommPzNeZHY8kD0JT+htGYf1csMhXUJi3wSOVEcgI6YOFKPFOv9gY5XX4WLhZqi+NPF0IInoIWgOAnOxhmnKllGVK7HVEfRm2fOm2PKitSZOguCt1loOb4V2Tyjd+SnMu8kaE4+VsKpEz5WOzjTJJ6FRWnBgFK1rBWTZARAf4UHm6zPOfQRUnMqQ7NCh/lGDIYgLAh2f6oHhaRIdnynl1zQFFkt23UrPW+0pczOeUCoSi1TC9XMy2VxCrYOarmK7/PXtiY3qGrfiMZelDwDR4gmC4+pANXuhD+lh2Cu6xnlzCnVSXU1vQKmmwvKnYmUOwIoaX9AUwJ4Q3CvOTlYForsMDyEfyOr/UOC2+IHbO1bN6y8LQCOL1TutFrp4htNvdpVEzxKBCBmeRuBKZRp09IriK3OHZO0QjFmA0k6QrVjv/fFB79RDGyZVOXxitgJ84auwqdA7ww1dr4rXcLzrviwX510y7zIZUVUo0dypXJffNrw8G9dFJRbPS4TdI3uW3J6c7LQ9q07yDZN6/1yWSlgqSe+0T66Lxpln1kcjVgczfCMPtoOxGYuTWXLjMl0UFajK/lBhovTLeUAeolUxfF3HGAi64Xt9fpWgr9HwL8Efwn+CYKWndo3E9RNi3y1BQH+axezpVHREg8vzXc43ynAsxIExLwZBXtBKx9IK1BNQ55Q5RIrSMXTv6VbWbdZ+1ltYf37aYCNDCyhiI/1oMkClUSXJlzqQ+lYEXZ+ICBN7E+UVbxqYtRB7QeqitEVq/SkJ22FxWFFcd6cn8kyla09W6ljD1eXdrpYzWYtzFzUbxdjH3LBLpR6CR1cDKavvjcznbg6vV1/6xqqoGZ3buM2FDPPdaVeNiS7vSVIh7TL0KIEYAylN3unCA8P9xrMXntxx20UP617vw3pOHXieUAGftQB68RDxpGz71a0F7tm/IYgmytoBp0+QPdFhOduZOiI9q8jNvOwSDdWbxQIoou1Pyd78KmtcYXY8HRzyZ8JvqzIUrn+X4R6VuMDMrwotuzi5YPuLZtiLzc+jsm3qlK5bzOqb4U+ERSbbHC5VLU7uUFu2DyvltItcSJo4zWxYAefWTaloU+SHgzaHYGbzlN1w7qBRac+y+ivrT4RJI9Rj4irn75QgtFZXymM55aHOydwZbyNE5zHuxBvONefzn60/0SwSV+tfFdoM4Fkg+0PSpb1eNtQpGmT3o5sVnsb9iMUFF+RxHOP33r/+YW8vZ1YaScM0v+VdPAnk8z/kyDRbz34PddfAgwAfP7m2QIPxogAAAAASUVORK5CYII="
alt="" />
![]()
子單號 234234234
234234
243234324
/<table>
<table>
寄
方:
收
方:
/<table>
<table>
數量
託寄物
備註
嬰兒用品
<table>
訂單號
style="vertical-align: middle; text-align: center;">
2355334314
/<table>
費用合計：
- 元
/<table>
/<code>
複製以上HTML內容保存為html格式的文件，可以查看模板效果。
9.關於簽名
快遞鳥和第三方電子商務公司系統進行對接，有一定的安全機制。採用 IP 認證加簽名的方式對接，具體方案如下：
<code>防止數據被篡改
在 POST 請求中會傳遞 5 個必須(R)參數
RequestData==數據內容(URL 編碼:UTF-8)
EBusinessID==用戶 ID
RequestType=請求指令類型
DataSign== 數據內容簽名：把(請求內容(未編碼)+ApiKey)進行 MD5 加密，然後 Base64
編碼，最後進行 URL(utf-8)編碼
DataType==2(返回數據類型為 json)
注：
DataSign 生成後，對方接收到數據後，以同樣的算法進行簽名(推送接口 RequestType 為
101/102 不需要進行 URL 編碼)，生成摘要，對比兩者的摘要是否相同，如果不同，說明傳遞過程中發生數據篡改。
調用接口的身份認證
註冊成為快遞鳥用戶後，會生成對應的用戶 ID 和 APIKey，用戶 ID 相當於用戶名，
APIKey 相當於密碼。/<code>
10.注意事項
12.1 關於順豐月結賬號接口傳值
MonthCode傳值順豐月結賬號（PayType為1、2時不填，為3、4時必填），
PayType傳值付款方式（包含：1-現付，2-到付，3-月結，4-第三方付），
客戶號配置頁需留兩個欄位（需正確對應以上兩個字段）由發貨商家填寫，商家自己開發的系統也建議保留配置頁，萬一賬號更換了呢？
注：商家的順豐月結賬號是否能發對應的快遞類型，請事先和順豐速運分部人員確認，除1、2、5、6外，其他快遞類型都需單獨再籤協議。
12.3 關於順豐速運增值服務傳值
- 保價
字段傳值："AddService": [{"Name":"INSURE ","Value":"1000"}]
- 代收貨款
字段傳值："AddService":[{"Name":"COD","Value":"1000","CustomerID":"1234567891"}]
- 子母件
Quantity傳值大於等於2表示子母件，並且會返回對應的SubCount子單數量、SubOrders子單單號、SubPrintTemplates子單html模板；
- 籤回單
IsReturnSignBill傳1表示需要籤回單，並且會返回對應的SignBillPrintTemplate籤回單html模板，默認為0不需要；
OperateRequire表示回單操作要求(如：簽名、蓋章、身份證複印件等)；
- 預約快遞員上門
IsNotice表示是否通知快遞員上門攬件，0-通知，1-不通知，默認為1；
12.4 關於是否需要預約快遞員上門攬件：
1、 如寄件點是全國各地不固定，需要快遞員上門攬件則預約（此類情況務必對預約用戶做限制，必須本人預約，通過手機驗證碼驗證成功後方可預約，不然會造成用戶惡意下單預約，導致順豐速運投訴）；
2、 如是固定幾個地點發貨，且每天都需要發貨，可線下與快遞員協商定時定點定人上門攬件，接口上不需要預約；
3、 如是固定地點發貨，只是偶爾發幾票，自己打印面單則隨機預約其中一個訂單，如需要快遞員打印則全部預約（快遞員是否能打印取決於順豐速運當地網點）；
注：如出現惡意預約，導致順豐速運向快遞鳥投訴超過3次的，快遞鳥將停用用戶此接口權限；
- 訂閱物流節點短信通知
物流節點短信包含：寄件短信、派件短信、簽收短信、問題件短信等；
字段傳值：IsSendMessage 0-不需要，1-需要
短信通知是收費服務，需聯繫商務同事購買會員套餐或短信套餐後方可使用。
12.5， 電子面單模板樣式
順豐速運模板共5個規格，具體如下
² 二聯150(默認模板，TemplateSize傳值為空)
² 三聯210(TemplateSize傳值210)
² 二聯180新(TemplateSize傳值180)
² 二聯150豐密面單(TemplateSize傳值15001)
² 三聯210豐密面單(TemplateSize傳值21001)
- ：快遞公司不支持的特殊字符：' " # & + % \\ < > 請確認請求數據（包含收寄方姓名、電話、地址、商品名稱等所有訂單數據）中是否含有以上特殊字符；
- 電子面單下單接口訂單號OrderCode不能重複使用，重複使用會報錯且返回的面單是此訂單號上次下單的內容；
- 默認的模板TemplateSize無需傳值，非默認模板傳對應模板尺寸，不可傳不存在的模板尺寸代碼；
- 下單成功後如不需要發貨，直接撕掉面單即可，不需要取消（如果一定要取消可對接”電子面單取消接口”），快遞員攬件後才收費，單號不收費；
- 不可派送表示派件地址不在順豐速運服務範圍，具體收派範圍可在順豐速運官網查看http://www.sf-express.com/cn/sc/dynamic_function/range/，可更換其他快遞發貨；
分享到:
閱讀更多 老楊佔線 的文章
