获取员工分组的字段值
接口说明: 查询员工分组的所有字段数据，包括自定义字段和固定字段。包含当前分组信息是否能编辑等信息；有些分组信息是不允许编辑更新的，例如:电子合同信息。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/employee/group/employee/fields2
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeIds | Lits<String> | Y | 员工id列表，员工id个数限制在1～100之间 |
| groupId | String | Y | 分组id |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
| status | Integer | N | 员工状态，默认为0。0:在职员工、1:离职员工、2:待入职、8:删除 |
| hasDel | Integer | N | 是否包含删除状态的分组字段记录，0否1是，默认为0 |
返回结果:
| 参数 | 类型 | 必传(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/employee/fields?sign=7omyqoNIY5QPWKCyQM3Q7Hk8mNQ=
请求Body示例:
{
"employeeIds": [
"a42c11aed7b645a2be77cd0a54cc33da"
],
"groupId": "66fa29cd414b4aca97f437e55e3ab565",
"timestamp": 1606206243566
}
SDK请求示例(java):
EmployeeFieldInfoRequest request = new EmployeeFieldInfoRequest(access_token());
request.setEmployeeIds(Arrays.asList("a42c11aed7b645a2be77cd0a54cc33da"));
request.setGroupId("66fa29cd414b4aca97f437e55e3ab565");
OpenapiResponse<List<EmployeeGroupFieldData>> list = XrxsEmployeeService.getEmployeeFieldInfo(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":[
{
"employeeId":"a42c11aed7b645a2be77cd0a54cc33da",
"firstRecordId":null,
"mainRecordId":null,
"recordDataList":[
{
"recordId":"131e9cba30994a8ab91f3a2ef0107519",
"editAble":true,
"fields":[
{
"fieldId":"6ee57253f8f84a008d132c6d24ffacb0",
"fieldIdName":"上家公司辞职原因",
"fieldValue":"测试002",
"fieldValueName":"测试002"
},
{
"fieldId":"d2882a1bdd4211eb99930242c0a81003",
"fieldIdName":"受雇开始时间",
"fieldValue":"2018-07-01",
"fieldValueName":"2018-07-01"
},
{
"fieldId":"d2888774dd4211eb99930242c0a81003",
"fieldIdName":"更换工作原因",
"fieldValue":"测试003",
"fieldValueName":"测试003"
},
{
"fieldId":"d288b6c6dd4211eb99930242c0a81003",
"fieldIdName":"有无竞业禁止",
"fieldValue":"0",
"fieldValueName":"否"
},
{
"fieldId":"d288e473dd4211eb99930242c0a81003",
"fieldIdName":"证明人",
"fieldValue":null,
"fieldValueName":null
},
{
"fieldId":"3c47fc2d5044450ebc9b6482503fa274",
"fieldIdName":"最后工作城市",
"fieldValue":"287",
"fieldValueName":"287"
},
{
"fieldId":"d288576ddd4211eb99930242c0a81003",
"fieldIdName":"受雇结束时间",
"fieldValue":"2021-06-01",
"fieldValueName":"2021-06-01"
},
{
"fieldId":"d287cf8bdd4211eb99930242c0a81003",
"fieldIdName":"曾受雇公司",
"fieldValue":"测试公司",
"fieldValueName":"测试公司"
},
{
"fieldId":"d28942bbdd4211eb99930242c0a81003",
"fieldIdName":"是否最后受雇",
"fieldValue":"1",
"fieldValueName":"是"
},
{
"fieldId":"d287ff47dd4211eb99930242c0a81003",
"fieldIdName":"曾任职位",
"fieldValue":"java开发工程师",
"fieldValueName":"java开发工程师"
},
{
"fieldId":"d28914f3dd4211eb99930242c0a81003",
"fieldIdName":"证明人联系电话",
"fieldValue":null,
"fieldValueName":null
},
{
"fieldId":"d2896f92dd4211eb99930242c0a81003",
"fieldIdName":"工作备注",
"fieldValue":"测试001",
"fieldValueName":"测试001"
}
]
}
]
}
]
}