快遞鳥一次性對接600+物流接口

通過此接口可對快遞公司、網點、快遞員進行評價或投訴。
（1）僅支持Json格式。
（2）請求指令1011。
（3）每次請求不超過100條明細。
（4）測試接口地址：//testapi.kdniao.com:8081/api/dist
（5）聯調通過後請更換為正式地址：//api.kdniao.com/api/dist

2.請求系統級參數説明：

參數名稱	類型	説明	必須要求
RequestData	String	請求內容需進行URL(utf-8)編碼。請求內容JSON格式，須和DataType一致。	R
EBusinessID	String	用户ID。	R
RequestType	String	請求指令類型：1011	R
DataSign	String	數據內容簽名	R
DataType	String	請求、返回數據類型：2-json；	O

3.應用級參數：

參數名稱		類型	説明	必須要求
MemberID		String	沒有不填	O
Enterpriseld		String	被投訴企業的ID，來源於獲取投訴企業列表API	R
Mobile		String	投訴人手機號	R
Name		String	投訴人姓名	R
OrderCode		String	訂單號，與物流單號至少一個	C
LogisticCode		String	物流單號，與訂單號至少一個	C
EvaluateType		Int	評價類型(1-物流評價2-物流投訴)	R
Target	MerchantType	String	(1-商品2-電商平台3-商家店鋪4-快遞員-5快遞網點6-快遞公司)	R
	MerchantName		物流或投訴對象的名稱	R
	MerchantPhone		評價或投訴對象的電話，當對象為快遞員時必填，其他對象時忽略。	C
	MerchantLink		評價或投訴對象的鏈接，當對象為電商平台和商家店鋪時必填，其他對象忽略。	C
	MerchantAddress		評價或投訴對象的地址，當對象為快遞網點時必填，其他對象忽略。	C
	MerchantPicture	Base64	Base64的圖片格式，當對象商品和商家店鋪時必填，其他對象忽略。	C
ComplaintType		Int	EvaluateType為投訴時必填，評價時忽略。針對物流企業有以下可選： 11-收件丟失 12-中轉丟失 13-派件丟失 14-未知原因（貨物丟失） 15-不是本人 16-未送貨上門 21-未知原因（快遞延誤） 22-收件破損 23-派件破損 24-中轉破損 31-未知原因（貨物破損） 32-未按時上門攬件 33-未按時派送 34-中轉延誤 41-其他針對電商企業有以下可選： 5-商品不實 6-商家虛假交易不發貨 7-服務態度	C
EvaluateValue		Double	EvaluateType為評價時必填，投訴時忽略。	C
EvaluateTag		String	EvaluateType為評價時必填，投訴時忽略。多個標籤以/隔開，eg：速度快/長得帥。	C
ComplaintContent		String	EvaluateType為投訴時必填，評價時忽略。	C

備註：R-必填（Required），O-可選（Optional），C-報文中該參數在一定條件下可選（Conditional）

4.返回參數定義：

參數名稱	類型	説明	必須要求
EBusinessID	String	電商用户ID	R
Success	Bool	成功與否:true,false	R
Reason	String	失敗原因	O

5.物流投訴JSON請求示例：

請求示例 JSON

{  	                "MemberId": "",  	                "EnterpriseId": "bb253828-0182-4638-988a-639d27cf7f54",  	                "Name": "張三",  	                "Mobile": 18658275958,  	                "OrderCode": "KDN123456",  	                "LogisticCode": "95030000",  	                "EvaluateType": 2,  	                "Target": {  		                "MerchantType": 4,  		                "MerchantName": "張三快遞員",  		                "MerchantPhone": "13500000000",  		                "MerchantLink": "",  		                "MerchantAddress": "",  		                "MerchantPicture": ""  	                },  	                "ComplaintType": 11,  	                "ComplaintContent": "貨物代簽丟失，未收到貨"                  }

6.物流投訴JSON返回示例：

返回示例 JSON

{  	                "EBusinessID": "1279441",  	                "Success": true                  }

7.物流評價JSON請求示例：

請求示例 JSON

{  	                "MemberId": "",  	                "EnterpriseId": "bb253828-0182-4638-988a-639d27cf7f54",  	                "Name": "張三",  	                "Mobile": 18658275958,  	                "OrderCode": "AS123456",  	                "LogisticCode": "95030001",  	                "EvaluateType": 1,  	                "Target": {  		                "MerchantType": 4,  		                "MerchantName": "張三快遞員",  		                "MerchantPhone": "13500000000",  		                "MerchantLink": "",  		                "MerchantAddress": "",  		                "MerchantPicture": ""  	                },  	                "EvaluateValue": 5,  	                "EvaluateTag": "人美/活好",                  }

8.物流評價JSON返回示例：

返回示例 JSON

{  	                    "EBusinessID": "1279441",  	                    "Success": true                      }

二、獲取企業列表接口規則

1.接口描述/説明

（1）僅支持Json格式。
（2）請求指令1013。
（3）測試接口地址：//testapi.kdniao.com:8081/api/dist
（4）聯調通過後請更換為正式地址：//api.kdniao.com/api/dist

2.請求系統級參數説明：

參數名稱	類型	説明	必須要求
RequestData	String	請求內容，JSON,須和DataType一致。	R
EBusinessID	String	用户ID。	R
RequestType	String	請求指令類型：1013	R
DataSign	String	數據內容簽名	R
DataType	String	請求、返回數據類型：2-json；	R

3.應用級參數：

參數名稱	類型	説明	必須要求
MemberID	String	沒有不填	O

備註：R-必填（Required），O-可選（Optional），C-報文中該參數在一定條件下可選（Conditional）

4.返回參數定義：

參數名稱		類型	説明	必須要求
EBusinessID		String	電商用户ID	R
Success		Bool	成功與否:true,false	R
Reason		String	失敗原因	R
Enterprises	EnterpriseId	String	企業編碼	R
Enterprises	EnterpriseName	String	企業名稱	R

5.JSON請求示例：

請求示例 JSON

{  	"MemberId": "123456"  }

6.JSON返回示例：

返回示例 JSON

{  	                "EBusinessID": "1279441",  	                "Enterprises": [{  		                "EnterpriseName": "測試--電商",  		                "EnterpriseId": "f29f5e83-4061-4098-ba1b-833bc00bc87d"  	                }, {  		                "EnterpriseName": "KDN",  		                "EnterpriseId": "97bdd4ed-ab33-4fd8-9ad4-2412b6c4db19"  	                }, {  		                "EnterpriseName": "測試--物流001",  		                "EnterpriseId": "2495df41-6f51-4092-81fd-b9ced7c3ba20"  	                }, {  		                "EnterpriseName": "測試公司--物流",  		                "EnterpriseId": "b0fb2740-eb88-4196-8674-f7f5b08e414e"  	                }, {  		                "EnterpriseName": "快遞鳥",  		                "EnterpriseId": "1dc26989-f365-4882-a821-6b0b32ee0319"  	                }],  	                "Success": true                     }

三、獲取企業平均分接口規則

1.接口描述/説明

通過此接口可以獲取各個快遞公司的評價平均分。
（1）僅支持Json格式。
（2）請求指令1012。
（3）測試接口地址：//testapi.kdniao.com:8081/api/dist
（4）聯調通過後請更換為正式地址：//api.kdniao.com/api/dist

2.請求系統級參數説明：

參數名稱	類型	説明	必須要求
RequestData	String	請求內容，JSON,須和DataType一致。	R
EBusinessID	String	用户ID。	R
RequestType	String	請求指令類型：1012	R
DataSign	String	數據內容簽名	R
DataType	String	請求、返回數據類型：2-json；	R

3.應用級參數：

參數名稱	類型	説明	必須要求
MemberID	String	沒有不填	O
EnterpriseId	String	企業編碼	R

備註：R-必填（Required），O-可選（Optional），C-報文中該參數在一定條件下可選（Conditional）

4.返回參數定義：

參數名稱		類型	説明	必須要求
EBusinessID		String	電商用户ID	R
Success		Bool	成功與否:true,false	R
Reason		String	失敗原因	O
Score	Double	平均分值	R

5.JSON請求示例：

請求示例 JSON

{  	                    "MemberId": "",  	                    "EnterpriseId": "bb253828-0182-4638-988a-639d27cf7f54"                      }

6.JSON返回示例：

返回示例 JSON

{  	                    "Score": "4.0",  	                    "EBusinessID": "1279441",  	                    "Success": true                      }

接入流程

demo下載

接口接入技術文檔
物流評價接口Demo工具.NET版

物流評價接口Demo工具.NODE.JS版

快遞鳥一次性對接600+物流接口

相關文檔與更多幫助？

解決方案

產品服務

API文檔

幫助與支持

關於我們

聯繫我們