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

首頁 > API文檔 > 物流評價API
物流評價API
申請API
為商家提供評價物流,網點,快遞員的渠道,並批量獲取平均分的功能,平均分值可應用於快遞公司推薦排序,綜合選擇,展示商家實力等場景。商家的評價分值將由快遞鳥彙總計算,統一傳遞到物流公司,指導物流公司提升服務質量。
應用場景
(1)用户評價體系,新增物流打分評價,查看物流對綜合評價的影響。
(2)電商商家在提供物流公司選擇時,附加綜合評分。
(3)叫快遞類服務平台,提供推薦快遞排行。
功能説明
使用流程
API參數
一、提交投訴接口規則
1.接口描述/説明
通過此接口可對快遞公司、網點、快遞員進行評價或投訴。
(1)僅支持Json格式。
(2)請求指令1011。
(3)每次請求不超過100條明細。
(4)測試接口地址://testapi.kdniao.com:8081/api/dist
(5)聯調通過後請更換為正式地址://api.kdniao.com/api/dist
2.請求系統級參數説明:
參數名稱類型説明必須要求
RequestDataString請求內容需進行URL(utf-8)編碼。請求內容JSON格式,須和DataType一致。R
EBusinessIDString用户ID。R
RequestTypeString請求指令類型:1011R
DataSignString數據內容簽名R
DataTypeString請求、返回數據類型:2-json;O
3.應用級參數:
參數名稱類型説明必須要求
MemberIDString沒有不填O
EnterpriseldString被投訴企業的ID,來源於獲取投訴企業列表APIR
MobileString投訴人手機號R
NameString投訴人姓名R
OrderCodeString訂單號,與物流單號至少一個C
LogisticCodeString物流單號,與訂單號至少一個C
EvaluateTypeInt評價類型(1-物流評價2-物流投訴)R
TargetMerchantTypeString(1-商品2-電商平台3-商家店鋪4-快遞員-5快遞網點6-快遞公司)R
MerchantName物流或投訴對象的名稱R
MerchantPhone評價或投訴對象的電話,當對象為快遞員時必填,其他對象時忽略。C
MerchantLink評價或投訴對象的鏈接,當對象為電商平台和商家店鋪時必填,其他對象忽略。C
MerchantAddress評價或投訴對象的地址,當對象為快遞網點時必填,其他對象忽略。C
MerchantPictureBase64Base64的圖片格式,當對象商品和商家店鋪時必填,其他對象忽略。C
ComplaintTypeIntEvaluateType為投訴時必填,評價時忽略。
針對物流企業有以下可選:
11-收件丟失
12-中轉丟失
13-派件丟失
14-未知原因(貨物丟失)
15-不是本人
16-未送貨上門
21-未知原因 (快遞延誤)
22-收件破損
23-派件破損
24-中轉破損
31-未知原因 (貨物破損)
32-未按時上門攬件
33-未按時派送
34-中轉延誤
41-其他
針對電商企業有以下可選:
5-商品不實
6-商家虛假交易不發貨
7-服務態度
C
EvaluateValueDoubleEvaluateType為評價時必填,投訴時忽略。C
EvaluateTagStringEvaluateType為評價時必填,投訴時忽略。多個標籤以/隔開,eg:速度快/長得帥。C
ComplaintContentStringEvaluateType為投訴時必填,評價時忽略。C
備註:R-必填(Required),O-可選(Optional),C-報文中該參數在一定條件下可選(Conditional)
4.返回參數定義:
參數名稱類型説明必須要求
EBusinessIDString電商用户IDR
SuccessBool成功與否:true,falseR
ReasonString失敗原因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.請求系統級參數説明:
參數名稱類型説明必須要求
RequestDataString請求內容,JSON,須和DataType一致。R
EBusinessIDString用户ID。R
RequestTypeString請求指令類型:1013R
DataSignString數據內容簽名R
DataTypeString請求、返回數據類型:2-json;R
3.應用級參數:
參數名稱類型説明必須要求
MemberIDString沒有不填O
備註:R-必填(Required),O-可選(Optional),C-報文中該參數在一定條件下可選(Conditional)
4.返回參數定義:
參數名稱類型説明必須要求
EBusinessIDString電商用户IDR
SuccessBool成功與否:true,falseR
ReasonString失敗原因R
EnterprisesEnterpriseIdString企業編碼R
EnterpriseNameString企業名稱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.請求系統級參數説明:
參數名稱類型説明必須要求
RequestDataString請求內容,JSON,須和DataType一致。R
EBusinessIDString用户ID。R
RequestTypeString請求指令類型:1012R
DataSignString數據內容簽名R
DataTypeString請求、返回數據類型:2-json;R
3.應用級參數:
參數名稱類型説明必須要求
MemberIDString沒有不填O
EnterpriseIdString企業編碼R
備註:R-必填(Required),O-可選(Optional),C-報文中該參數在一定條件下可選(Conditional)
4.返回參數定義:
參數名稱類型説明必須要求
EBusinessIDString電商用户IDR
SuccessBool成功與否:true,falseR
ReasonString失敗原因O
ScoreDouble平均分值R
5.JSON請求示例:
請求示例 JSON
{  	                    "MemberId": "",  	                    "EnterpriseId": "bb253828-0182-4638-988a-639d27cf7f54"                      }
6.JSON返回示例:
返回示例 JSON
{  	                    "Score": "4.0",  	                    "EBusinessID": "1279441",  	                    "Success": true                      }
接入流程
demo下載

相關文檔與更多幫助?

30萬+
數十萬客户的選擇
5.8億次+
日均處理物流數據次數
1450萬+
日均千萬訂單數據處理
600家+
支持全國600+家物流商
在線諮詢
商務合作羣:
1054978381
技術對接羣11:
844089794
400-9633-321
免費獲取API