添加员工分组信息
接口说明: 用于给员工添加一条分组信息记录。支持固定分组和自定义分组目前合同分组记录不支持通过该接口添加电子同记录
接口的调用步骤为先调用员工分组信息字段接口，查询员工有那些分组字段。然后再调用此接口去添加分组记录。路程图如下:
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/employee/group/add2
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
| employeeId | String | Y | 员工ID |
| groupId | String | Y | 分组ID |
| employeeFields | Map<String,String> | Y | 分组信息记录注意字段是否必填项，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 | EmployeeGroupAddResponse | Y | 返回值 |
EmployeeGroupAddResponse
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| date | String | Y | 添加的当前分组记录ID |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/group/add2?sign=cwyzXRxvXDiGetbidkMvHYJ7TVI%3D
请求Body示例:
//添加教育经历
{
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"groupId": "aade162f7fa542898fb27859c278a41e",
"employeeFields": {
"毕业证书": "5AH39QjEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==",//对应为文件key
"毕业时间": "2020-09-29",
"教学方式": "2",
"毕业院校": "北京大学",
"学位证书": "5AH3eH+kYolQBx8rEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==",//对应的文件key
"是否最高学历": "1",
"专业": "计算机科学与技术"
},
"timestamp": 1606203448208
}
//添加兼职信息
{
"employeeId":"d22e30ed49024f788049e1893ed871a4",
"groupType":"fc0a119b7d66419a89ccf9dcd669e774",
"employeeFields":{
"兼职岗位":"886f867fdd8f4fd1b52120213dcd9276",//岗位id
"兼职职级":"3cfd59661b0642659f12eb8c75ad0f18",//职级id
"兼职部门":"66cb5a71fbd24afb831b1ed14ed0a36b"//部门id
},
"timestamp":1626225201347
}
SDK请求示例(java):
//添加工作经历
EmployeeGroupAddV2Request request = new EmployeeGroupAddV2Request(access_token());
request.setEmployeeId("a42c11aed7b645a2be77cd0a54cc33da");
request.setGroupId("66fa29cd414b4aca97f437e55e3ab565");
Map<String, String> map = new HashMap<>();
map.put("曾受雇公司", "测试公司");
map.put("曾任职位", "java开发");
map.put("受雇开始时间", "2021-07-01");
map.put("有无竞业禁止", "0");
map.put("上家公司辞职原因", "测试");
request.setEmployeeFields(map);
OpenapiResponse<EmployeeGroupAddResponse> employeeGroupAdd = XrxsEmployeeService.employeeGroupV2Add(request);
//添加兼职信息
EmployeeGroupAddV2Request request = new EmployeeGroupAddV2Request(access_token());
request.setEmployeeId("d22e30ed49024f788049e1893ed871a4");
request.setGroupId("fc0a119b7d66419a89ccf9dcd669e774");
Map<String, String> map = new HashMap<>();
map.put("兼职部门", "66cb5a71fbd24afb831b1ed14ed0a36b");
map.put("兼职岗位", "886f867fdd8f4fd1b52120213dcd9276");
map.put("兼职职级", "");
request.setEmployeeFields(map);
OpenapiResponse<EmployeeGroupAddResponse> response = XrxsEmployeeService.employeeGroupV2Add(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"data": "ab9b0bf7778d418c9b04f5a478a34aae"
}
}