员工分组信息更新

接口说明: 用于更新一条分组信息记录,根据员工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类型,Map的key需要更新字段页面展示文案(分组字段中的labelName),Map的Value更新字段设置的新值(选项类型值为dataSoure的Key)

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
}
2024 © 企家有道网络技术(北京)有限公司版权所有@京ICP备15035315号 all right reserved,powered by Gitbookupdate by: 2024-01-15 15:26:15

results matching ""

    No results matching ""