批量修改员工信用分
业务场景
客户方信用体系完善需要依托于他们将异构系统中的信用分写入至每刻系统中
接口说明
- 请求参数中的userName和operatoName只用来确认，实际不进行保存处理
- 传入的List参数中，当有一个数据不符合校验规则后，会返回当前不符合校验规则的dto对象，而不会全部返回,且所有的修改信用分都不会执行
接口地址
/api/openapi/credit/adjust
请求类型
POST
请求参数
参数说明
| 字段名称 |
字段类型 |
字段说明 |
必填 |
| adjustType |
String |
调整类型：
API_ADJUST（增量更新）
API_COVER（覆盖更新） |
是 |
| operatorId |
String |
操作人id |
是 |
| userEmployeeId |
String |
员工工号 |
是 |
| credit |
Number |
调整分数 |
是 |
| operatorName |
String |
操作人（不进行保存） |
否 |
| reason |
String |
调整理由 |
否 |
| userName |
String |
员工姓名（不进行保存） |
否 |
| formCode |
String |
单据号 |
否 |
参数样例
{
"employeeCreditScoreDtoList": [
{
"adjustType": "API_ADJUST",
"reason": "",
"credit": -10,
"operatorName": "测试",
"operatorId": "1234",
"formDataCode": "",
"userEmployeeId":"1234",
"formCode": ""
}
]
}
响应参数
参数说明
| 参数key |
类型 |
说明 |
| code |
String |
是否响应成功; ACK表示请求成功，NACK表示请求失败 |
| message |
String |
异常信息 |
| errorCode |
String |
业务异常code |
| data |
Array |
不符合校验规则的错误数据对象 |
data数组的每一个对象结构说明：
| code |
错误code（每刻内部定位使用，如果有问题可以用这个code反馈） |
| msg |
错误信息（具体错误原因描述） |
| employeeCreditScoreDto |
错误信息原始数据（与入参数据结构相同） |
错误码示例
| 错误码code |
说明 |
| A0320 |
超过单次100条数据（出于接口性能要求，限制最多单词导入100条） |
参数样例
成功响应示例
{
"code": "ACK",
"errorCode": "",
"message": "",
"data": null
}
失败响应示例
{
"code": "NACK",
"message": null,
"data": [
{
"code": "A0402",
"msg": "该员工不存在,请求失败！",
"employeeCreditScoreDto": {
"adjustType": "API_ADJUST",
"userName": null,
"userEmployeeId": "1234",
"reason": "",
"credit": -10,
"operatorName": "测试",
"operatorId": "1234",
"formDataCode": "",
"formCode": ""
}
}
],
"errorCode": null,
"success": false
}
修改记录