lnnlx9手機多少錢（順豐電子面單）

目錄1.完成前期準備工作2.API接口3.請求參數（Headers）4.請求完整報文（示例）5.成功返回報文（示例）6.失敗返回報文（示例）7.分步講解（C#版本）8.順豐電子面單打印模板內容（HTML）9.關于簽名前言豐密面單，就是隱藏了

目錄

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.請求報文（示例）

{                           "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": "小心輕放"                         }

5.成功返回報文（示例）

 {                             "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": "成功"                           }

6.失敗返回報文（示例）

 {                               "EBusinessID": "1237100",                               "ResultCode": "106",                               "Reason": "該訂單號已下單成功"，                               "UniquerRequestNumber":"5e66486b-8fbc-4131-b875-9b13d2ad1354"                           }

說明：未實名認證，未訂購套餐，套餐可用查詢量已經用完 都會返回此報文信息去實名認證 / 了解套餐詳情

7.分步講解（C#版本）

9.1，請求數據包結構

9.2,C#調用代碼示例

技術支持：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的方法就能獲取到里面的字段信息。

9.3,C#調用方法

///
     /// 字符串MD5加密     ///
     ///"str">要加密的字符串     ///"charset">編碼方式     ///密文     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;         }     }     /// 
     /// base64編碼     /// 
     /// "str">內容     /// "charset">編碼方式     ///      private string base64(String str, String charset)     {         return Convert.Tobase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str)); }  /// 
     /// Post方式提交數據，返回網頁的源代碼     /// 
     /// "url">發送請求的 URL     /// "postData">請求報文參數     /// 遠程資源的響應結果     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 = "*             .print_paper .p0 .sp {                 position: absolute;                 left: 3px;                 top: 110px;     }         .print_paper .ovh {             overflow: hidden;     }         .print_paper .ov {             overflow: visible;     }         .print_paper .f10 {             font-size: 10px;     }         .print_paper .f13 {             font-size: 13px;     }         .print_paper .bln {             border-left: none;     }         .print_paper .brn {             border-right: none;     }            "print_paper table_first">     "53">     
     "no_border">     
     
"vertical-align: middle;">     "logo" height="35" alt=""                                  src=http://www.rotsrelo.com/skin/keji/image/nopic.gif />     
     
"vertical-align: middle;" colspan="2">          
"f20"                                  style="font-weight: bold;">              
     
          
"vertical-align: middle; text-align: right; position: absolute; left: 264px">     "35" class="phone" alt=""                                  src=http://www.rotsrelo.com/skin/keji/image/nopic.gif />     
     
     
     
     
     
     "print_paper">     "65">     
"p0" width="249" style="text-align: center;">     "249px"                      src=http://www.rotsrelo.com/skin/keji/image/nopic.gif /> "sp"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                style="font-size: 11px;display: none">1 / 1     
     
"font-size: 11px; font-weight: bold;">     "display: none">子單號  555555555
母單號  888888888888     "display: block;margin-top: 3px;">運單號  5622033142418     "display: none;margin-top: 10px;">簽回單號  3552033142418     
     
     
"xx16 p0">     
"height: 74px;">                     順豐標快 
 "xx10">目的地：     
"f24">010
     
     
     
     
     "print_paper" height="50">     
     
"50" style="padding: 0;" class="xx16 brn">收方:
     
"bln">     
"height: 59px; overflow: hidden;">                     北京北京市朝陽區******
     "width: 297px;display: inline-block;">楊**  1590****89     
     
     
     
     "print_paper" height="58">     
     
"2" style="vertical-align: top;" class="f13">                 月結帳號：3434555 
 支付方式：寄付月結 
     
"display: none">聲明價值：0
     
"display: none">簽單返回單號：${SignWaybillCode}
     
"display: none">操作要求：${OperateRequire}
     
     
"45">                 代收貨款：￥0元
卡號：             
     
     
     
                 運費：-
費用合計：-             
     
     
     "print_paper" height="68" width="100%">     
     
"xx14 brn" width="50" style="padding: 0; ">                 寄方:             
     
"ov bln" style="width: 136px;">     
"xx10" style="width: 115px; height: 66px;">     
"height: 40px; overflow: hidden">                         廣東省東莞市清溪鎮******                     
     
"width: 140px;overflow: hidden;">     "width: 52px;display: inline-block;">鞋襪廠13288****80                     
     
"xx10" style="margin-left: -45px; position: absolute;top: 337px;">原寄地：339
     
     
     
"xx10" width="86">                 收件員：
寄件日期：2020-02-05 11:34:24             
     
"xx10">                 收方簽署:
 
日期：             
     
     
     "print_paper table_first" height="60">     "55">     
     "logo" height="30"                      src=http://www.rotsrelo.com/skin/keji/image/nopic.gif                      alt="" /> "phone" height="30"                                     src=http://www.rotsrelo.com/skin/keji/image/nopic.gif                                     alt="" />     
     
"text-align: center;">          "display: none">子單號 234234234     "display: block">234234     "display: none">243234324     
     
     
     "print_paper ">     "76">     
"brn" style="padding: 0; width: 16px;">                 寄
方:             
     
"xx10 bln">     
"height: 67px; overflow: hidden;">                     廣東省東莞市清溪鎮******
     "width: 164px;display: inline-block;">     "width: 52px;display: inline-block;">鞋襪廠13288****80                          
     
     
"padding: 0; width: 16px;" class="fwb brn">                 收
方:             
     
"xx10 bln">     
"height: 67px; overflow: hidden">                     北京北京市朝陽區******
     "width: 164px;display: inline-block;">     "width: 52px;display: inline-block;">楊**1590****89                          
     
     
     
     "print_paper">     "18">     "34">     "40">     
"36" style="padding: 0; text-align: center;">數量
     
"254" style="padding: 0; text-align: center;">托寄物
     
"padding: 0; text-align: center;">備注
     
     
 
     
嬰兒用品
     
     
"f10 ovh" style="height: 33px">
     
     
     
"2">     "no_border">     
     
訂單號
     
"xx14"                             style="vertical-align: middle; text-align: center;">     
2355334314                         
     
     
     
     
"text-align: center;">                 費用合計：
- 元             
     
     
  

復制以上HTML內容保存為html格式的文件，可以查看模板效果。

9.關于簽名

快遞鳥和第三方電子商務公司系統進行對接，有一定的安全機制。采用 IP 認證加簽名的方式對接，具體方案如下：

防止數據被篡改  在 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 相當于密碼。

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個規格，具體如下

2 二聯150(默認模板，TemplateSize傳值為空)

2 三聯210(TemplateSize傳值210)

2 二聯180新(TemplateSize傳值180)

2 二聯150豐密面單(TemplateSize傳值15001)

2 三聯210豐密面單(TemplateSize傳值21001)

• ：快遞公司不支持的特殊字符：' " # & + % < > 請確認請求數據（包含收寄方姓名、電話、地址、商品名稱等所有訂單數據）中是否含有以上特殊字符；
• 電子面單下單接口訂單號OrderCode不能重復使用，重復使用會報錯且返回的面單是此訂單號上次下單的內容；
• 默認的模板TemplateSize無需傳值，非默認模板傳對應模板尺寸，不可傳不存在的模板尺寸代碼；
• 下單成功后如不需要發貨，直接撕掉面單即可，不需要取消（如果一定要取消可對接”電子面單取消接口”），快遞員攬件后才收費，單號不收費；
• 不可派送表示派件地址不在順豐速運服務范圍，具體收派范圍可在順豐速運官網查看http://www.sf-express.com/cn/sc/dynamic_function/range/，可更換其他快遞發貨；