目录

1.完成准备工作。

2.API接口

3.请求参数(标题)

4.请求完成消息(示例)

5.成功返回消息(示例)

6.失败返回消息(示例)

7.分步解释(C#版本)

8.SF电子面单打印模板内容(HTML)

9.关于签名

前言

密密麻麻的面单，就是隐藏了用户个人信息的顺丰快递面单。面单可以隐藏发件人姓名、收件人手机、地址等一些信息。，让个人信息不再直接暴露。

先来看两张面对面的效果图。

图一

第一张图是150MM的电子单模板，一式两份，发件人和收件人的手机可见。

图二

第二张图也是150MM的电子板材模板，一式两份。发信人和收信人的手机，星星是看不见的。这种面单安全可靠，主要是保护客户隐私。强烈建议客户使用。下面来解释一下实现过程。

1.完成前期准备工作

1.1.去快鸟免费注册一个对接账号。

1.2、免费获得一个apiKey(接口权限验证需要)

1.3.完成实名认证流程。

1.4，订购免费套餐。

1.5.申请顺丰速运月账户。

顺丰的月结账户需要线下与当地顺丰分公司签订代收代付合同。签约后，顺丰会提供一个顺丰速运的10位月度结算账户，用于发货和结算运费；

注意:快鸟官网后台显示的信息和状态(如“我的物流服务商”页面不显示顺丰或顺丰月账号)不影响界面的使用，也不需要在后台添加要使用的客户号，直接通过界面下单即可。

1.6.准备打印机和打印纸。

打印机：

电子表模板中对打印机的品牌和型号没有要求，只要是热敏打印机即可。常见品牌如斑马、得力、快迈、汉音、佳博等。

打印机可以由快递网点提供，也可以在淘宝JD.COM上购买。安装打印机和驱动程序，并联系打印机提供商。

打印纸：

顺丰快递使用的打印纸有三种:100mm*150mm(切点90/60)，100mm*180mm(切点110/70)，100mm*210mm(切点90/60/60)。

打印纸可以由快递网点提供，也可以在淘宝JD.COM上购买。选购时可选择全白热敏纸。

2.API接口

2.1、测试调用地址:http://sandboxeapi . kdniao . com:8080/kdniaosandbox/gateway/external invoke . JSON。

2.2.官方通话地址:http://api.kdniao.com/api/EOrderService

2.3.申请方式:邮寄

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.调试工具:debug(用快鸟账号登录)

3.请求参数（Headers）

参数类型描述必须要求RequestDataString请求内容为URL(utf-8)编码，请求内容的JSON格式必须与DataType一致。必需的EBusinessIDString用户ID，请检查用户ID和ApiKey。必需的RequestTypeString请求指令类型:1007必需的
DataSignString签名数据，(Body+ApiKey) MD5加密，然后base64编码，最后URL(utf-8)编码。必需的数据类型字符串，返回数据类型:2-json，默认json可选。

4.请求报文（示例）

{ "订单代码& # 34；: "012657018199", "托运人代码& # 34；: "SF & # 34, "工资类型& # 34；: 1, "MonthCode & # 34: "1234567890", "ExpType & # 34: 1, "成本& # 34；: 1.0, "其他成本& # 34；: 1.0, "发件人& # 34；: { "公司& # 34；: "吕& # 34；, "姓名& # 34；: "泰勒& # 34；, "移动& # 34；: "15018442396", "普罗文斯名称& # 34；: "上海& # 34；, "CityName & # 34: "上海& # 34；, "ExpAreaName & # 34: "青浦区& # 34；, "地址& # 34；: "明珠路& # 34；}, "接收者& # 34；: { "公司& # 34；: "GCCUI & # 34, "姓名& # 34；: "扬恩& # 34；, "移动& # 34；: "15018442396", "普罗文斯名称& # 34；: "北京& # 34；, "CityName & # 34: "北京& # 34；, "ExpAreaName & # 34: "朝阳区& # 34；, "地址& # 34；: "三里屯大街& # 34；}, "商品& # 34；: [ { "GoodsName & # 34: "鞋子& # 34；, "商品数量& # 34；: 1, "GoodsWeight & # 34: 1.0 }, { "GoodsName & # 34: "衣服& # 34；, "商品数量& # 34；: 1, "GoodsWeight & # 34: 1.0 }, ], "AddService & # 34: [ { "姓名& # 34；: "投保& # 34；, "价值& # 34；: "1000"}, { "姓名& # 34；: "COD & # 34, "价值& # 34；: "1020""CustomerID & # 34: "1234567890"} ], "重量& # 34；: 1.0, "数量& # 34；: 1, "卷& # 34；: 0.0, "备注& # 34；: "小心轻放& # 34；} 5.成功返回消息(示例){ & # 34；电子商务& # 34；: "1237100", "订单& # 34；: { "订单代码& # 34；: "012657700387", "托运人代码& # 34；: "HTKY & # 34, "物流代码& # 34；: "50002498503427", "MarkDestination & # 34: "北京-朝阳(北京-1)& # 34；, "OriginCode & # 34: "200000", "OriginName & # 34: "上海配送中心& # 34；, "PackageCode & # 34: "北京& # 34；}, "PrintTemplate & # 34:"打印模板的HTML内容在后面单独列出& # 34；, "EstimatedDeliveryTime & # 34:"2016-03-06", "成功& # 34；:真的，& # 34；结果代码& # 34；: "100", "原因& # 34；: "成功& # 34；} 6.失败返回消息(示例){ & # 34；电子商务& # 34；: "1237100", "结果代码& # 34；: "106", "原因& # 34；: "订单编号已成功下达& # 34；, "UniquerRequestNumber & # 34:"5e 66486 b-8 FBC-4131-b875-9b 13 D2 ad 1354 & # 34；}说明:如果没有进行实名认证，没有订购套餐，套餐的可用查询数量用完，会返回此消息进行实名认证/套餐详解。

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

9.1、请求包结构

9.2、C#调用代码示例

技术支持：QQ:510997342//电商IDstring eEBusinessID = "test1617571"; //电商加密私钥，快递鸟提供，注意保管，不要泄漏string appKey= "554343b2-7252-439b-b4eb-1af42c8f2175"; //请求urlstring 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.41120.com/skin/shenghuo/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.41120.com/skin/shenghuo/image/nopic.gif />

"print_paper"> "65">

"p0" width="249" style="text-align: center;"> "249px" src=http://www.41120.com/skin/shenghuo/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.41120.com/skin/shenghuo/image/nopic.gif alt="" /> "phone" height="30" src=http://www.41120.com/skin/shenghuo/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格式的文件，可以查看模板效果。技术支持:QQ:510997342//电商IDstring eEBusinessID = & # 34test1617571 & # 34；//电商加密私钥，快鸟提供，注意保管，不要泄露字符串appKey = & # 34554343 B2-7252-439 b-b4eb-1 af 42 c8 f 2175 & # 34；；//请求urlstring reqURL = & # 34http://sandbox API . kdn iao . com:8080/kdniaosandbox/gateway/extraceface invoke . JSON & # 34；；//请求指令字符串reqType = & # 341007"；//2-json字符串数据类型= & # 34；2"；//字符编码是UTF-8字符串charset = & # 34UTF-8 & # 34；；//JSON string字符串jsonStr = & # 34{"订单代码 & # 34；: "012657018199","ShipperCode & # 34: "SF & # 34,"工资类型 & # 34；: 1,"MonthCode & # 34: "1234567890","ExpType & # 34: 1,"成本 & # 34；: 1.0,"其他成本 & # 34；: 1.0,"发件人 & # 34；: {"公司 & # 34；: "吕 & # 34；,"姓名 & # 34；: "泰勒 & # 34；,"手机 & # 34；: "15018442396","ProvinceName & # 34: "上海 & # 34；,"CityName & # 34: "上海 & # 34；,"ExpAreaName & # 34: "青浦区 & # 34；,"地址 & # 34；: "路 & # 34；},"接收者 & # 34；: {"公司 & # 34；: "GCCUI & # 34,"姓名 & # 34；: "Yann & # 34,"手机 & # 34；: "15018442396","ProvinceName & # 34: "北京 & # 34；,"CityName & # 34: "北京 & # 34；,"ExpAreaName & # 34: "朝阳区 & # 34；,"地址 & # 34；: "三里屯街 & # 34；},"商品 & # 34；: [{"GoodsName & # 34: "鞋子 & # 34；,"商品数量 & # 34；: 1,"GoodsWeight & # 34: 1.0},{"GoodsName & # 34: "衣服 & # 34；,"商品数量 & # 34；: 1,"GoodsWeight & # 34: 1.0},],"AddService & # 34: [{"姓名 & # 34；: "投保 & # 34；,"价值 & # 34；: "1000"},{"姓名 & # 34；: "COD & # 34,"价值 & # 34；: "1020""CustomerID & # 34: "1234567890"}],"重量 & # 34；: 1.0,"数量 & # 34；: 1,"卷 & # 34；: 0.0,"备注 & # 34；: "小心轻放 & # 34；}"；//base64编码md5Str字符串base64str = base64 (md5str，charset)；//URL编码(UTF-8)字符串data sign = HTTP utility . urlencode(base 64 str，charset)；//请求消息参数字符串postStr = & # 34request type = req type & e businessid = eEBusinessID & request data = JSON str & data sign = data sign & DataType = DataType & # 34；；//通信协议使用Http协议Post请求方式返回跟踪数据字符串post = send post (requrl，poststr)；//获得的帖子数据是信使鸟返回的完整消息。接下来，您可以通过自己编写解析json的方法来获取字段信息。//用MD5字符串MD5str = MD5 (jsonstr+apikey，charset)加密(JSON str+API key)；//base64编码md5Str字符串base64str = base64 (md5str，charset)；//URL编码(UTF-8)字符串data sign = HTTP utility . urlencode(base 64 str，charset)；//请求消息参数字符串postStr = & # 34request type = req type & e businessid = eEBusinessID & request data = JSON str & data sign = data sign & DataType = DataType & # 34；；//通信协议使用Http协议Post请求方式返回跟踪数据字符串post = send post (requrl，poststr)；//获得的帖子数据是信使鸟返回的完整消息。接下来，您可以通过自己编写解析json的方法来获取字段信息。9.3、C#调用方法//< summary & gt；///字符串MD5加密///

9.关于签名

小鸟快递与第三方电商公司系统的对接有一定的安全机制。对接采用IP认证和签名。具体方案如下:

POST防止数据被篡改，五个必需的(R)参数RequestData==数据内容(URL编码:UTF-8) EBusinessID==用户ID RequestType=请求指令类型DataSign==数据内容签名:MD5加密(请求内容(未编码)+ApiKey)，然后是base64编码，最后是URL(utf-8)编码。DataType==2(返回的数据类型为json)注意:DataSign生成后，对方用同样的算法对数据进行签名(push接口RequestType为101/102，不需要URL编码)生成摘要。比较两个汇总是否相同，如果不同，说明传输过程中发生了数据篡改。调用接口的认证注册为信使鸟用户后，会生成相应的用户ID和APIKey，其中用户ID相当于用户名，APIKey相当于密码。10.注12.1关于SF月结接口的价值转移

MonthCode传输SF每月帐号(当PayType为1或2时不填写，但当PayType为3或4时需要填写)。

键入逐值支付方式(包括:1-现金支付，2-按需支付，3-每月结算，4-第三方支付)，

客户配置页面要留两个字段(正确对应以上两个字段)，发货商家填写。商家自己开发的系统也建议保留配置页面。账号改了怎么办？

注:商家的顺丰月结是否可以发送对应的快递类型，请提前与顺丰速运分公司工作人员确认。除1、2、5、6外，其他快递类型需要单独签订协议。

12.3顺丰速运的增值服务

保价

字段值转移:& # 34；AddService & # 34: [{"姓名& # 34；:"投保& # 34；,"价值& # 34；:"1000"}]

代收货款

字段值转移:& # 34；AddService & # 34:[{"姓名& # 34；:"COD & # 34,"价值& # 34；:"1000","CustomerID & # 34:"1234567891"}]

子母件

传入数量值大于等于2表示子母，返回对应的子盘点子单据号、子订单子单据号、子打印模板子单据html模板；

签回单

IsReturnSignBill传递1表示需要一个签到表单，会返回签到表单对应的SignBillPrintTemplate html模板。默认值为0，这不是必需的。

OperateRequire表示收据操作要求(如签名、盖章、身份证复印件等。);

预约快递员上门

IsNotice表示是否通知快递员来取包裹，0-通知，1-不通知，默认为1；

12.4关于快递员取包裹是否需要预约:

1.如果全国各地都没有固定的投递点，需要快递员来取包裹，那就预约(这种情况下，必须限制预约用户。必须自己预约，手机验证码验证成功后才能预约，否则会造成用户恶意预约，导致顺丰投诉)；

2.如果货物是在几个固定地点送达，需要每天送达，可以线下和快递员协商，固定时间上门取货。在接口上不需要预约；

3.如果是在固定地点投递，偶尔也只会开几张票。如果您打印自己的面单，您将随机预订其中一个订单。如需快递打印，则全部预约(快递员能否打印取决于顺丰当地网点)；

注意:如果存在恶意预订，导致顺丰向快鸟投诉3次以上，快鸟将禁用用户对此界面的权限；

订阅物流节点短信通知

节点短信包括:发送短信、发送短信、签约短信、问题短信等。

传入值:IsSendMessage 0-不需要，1-需要。

短信是收费服务。您需要联系您的业务同事购买会员套餐或短信套餐，然后才能使用。

12.5、电子表格模板样式

顺丰快递模板有五种规格，如下

双链接150(默认模板，TemplateSize的值为空)

三元组210(模板大小传递值210)

两个180新(模板大小传递值180)

一百五十分之二密面纸(模板尺寸传输值15001)

三层210密度面条板(模板尺寸值21001)

：快递公司不支持的特殊字符：' " # & + % < > 请确认请求数据（包含收寄方姓名、电话、地址、商品名称等所有订单数据）中是否含有以上特殊字符；电子面单下单接口订单号OrderCode不能重复使用，重复使用会报错且返回的面单是此订单号上次下单的内容；默认的模板TemplateSize无需传值，非默认模板传对应模板尺寸，不可传不存在的模板尺寸代码；下单成功后如不需要发货，直接撕掉面单即可，不需要取消（如果一定要取消可对接”电子面单取消接口”），快递员揽件后才收费，单号不收费；不可派送表示派件地址不在顺丰速运服务范围，具体收派范围可在顺丰速运官网查看http://www.sf-express.com/cn/sc/dynamic_function/range/，可更换其他快递发货；