| 程序包 | 说明 |
|---|---|
| com.lark.oapi.service.corehr.v2.model |
| 限定符和类型 | 方法和说明 |
|---|---|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.additionalNationalIdNumberList(String[] additionalNationalIdNumberList)
其他国籍ID列表，精准匹配查询
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.archiveCpstPlanIdList(String[] archiveCpstPlanIdList)
员工当前所属薪资方案 ID 列表;- 可通过[【批量查询薪资方案】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)获取;- 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.assignmentPayGroupIdList(String[] assignmentPayGroupIdList)
员工所属外派薪资组 ID 列表;- 可通过 [【获取薪资组基本信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取;- 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.citizenshipStatusList(String[] citizenshipStatusList)
公民身份类型列表，精确匹配查询
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.contractTypeList(String[] contractTypeList)
员工当前合同类型列表;- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)查询; - object_api_name：contract; - custom_api_name：contract_type;- 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.costCenterIdList(String[] costCenterIdList)
成本中心 ID 列表;- 可通过 [【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search) 获取
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.departmentIdList(String[] departmentIdList)
部门 ID，根据员工主职的直接部门查询，可以通过【查询部门】API 获取 部门 ID
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.departmentIdListIncludeSub(String[] departmentIdListIncludeSub)
部门 ID 列表，查询属于该部门及下级部门的员工
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.directManagerIdList(String[] directManagerIdList)
直接上级的雇佣 ID，根据员工主职的直接上级查询
示例值：7027024823985447820
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.dottedLineManagerIdList(String[] dottedLineManagerIdList)
虚线上级的雇佣 ID，根据员工主职的虚线上级查询
示例值：7027024823985117820
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.effectiveTimeEnd(String effectiveTimeEnd)
入职日期-搜索范围结束
示例值：2020-01-01
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.effectiveTimeStart(String effectiveTimeStart)
入职日期-搜索范围开始，需要与搜索范围结束一同使用
示例值：2020-01-01
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.emailAddressList(String[] emailAddressList)
工作邮箱地址列表，精确匹配查询
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.employeeNumberList(String[] employeeNumberList)
工号列表
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.employeeTypeId(String employeeTypeId)
人员类型 ID
示例值：6971090097697521314
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.employmentIdList(String[] employmentIdList)
雇佣 ID 列表
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.employmentStatus(SearchEmployeeEmploymentStatusEnum employmentStatus)
雇佣状态
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.employmentStatus(String employmentStatus)
雇佣状态
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.fields(String[] fields)
返回数据的字段列表，填写方式：为空时默认仅返回 ID
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.jobFamilyIdList(String[] jobFamilyIdList)
序列 ID 列表; - [【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.jobFamilyIdListIncludeSub(String[] jobFamilyIdListIncludeSub)
序列 ID 列表（含下级）; - [【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.jobGradeIdList(String[] jobGradeIdList)
职等 ID 列表;- 可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取;- 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.jobIdList(String[] jobIdList)
职务 ID 列表;- 可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取;- 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.jobLevelIdList(String[] jobLevelIdList)
职级 ID 列表;- 可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取;- 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.keyWord(String keyWord)
搜索关键字，支持对邮箱、工号和姓名的模糊匹配
示例值：张三
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.nationalIdNumberList(String[] nationalIdNumberList)
居民身份证件号码精确搜索
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.nationalityIdList(String[] nationalityIdList)
国籍 ID 列表;- 可通过[【查询国籍信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)获取;- 需要有字段读取权限
示例值：
|
static SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.newBuilder() |
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.payGroupIdList(String[] payGroupIdList)
员工所属薪资组 ID 列表; - 可通过 [【获取薪资组基本信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取; - 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.phoneNumber(String phoneNumber)
个人电话，精确匹配查询
示例值：16760342300
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.phoneNumberList(String[] phoneNumberList)
个人电话列表，精确匹配查询
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.positionIdList(String[] positionIdList)
岗位 ID 列表; - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW); - 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.positionIdListIncludeSub(String[] positionIdListIncludeSub)
岗位 ID 列表（含下级）; - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW); - 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.preferredEnglishFullNameList(String[] preferredEnglishFullNameList)
常用英文全名精确搜索
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.preferredLocalFullNameList(String[] preferredLocalFullNameList)
常用本地全名精确搜索
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.regularEmployeeStartDateEnd(String regularEmployeeStartDateEnd)
转正式员工日期-搜索范围结束
示例值：2020-01-01
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.regularEmployeeStartDateStart(String regularEmployeeStartDateStart)
转正式员工日期-搜索范围开始
示例值：2020-01-01
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.serviceCompanyList(String[] serviceCompanyList)
任职公司 ID 列表;- [【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.serviceCompanyListIncludeSub(String[] serviceCompanyListIncludeSub)
任职公司 ID 列表（含下级）;- [【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.userName(String userName)
老People user_name查询，仅支持字节租户
示例值：zhangsan
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.workEmail(String workEmail)
邮箱，精确匹配查询
示例值：13312345678@qq.com
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.workingHoursTypeIdList(String[] workingHoursTypeIdList)
工时制度 ID 列表;- 可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取;- 需要有字段读取权限
示例值：
|
SearchEmployeeReqBody.Builder |
SearchEmployeeReqBody.Builder.workLocationIdListIncludeSub(String[] workLocationIdListIncludeSub)
工作地点 ID 列表，查询属于该工作地点及下级工作地点的员工
示例值：
|
| 构造器和说明 |
|---|
SearchEmployeeReqBody(SearchEmployeeReqBody.Builder builder) |
Copyright © 2025. All rights reserved.