| 程序包 | 说明 |
|---|---|
| com.lark.oapi.service.corehr.v2.model |
| 限定符和类型 | 方法和说明 |
|---|---|
EmployeeBt.Builder |
EmployeeBt.Builder.archiveCpstPlanId(String archiveCpstPlanId)
当前所属薪资方案 ID;- 可结合[批量查询薪资方案](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)接口使用
示例值：123456789
|
EmployeeBt.Builder |
EmployeeBt.Builder.assignmentPayGroupId(String assignmentPayGroupId)
所属外派薪资组 ID
示例值：7164286667866966659
|
EmployeeBt.Builder |
EmployeeBt.Builder.atsApplicationId(String atsApplicationId)
招聘投递 ID;- 可通过[获取投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get)获取详情
示例值：6838119494196871234
|
EmployeeBt.Builder |
EmployeeBt.Builder.attendanceGroupId(String attendanceGroupId)
当前所在考勤组 ID;- 可通过[按 ID 查询考勤组](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/get)获取详情
示例值：123456789
|
EmployeeBt.Builder |
EmployeeBt.Builder.avatarUrl(String avatarUrl)
员工头像（即飞书头像）
示例值：https://internal-api-lark-file.feishu-boe.cn/static-resource/v1/v2_a550d36b-28ef-48ad-9e50-58004beb386j~?
|
EmployeeBt.Builder |
EmployeeBt.Builder.companyId(String companyId)
所属公司 ID;- 可通过[查询单个公司](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)获取详情
示例值：6893014062142064135
|
EmployeeBt.Builder |
EmployeeBt.Builder.compensationType(Enum compensationType)
薪资类型;- 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：; - object_api_name：job_data; - custom_api_name：compensation_type
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.contractEndDate(String contractEndDate)
主合同到期日期
示例值：2020-01-01
|
EmployeeBt.Builder |
EmployeeBt.Builder.contractExpectedEndDate(String contractExpectedEndDate)
主合同预计到期日期
示例值：2020-01-01
|
EmployeeBt.Builder |
EmployeeBt.Builder.contractStartDate(String contractStartDate)
主合同开始日期
示例值：2020-01-01
|
EmployeeBt.Builder |
EmployeeBt.Builder.contractType(Enum contractType)
当前所属的合同类型;- 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)查询; - object_api_name：contract; - custom_api_name：contract_type
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.costCenterList(JobDataCostCenter[] costCenterList)
成本中心列表
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.customFields(CustomFieldData[] customFields)
自定义字段;- 请参考[自定义字段说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.customOrg(String customOrg)
自定义组织
示例值：{"custom_org_02":[{"id":"1","rate":"99"}]}
|
EmployeeBt.Builder |
EmployeeBt.Builder.department(BasicDepartment department)
部门基本信息
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.departmentId(String departmentId)
部门 ID;- 可通过[批量查询部门V2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get) 或者[搜索部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search) 获取详情;- 类型与 department_id_type 一致
示例值：6893014062142064135
|
EmployeeBt.Builder |
EmployeeBt.Builder.directManager(BasicEmployee directManager)
直接上级基本信息
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.directManagerId(String directManagerId)
直接上级的雇佣 ID;- 类型与 user_id_type 一致;- 可通过[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get) 或 [搜索员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)获取详细信息
示例值：7027024823985411287
|
EmployeeBt.Builder |
EmployeeBt.Builder.dottedLineManager(BasicEmployee dottedLineManager)
虚线上级基本信息
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.dottedLineManagerId(String dottedLineManagerId)
虚线上级的雇佣 ID; - 类型与 user_id_type 一致; - 可通过[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get) 或 [搜索员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)获取详细信息
示例值：7027024823985411782
|
EmployeeBt.Builder |
EmployeeBt.Builder.effectiveDate(String effectiveDate)
当前雇佣记录的入职日期
示例值：2021-03-16
|
EmployeeBt.Builder |
EmployeeBt.Builder.emailAddress(String emailAddress)
邮箱地址
示例值：test@163.com
|
EmployeeBt.Builder |
EmployeeBt.Builder.employeeNumber(String employeeNumber)
工号
示例值：1000000
|
EmployeeBt.Builder |
EmployeeBt.Builder.employeeSubtypeId(String employeeSubtypeId)
人员子类型 ID
示例值：6971090097697521317
|
EmployeeBt.Builder |
EmployeeBt.Builder.employeeTypeId(String employeeTypeId)
人员类型 ID;- 可通过[查询单个人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/get)获取详情
示例值：6971090097697521314
|
EmployeeBt.Builder |
EmployeeBt.Builder.employmentId(String employmentId)
雇佣 ID;- 类型与 user_id_type 一致
示例值：6893014062142064135
|
EmployeeBt.Builder |
EmployeeBt.Builder.employmentStatus(Enum employmentStatus)
雇佣状态;- 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：; - object_api_name：employment; - custom_api_name：employment_status
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.employmentType(Enum employmentType)
雇佣类型;- 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：; - object_api_name：employment; - custom_api_name：employment_type
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.expirationDate(String expirationDate)
离职日期;- 即员工的最后一个工作日，最后一个工作日时员工的雇佣状态仍为“在职”，次日凌晨将更改为“离职”
示例值：2022-08-16
|
EmployeeBt.Builder |
EmployeeBt.Builder.externalId(String externalId)
外部系统 ID , 可存储租户系统中的员工 ID
示例值：10000000
|
EmployeeBt.Builder |
EmployeeBt.Builder.internationalAssignment(Boolean internationalAssignment)
是否外派
示例值：true
|
EmployeeBt.Builder |
EmployeeBt.Builder.jobFamilyId(String jobFamilyId)
序列 ID;- 可通过[查询单个序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/get)获取详情
示例值：6893014062142064135
|
EmployeeBt.Builder |
EmployeeBt.Builder.jobGradeId(String jobGradeId)
职等 ID;- 可通过 [查询职等](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取详情
示例值：6893014062142064135
|
EmployeeBt.Builder |
EmployeeBt.Builder.jobId(String jobId)
职务 ID;- 可通过[查询单个职务（V2）](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/get)获取详情
示例值：6893014062142064135
|
EmployeeBt.Builder |
EmployeeBt.Builder.jobLevelId(String jobLevelId)
职级 ID;- 可通过[查询单个职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/get)获取详情
示例值：6893014062142064135
|
static EmployeeBt.Builder |
EmployeeBt.newBuilder() |
EmployeeBt.Builder |
EmployeeBt.Builder.noncompeteStatus(Enum noncompeteStatus)
竞业状态;- 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：; - object_api_name：employment; - custom_api_name：noncompete_status
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.onProbation(Boolean onProbation)
是否在试用期中
示例值：true
|
EmployeeBt.Builder |
EmployeeBt.Builder.pastOffboarding(Boolean pastOffboarding)
是否历史离职人员
示例值：true
|
EmployeeBt.Builder |
EmployeeBt.Builder.payGroupId(String payGroupId)
所属薪资组 ID
示例值：7164286667866966659
|
EmployeeBt.Builder |
EmployeeBt.Builder.personInfo(PersonInfoBt personInfo)
基本个人信息
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.positionId(String positionId)
岗位 ID;- 功能灰度中，有需要请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
示例值：6893014062142064135
|
EmployeeBt.Builder |
EmployeeBt.Builder.prehireId(String prehireId)
待入职 ID;- 可通过[查询单个待入职](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/pre_hire/get)获取详情
示例值：7023239238976141133
|
EmployeeBt.Builder |
EmployeeBt.Builder.primaryContractId(String primaryContractId)
主合同 ID;- 可通过[查询单个合同](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/contract/get)获取详情
示例值：7164286667866966659
|
EmployeeBt.Builder |
EmployeeBt.Builder.primaryEmployment(Boolean primaryEmployment)
是否是主雇佣信息
示例值：true
|
EmployeeBt.Builder |
EmployeeBt.Builder.primaryInternationalAssignment(InternationalAssignment primaryInternationalAssignment)
当前生效的外派记录
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.probationEndDate(String probationEndDate)
试用期结束日期（实际结束日期）
示例值：2022-08-01
|
EmployeeBt.Builder |
EmployeeBt.Builder.probationPeriod(Integer probationPeriod)
试用期时长（月）
示例值：16
|
EmployeeBt.Builder |
EmployeeBt.Builder.reasonForOffboarding(Enum reasonForOffboarding)
离职原因;- 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：; - object_api_name：employment; - custom_api_name：reason_for_offboarding
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.recruitmentType(Enum recruitmentType)
招聘来源;- 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：; - object_api_name：employment; - custom_api_name：recruitment_type
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.regularEmployeeStartDate(String regularEmployeeStartDate)
转正式日期
示例值：2020-01-01
|
EmployeeBt.Builder |
EmployeeBt.Builder.rehire(Enum rehire)
是否离职重聘;- 枚举如下：; - no：否; - yes：是; - to_be_confirmed：待确定
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.rehireEmploymentId(String rehireEmploymentId)
历史雇佣信息 ID;- 可通过[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get) 或 [搜索员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search)获取详细信息;- 类型不跟随 user_id_type
示例值：7164286667866966659
|
EmployeeBt.Builder |
EmployeeBt.Builder.seniorityAdjustInformationList(SeniorityAdjustInformation[] seniorityAdjustInformationList)
司龄调整信息
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.seniorityDate(String seniorityDate)
司龄起算日期
示例值：2021-03-16
|
EmployeeBt.Builder |
EmployeeBt.Builder.serviceCompany(String serviceCompany)
任职公司;- 可通过[查询单个公司](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/get)获取详情
示例值：7174374910734141112
|
EmployeeBt.Builder |
EmployeeBt.Builder.talentPoolIdList(String[] talentPoolIdList)
所属人才池
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.tenure(String tenure)
司龄
示例值：0.01
|
EmployeeBt.Builder |
EmployeeBt.Builder.timesEmployed(Integer timesEmployed)
入职次数
示例值：16
|
EmployeeBt.Builder |
EmployeeBt.Builder.timeZone(String timeZone)
时区
示例值：Asia/Shanghai
|
EmployeeBt.Builder |
EmployeeBt.Builder.userName(String userName)
对应老People user_name字段，仅支持字节租户
示例值：test
|
EmployeeBt.Builder |
EmployeeBt.Builder.workCalendarId(String workCalendarId)
工作日历 ID - 可通过[查询工作日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详情
示例值：7164286667866966659
|
EmployeeBt.Builder |
EmployeeBt.Builder.workEmailList(WorkEmail[] workEmailList)
工作邮箱列表
示例值：
|
EmployeeBt.Builder |
EmployeeBt.Builder.workingHoursTypeId(String workingHoursTypeId)
工时制度 ID;- 可通过[查询单个工时制度](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/get)获取详情
示例值：6893014062142064135
|
EmployeeBt.Builder |
EmployeeBt.Builder.workLocationId(String workLocationId)
工作地点 ID;- 可通过[查询单个地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/get)获取详情
示例值：6893014062142064135
|
EmployeeBt.Builder |
EmployeeBt.Builder.workShift(Enum workShift)
排班类型;- 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：; - object_api_name：job_data; - custom_api_name：work_shift
示例值：
|
| 构造器和说明 |
|---|
EmployeeBt(EmployeeBt.Builder builder) |
Copyright © 2025. All rights reserved.