什么是電子面單

標準定義：電子面單是一種通過熱敏紙打印輸出紙質物流面單的物流服務。

通俗定義：快遞行業，上面標記有發件人/收件人信息及地址，三段碼，物品信息等的一張貼紙，貼在包裹上；派件簽收等都可以依據這張紙來操作。

電子面單長啥樣呢，我們以申通電子面單為例，如下：

三家電子面單接口對比

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

公共請求參數

名稱類型是否必須描述

method	string	是	API接口名稱
app_id	string	是	用戶ID（注冊開放平臺時分配，在控制臺中查看）
sign	string	是	按照規則(md5(app_id + method + ts + api_key))生成的驗證合法性簽名
ts	string	是	當前請求的時間戳
data	string	是	JSON格式請求參數設置

公共響應參數

稱類型是否必須描述

code	int	是	響應狀態碼。0-成功，非0-失敗
msg	string	是	返回結果說明
uid	string	是	本次請求唯一業務流水號
data	string	是	JSON格式響應數據

請求參數

名稱類型是否必須描述

customer_name	string	是	快遞網點或快遞開放平臺申請的客戶號。
customer_password	string	是	快遞網點或快遞開放平臺申請的客戶密碼。
customer_id	string	否	快遞網點的客戶編號。
order_id	string	是	訂單編號，必須唯一 (注：如有使用本公司其他平臺生成訂單，請添加相應的前綴，避免重復，以示區分。)
custom_value	string	否	請求時的自定義預留信息,在響應成功時返回
site_flag	string	可選	快遞網點名稱或標識符 （申通必填）。
shipper_type	string	是	快遞公司標識符，如：zt 。下載并查看詳情
month_no	string	否	月結卡號
pay_type	int	是	支付方式 ：1-寄方支付，2-收方支付, 3-月結
trade_name	string	否	貨品或者包裹名稱
is_notice	int	否	是否通知快遞員上面攬件 ：0-通知，1-不通知
start_time	string	否	上門取件時段開始時間，格式必須為：yyyy-mm-dd hh : mm : ss
end_time	string	否	上門取件時段截止時間，格式必須為：yyyy-mm-dd hh : mm : ss
post_cost	double	否	運費
other_cost	double	否	其他費用
weight	double	否	物品總重量 ：kg
quantity	int	否	商品的件數，或包裹數
volume	double	否	物品總體積：m3
remark	string	否	備注信息
sender	data	是	寄件方信息列表（信息比較多，具體可以去他們平臺看看）
recipient	data	是	收件方信息列表（信息比較多，具體可以去他們平臺看看）
commodities	data	是	商品信息列表（信息比較多，具體可以去他們平臺看看）

響應參數

名稱類型是否必須描述

result	data	是	響應的結果（信息比較多，具體可以去他們平臺看看）
custom_value	string	否	自定義預留信息

舉個例子

他們支持6中開發語言，包括：PHP，Java，C#，Python，Node.js，Curl，以PHP為例：

$host = "https://kop.kuaidihelp.com/api"; $method = "POST"; $headers = array(); //根據API的要求，定義相對應的Content-Type array_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":"王三姨","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"王三姨" "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-

總結

以上是生活随笔為你收集整理的获取电子面单号的API接口对比（中通、快宝、菜鸟）的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。