绩效完成值录入
接口说明:支持企业系统推送完成值数据至薪人薪事系统
使用说明:
1、企业系统需接收薪人薪事系统推送的消息（绩效完成值录入消息），获取需要录入的字段；
2、企业系统接收消息后，再调用完成值录入接口，同步字段值。
请求方式: POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/apprisal/kpi/complete/value
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 参数类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
| planId | String | Y | 方案id |
| assesseeEmpId | String | Y | 被考核人员工id |
| targetDetailList | List<KpiApiTargetDetailModel> | Y | 指标详情 |
KpiApiTargetDetailModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| targetGroupId | String | Y | 指标的维度ID |
| targetId | String | Y | 指标ID |
| entryFieldList | List<KpiApiTargetEntryFieldModel> | Y | 指标需要录入字段列表 |
KpiApiTargetEntryFieldModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| fieldId | String | Y | 字段id |
| fieldValue | String | Y | 字段值 |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/apprisal/kpi/complete/value?sign=26dAzTk%2BzeMz%2Bx45d8SRniM1PTk%3D
请求Body示例:
{
"timestamp": 1606183503814,
"planId":"28b9434ceab0478b959c964e3e8a1063",
"assesseeEmpId": "a42c11aed7b645a2be77cd0a54cc33da",
"targetDetailList": [
{
"targetGroupId": "40c91b0cb3a9472c8a66cc6fabaf5278",
"targetId": "715091c5d09d40558b95812f3281dd12",
"entryFieldList": [
{
"fieldId": "900c6cc799df4ba5ab88f6eb9621be58",
"fieldValue": "100"
}
]
},
{
"targetGroupId": "40c91b0cb3a9472c8a66cc6fabaf5278",
"targetId": "f56088a8a1f345419c7ea429ca9fd08e",
"entryFieldList": [
{
"fieldId": "900c6cc799df4ba5ab88f6eb9621be58",
"fieldValue": "5"
}
]
}
]
}
SDK请求示例(java):
ApprisalKpiAccessCompleteValueRequest request = new ApprisalKpiAccessCompleteValueRequest(access_token());
request.setPlanId("28b9434ceab0478b959c964e3e8a1063");
request.setAssesseeEmpId("a42c11aed7b645a2be77cd0a54cc33da");
//填入指标详情
List<ApprisalKpiTargetDetailModel> targetDetailList = new ArrayList<>();
//指标1
ApprisalKpiTargetDetailModel targetDetailModel1 = new ApprisalKpiTargetDetailModel();
targetDetailModel1.setTargetId("715091c5d09d40558b95812f3281dd12");
targetDetailModel1.setTargetGroupId("40c91b0cb3a9472c8a66cc6fabaf5278");
//填入指标的字段
List<ApprisalKpiTargetEntryFieldModel> entryFieldList1 = new ArrayList<>();
ApprisalKpiTargetEntryFieldModel fieldModel1 = new ApprisalKpiTargetEntryFieldModel();
fieldModel1.setFieldId("900c6cc799df4ba5ab88f6eb9621be58");
fieldModel1.setFieldValue("100");
entryFieldList1.add(fieldModel1);
targetDetailModel1.setEntryFieldList(entryFieldList1);
targetDetailList.add(targetDetailModel1);
//指标2
ApprisalKpiTargetDetailModel targetDetailModel2 = new ApprisalKpiTargetDetailModel();
targetDetailModel2.setTargetId("f56088a8a1f345419c7ea429ca9fd08e");
targetDetailModel2.setTargetGroupId("40c91b0cb3a9472c8a66cc6fabaf5278");
//填入指标的字段
List<ApprisalKpiTargetEntryFieldModel> entryFieldList2 = new ArrayList<>();
ApprisalKpiTargetEntryFieldModel fieldModel2 = new ApprisalKpiTargetEntryFieldModel();
fieldModel2.setFieldId("900c6cc799df4ba5ab88f6eb9621be58");
fieldModel2.setFieldValue("5");
entryFieldList2.add(fieldModel2);
targetDetailModel2.setEntryFieldList(entryFieldList2);
targetDetailList.add(targetDetailModel2);
request.setTargetDetailList(targetDetailList);
XrxsApprisalService.handAccessCompleteValue(request);
响应实例:
{
"errcode": 0,
"errmsg": "成功"
}