首頁 > API文檔 > 物流評價API
物流評價API
申請API
為商家提供評價物流,網點,快遞員的渠道,并批量獲取平均分的功能,平均分值可應用于快遞公司推薦排序,綜合選擇,展示商家實力等場景。商家的評價分值將由快遞鳥匯總計算,統一傳遞到物流公司,指導物流公司提升服務質量。
應用場景
(1)用戶評價體系,新增物流打分評價,查看物流對綜合評價的影響。
(2)電商商家在提供物流公司選擇時,附加綜合評分。
(3)叫快遞類服務平臺,提供推薦快遞排行。
功能說明
使用流程
API參數
一、提交投訴接口規則
1.接口描述/說明
通過此接口可對快遞公司、網點、快遞員進行評價或投訴。
(1)僅支持Json格式。
(2)請求指令1011。
(3)每次請求不超過100條明細。
(4)測試接口地址://testapi.www.bcvon.club: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為投訴時必填,評價時忽略。
針對物流企業有以下可?。?br />11-收件丟失
12-中轉丟失
13-派件丟失
14-未知原因(貨物丟失)
15-不是本人
16-未送貨上門
21-未知原因 (快遞延誤)
22-收件破損
23-派件破損
24-中轉破損
31-未知原因 (貨物破損)
32-未按時上門攬件
33-未按時派送
34-中轉延誤
41-其他
針對電商企業有以下可?。?br />5-商品不實
6-商家虛假交易不發貨
7-服務態度
C
EvaluateValueDoubleEvaluateType為評價時必填,投訴時忽略。C
EvaluateTagStringEvaluateType為評價時必填,投訴時忽略。多個標簽以/隔開,eg:速度快/長得帥。C
ComplaintContentStringEvaluateType為投訴時必填,評價時忽略。C
備注:R-必填(Required),O-可?。∣ptional),C-報文中該參數在一定條件下可?。–onditional)
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.www.bcvon.club: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-可?。∣ptional),C-報文中該參數在一定條件下可?。–onditional)
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.www.bcvon.club: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-可?。∣ptional),C-報文中該參數在一定條件下可?。–onditional)
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萬+
日均千萬訂單數據處理
418家+
支持全國418家物流商
在線咨詢
商務合作群:
783245476
技術對接群14:
665031725
火箭vs鹈鹕
400-9633321
免費獲取API
广西十一选五走势图百度 七星彩走势图查询 腾游棋牌游戏平台 赚钱给自己花的句子 南京有中彩票大奖的吗 投资银行如何赚钱 双色球什么时候开奖直播 北京十一选五开奖彩票控 卖电动车能不能赚钱 四川金7乐走势图012路 918棋牌游戏大厅 消防工程师能赚钱马 福建十一选五彩票群 股票配资哪个平台靠谱 和值分布图 100元可提现的棋牌游戏