物流投诉评价接口.docxVIP

物流投诉评价接口

物流投诉功能说明

通过此接口将评价或投诉信息发送给物流公司，将物流部分问题直接交付物流公司处理，前期由平台统一收集处理。可针对揽收或派送两个物流环节进行评价，仅产生物流单号（即服务生效）的订单才可进行评价。

1.1.2业务流程图-物流评价

1.1.2业务流程图-物流投诉

（共用一个接口）

接口规则

(1)、仅支持Json格式。

(2)、请求指令8101。

(3)、每次请求不超过100条明细。

(4)、测试接口地址：http://testapi.kdniao.cc:8081/api/dist

(5)、联调通过后请更换为正式地址：http://api.kdniao.cc/api/dist

系统级参数

系统级输入参数

类型

必须要求

说明

RequestData

String

R

请求内容，JSON,须和DataType一致

EBusinessID

String

R

用户ID

RequestType

String

R

请求指令类型：--

DataSign

String

R

数据内容签名

DataType

类型

R

请求、返回数据类型：2-json；

应用级参数

应用级输入参数

类型

必须要求

说明

MemberID

String

O

电商平台会员ID或ERP商家ID等

订单编号

String

O

选填

物流单号

String

R

物流单号

类型

Int

R

物流评价

物流投诉

环节

Int

R

1-揽件

2-派件

评价目标

快递公司编码

string

R

快递公司编码

网点编码

O

网点编码

快递员编码

O

快递员编码

分值

快递公司分值

Double

C

类型为1时必填，Json,当类型为1时必填，1-5,允许小数点后一位小数如4.5,用于对应【评价项目】分值

快递网点分值

快递员分值

评价标签

String

O

定义标签：服务好，速度慢，态度差+自定义标签，允许同时选择多个标签。

投诉类型

Int

O

定义类型：服务态度，速度慢，态度差+自定义标签，允许同时选择多个标签。

内容

String

C

类型为2时必填,2-200字。

返回结果参数

参数名称

类型

必须要求

说明

EBusinessID

String

R

电商用户ID

Success

Bool

R

成功与否:true,false

Reason

String

O

失败原因

业务规则：

1.无MemberID时，同一用户ID,相同单号最多允许评论2次，投诉1次。

有MemberID时，同一用户ID下的相同memberID最多允许评论两次，投诉1次。

2.根据揽件/派件轨迹记录网点和快递员信息，如接口传入此信息以接口传递信息为准。

3.需记录快递公司，快递员评价平均分，以及投诉次数，作为推荐物流的参考因素。

指定订单状态可评论，（考虑可能多种开放式评价应用场景，本期暂时不做）

仅自己订单可评论（由用户端限制）

错误码

规则

报错提示

缺少关键字段

必填字段不能为空

未输入评价或投诉内容

内容需为2个字符以上

评价或投诉内容超长

内容不能超过200字符

超过评价或投诉次数

该用户物流单已超过最大评论次数

其他

其他错误

物流平均分获取接口

系统级参数

系统级输入参数

类型

必须要求

说明

RequestData

String

R

请求内容，JSON,须和DataType一致

EBusinessID

String

R

用户ID

RequestType

String

R

请求指令类型：--

DataSign

String

R

数据内容签名

DataType

类型

R

请求、返回数据类型：2-json；

应用级参数

应用级输入参数

类型

必须要求

说明

MemberID

String

O

电商平台会员ID或ERP商家ID等

获取类型

Int

R

1.物流公司2.快递网点3.快递员

快递公司编码

string

C

类型为2和3时必填，返回全部网点平评分

网点编码

String

C

类型为3时必填，返回网点对应全部快递员评分

返回结果参数

参数名称

类型

必须要求

说明

EBusinessID

String

R

电商用户ID

Success

Bool

R

成功与否:true,false

Reason

String

O

失败原因

分值

Double

R

返回获取类型字段所包含的全部分值，例如，获取类型为1，返回全部快递公司评价分值。

业务规则：

请求分值返回项为全部结果，用户使用需自行根据返回结果匹配。

快递公司分值：配置快递鸟已支持主流22家快递公司分值，默认为0。未在此范围内，有评价产生时自动记录，默认分值为0。

网点及快递员分值：评价时自动产生记录，默认分值为0.

其中，网点分值和快递员分值的计算，需在对应请求的物流公司下搜索，如无