| 程序包 | 说明 |
|---|---|
| com.lark.oapi.service.corehr.v2.model |
| 限定符和类型 | 方法和说明 |
|---|---|
BasicInfo.Builder |
BasicInfo.Builder.additionalName(Name additionalName)
常用名
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.additionalNationalityIdList(String[] additionalNationalityIdList)
其他国籍,可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获得
示例值:[6862995757234914824]
|
BasicInfo.Builder |
BasicInfo.Builder.addressList(AddressForUpdate[] addressList)
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.bankAccountList(BankAccountForUpdate[] bankAccountList)
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.bornCountryRegion(String bornCountryRegion)
出生国家/地区,可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.citizenshipStatusIdList(String[] citizenshipStatusIdList)
公民身份,如需获取具体值,请联系人员档案管理员
示例值:[6862995757234914824]
|
BasicInfo.Builder |
BasicInfo.Builder.cityOfBirth(String cityOfBirth)
出生城市
示例值:example
|
BasicInfo.Builder |
BasicInfo.Builder.customFields(ObjectFieldData[] customFields)
person对象上的自定义字段,可以通过[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)接口获得
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.dateEnteredWorkforce(String dateEnteredWorkforce)
参加工作日期,格式:"YYYY-MM-DD"
示例值:2010-09-09
|
BasicInfo.Builder |
BasicInfo.Builder.dateOfBirth(String dateOfBirth)
生日
示例值:2011-09-09
|
BasicInfo.Builder |
BasicInfo.Builder.dependentList(DependentForUpdate[] dependentList)
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.disableCardNumber(String disableCardNumber)
示例值:身份证号+残疾类型(1-7)+ 残疾程度分级(1-4)+[补发编号]
|
BasicInfo.Builder |
BasicInfo.Builder.email(String email)
个人邮箱
示例值:xxx@bytedance.com
|
BasicInfo.Builder |
BasicInfo.Builder.emergencyContactList(EmergencyContactForUpdate[] emergencyContactList)
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.ethnicityRace(String ethnicityRace)
民族 /
种族,枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取,按如下参数查询即可:;-
object_api_name:person;- custom_api_name:ethnicity_race
示例值:han
|
BasicInfo.Builder |
BasicInfo.Builder.expectedGraduateDate(String expectedGraduateDate)
示例值:2023-01-10
|
BasicInfo.Builder |
BasicInfo.Builder.genderId(String genderId)
性别,枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取,按如下参数查询即可:
;- object_api_name = person;- custom_api_name = gender
示例值:male
|
BasicInfo.Builder |
BasicInfo.Builder.homeAddress(String homeAddress)
家庭地址(待废弃)
示例值:xx市xx街道xx路xx号
|
BasicInfo.Builder |
BasicInfo.Builder.hukouLocation(String hukouLocation)
示例值:北京市海淀区北三环西路
|
BasicInfo.Builder |
BasicInfo.Builder.hukouType(String hukouType)
户口类型,枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取,按如下参数查询即可:;-
object_api_name:person_info_chn;- custom_api_name:hukou_type
示例值:local_urban_residence
|
BasicInfo.Builder |
BasicInfo.Builder.internationalAreaCode(String internationalAreaCode)
区号,枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取,按如下参数查询即可:
;- object_api_name = phone;- custom_api_name = international_area_code
示例值:86_china
|
BasicInfo.Builder |
BasicInfo.Builder.isDisabled(Boolean isDisabled)
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.isMartyrFamily(Boolean isMartyrFamily)
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.isOldAlone(Boolean isOldAlone)
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.legalName(Name legalName)
常用名
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.legalNames(NameForUpdate[] legalNames)
法定姓名列表
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.maritalStatus(String maritalStatus)
婚姻状况,枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取,按如下参数查询即可:;-
object_api_name:person;- custom_api_name:marital_status
示例值:single
|
BasicInfo.Builder |
BasicInfo.Builder.martyrCardNumber(String martyrCardNumber)
示例值:00001
|
BasicInfo.Builder |
BasicInfo.Builder.motherName(String motherName)
母亲姓名
示例值:example
|
BasicInfo.Builder |
BasicInfo.Builder.name(Name name)
常用名
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.nationalIdList(NationalIdForUpdate[] nationalIdList)
国家证件
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.nationalIdV2s(NationalIdForUpdate[] nationalIdV2s)
国家证件v2
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.nationalityId(String nationalityId)
国籍
示例值:6862995757234914824
|
BasicInfo.Builder |
BasicInfo.Builder.nationalityV2Id(String nationalityV2Id)
国籍(新),可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获得
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.nativeRegion(String nativeRegion)
籍贯,可以通过[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取
示例值:6822114062122064111
|
static BasicInfo.Builder |
BasicInfo.newBuilder() |
BasicInfo.Builder |
BasicInfo.Builder.passports(PassportForUpdate[] passports)
护照列表
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.personalIdNumber(String personalIdNumber)
证件号(待废弃,建议使用national_id_list, 如果与national_id_list同时传值,则national_id_list会被忽略)
示例值:3101xxxx1234567890
|
BasicInfo.Builder |
BasicInfo.Builder.personalIdType(String personalIdType)
证件类型(待废弃,建议使用national_id_list,
如果与national_id_list同时传值,则national_id_list会被忽略),可以通过[批量查询国家证件类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/national_id_type/list)接口获取
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.personalProfileList(PersonalProfileForUpdate[] personalProfileList)
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.personForCountries(PersonForCountryForUpdate[] personForCountries)
多国个人信息
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.phoneNumber(String phoneNumber)
手机号
示例值:138xxxx1234
|
BasicInfo.Builder |
BasicInfo.Builder.politicalAffiliation(String politicalAffiliation)
政治面貌,枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取,按如下参数查询即可:;-
object_api_name:person_info_chn;- custom_api_name:political_affiliation
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.preferredNameV2(NameForUpdate preferredNameV2)
常用姓名v2
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.regionOfBirth(String regionOfBirth)
出生省份
示例值:example
|
BasicInfo.Builder |
BasicInfo.Builder.religion(String religion)
宗教信仰,枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取,按如下参数查询即可:;-
object_api_name:person;- custom_api_name:religion
示例值:buddism
|
BasicInfo.Builder |
BasicInfo.Builder.residentTaxList(ResidentTaxForUpdate[] residentTaxList)
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.taxInfoMys(TaxInfoMysForUpdate taxInfoMys)
马来税务信息
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.userGeo(String userGeo)
数据驻留地(部分租户开通此功能),枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取。
|
BasicInfo.Builder |
BasicInfo.Builder.visas(VisaForUpdate[] visas)
签证列表
示例值:
|
BasicInfo.Builder |
BasicInfo.Builder.workerId(String workerId)
人员编号
示例值:DDD00001
|
| 构造器和说明 |
|---|
BasicInfo(BasicInfo.Builder builder) |
Copyright © 2026. All rights reserved.