首页 > API文档 > 物流评价API
物流评价API
申请API
为商家提供评价物流,网点,快递员的渠道,并批量获取平均分的功能,平均分值可应用于快递公司推荐排序,综合选择,展示商家实力等场景。商家的评价分值将由快递鸟汇总计算,统一传递到物流公司,指导物流公司提升服务质量。
应用场景
(1)用户评价体系,新增物流打分评价,查看物流对综合评价的影响。
(2)电商商家在提供物流公司选择时,附加综合评分。
(3)叫快递类服务平台,提供推荐快递排行。
功能说明
使用流程
API参数
一、提交投诉接口规则
1.接口描述/说明
通过此接口可对快递公司、网点、快递员进行评价或投诉。
(1)仅支持Json格式。
(2)请求指令1011。
(3)每次请求不超过100条明细。
(4)测试接口地址:http://testapi.kdniao.cc:8081/api/dist
(5)联调通过后请更换为正式地址:http://api.kdniao.cc/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)测试接口地址:http://testapi.kdniao.cc:8081/api/dist
(4)联调通过后请更换为正式地址:http://api.kdniao.cc/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)测试接口地址:http://testapi.kdniao.cc:8081/api/dist
(4)联调通过后请更换为正式地址:http://api.kdniao.cc/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万+
日均千万订单数据处理
418家+
支持全国418家物流商
在线咨询
商务合作群:
526574204
技术对接群:
620453345
400-9633321
免费获取API