员工固定分组信息批量查询
接口说明: 批量查询多个员工的分组信息。包含当前分组信息是否能编辑等信息；有些分组信息是不允许编辑更新的，例如:电子合同信息。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/employee/group/list
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeIds | Lits<String> | Y | 员工id列表，员工id个数限制在1～100之间 |
| employeeStatus | Integer | N | 员工状态，默认为0。0:在职员工、1:离职员工、2:待入职、8:删除 |
| groupType | String | Y | 分组类型，1-合同记录,5-兼职信息,7-教育经历,8-工作经历,9-培训经历,10-证书记录,11-联系人记录 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| data | List<EmployeeGroupFieldData> | N | 操作成功时返回,分组字段信息列表 |
EmployeeGroupFieldData
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工ID |
| firstRecordId | String | Y | 首次记录ID（合同分组信息特有） |
| mainRecordId | String | Y | 主记录ID（合同分组信息特有） |
| recordDataList | List<EmployeeGroupFieldDetail> | Y | 分组记录信息列表 |
EmployeeGroupFieldDetail
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| recordId | String | Y | 记录ID |
| editAble | Boolean | Y | true-可更新，false-不可更新 |
| fields | List<EmployeeGroupRecordField> | Y | 分组记录字段信息 |
EmployeeGroupRecordField
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| fieldId | String | Y | 字段ID 如:字段uuid |
| fieldIdName | String | Y | 字段ID对应页面展示文案 如:新/续签 |
| fieldValue | String | N | 字段值 如:0 |
| fieldValueName | String | N | 字段值对应页面展示文案 如:新签 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/group/list?sign=7omyqoNIY5QPWKCyQM3Q7Hk8mNQ=
请求Body示例:
{
"employeeIds": [
"3cfd59661b0642659f12eb8c75ad0f18"
],
"groupType": 7,
"timestamp": 1606206243566
}
SDK请求示例(java):
EmployeeGroupListRequest request = new EmployeeGroupListRequest(access_token);
List<String> employeeIds = = new ArrayList<>();
employeeIds.add("3cfd59661b0642659f12eb8c75ad0f18");
request.setEmployeeIds(employeeIds);
request.setGroupType(EmpGroupEnum.EDU_EXPERIENCE);
OpenapiResponse<List<EmployeeGroupFieldData>> list = XrxsEmployeeService.employeeGroupList(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": [
{
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"firstRecordId": null,
"mainRecordId": null,
"recordDataList": [
{
"recordId": "ab9b0bf7778d418c9b04f5a478a34aae",
"editAble": true,
"fields": [
{
"fieldId": "990c1757233d11ebb1810242c0a8100a",
"fieldIdName": "毕业证书",
"fieldValue": "5AH39QjEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==",
"fieldValueName": "毕业证书"
},
{
"fieldId": "990c2fcf233d11ebb1810242c0a8100a",
"fieldIdName": "学位证书",
"fieldValue": "5AH3eH+kYolQBx8rEoMU1nVO5PutoK5/q7hTTva7J1IOOARg==",
"fieldValueName": "学位证书"
},
{
"fieldId": "990b7f7f233d11ebb1810242c0a8100a",
"fieldIdName": "毕业院校",
"fieldValue": "北京大学",
"fieldValueName": "毕业院校"
},
{
"fieldId": "990b9752233d11ebb1810242c0a8100a",
"fieldIdName": "专业",
"fieldValue": "计算机科学与技术",
"fieldValueName": "专业"
},
{
"fieldId": "990bb073233d11ebb1810242c0a8100a",
"fieldIdName": "学历",
"fieldValue": "0",
"fieldValueName": "请选择"
},
{
"fieldId": "990bc9a0233d11ebb1810242c0a8100a",
"fieldIdName": "教学方式",
"fieldValue": "2",
"fieldValueName": "自考"
},
{
"fieldId": "990c48cc233d11ebb1810242c0a8100a",
"fieldIdName": "是否最高学历",
"fieldValue": "1",
"fieldValueName": "是"
},
{
"fieldId": "990b6664233d11ebb1810242c0a8100a",
"fieldIdName": "教育序号",
"fieldValue": "20201124000001",
"fieldValueName": "教育序号"
},
{
"fieldId": "990be262233d11ebb1810242c0a8100a",
"fieldIdName": "入学时间",
"fieldValue": null,
"fieldValueName": null
},
{
"fieldId": "990bfcf8233d11ebb1810242c0a8100a",
"fieldIdName": "毕业时间",
"fieldValue": "2020-09-29",
"fieldValueName": "毕业时间"
},
{
"fieldId": "990c6407233d11ebb1810242c0a8100a",
"fieldIdName": "第一学历",
"fieldValue": "0",
"fieldValueName": "否"
}
]
}
]
}
]
}