什么是電子面單

標(biāo)準(zhǔn)定義：電子面單是一種通過熱敏紙打印輸出紙質(zhì)物流面單的物流服務(wù)。

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

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

三家電子面單接口對比

1.中通電子面單，需要先申請開發(fā)者賬號，企業(yè)資格認證，電子面單獲取接口對接聯(lián)調(diào)，調(diào)試完成后方可上線。其他快遞公司的電子面單，申請流程大致如此。

2.快寶電子面單，通過快寶開放平臺，可以一次性申請國內(nèi)6家主流快遞（順豐、中通、申通、圓通、韻達、百事快遞）電子面單。他們平臺屏蔽了各大快遞公司的接口差異性，一個請求就輕松申請到了電子面單。

3.菜鳥電子面單，可一次對接多家快遞公司， 無需和每一家快遞公司做對接。支持快遞有四通一達、順豐、EMS、宅急送、德邦、優(yōu)速等15家快遞公司，對順豐有電子面單服務(wù)需求的可以選擇順豐自有的電子面單或者是快遞鳥電子面單。

三家電子面單申請流程

1.中通電子面單接口

a.申請開發(fā)者賬號，并做企業(yè)資質(zhì)認證

b.接口對接聯(lián)調(diào)

c.電子面單服務(wù)用戶向快遞網(wǎng)點申請開通及確認合作細節(jié)

2.快寶電子面單接口

a.注冊開發(fā)者賬號，獲得用戶ID和API Key。

b.接口對接聯(lián)調(diào)

c.電子面單服務(wù)用戶向快遞網(wǎng)點申請開通及確認合作細節(jié)。

3.菜鳥電子面單?

a.向菜鳥網(wǎng)絡(luò)提交對接申請?

b.和菜鳥進行接口對接?

c.電子面單服務(wù)用戶向菜鳥申請賬號?

d.電子面單服務(wù)用戶向快遞網(wǎng)點申請開通及確認合作細節(jié)。

由于快寶電子面單，對接簡單，比較有代表性，固拿他舉例。

接口參數(shù)與說明

接口名稱：account.waybill.get

請求方式：POST

編碼：UTF-8

返回數(shù)據(jù)格式：JSON

正式地址：https://kop.kuaidihelp.com/api	?
測試地址：https://kop.kuaidihelp.com/test	測試賬號，用戶ID ：80001 ； ? ? API Key：4f1360e9f24ea6c9c8f023f13e7edce5

公共請求參數(shù)

名稱類型是否必須描述

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

公共響應(yīng)參數(shù)

稱類型是否必須描述

code	int	是	響應(yīng)狀態(tài)碼。0-成功，非0-失敗
msg	string	是	返回結(jié)果說明
uid	string	是	本次請求唯一業(yè)務(wù)流水號
data	string	是	JSON格式響應(yīng)數(shù)據(jù)

請求參數(shù)

名稱類型是否必須描述

customer_name	string	是	快遞網(wǎng)點或快遞開放平臺申請的客戶號。
customer_password	string	是	快遞網(wǎng)點或快遞開放平臺申請的客戶密碼。
customer_id	string	否	快遞網(wǎng)點的客戶編號。
order_id	string	是	訂單編號，必須唯一 (注：如有使用本公司其他平臺生成訂單，請?zhí)砑酉鄳?yīng)的前綴，避免重復(fù)，以示區(qū)分。)
custom_value	string	否	請求時的自定義預(yù)留信息,在響應(yīng)成功時返回
site_flag	string	可選	快遞網(wǎng)點名稱或標(biāo)識符 （申通必填）。
shipper_type	string	是	快遞公司標(biāo)識符，如：zt 。下載并查看詳情
month_no	string	否	月結(jié)卡號
pay_type	int	是	支付方式 ：1-寄方支付，2-收方支付, 3-月結(jié)
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	否	商品的件數(shù)，或包裹數(shù)
volume	double	否	物品總體積：m3
remark	string	否	備注信息
sender	data	是	寄件方信息列表（信息比較多，具體可以去他們平臺看看）
recipient	data	是	收件方信息列表（信息比較多，具體可以去他們平臺看看）
commodities	data	是	商品信息列表（信息比較多，具體可以去他們平臺看看）

響應(yīng)參數(shù)

名稱類型是否必須描述

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

舉個例子

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

$host = "https://kop.kuaidihelp.com/api"; $method = "POST"; $headers = array(); //根據(jù)API的要求，定義相對應(yīng)的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":"預(yù)留信息","shipper_type":"ZTO","pay_type":"1","weight":"1.23","remark":"小心輕放","sender":{"company":"南山區(qū)深圳軟件產(chǎn)業(yè)基地","name":"張飛鴻","tel":"","mobile":"18688888888","post_code":"200083","province":"廣東省","city":"深圳市","district":"南山區(qū)","address":"深圳軟件產(chǎn)業(yè)基地"},"recipient":{"company":"寶芝林貿(mào)易","name":"王三姨","tel":"95127777","mobile":"13666666666","post_code":"215000","province":"江蘇省","city":"蘇州市","district":"滄浪區(qū)","address":"人民路滄浪亭街31號寶芝林貿(mào)易有限公司"},"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));

成功結(jié)果響應(yīng)示例

{ "code":int0 "msg":string"success" "uid":string"a6934adee62d8ba3430d4ac678dd5f46c7a79d6e" "data":{ "result":{ "sender":{ "company":string"南山區(qū)深圳軟件產(chǎn)業(yè)基地" "name":string"張飛鴻" "tel":string"" "mobile":string"18688888888" "post_code":string"200083" "province":string"廣東省" "city":string"深圳市" "district":string"南山區(qū)" "address":string"深圳軟件產(chǎn)業(yè)基地" } "recipient":{ "company":string"寶芝林貿(mào)易" "name":string"王三姨" "tel":string"95127777" "mobile":string"13666666666" "post_code":string"215000" "province":string"江蘇省" "city":string"蘇州市" "district":string"滄浪區(qū)" "address":string"人民路滄浪亭街31號寶芝林貿(mào)易有限公司" } "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"預(yù)留信息" "reason":string"ok" } }

錯誤信息碼

可以自查

錯誤碼描述

300101	快遞單號創(chuàng)建失敗
300102	獲取快遞單號失敗
300103	不合法的請求參數(shù)
300104	簽名格式錯誤
300105	請求方式錯誤
300106	請求的數(shù)據(jù)格式錯誤
300107	缺少必要參數(shù)
300108	用戶app_id值不正確
300109	不存在的業(yè)務(wù)類型
300110	請求含有非法參數(shù)
300111	必要參數(shù)不能為空
300112	用戶app_key值不正確
300115	業(yè)務(wù)參數(shù)有誤，請檢查

-the end-

總結(jié)

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。