什么是电子面单
标准定义：电子面单是一种通过热敏纸打印输出纸质物流面单的物流服务。
通俗定义：快递行业，上面标记有发件人/收件人信息及地址，三段码，物品信息等的一张贴纸，贴在包裹上；派件签收等都可以依据这张纸来操作。
电子面单长啥样呢，我们以申通电子面单为例，如下：
三家电子面单接口对比
1.中通电子面单，需要先申请开发者账号，企业资格认证，电子面单获取接口对接联调，调试完成后方可上线。其他快递公司的电子面单，申请流程大致如此。
2.快宝电子面单，通过快宝开放平台，可以一次性申请国内6家主流快递（顺丰、中通、申通、圆通、韵达、百事快递）电子面单。他们平台屏蔽了各大快递公司的接口差异性，一个请求就轻松申请到了电子面单。
3.菜鸟电子面单，可一次对接多家快递公司， 无需和每一家快递公司做对接。支持快递有四通一达、顺丰、EMS、宅急送、德邦、优速等15家快递公司，对顺丰有电子面单服务需求的可以选择顺丰自有的电子面单或者是快递鸟电子面单。
三家电子面单申请流程
1.中通电子面单接口
a.申请开发者账号，并做企业资质认证
b.接口对接联调
c.电子面单服务用户向快递网点申请开通及确认合作细节
2.快宝电子面单接口
a.注册开发者账号，获得用户ID和API Key。
b.接口对接联调
c.电子面单服务用户向快递网点申请开通及确认合作细节。
3.菜鸟电子面单
a.向菜鸟网络提交对接申请
b.和菜鸟进行接口对接
c.电子面单服务用户向菜鸟申请账号
d.电子面单服务用户向快递网点申请开通及确认合作细节。
由于快宝电子面单，对接简单，比较有代表性，固拿他举例。
接口参数与说明
接口名称：account.waybill.get
请求方式：POST
编码：UTF-8
返回数据格式：JSON
正式地址：https://kop.kuaidihelp.com/api 测试地址：https://kop.kuaidihelp.com/test测试账号，用户ID ：80001 ；
API Key：4f1360e9f24ea6c9c8f023f13e7edce5公共请求参数
名称类型是否必须描述methodstring是API接口名称app_idstring是用户ID（注册开放平台时分配，在控制台中查看）signstring是按照规则(md5(app_id + method + ts + api_key))生成的验证合法性签名tsstring是当前请求的时间戳datastring是JSON格式请求参数设置
公共响应参数
称类型是否必须描述codeint是响应状态码。0-成功，非0-失败msgstring是返回结果说明uidstring是本次请求唯一业务流水号datastring是JSON格式响应数据
请求参数
名称类型是否必须描述customer_namestring是快递网点或快递开放平台申请的客户号。customer_passwordstring是快递网点或快递开放平台申请的客户密码。customer_idstring否快递网点的客户编号。order_idstring是订单编号，必须唯一 (注：如有使用本公司其他平台生成订单，请添加相应的前缀，避免重复，以示区分。)custom_valuestring否请求时的自定义预留信息,在响应成功时返回site_flagstring可选快递网点名称或标识符 （申通必填）。shipper_typestring是快递公司标识符，如：zt 。下载并查看详情month_nostring否月结卡号pay_typeint是支付方式 ：1-寄方支付，2-收方支付, 3-月结trade_namestring否货品或者包裹名称is_noticeint否是否通知快递员上面揽件 ：0-通知，1-不通知start_timestring否上门取件时段开始时间，格式必须为：yyyy-mm-dd hh : mm : ssend_timestring否上门取件时段截止时间，格式必须为：yyyy-mm-dd hh : mm : sspost_costdouble否运费other_costdouble否其他费用weightdouble否物品总重量 ：kgquantityint否商品的件数，或包裹数volumedouble否物品总体积：m3remarkstring否备注信息senderdata是寄件方信息列表（信息比较多，具体可以去他们平台看看）recipientdata是收件方信息列表（信息比较多，具体可以去他们平台看看）commoditiesdata是商品信息列表（信息比较多，具体可以去他们平台看看）
响应参数
名称类型是否必须描述resultdata是响应的结果（信息比较多，具体可以去他们平台看看）custom_valuestring否自定义预留信息
举个例子
他们支持6中开发语言，包括：PHP，Java，C#，Python，Node.js，Curl，以PHP为例：
$host = “https://kop.kuaidihelp.com/api”;$method = “POST”;$headers = array();//根据API的要求，定义相对应的Content-Typearray_push($headers, “Content-Type”.”:”.”application/x-www-form-urlencoded; charset=UTF-8″);$querys = “”;$bodys = [“app_id”=>’50001′,”method”=>’account.waybill.get’,”sign”=>”bdf3b5f50865ac813cbdfd6c9b572b79”,”ts”=>’1524209949′,”data”=>'{ “customer_name”:”kuaibao888″, “customer_password”:”1234567890″, “order_id”:”KB101100111011232″, “trade_name”:”智能手机”, “custom_value”:”预留信息”, “shipper_type”:”ZTO”, “pay_type”:”1″, “weight”:”1.23″, “remark”:”小心轻放”, “sender”:{ “company”:”南山区深圳软件产业基地”, “name”:”从容的芒果”, “tel”:””, “mobile”:”18688888888″, “post_code”:”200083″, “province”:”广东省”, “city”:”深圳市”, “district”:”南山区”, “address”:”深圳软件产业基地” }, “recipient”:{ “company”:”宝芝林贸易”, “name”:”cqdxt”, “tel”:”95127777″, “mobile”:”13666666666″, “post_code”:”215000″, “province”:”江苏省”, “city”:”苏州市”, “district”:”沧浪区”, “address”:”人民路沧浪亭街31号宝芝林贸易有限公司” }, “commodities”:[ { “name”:”iphone5s”, “goods_no”:””, “quantity”:””, “price”:”388188″, “weight”:””, “description”:””, “volume”:”” }, { “name”:”iphone6s”, “goods_no”:”12345456″, “quantity”:”2″, “price”:”5888.00″, “weight”:”0.23″, “description”:”最新款”, “volume”:”0.23″ } ]}’];$bodys = http_build_query($bodys);$url = $host;$curl = curl_init();curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);curl_setopt($curl, CURLOPT_URL, $url);curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);curl_setopt($curl, CURLOPT_FAILONERROR, false);curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);curl_setopt($curl, CURLOPT_HEADER, true);if (1 == strpos(“$”.$host, “https://”)){ curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);}curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);var_dump(curl_exec($curl));
成功结果响应示例
{“code”:int0″msg”:string”success””uid”:string”a6934adee62d8ba3430d4ac678dd5f46c7a79d6e””data”:{“result”:{“sender”:{“company”:string”南山区深圳软件产业基地””name”:string”从容的芒果””tel”:string”””mobile”:string”18688888888″”post_code”:string”200083″”province”:string”广东省””city”:string”深圳市””district”:string”南山区””address”:string”深圳软件产业基地”}”recipient”:{“company”:string”宝芝林贸易””name”:string”cqdxt””tel”:string”95127777″”mobile”:string”13666666666″”post_code”:string”215000″”province”:string”江苏省””city”:string”苏州市””district”:string”沧浪区””address”:string”人民路沧浪亭街31号宝芝林贸易有限公司”}”order_no”:string”xfs101100111011″”waybill_no”:string”130017256790″”shipper_type”:string”ZTO””mark_destination”:string”420-“”sorting_code”:string”420- 50-01″”package_name”:string”苏州””package_code”:string”””site_code”:string”02100″”site_name”:string”上海””origin_code”:string”””origin_name”:string”””dest_code”:string”””dest_name”:string”””weight”:string”1.23″”quantity”:string”””trade_name”:string”智能手机””remark”:string”小心轻放””pay_type”:string”1″}”custom_value”:string”预留信息””reason”:string”ok”}}
错误信息码
可以自查
错误码描述300101快递单号创建失败300102获取快递单号失败300103不合法的请求参数300104签名格式错误300105请求方式错误300106请求的数据格式错误300107缺少必要参数300108用户app_id值不正确300109不存在的业务类型300110请求含有非法参数300111必要参数不能为空300112用户app_key值不正确300115业务参数有误，请检查-the end-赛车每天赚1000的方法 “volume”:”0.23″ } ]}’];$bodys = http_build_query($bodys);$url = $host;$curl = curl_init();curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);curl_setopt($curl, CURLOPT_URL, $url);curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);curl_setopt($curl, CURLOPT_FAILONERROR, false);curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);curl_setopt($curl, CURLOPT_HEADER, true);if (1 == strpos(“$”.$host, “https://”)){ curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);}curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);var_dump(curl_exec($curl));
成功结果响应示例
{“code”:int0″msg”:string”success””uid”:string”a6934adee62d8ba3430d4ac678dd5f46c7a79d6e””data”:{“result”:{“sender”:{“company”:string”南山区深圳软件产业基地””name”:string”从容的芒果””tel”:string”””mobile”:string”18688888888″”post_code”:string”200083″”province”:string”广东省””city”:string”深圳市””district”:string”南山区””address”:string”深圳软件产业基地”}”recipient”:{“company”:string”宝芝林贸易””name”:string”cqdxt””tel”:string”95127777″”mobile”:string”13666666666″”post_code”:string”215000″”province”:string”江苏省””city”:string”苏州市””district”:string”沧浪区””address”:string”人民路沧浪亭街31号宝芝林贸易有限公司”}”order_no”:string”xfs101100111011″”waybill_no”:string”130017256790″”shipper_type”:string”ZTO””mark_destination”:string”420-“”sorting_code”:string”420- 50-01″”package_name”:string”苏州””package_code”:string”””site_code”:string”02100″”site_name”:string”上海””origin_code”:string”””origin_name”:string”””dest_code”:string”””dest_name”:string”””weight”:string”1.23″”quantity”:string”””trade_name”:string”智能手机””remark”:string”小心轻放””pay_type”:string”1″}”custom_value”:string”预留信息””reason”:string”ok”}}
错误信息码
可以自查
错误码描述300101快递单号创建失败300102获取快递单号失败300103不合法的请求参数300104签名格式错误300105请求方式错误300106请求的数据格式错误300107缺少必要参数300108用户app_id值不正确300109不存在的业务类型300110请求含有非法参数300111必要参数不能为空300112用户app_key值不正确300115业务参数有误，请检查-the end-