| 程序包 | 说明 |
|---|---|
| com.lark.oapi.service.corehr.v2.model |
| 限定符和类型 | 方法和说明 |
|---|---|
Employee.Builder |
Employee.Builder.archiveCpstPlanId(String archiveCpstPlanId)
当前所属薪资方案 ID;- 可结合[批量查询薪资方案](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)接口使用
示例值:123456789
|
Employee.Builder |
Employee.Builder.assignmentPayGroupId(String assignmentPayGroupId)
所属外派薪资组 ID
示例值:7164286667866966659
|
Employee.Builder |
Employee.Builder.atsApplicationId(String atsApplicationId)
招聘投递 ID ,详细信息可以通过【获取投递信息】接口查询获得
示例值:6838119494196871234
|
Employee.Builder |
Employee.Builder.attendanceGroupId(String attendanceGroupId)
当前所在考勤组 ID;- 可通过[按 ID 查询考勤组](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/get)获取详情
示例值:123456789
|
Employee.Builder |
Employee.Builder.avatarUrl(String avatarUrl)
员工头像
示例值:https://internal-api-lark-file.feishu-boe.cn/static-resource/v1/v2_a550d36b-28ef-48ad-9e50-58004beb386j~?
|
Employee.Builder |
Employee.Builder.companyId(String companyId)
所属公司 ID,详细信息可通过【查询单个公司】接口获得
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.compensationType(Enum compensationType)
薪资类型
示例值:
|
Employee.Builder |
Employee.Builder.contractEndDate(String contractEndDate)
主合同到期日期
示例值:2020-01-01
|
Employee.Builder |
Employee.Builder.contractExpectedEndDate(String contractExpectedEndDate)
主合同预计到期日期
示例值:2020-01-01
|
Employee.Builder |
Employee.Builder.contractStartDate(String contractStartDate)
主合同开始日期
示例值:2020-01-01
|
Employee.Builder |
Employee.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
示例值:
|
Employee.Builder |
Employee.Builder.costCenterList(JobDataCostCenter[] costCenterList)
成本中心列表
示例值:
|
Employee.Builder |
Employee.Builder.customFields(CustomFieldData[] customFields)
自定义字段
示例值:
|
Employee.Builder |
Employee.Builder.customOrg(String customOrg)
自定义组织
示例值:{"custom_org_02":[{"id":"1","rate":"99"}]}
|
Employee.Builder |
Employee.Builder.department(BasicDepartment department)
部门基本信息
示例值:
|
Employee.Builder |
Employee.Builder.departmentId(String departmentId)
部门 ID;- 可通过 [【查询单个部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)获取详细信息;- 类型与 department_id_type 一致;- 请使用 department_id_v2
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.departmentIdV2(String departmentIdV2)
部门 ID;- 可通过 [【查询单个部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/get)获取详细信息;- 类型与 department_id_type 一致,转换失败时返回空值
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.directManager(BasicEmployee directManager)
直接上级基本信息
示例值:
|
Employee.Builder |
Employee.Builder.directManagerId(String directManagerId)
直接上级的雇佣 ID;- 类型与 user_id_type 一致;- 请使用 direct_manager_id_v2
示例值:7027024823985411287
|
Employee.Builder |
Employee.Builder.directManagerIdV2(String directManagerIdV2)
直接上级的雇佣 ID;- 类型与 user_id_type 一致,转换失败返回空值
示例值:7027024823985411287
|
Employee.Builder |
Employee.Builder.dottedLineManager(BasicEmployee dottedLineManager)
虚线上级基本信息
示例值:
|
Employee.Builder |
Employee.Builder.dottedLineManagerId(String dottedLineManagerId)
虚线上级的雇佣 ID; - 类型与 user_id_type 一致; - 请使用 dotted_line_manager_id_v2
示例值:7027024823985411782
|
Employee.Builder |
Employee.Builder.dottedLineManagerIdV2(String dottedLineManagerIdV2)
虚线上级的雇佣 ID;- 类型与 user_id_type 一致,转换失败返回空值
示例值:7027024823985411782
|
Employee.Builder |
Employee.Builder.effectiveDate(String effectiveDate)
当前雇佣记录的入职日期
示例值:2021-03-16
|
Employee.Builder |
Employee.Builder.emailAddress(String emailAddress)
邮箱地址
示例值:test@163.com
|
Employee.Builder |
Employee.Builder.employeeNumber(String employeeNumber)
工号
示例值:1000000
|
Employee.Builder |
Employee.Builder.employeeSubtypeId(String employeeSubtypeId)
人员子类型 ID
示例值:6971090097697521317
|
Employee.Builder |
Employee.Builder.employeeTypeId(String employeeTypeId)
人员类型 ID,详细信息可通过【查询单个人员类型】接口获得
示例值:6971090097697521314
|
Employee.Builder |
Employee.Builder.employmentAllBps(EmploymentBp employmentAllBps)
员工全部 BP 信息
示例值:
|
Employee.Builder |
Employee.Builder.employmentDirectBps(EmploymentBp employmentDirectBps)
员工直属 BP 信息,当员工所在部门、属地无 BP 时,会上钻找到最近的 BP
示例值:
|
Employee.Builder |
Employee.Builder.employmentId(String employmentId)
雇佣 ID;- 类型与 user_id_type 一致;- 请使用 employment_id_v2
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.employmentIdV2(String employmentIdV2)
雇佣 ID;- 类型与 user_id_type 一致,转换失败时返回空值
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.employmentStatus(Enum employmentStatus)
雇佣状态,枚举值可通过文档【飞书人事枚举常量】雇员状态(employment_status)枚举定义获得
示例值:
|
Employee.Builder |
Employee.Builder.employmentType(Enum employmentType)
雇佣类型,枚举值可通过文档【飞书人事枚举常量】雇佣类型(employment_type)枚举定义获得
示例值:
|
Employee.Builder |
Employee.Builder.expirationDate(String expirationDate)
离职日期,即员工的最后一个工作日,最后一个工作日时员工的雇佣状态仍为“在职”,次日凌晨将更改为“离职”
示例值:2022-08-16
|
Employee.Builder |
Employee.Builder.externalId(String externalId)
外部系统 ID , 可存储租户系统中的员工 ID
示例值:10000000
|
Employee.Builder |
Employee.Builder.individualsWithHeadcountOrNot(Enum individualsWithHeadcountOrNot)
员工是否占用编制
示例值:with_headcount
|
Employee.Builder |
Employee.Builder.internationalAssignment(Boolean internationalAssignment)
是否外派
示例值:true
|
Employee.Builder |
Employee.Builder.job(Job job)
职务
示例值:
|
Employee.Builder |
Employee.Builder.jobFamily(EmployeeJobFamily jobFamily)
序列
示例值:
|
Employee.Builder |
Employee.Builder.jobFamilyId(String jobFamilyId)
序列 ID,详细信息可通过【查询单个职务序列】接口获得
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.jobGradeId(String jobGradeId)
职等 ID
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.jobId(String jobId)
职务 ID,详细信息可通过【查询单个职务】接口获得
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.jobLevel(EmployeeJobLevel jobLevel)
职级
示例值:
|
Employee.Builder |
Employee.Builder.jobLevelId(String jobLevelId)
职级 ID,详细信息可通过【查询单个职务级别】接口获得
示例值:6893014062142064135
|
static Employee.Builder |
Employee.newBuilder() |
Employee.Builder |
Employee.Builder.noncompeteStatus(Enum noncompeteStatus)
竞业状态,枚举值包括:1.竞业中;2.未竞业
示例值:
|
Employee.Builder |
Employee.Builder.onProbation(Boolean onProbation)
是否在试用期中
示例值:true
|
Employee.Builder |
Employee.Builder.pastOffboarding(Boolean pastOffboarding)
是否历史离职人员
示例值:true
|
Employee.Builder |
Employee.Builder.pathway(EmployeePathway pathway)
通道
示例值:
|
Employee.Builder |
Employee.Builder.pathwayId(String pathwayId)
通道 ID
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.payGroupId(String payGroupId)
所属薪资组 ID
示例值:7164286667866966659
|
Employee.Builder |
Employee.Builder.personInfo(PersonInfo personInfo)
基本个人信息
示例值:
|
Employee.Builder |
Employee.Builder.position(Position position)
岗位
示例值:
|
Employee.Builder |
Employee.Builder.positionId(String positionId)
岗位 ID,详细信息可通过【查询单个岗位】接口获得
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.prehireId(String prehireId)
待入职 ID
示例值:7023239238976141133
|
Employee.Builder |
Employee.Builder.primaryContractId(String primaryContractId)
主合同 ID
示例值:7164286667866966659
|
Employee.Builder |
Employee.Builder.primaryEmployment(Boolean primaryEmployment)
是否是主雇佣信息
示例值:true
|
Employee.Builder |
Employee.Builder.primaryInternationalAssignment(InternationalAssignment primaryInternationalAssignment)
当前生效的外派记录
示例值:
|
Employee.Builder |
Employee.Builder.probationEndDate(String probationEndDate)
试用期结束日期(实际结束日期)
示例值:2022-08-01
|
Employee.Builder |
Employee.Builder.probationPeriod(Integer probationPeriod)
试用期时长(月)
示例值:16
|
Employee.Builder |
Employee.Builder.reasonForOffboarding(Enum reasonForOffboarding)
离职原因,枚举值可通过文档【飞书人事枚举常量】离职原因(reason_for_offboarding)枚举定义部分获得
示例值:
|
Employee.Builder |
Employee.Builder.recruitmentType(Enum recruitmentType)
招聘来源,枚举值 api_name 可通过【获取自定义字段详情】接口查询
示例值:
|
Employee.Builder |
Employee.Builder.regularEmployeeStartDate(String regularEmployeeStartDate)
转正式日期
示例值:2020-01-01
|
Employee.Builder |
Employee.Builder.rehire(Enum rehire)
是否离职重聘
示例值:
|
Employee.Builder |
Employee.Builder.rehireEmploymentId(String rehireEmploymentId)
历史雇佣信息 ID,可以通过【查询单个雇佣信息】查询详细信息
示例值:7164286667866966659
|
Employee.Builder |
Employee.Builder.seniorityAdjustInformationList(SeniorityAdjustInformation[] seniorityAdjustInformationList)
司龄调整信息
示例值:
|
Employee.Builder |
Employee.Builder.seniorityDate(String seniorityDate)
资历起算日期
示例值:2021-03-16
|
Employee.Builder |
Employee.Builder.serviceCompany(String serviceCompany)
任职公司
示例值:7174374910734141112
|
Employee.Builder |
Employee.Builder.talentPoolIdList(String[] talentPoolIdList)
所属人才池
示例值:
|
Employee.Builder |
Employee.Builder.tenure(String tenure)
司龄
示例值:0.01
|
Employee.Builder |
Employee.Builder.timesEmployed(Integer timesEmployed)
入职次数
示例值:16
|
Employee.Builder |
Employee.Builder.timeZone(String timeZone)
时区
示例值:Asia/Shanghai
|
Employee.Builder |
Employee.Builder.userName(String userName)
对应老People user_name字段,仅支持字节租户
示例值:test
|
Employee.Builder |
Employee.Builder.workCalendarId(String workCalendarId)
工作日历 ID
示例值:7164286667866966659
|
Employee.Builder |
Employee.Builder.workEmailList(WorkEmail[] workEmailList)
工作邮箱列表,只有当邮箱满足下面所有条件时,才在个人信息页面可见
示例值:
|
Employee.Builder |
Employee.Builder.workingHoursTypeId(String workingHoursTypeId)
工时制度 ID,详细信息可通过【查询单个工时制度】接口获得
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.workLocationId(String workLocationId)
工作地点 ID,详细信息可通过【查询单个地点】接口获得
示例值:6893014062142064135
|
Employee.Builder |
Employee.Builder.workShift(Enum workShift)
排班类型
示例值:
|
| 构造器和说明 |
|---|
Employee(Employee.Builder builder) |
Copyright © 2025. All rights reserved.