员工分组信息更新
接口说明: 用于更新一条分组信息记录,根据员工ID及记录信息ID和分组字段类型更新员工的一条分组记录信息;不同类型的分组信息处理逻辑也不同,如合同类型,合同类型有多种,不通的合同类型处理逻辑有所不同。
- 非合同类型:设置需要更新的字段及需要更新的值,进行更新
- 合同类型:无固定期限劳动合同、以完成一定任务为期限
- 这两类合同是不需要合同结束日期、合同期限的
- 其他合同类型更新为这两种合同类型时,合同结束日期、合同期限会被清空
- 这两种合同类型更新为其他合同类型时,合同结束日期、合同期限必传
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/employee/group/update
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
employeeId | String | Y | 员工ID |
recordId | String | Y | 更新分组信息记录ID |
groupType | String | Y | 分组类型,1-合同记录,5-兼职信息,7-教育经历,8-工作经历,9-培训经历,10-证书记录,11-联系人记录 |
employeeFields | Map<String,String> | Y | 更新分组信息记录 Map<String, String>,Map的key需要更新字段页面展示文案(分组字段中的labelName),Map的Value更新字段设置的新值(选项类型值为dataSoure的Key) |
特殊说明:
1、修改分组信息时候employeeFields 为Map
2、图片字段修改时候采用加密Key方式修改,图片的加密Key获取方式 参考员工文件上传及下载接口
3、修改兼职信息的时候:兼职岗位对应的值是岗位id,兼职部门对应的是部门id,兼职职级对应的职级id
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
data | Object | N | 响应结果 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/group/update?sign=BqCoQtiHaDxnYhfeDi87%2BiR7CXc%3D
请求Body示例:
//更新教育经历
{
"recordId": "ab9b0bf7778d418c9b04f5a478a34aae",
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"groupType": 7,
"employeeFields": {
"毕业证书": "5AH39QjEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==",//对应的文件key
"毕业时间": "2019-09-29",
"教学方式": "2",
"毕业院校": "清华大学",
"学位证书": "5AH3eH+kYolQBx8rEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==",//对应的文件key
"是否最高学历": "1",
"专业": "软件工程"
},
"timestamp": 1606207670729
}
//更新兼职信息
{
"recordId":"b59812ad6cde493d9b62ff6f366d7562",
"employeeId":"d22e30ed49024f788049e1893ed871a4",
"groupType":7,
"employeeFields":{
"兼职岗位":"da9eb5053fb642fbb0eb4f266882e0bc", //岗位id
"兼职职级":"3cfd59661b0642659f12eb8c75ad0f18", //职级id
"兼职部门":"66cb5a71fbd24afb831b1ed14ed0a36b" //部门id
},
"timestamp":1626225494697
}
SDK请求示例(java):
//更新教育经历
EmployeeGroupUpdateRequest request = new EmployeeGroupUpdateRequest(access_token);
request.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18");
request.setRecordId("ab9b0bf7778d418c9b04f5a478a34aae");
request.setGroupType(EmpGroupEnum.EDU_EXPERIENCE);
Map<String, String> map = new HashMap<>();
map.put("毕业证书", "5AH39QjEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==");//文件的key
map.put("毕业时间", "2019-09-29");
map.put("教学方式", "2");
map.put("毕业院校", "清华大学");
map.put("学位证书", "5AH3eH+kYolQBx8rEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==");//文件的key
map.put("是否最高学历", "1");
map.put("专业", "软件工程");
request.setEmployeeFields(map);
OpenapiResponse<Void> response = XrxsEmployeeService.employeeGroupUpdate(request);
//更新兼职信息
EmployeeGroupUpdateRequest request = new EmployeeGroupUpdateRequest(access_token());
request.setEmployeeId("d22e30ed49024f788049e1893ed871a4");
request.setRecordId("b59812ad6cde493d9b62ff6f366d7562");
request.setGroupType(EmpGroupEnum.PART_TIME_INFO);
Map<String, String> map = new HashMap<>();
map.put("兼职部门", "66cb5a71fbd24afb831b1ed14ed0a36b");
map.put("兼职岗位", "da9eb5053fb642fbb0eb4f266882e0bc");
map.put("兼职职级", "3cfd59661b0642659f12eb8c75ad0f18");
request.setEmployeeFields(map);
OpenapiResponse<EmployeeGroupUpdateRequest> response = XrxsEmployeeService.employeeGroupUpdate(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": null
}