首页 > 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会员IDO
EvaluateTypeInt评价类型(1-物流评价2-物流投诉)R
ExpressNodeInt物流环节(1-揽件 2-派件)R
OrderCodeString订单编号O
LogisticCodeString物流单号R
TargetExpCodeString快递公司编码R
OutletCodeString网点编码O
CourierCodeString快递员编码O
ScoreExpValueDouble快递公司分值C
OutletValueDouble快递网点分值C
CourierValueDouble快递员分值C
EvaluationTagString评价标签O
ContentsString内容C
备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)
4.返回参数定义:
参数名称类型说明必须要求
EBusinessIDString电商用户IDR
SuccessBool成功与否:true,falseR
ReasonString失败原因O
5.JSON请求示例:
请求示例 JSON
{
                    "MemberID":"",
                    "EvaluateType":1,
                    "ExpressNode":1,
                    "OrderCode":"",
                    "LogisticCode":"12345678",
                    "Target":{
                        "ExpCode":"YTO",
                        "OutletCode":"0453",
                        "CourierCode":"2001158001"
                    },
                    "Score":{
                        "ExpValue":5,
                        "OutletValue":4.5,
                        "CourierValue":4
                    },
                    "EvaluationTag":"速度快,服务好",
                    "Content":""
             }
6.JSON返回示例:
返回示例 JSON
{
                "EBusinessID": "1261737",
                "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会员IDO
LogisticsTypeInt获取类型(1-物流公司2-快递网点3-快递员)R
ExpCodeInt快递公司编码O
OrderCodeString网点编码O
备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)
4.返回参数定义:
参数名称类型说明必须要求
EBusinessIDString电商用户IDR
SuccessBool成功与否:true,falseR
ScoresExpCodeString快递公司编码O
ExpValueDouble快递公司分值O
ReasonString失败原因O
5.JSON请求示例:
请求示例 JSON
{
                    "MemberID":"123456",
                    "LogisticsType":1,
                    "ExpCode":"",
                    "OutletCode":""
                }
6.JSON返回示例:
返回示例 JSON
{
                        "EBusinessID": "1261737",
                        "Success": true,
                        "Scores":[
                                {
                                    "ExpCode":"EMS",
                                    "ExpValue":"4.3"
                                },
                                {
                                    "ExpCode":"YTO",
                                    "ExpValue":"4.5"
                                },
                                {
                                    "ExpCode":"SF",
                                    "ExpValue":"4.4"
                                }
                            ]
                        }
接入流程
demo下载

相关文档与更多帮助?

30万+
数十万客户的选择
5.8亿次+
日均处理物流数据次数
1450万+
日均千万订单数据处理
418家+
支持全国418家物流商
在线咨询
商务合作群:
526574204
技术对接群:
620453345
400-9633321
免费获取API