员工分组信息添加
接口说明: 用于给员工添加一条分组信息记录。目前合同分组记录不支持通过该接口添加电子同记录
接口的调用步骤为先调用员工分组信息字段接口,查询员工有那些分组字段。然后再调用此接口去添加分组记录。路程图如下:
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/employee/group/add
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
employeeId | String | Y | 员工ID |
groupType | String | Y | 分组类型,1-合同记录,5-兼职信息,7-教育经历,8-工作经历,9-培训经历,10-证书记录,11-联系人记录 |
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/add?sign=cwyzXRxvXDiGetbidkMvHYJ7TVI%3D
请求Body示例:
//添加教育经历
{
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"groupType": 7,
"employeeFields": {
"毕业证书": "5AH39QjEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==",//对应为文件key
"毕业时间": "2020-09-29",
"教学方式": "2",
"毕业院校": "北京大学",
"学位证书": "5AH3eH+kYolQBx8rEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==",//对应的文件key
"是否最高学历": "1",
"专业": "计算机科学与技术"
},
"timestamp": 1606203448208
}
//添加兼职信息
{
"employeeId":"d22e30ed49024f788049e1893ed871a4",
"groupType":5,
"employeeFields":{
"兼职岗位":"886f867fdd8f4fd1b52120213dcd9276",//岗位id
"兼职职级":"3cfd59661b0642659f12eb8c75ad0f18",//职级id
"兼职部门":"66cb5a71fbd24afb831b1ed14ed0a36b"//部门id
},
"timestamp":1626225201347
}
SDK请求示例(java):
//添加教育经历
EmployeeGroupAddRequest request = new EmployeeGroupAddRequest(access_token());
request.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18");
request.setGroupType(EmpGroupEnum.EDU_EXPERIENCE);
Map<String, String> map = new HashMap<>();
map.put("毕业证书", "5AH39QjEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==");
map.put("毕业时间", "2020-09-29");
map.put("教学方式", "2");
map.put("毕业院校", "北京大学");
map.put("学位证书", "5AH3eH+kYolQBx8rEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==");
map.put("是否最高学历", "1");
map.put("专业", "计算机科学与技术");
request.setEmployeeFields(map);
OpenapiResponse<EmployeeGroupAddResponse> response = XrxsEmployeeService.employeeGroupAdd(request);
//添加兼职信息
EmployeeGroupAddRequest request = new EmployeeGroupAddRequest(access_token());
request.setEmployeeId("d22e30ed49024f788049e1893ed871a4");
request.setGroupType(EmpGroupEnum.PART_TIME_INFO);
Map<String, String> map = new HashMap<>();
map.put("兼职部门", "66cb5a71fbd24afb831b1ed14ed0a36b");
map.put("兼职岗位", "886f867fdd8f4fd1b52120213dcd9276");
map.put("兼职职级", "");
request.setEmployeeFields(map);
OpenapiResponse<EmployeeGroupAddResponse> response = XrxsEmployeeService.employeeGroupAdd(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"data": "ab9b0bf7778d418c9b04f5a478a34aae"
}
}