更新待入职

通过指定系统字段和自定义字段以更新待入职数据

Tip: 该接口会按照应用拥有的「待入职人员」的权限范围返回数据，请提前在「开发者后台 - 权限管理 - 数据权限-飞书人事(企业版)数据权限范围」中申请「待入职人员」权限范围

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/pre_hires/:pre_hire_id
HTTP Method	PATCH
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom
权限要求调用该 API 所需的权限。开启其中任意一项权限即可调用	`corehr:pre_hire:update` 更新待入职人员信息

请求头

名称	类型	必填	描述
Authorization	string	是	`tenant_access_token` 值格式："Bearer `access_token`" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

路径参数

名称	类型	描述
`pre_hire_id`	`string`	待入职ID，可以通过搜索待入职人员信息接口获得示例值："7345005664477775411"

请求体

名称	类型	必填	描述
`basic_info_update`	`basic_info_update`	否	更新个人（person）信息
└ `names`	`name_for_update\[\]`	否	姓名，该值是一个list，会全量更新。即使只更新 list 中的某一个元素，也需要把其它元素都完整传值，否则将丢失数据。
└ `full_name`	`string`	否	全名示例值："李一一"
└ `first_name`	`string`	否	名示例值："一"
└ `middle_name`	`string`	否	中间名示例值："一"
└ `name_primary`	`string`	否	姓示例值："李"
└ `local_first_name`	`string`	否	名 - 本地文字示例值："一"
└ `local_middle_name`	`string`	否	本地中间名示例值："一"
└ `local_primary`	`string`	否	姓 - 本地文字示例值："李"
└ `custom_local_name`	`string`	否	自定义姓名（本地文字）示例值："李一一"
└ `custom_western_name`	`string`	否	自定义姓名（西方文字）示例值："YiyiLi"
└ `country_region`	`string`	是	国家/地区，可以通过接口查询国家/地区信息获得示例值："6862995757234914824"
└ `name_type`	`string`	是	姓名类型，枚举值如下： - legal_name：法定姓名 - preferred_name：常用名 - former_name：曾用名 - additional_name：别名示例值："legal_name"
└ `additional_name`	`string`	否	别名示例值："别名"
└ `phones`	`phone_for_update\[\]`	否	电话，该值是一个list，会全量更新。即使只更新 list 中的某一个元素，也需要把其它元素都完整传值，否则将丢失数据。
└ `international_area_code`	`string`	是	电话区号，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = phone - custom_api_name = international_area_code 示例值："86_china"
└ `phone_number`	`string`	是	电话号码示例值："178xxxx1234"
└ `device_type`	`string`	是	设备类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = phone - custom_api_name = device_type 示例值："mobile_phone"
└ `phone_usage`	`string`	是	电话用途，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = phone - custom_api_name = phone_usage 示例值："work"
└ `is_primary`	`boolean`	是	主要电话，若有多个电话，只能有一个电话的「is_primary」为true 示例值：true
└ `is_public`	`boolean`	是	公开电话示例值：true
└ `emails`	`email_for_update\[\]`	否	邮箱，该值是一个list，会全量更新。即使只更新 list 中的某一个元素，也需要把其它元素都完整传值，否则将丢失数据。
└ `email`	`string`	是	邮箱地址示例值："1234567@bytedance.com"
└ `is_primary`	`boolean`	是	是否为主要邮箱,若有多个邮箱，只能有一个邮箱的「is_primary」为true 示例值：true
└ `is_public`	`boolean`	是	是否为公开邮箱示例值：true
└ `email_usage`	`string`	是	邮箱用途，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = email - custom_api_name = email_usage 示例值："work"
└ `nationality_v2_id`	`string`	否	国籍，可以通过查询国籍信息接口获取示例值："6862995757234914824"
└ `additional_nationality_id_list`	`string\[\]`	否	其他国籍，可以通过查询国籍信息接口获取示例值：["6862995757234914824"]
└ `resident_tax_list`	`resident_tax_for_update\[\]`	否	纳税身份信息,该值是一个list，会全量更新
└ `tax_country_region`	`string`	否	国家 / 地区ID，可以通过接口查询国家/地区信息获得示例值："6862995757234914824"
└ `resident_status`	`string`	否	居民身份示例值："tax_residence"
└ `tax_address`	`address_for_update`	否	纳税地址
└ `country_region_id`	`string`	是	国家 / 地区，可以通过接口查询国家/地区信息获得示例值："6862995757234914824"
└ `region_id`	`string`	否	主要行政区，可以通过接口查询省份/行政区信息获得示例值："6863326815667095047"
└ `local_address_line1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："北京市海淀区"
└ `local_address_line2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："上海市杨浦区"
└ `local_address_line3`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："北京市房山区"
└ `local_address_line4`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："天津滨海高新区"
└ `local_address_line5`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："成都市成华区"
└ `local_address_line6`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："深圳市南山区"
└ `local_address_line7`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："南京市鼓楼区"
└ `local_address_line8`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："杭州市滨江区"
└ `local_address_line9`	`string`	否	地址行 9（非拉丁语系的本地文字）示例值："郑州市中原区"
└ `postal_code`	`string`	否	邮政编码示例值："611530"
└ `address_types`	`string\[\]`	是	地址类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：address - custom_api_name：address_type 示例值：["home_address"] 数据校验规则： - 长度范围：`1` ～ `1000`
└ `is_primary`	`boolean`	是	主要地址示例值：true
└ `is_public`	`boolean`	是	公开地址示例值：true
└ `city_id_v2`	`string`	否	城市，可以通过接口查询城市信息获取详情示例值："6863333254578046471"
└ `district_id_v2`	`string`	否	区/县，可以通过接口查询区/县信息获取详情示例值："6863333516579440141"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `address_line1`	`string`	否	地址行 1 示例值："丹佛测试地址-纽埃时区"
└ `address_line2`	`string`	否	地址行 2 示例值："PoewH"
└ `address_line3`	`string`	否	地址行 3 示例值："PoewH"
└ `address_line4`	`string`	否	地址行 4 示例值："jmwJc"
└ `address_line5`	`string`	否	地址行 5 示例值："jmwJc"
└ `address_line6`	`string`	否	地址行 6 示例值："jmwJc"
└ `address_line7`	`string`	否	地址行 7 示例值："jmwJc"
└ `address_line8`	`string`	否	地址行 8 示例值："rafSu"
└ `address_line9`	`string`	否	地址行 9 示例值："McPRG"
└ `resident_status_specification`	`string`	否	居民纳税身份说明示例值："文本内容，对纳税身份的补充说明信息"
└ `year_resident_tax`	`string`	否	年度示例值："2006-01-01"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `born_country_region`	`string`	否	出生国家/地区，可以通过接口查询国家/地区信息获得示例值："6862995757234914824"
└ `is_disabled`	`boolean`	否	是否残疾示例值：true
└ `disable_card_number`	`string`	否	残疾证号示例值："身份证号+残疾类型（1-7）+ 残疾程度分级（1-4）+[补发编号]"
└ `is_old_alone`	`boolean`	否	是否孤老示例值：true
└ `is_martyr_family`	`boolean`	否	是否烈属示例值：true
└ `martyr_card_number`	`string`	否	烈属证号示例值："00001"
└ `dependent_list`	`dependent_for_update\[\]`	否	家庭成员
└ `relationship`	`string`	是	关系，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：dependent - custom_api_name：relationship_with_dependent 示例值："parent"
└ `gender`	`string`	否	性别，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：dependent - custom_api_name：gender 示例值："male"
└ `date_of_birth`	`string`	否	生日示例值："2020-01-01"
└ `national_ids`	`national_id_for_update\[\]`	否	证件号码数据校验规则： - 长度范围：`1` ～ `1000`
└ `country_region_id`	`string`	是	国家 / 地区，可以通过查询国家/地区信息接口获得示例值："6862995757234914824"
└ `national_id_type_id`	`string`	是	国家证件类型，可以通过批量查询国家证件类型接口获得示例值："6863330041896371725"
└ `national_id_number`	`string`	是	证件号码示例值："1231131333xxxx222"
└ `issue_date`	`string`	否	证件签发日期示例值："2020-04-01"
└ `expiration_date`	`string`	否	证件到期日期示例值："2020-05-21"
└ `issued_by`	`string`	否	证件签发机构示例值："北京市公安局"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `spouses_working_status`	`string`	否	配偶工作状态，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：dependent - custom_api_name：spouses_working_status 示例值："working"
└ `is_this_person_covered_by_health_insurance`	`boolean`	否	包含家属医疗保险示例值：true
└ `is_this_person_allowed_for_tax_deduction`	`boolean`	否	允许家属抵扣税款示例值：false
└ `dependent_name`	`string`	否	家庭成员姓名示例值："王冰"
└ `employer`	`string`	否	工作单位示例值："海淀区交警大队"
└ `job`	`string`	否	岗位信息描述示例值："保安"
└ `phone`	`phone_for_update`	否	电话
└ `international_area_code`	`string`	是	国家区号，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：phone - custom_api_name：international_area_code 示例值："86_china"
└ `phone_number`	`string`	是	电话号码示例值："178xxxx1232"
└ `device_type`	`string`	是	设备类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：phone - custom_api_name：device_type 示例值："mobile_phone"
└ `phone_usage`	`string`	是	电话用途，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：phone - custom_api_name：phone_usage 示例值："home"
└ `is_primary`	`boolean`	是	主要电话，若有多个电话，只能有一个电话的「is_primary」为true 示例值：true
└ `is_public`	`boolean`	是	公开电话示例值：true
└ `address`	`address_for_update`	否	联系地址
└ `country_region_id`	`string`	是	国家 / 地区，可以通过接口查询国家/地区信息获得示例值："6862995757234914824"
└ `region_id`	`string`	否	主要行政区，可以通过接口查询省份/行政区信息获得示例值："6863326815667095047"
└ `local_address_line1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："北京市海淀区"
└ `local_address_line2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："上海市杨浦区"
└ `local_address_line3`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："北京市房山区"
└ `local_address_line4`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："天津滨海高新区"
└ `local_address_line5`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："成都市成华区"
└ `local_address_line6`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："深圳市南山区"
└ `local_address_line7`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："南京市鼓楼区"
└ `local_address_line8`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："杭州市滨江区"
└ `local_address_line9`	`string`	否	地址行 9（非拉丁语系的本地文字）示例值："郑州市中原区"
└ `postal_code`	`string`	否	邮政编码示例值："611530"
└ `address_types`	`string\[\]`	是	地址类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：address - custom_api_name：address_type 示例值：["home_address"] 数据校验规则： - 长度范围：`1` ～ `1000`
└ `is_primary`	`boolean`	是	主要地址示例值：true
└ `is_public`	`boolean`	是	公开地址示例值：true
└ `city_id_v2`	`string`	否	城市示例值："6863333254578046471"
└ `district_id_v2`	`string`	否	区/县示例值："6863333516579440141"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `address_line1`	`string`	否	地址行 1 示例值："丹佛测试地址-纽埃时区"
└ `address_line2`	`string`	否	地址行 2 示例值："PoewH"
└ `address_line3`	`string`	否	地址行 3 示例值："PoewH"
└ `address_line4`	`string`	否	地址行 4 示例值："jmwJc"
└ `address_line5`	`string`	否	地址行 5 示例值："jmwJc"
└ `address_line6`	`string`	否	地址行 6 示例值："jmwJc"
└ `address_line7`	`string`	否	地址行 7 示例值："jmwJc"
└ `address_line8`	`string`	否	地址行 8 示例值："rafSu"
└ `address_line9`	`string`	否	地址行 9 示例值："McPRG"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `religion`	`string`	否	宗教信仰，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：person - custom_api_name：religion 示例值："buddism"
└ `bank_account_list`	`bank_account_for_update\[\]`	否	银行账号
└ `bank_name`	`string`	否	银行名称示例值："中国农业银行"
└ `branch_name`	`string`	否	支行名称示例值："中国农业银行支行"
└ `bank_account_number`	`string`	是	银行账号示例值："6231200xxxx01223"
└ `account_holder`	`string`	是	开户人姓名示例值："孟十五"
└ `country_region_id`	`string`	否	国家/地区 ID，可以通过接口查询国家/地区信息获得示例值："6862995745889322510"
└ `bank_account_usages`	`string\[\]`	否	银行卡用途，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：bank_account - custom_api_name：bank_account_usage 示例值：["payment"] 数据校验规则： - 长度范围：`0` ～ `100`
└ `bank_account_type`	`string`	否	银行卡类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：bank_account - custom_api_name：bank_account_type 示例值："checking"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `national_id_list`	`national_id_for_update\[\]`	否	证件账号
└ `country_region_id`	`string`	是	国家 / 地区，可以通过接口查询国家/地区信息获得示例值："6862995757234914824"
└ `national_id_type_id`	`string`	是	国家证件类型，可以通过批量查询国家证件类型接口获得示例值："6863330041896371725"
└ `national_id_number`	`string`	是	证件号码示例值："1231131333"
└ `issue_date`	`string`	否	证件签发日期示例值："2020-04-01"
└ `expiration_date`	`string`	否	证件到期日期示例值："2020-05-21"
└ `issued_by`	`string`	否	证件签发机构示例值："北京市公安局"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `personal_profile_list`	`personal_profile_for_update\[\]`	否	个人资料
└ `personal_profile_type`	`string`	否	资料类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：personal_profile - custom_api_name: profile_type 示例值："profile_type_1_101_101011"
└ `files`	`file\[\]`	否	资料文件列表数据校验规则： - 长度范围：`0` ～ `1000`
└ `id`	`string`	否	文件ID，通过上传文件接口上传文件后，获取文件ID 示例值："6655aa1b2ec326f983b91f9d_f9974583040c4b05ae71f92f5df16bbc"
└ `emergency_contact_list`	`emergency_contact_for_update\[\]`	否	紧急联系人
└ `legal_name`	`string`	否	紧急联系人姓名示例值："王冰"
└ `relationship`	`string`	否	紧急联系人与本人亲属关系，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：emergency_contact - custom_api_name：relationship 示例值："parent"
└ `phones`	`phone_for_update\[\]`	否	电话数据校验规则： - 长度范围：`0` ～ `1000`
└ `international_area_code`	`string`	是	国家区号，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：phone - custom_api_name：international_area_code 示例值："86_china"
└ `phone_number`	`string`	是	电话号码示例值："178xxxx1232"
└ `device_type`	`string`	是	设备类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：phone - custom_api_name：device_type 示例值："mobile_phone"
└ `phone_usage`	`string`	是	电话用途，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：phone - custom_api_name：phone_usage 示例值："home"
└ `is_primary`	`boolean`	是	主要电话，若有多个电话，只能有一个电话的「is_primary」为true 示例值：true
└ `is_public`	`boolean`	是	公开电话示例值：true
└ `address`	`address_for_update`	否	地址
└ `country_region_id`	`string`	是	国家 / 地区，可以通过接口查询国家/地区信息获得示例值："6862995757234914824"
└ `region_id`	`string`	否	主要行政区，可以通过接口查询省份/行政区信息获得示例值："6863326815667095047"
└ `local_address_line1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："北京市海淀区"
└ `local_address_line2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："上海市杨浦区"
└ `local_address_line3`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："北京市房山区"
└ `local_address_line4`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："天津滨海高新区"
└ `local_address_line5`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："成都市成华区"
└ `local_address_line6`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："深圳市南山区"
└ `local_address_line7`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："南京市鼓楼区"
└ `local_address_line8`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："杭州市滨江区"
└ `local_address_line9`	`string`	否	地址行 9（非拉丁语系的本地文字）示例值："郑州市中原区"
└ `postal_code`	`string`	否	邮政编码示例值："611530"
└ `address_types`	`string\[\]`	是	地址类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：address - custom_api_name：address_type 示例值：["home_address"] 数据校验规则： - 长度范围：`1` ～ `1000`
└ `is_primary`	`boolean`	是	主要地址示例值：true
└ `is_public`	`boolean`	是	公开地址示例值：true
└ `city_id_v2`	`string`	否	城市示例值："6863333254578046471"
└ `district_id_v2`	`string`	否	区/县示例值："6863333516579440141"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `address_line1`	`string`	否	地址行 1 示例值："丹佛测试地址-纽埃时区"
└ `address_line2`	`string`	否	地址行 2 示例值："PoewH"
└ `address_line3`	`string`	否	地址行 3 示例值："PoewH"
└ `address_line4`	`string`	否	地址行 4 示例值："jmwJc"
└ `address_line5`	`string`	否	地址行 5 示例值："jmwJc"
└ `address_line6`	`string`	否	地址行 6 示例值："jmwJc"
└ `address_line7`	`string`	否	地址行 7 示例值："jmwJc"
└ `address_line8`	`string`	否	地址行 8 示例值："rafSu"
└ `address_line9`	`string`	否	地址行 9 示例值："McPRG"
└ `email`	`email_for_update`	否	邮箱
└ `email`	`string`	是	邮箱地址示例值："1234567@bytedance.com"
└ `is_primary`	`boolean`	是	是否为主要邮箱,若有多个邮箱，只能有一个邮箱的「is_primary」为true 示例值：true
└ `is_public`	`boolean`	是	是否为公开邮箱示例值：true
└ `email_usage`	`string`	是	邮箱用途，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：email - custom_api_name：email_usage 示例值："work"
└ `is_primary`	`boolean`	否	主要联系人,若有多个联系人，只能有一个联系人的「is_primary」为true 示例值：true
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `address_list`	`address_for_update\[\]`	否	联系地址
└ `country_region_id`	`string`	是	国家 / 地区，可以通过接口查询国家/地区信息获得示例值："6862995757234914824"
└ `region_id`	`string`	否	主要行政区，可以通过接口查询省份/行政区信息获得示例值："6863326815667095047"
└ `local_address_line1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："北京市海淀区"
└ `local_address_line2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："上海市杨浦区"
└ `local_address_line3`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："北京市房山区"
└ `local_address_line4`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："天津滨海高新区"
└ `local_address_line5`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："成都市成华区"
└ `local_address_line6`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："深圳市南山区"
└ `local_address_line7`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："南京市鼓楼区"
└ `local_address_line8`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："杭州市滨江区"
└ `local_address_line9`	`string`	否	地址行 9（非拉丁语系的本地文字）示例值："郑州市中原区"
└ `postal_code`	`string`	否	邮政编码示例值："611530"
└ `address_types`	`string\[\]`	是	地址类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：address - custom_api_name：address_type 示例值：["home_address"] 数据校验规则： - 长度范围：`1` ～ `1000`
└ `is_primary`	`boolean`	是	主要地址示例值：true
└ `is_public`	`boolean`	是	公开地址示例值：true
└ `city_id_v2`	`string`	否	城市示例值："6863333254578046471"
└ `district_id_v2`	`string`	否	区/县示例值："6863333516579440141"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `address_line1`	`string`	否	地址行 1 示例值："丹佛测试地址-纽埃时区"
└ `address_line2`	`string`	否	地址行 2 示例值："PoewH"
└ `address_line3`	`string`	否	地址行 3 示例值："PoewH"
└ `address_line4`	`string`	否	地址行 4 示例值："jmwJc"
└ `address_line5`	`string`	否	地址行 5 示例值："jmwJc"
└ `address_line6`	`string`	否	地址行 6 示例值："jmwJc"
└ `address_line7`	`string`	否	地址行 7 示例值："jmwJc"
└ `address_line8`	`string`	否	地址行 8 示例值："rafSu"
└ `address_line9`	`string`	否	地址行 9 示例值："McPRG"
└ `marital_status`	`string`	否	婚姻状况，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：person - custom_api_name：marital_status 示例值："single"
└ `ethnicity_race`	`string`	否	民族 / 种族，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：person - custom_api_name：ethnicity_race 示例值："han"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05) 示例值："Sandy"
└ `native_region`	`string`	否	籍贯，可以通过查询省份/行政区信息接口获取示例值："6862995757234914824"
└ `hukou_type`	`string`	否	户口类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：person_info_chn - custom_api_name：hukou_type 示例值："local_urban_residence"
└ `hukou_location`	`string`	否	户口所在地示例值："北京市海淀区北三环西路"
└ `gender_id`	`string`	否	性别，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：dependent - custom_api_name：gender 示例值："male"
└ `date_of_birth`	`string`	否	生日示例值："2019-06-07T00:00:00.000Z"
└ `date_entered_workforce`	`string`	否	参加工作日期示例值："2100-09-09"
└ `expected_graduate_date`	`string`	否	预计毕业日期示例值："2023-01-10"
└ `citizenship_status_id_list`	`string\[\]`	否	公民身份示例值：["6862995757234914824"]
└ `work_experience`	`work_experience_for_update\[\]`	否	工作履历
└ `company_name`	`string`	否	公司名称示例值："猎豹"
└ `start_time`	`string`	否	开始时间示例值："2015-02-01"
└ `end_time`	`string`	否	结束时间示例值："2017-02-01"
└ `job_title`	`string`	否	岗位示例值："产品经理"
└ `description`	`string`	否	工作描述示例值："app"
└ `department`	`string`	否	部门示例值："部门名称"
└ `education_info`	`education_info_for_update\[\]`	否	教育经历
└ `school_name`	`string`	否	学校名称示例值："长安大学"
└ `education`	`string`	否	学历，枚举值可通过文档枚举常量介绍学历（level_of_education）枚举定义获得示例值："phd"
└ `start_time`	`string`	否	开始时间示例值："2017-04-01"
└ `end_time`	`string`	否	结束时间示例值："2018-04-01"
└ `field_of_study`	`string`	否	专业示例值："医学影像技术"
└ `degree`	`string`	否	学位，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：education - custom_api_name：degree 示例值："phd"
└ `political_affiliation`	`string`	否	政治面貌，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：person_info_chn - custom_api_name：political_affiliation 示例值："public"
`offer_info_update`	`offer_info_update`	否	更新待入职（prehire）信息
└ `onboarding_date`	`string`	否	入职日期示例值："2022-10-08"
└ `ats_application_id`	`string`	否	招聘应用 ID，仅支持飞书招聘 ID，可以通过获取投递列表接口获取示例值："7140946969586010376"
└ `onboarding_location_id`	`string`	否	入职地点ID，可以通过批量查询地点接口获得示例值："6977976687350924832"
└ `onboarding_address_id`	`string`	否	入职地址ID，可以通过批量查询地点接口获得示例值："6977976687350924832"
└ `office_location_id`	`string`	否	办公地点ID，可以通过批量查询地点接口获得示例值："6977976687350924833"
└ `office_address_id`	`string`	否	办公地址ID，可以通过批量查询地点接口获得示例值："6977976687350924832"
└ `employment_type`	`string`	否	雇佣类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = pre_hire - custom_api_name = employment_type 示例值："employee"
└ `onboarding_method`	`string`	否	入职方式，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = pre_hire - custom_api_name = onboarding_method 示例值："onsite"
└ `work_emails`	`email_for_update\[\]`	否	工作邮箱，该值是一个list，会全量更新。即使只更新 list 中的某一个元素，也需要把其它元素都完整传值，否则将丢失数据。
└ `email`	`string`	是	邮箱地址示例值："1234567@bytedance.com"
└ `is_primary`	`boolean`	是	是否为主要邮箱,若有多个邮箱，只能有一个邮箱的「is_primary」为true 示例值：true
└ `is_public`	`boolean`	是	是否为公开邮箱示例值：true
└ `email_usage`	`string`	是	邮箱用途，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = email - custom_api_name = email_usage 示例值："work"
└ `cost_center_rates`	`job_data_cost_center\[\]`	否	成本中心分摊信息 - 待废弃，建议使用cost_allocation
└ `cost_center_id`	`string`	否	成本中心 ID，可以通过搜索成本中心信息接口获得示例值："6950635856373745165"
└ `rate`	`int`	否	分摊比例（%），大于0小于等于100的正整数示例值：100
└ `new_rate`	`number(float)`	否	分摊比例（%）示例值：50.2
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，该值是一个 string list 经转义后的字符串，具体参考请求体示例示例值："["Sandy"]"
└ `position_id`	`string`	否	岗位id，如需获取具体值，请联系人员档案管理员示例值："697797668735092768"
└ `probation_period`	`int`	否	试用期时长（单位：月）示例值：6
└ `probation_start_date`	`string`	否	试用期开始日期，格式："YYYY-MM-DD" 示例值："2022-07-29"
└ `probation_end_date`	`string`	否	试用期结束日期，格式："YYYY-MM-DD" 示例值："2023-04-07"
└ `contract_start_date`	`string`	否	合同开始日期，格式："YYYY-MM-DD" 示例值："2022-10-08"
└ `contract_end_date`	`string`	否	合同结束日期，格式："YYYY-MM-DD" 示例值："2025-10-07"
└ `contract_type`	`string`	否	合同类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：pre_hire - custom_api_name：contract_type 示例值："internship_agreement"
└ `duration_type_id`	`string`	否	期限类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：pre_hire - custom_api_name：duration_type 示例值："fixed_term"
└ `signing_type_id`	`string`	否	签订类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：pre_hire - custom_api_name：signing_type 示例值："new"
└ `worker_id`	`string`	否	工号示例值："DDD00001"
└ `check_in_time`	`string`	否	签到日期，格式："YYYY-MM-DD" 示例值："2024-12-31"
└ `check_in_method`	`string`	否	签到方式，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name：pre_hire - custom_api_name：onboarding_method 示例值："onsite"
└ `company`	`string`	否	公司主体，可以通过批量查询公司接口查询示例值："6738317738688661772"
└ `work_shift`	`string`	否	排班，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = pre_hire - custom_api_name = work_shift 示例值："work_shift"
└ `recruitment_type_id`	`string`	否	招聘类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = pre_hire - custom_api_name = recruitment_type 示例值："experienced_professionals"
└ `compensation_type`	`string`	否	薪资类型，枚举值可查询获取字段详情接口获取，按如下参数查询即可： - object_api_name = pre_hire - custom_api_name = compensation_type 示例值："hourly"
└ `pay_group_id`	`string`	否	薪资组，如需获取具体值，请联系人员档案管理员示例值："6977976687350924833"
└ `offer_hr_id`	`string`	否	Offer HR 雇佣ID，可以通过批量查询员工信息接口获取示例值："7032210902531327521"
└ `job_id`	`string`	否	职务 ID，可以通过批量查询职务接口获取示例值："6977976735715378724"
└ `job_family_id`	`string`	否	序列 ID，可以通过批量查询序列接口获取示例值："6977972856625939999"
└ `job_level_id`	`string`	否	职级 ID，可以通过批量查询职级接口获取示例值："6977971894960145950"
└ `job_grade_id`	`string`	否	职等ID，可以通过查询职等接口获取示例值："6738317738688661772"
└ `employee_type_id`	`string`	否	人员类型 ID，可以通过接口批量查询人员类型获取示例值："6977973225846343171"
└ `employee_subtype_id`	`string`	否	人员子类型示例值："6150309523419405950"
└ `direct_leader_id`	`string`	否	直属上级，可以通过批量查询员工信息接口获取示例值："7032210902531327521"
└ `dotted_line_manager_id`	`string`	否	虚线上级，可以通过搜索员工信息接口获取详情 - 功能灰度中，如有需求请联系技术支持示例值："6829541172930572684"
└ `department_id`	`string`	否	部门 ID，可以通过批量查询部门接口获取示例值："7147562782945478177"
└ `social_security_city`	`string`	否	社保城市ID，可以通过批量查询地点接口获得示例值："6977976687350924833"
└ `work_location_id`	`string`	否	工作地点ID，可以通过批量查询地点接口获得示例值："6977976687350924833"
└ `working_calendar`	`string`	否	工作日历，可以通过查询日历信息接口获得示例值："6890452208593372141"
└ `working_hours_type`	`string`	否	工时制度，可以通过批量查询工时制度接口获得示例值："6890452208593372679"
└ `seniority_date`	`string`	否	司龄起算日期示例值："2022-10-08"
└ `seniority_adjust_information_list`	`prehire_seniority_adjust_information_update\[\]`	否	司龄调整信息 - 功能灰度中，如有需求请联系技术支持
└ `seniority_adjustment`	`number(float)`	否	调整值 - 精确度：两位小数 - 单位：年 - 自动计算逻辑：如果这个值为空，司龄调整的开始日期和结束日期均不为空，会自动计算出调整值示例值：0.5 数据校验规则： - 取值范围：`0` ～ `100`
└ `seniority_adjustment_type`	`string`	是	调整类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：seniority_adjust_information - custom_api_name：seniority_adjustment_type 示例值："增加" 可选值有： - `decrease`: 减少 - `increase`: 增加
└ `reasons_for_seniority_adjustment`	`string`	否	司龄调整原因示例值："工厂停产需要减去半年工龄"
└ `start_date`	`string`	否	开始日期 - 格式： yyyy-mm-dd 示例值："2024-05-19"
└ `end_date`	`string`	否	结束日期 - 格式： yyyy-mm-dd 示例值："2024-11-18"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `notice_period_probation_voluntary`	`notice_period_detail`	否	试用期内通知期（主动离职) - 功能灰度中，如有需求请联系技术支持示例值：xxx
└ `wk_id`	`string`	否	ID 示例值："4698019107896524633"
└ `value`	`int`	否	数值示例值：1 数据校验规则： - 取值范围：`1` ～ `65535`
└ `value_unit`	`string`	否	单位示例值："月"
└ `notice_period_probation_involuntary`	`notice_period_detail`	否	试用期内通知期（被动离职） - 功能灰度中，如有需求请联系技术支持示例值：xxx
└ `wk_id`	`string`	否	ID 示例值："4698019107896524633"
└ `value`	`int`	否	数值示例值：1 数据校验规则： - 取值范围：`1` ～ `65535`
└ `value_unit`	`string`	否	单位示例值："月"
└ `notice_period_positive_voluntary`	`notice_period_detail`	否	转正后通知期（主动离职） - 功能灰度中，如有需求请联系技术支持示例值：xxx
└ `wk_id`	`string`	否	ID 示例值："4698019107896524633"
└ `value`	`int`	否	数值示例值：1 数据校验规则： - 取值范围：`1` ～ `65535`
└ `value_unit`	`string`	否	单位示例值："月"
└ `notice_period_positive_involuntary`	`notice_period_detail`	否	转正后通知期（被动离职） - 功能灰度中，如有需求请联系技术支持示例值：xxx
└ `wk_id`	`string`	否	ID 示例值："4698019107896524633"
└ `value`	`int`	否	数值示例值：1 数据校验规则： - 取值范围：`1` ～ `65535`
└ `value_unit`	`string`	否	单位示例值："月"
└ `condition_worker`	`boolean`	否	是否外部人员示例值：true
└ `company_sponsored_visa`	`boolean`	否	需要公司办理签证示例值：true
└ `weekly_working_hours_v2`	`number(float)`	否	周工作时长（单位：小时）示例值：8.5
└ `work_station`	`string`	否	工位示例值："5-1-2"
└ `service_company`	`string`	否	任职公司，可以通过批量查询公司接口查询示例值："6738317738688661772"
└ `non_compete_covenant`	`boolean`	否	是否包含竞业条款示例值：true
└ `pathway`	`string`	否	通道示例值："7460865381179115052"
└ `default_cost_center`	`prehire_default_cost_center_update`	否	默认成本中心 - 功能灰度中，如有需求请联系技术支持
└ `cost_center_id`	`string`	是	成本中心 ID，可以通过搜索成本中心信息接口获得示例值："6950635856373745165"
└ `is_herit`	`boolean`	是	是否继承岗位/部门的默认成本中心示例值：false
└ `cost_allocation`	`cost_allocation`	否	成本分摊 - 功能灰度中，如有需求请联系技术支持
└ `effective_time`	`string`	否	分摊生效日期示例值："2025-01-01"
└ `expiration_time`	`string`	否	分摊失效日期示例值："2025-02-01"
└ `cost_center_rates`	`job_data_cost_center\[\]`	否	成本分摊信息数据校验规则： - 长度范围：`0` ～ `50`
└ `cost_center_id`	`string`	否	成本中心 ID，可以通过搜索成本中心信息接口获得示例值："6950635856373745165"
└ `rate`	`int`	否	分摊比例(整数) 示例值：100
└ `new_rate`	`number(float)`	否	分摊比例示例值：50.2
└ `reuse_feishu_account`	`string`	否	是否复用飞书账号，支持传入“reuse”或者“not_resue”，当字段为“reuse”时，需要传入reused_feishu_account_id - 功能灰度中，如有需求请联系技术支持示例值："reuse"
└ `reused_feishu_account_id`	`string`	否	复用的飞书账号，仅支持Lark Union ID，可以通过搜索员工信息接口获取 - 功能灰度中，如有需求请联系技术支持示例值："on_773dd2c4d14c5c980a4d89a2da5c86d3"
`standard_update_fields`	`string\[\]`	否	指定需要更新的系统字段，只支持最多下钻一层，格式如下： - basic_info_update字段：basic_info_update.names（对name整体进行覆盖更新）；basic_info_update.emails（对邮箱整体进行更新） - offer_info_update字段：offer_info_update.onboarding_method 注意，如果指定了要更新的系统字段但是没有在结构体中传对应的值，那么就会清空该字段的值示例值：["basic_info_update.names"]
`custom_update_fields`	`string\[\]`	否	指定需要更新的pre_hire对象上的自定义字段，可以通过获取自定义字段列表接口获得注意：如果指定了要更新的自定义字段但是没有在结构体中传对应的值，那么就会清空该字段的值示例值：["custom_field1__c"]
`person_custom_update_fields`	`string\[\]`	否	指定需要更新的person对象上的自定义字段，可以通过获取自定义字段列表接口获得注意：如果指定了要更新的自定义字段但是没有在结构体中传对应的值，那么就会清空该字段的值示例值：["custom_field1__c"]

请求体示例

json

{
    "basic_info_update": {
        "names": [
            {
                "full_name": "李一一",
                "first_name": "一",
                "middle_name": "一",
                "name_primary": "李",
                "local_first_name": "一",
                "local_middle_name": "一",
                "local_primary": "李",
                "custom_local_name": "李一一",
                "custom_western_name": "YiyiLi",
                "country_region": "6862995757234914824",
                "name_type": "legal_name",
                "additional_name": "别名"
            }
        ],
        "phones": [
            {
                "international_area_code": "86_china",
                "phone_number": "178xxxx1234",
                "device_type": "mobile_phone",
                "phone_usage": "work",
                "is_primary": true,
                "is_public": true
            }
        ],
        "emails": [
            {
                "email": "1234567@bytedance.com",
                "is_primary": true,
                "is_public": true,
                "email_usage": "work"
            }
        ],
        "nationality_v2_id": "6862995757234914824",
        "additional_nationality_id_list": [
            "6862995757234914824"
        ],
        "resident_tax_list": [
            {
                "tax_country_region": "6862995757234914824",
                "resident_status": "tax_residence",
                "tax_address": {
                    "country_region_id": "6862995757234914824",
                    "region_id": "6863326815667095047",
                    "local_address_line1": "北京市海淀区",
                    "local_address_line2": "上海市杨浦区",
                    "local_address_line3": "北京市房山区",
                    "local_address_line4": "天津滨海高新区",
                    "local_address_line5": "成都市成华区",
                    "local_address_line6": "深圳市南山区",
                    "local_address_line7": "南京市鼓楼区",
                    "local_address_line8": "杭州市滨江区",
                    "local_address_line9": "郑州市中原区",
                    "postal_code": "611530",
                    "address_types": [
                        "home_address"
                    ],
                    "is_primary": true,
                    "is_public": true,
                    "city_id_v2": "6863333254578046471",
                    "district_id_v2": "6863333516579440141",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "Sandy"
                        }
                    ],
                    "address_line1": "丹佛测试地址-纽埃时区",
                    "address_line2": "PoewH",
                    "address_line3": "PoewH",
                    "address_line4": "jmwJc",
                    "address_line5": "jmwJc",
                    "address_line6": "jmwJc",
                    "address_line7": "jmwJc",
                    "address_line8": "rafSu",
                    "address_line9": "McPRG"
                },
                "resident_status_specification": "文本内容，对纳税身份的补充说明信息",
                "year_resident_tax": "2006-01-01",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "Sandy"
                    }
                ]
            }
        ],
        "born_country_region": "6862995757234914824",
        "is_disabled": true,
        "disable_card_number": "身份证号+残疾类型（1-7）+ 残疾程度分级（1-4）+[补发编号]",
        "is_old_alone": true,
        "is_martyr_family": true,
        "martyr_card_number": "00001",
        "dependent_list": [
            {
                "relationship": "parent",
                "gender": "male",
                "date_of_birth": "2020-01-01",
                "national_ids": [
                    {
                        "country_region_id": "6862995757234914824",
                        "national_id_type_id": "6863330041896371725",
                        "national_id_number": "1231131333xxxx222",
                        "issue_date": "2020-04-01",
                        "expiration_date": "2020-05-21",
                        "issued_by": "北京市公安局",
                        "custom_fields": [
                            {
                                "field_name": "name",
                                "value": "Sandy"
                            }
                        ]
                    }
                ],
                "spouses_working_status": "working",
                "is_this_person_covered_by_health_insurance": true,
                "is_this_person_allowed_for_tax_deduction": false,
                "dependent_name": "王冰",
                "employer": "海淀区交警大队",
                "job": "保安",
                "phone": {
                    "international_area_code": "86_china",
                    "phone_number": "178xxxx1232",
                    "device_type": "mobile_phone",
                    "phone_usage": "home",
                    "is_primary": true,
                    "is_public": true
                },
                "address": {
                    "country_region_id": "6862995757234914824",
                    "region_id": "6863326815667095047",
                    "local_address_line1": "北京市海淀区",
                    "local_address_line2": "上海市杨浦区",
                    "local_address_line3": "北京市房山区",
                    "local_address_line4": "天津滨海高新区",
                    "local_address_line5": "成都市成华区",
                    "local_address_line6": "深圳市南山区",
                    "local_address_line7": "南京市鼓楼区",
                    "local_address_line8": "杭州市滨江区",
                    "local_address_line9": "郑州市中原区",
                    "postal_code": "611530",
                    "address_types": [
                        "home_address"
                    ],
                    "is_primary": true,
                    "is_public": true,
                    "city_id_v2": "6863333254578046471",
                    "district_id_v2": "6863333516579440141",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "Sandy"
                        }
                    ],
                    "address_line1": "丹佛测试地址-纽埃时区",
                    "address_line2": "PoewH",
                    "address_line3": "PoewH",
                    "address_line4": "jmwJc",
                    "address_line5": "jmwJc",
                    "address_line6": "jmwJc",
                    "address_line7": "jmwJc",
                    "address_line8": "rafSu",
                    "address_line9": "McPRG"
                },
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "Sandy"
                    }
                ]
            }
        ],
        "religion": "buddism",
        "bank_account_list": [
            {
                "bank_name": "中国农业银行",
                "branch_name": "中国农业银行支行",
                "bank_account_number": "6231200xxxx01223",
                "account_holder": "孟十五",
                "country_region_id": "6862995745889322510",
                "bank_account_usages": [
                    "payment"
                ],
                "bank_account_type": "checking",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "Sandy"
                    }
                ]
            }
        ],
        "national_id_list": [
            {
                "country_region_id": "6862995757234914824",
                "national_id_type_id": "6863330041896371725",
                "national_id_number": "1231131333",
                "issue_date": "2020-04-01",
                "expiration_date": "2020-05-21",
                "issued_by": "北京市公安局",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "Sandy"
                    }
                ]
            }
        ],
        "personal_profile_list": [
            {
                "personal_profile_type": "profile_type_1_101_101011",
                "files": [
                    {
                        "id": "6655aa1b2ec326f983b91f9d_f9974583040c4b05ae71f92f5df16bbc"
                    }
                ]
            }
        ],
        "emergency_contact_list": [
            {
                "legal_name": "王冰",
                "relationship": "parent",
                "phones": [
                    {
                        "international_area_code": "86_china",
                        "phone_number": "178xxxx1232",
                        "device_type": "mobile_phone",
                        "phone_usage": "home",
                        "is_primary": true,
                        "is_public": true
                    }
                ],
                "address": {
                    "country_region_id": "6862995757234914824",
                    "region_id": "6863326815667095047",
                    "local_address_line1": "北京市海淀区",
                    "local_address_line2": "上海市杨浦区",
                    "local_address_line3": "北京市房山区",
                    "local_address_line4": "天津滨海高新区",
                    "local_address_line5": "成都市成华区",
                    "local_address_line6": "深圳市南山区",
                    "local_address_line7": "南京市鼓楼区",
                    "local_address_line8": "杭州市滨江区",
                    "local_address_line9": "郑州市中原区",
                    "postal_code": "611530",
                    "address_types": [
                        "home_address"
                    ],
                    "is_primary": true,
                    "is_public": true,
                    "city_id_v2": "6863333254578046471",
                    "district_id_v2": "6863333516579440141",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "Sandy"
                        }
                    ],
                    "address_line1": "丹佛测试地址-纽埃时区",
                    "address_line2": "PoewH",
                    "address_line3": "PoewH",
                    "address_line4": "jmwJc",
                    "address_line5": "jmwJc",
                    "address_line6": "jmwJc",
                    "address_line7": "jmwJc",
                    "address_line8": "rafSu",
                    "address_line9": "McPRG"
                },
                "email": {
                    "email": "1234567@bytedance.com",
                    "is_primary": true,
                    "is_public": true,
                    "email_usage": "work"
                },
                "is_primary": true,
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "Sandy"
                    }
                ]
            }
        ],
        "address_list": [
            {
                "country_region_id": "6862995757234914824",
                "region_id": "6863326815667095047",
                "local_address_line1": "北京市海淀区",
                "local_address_line2": "上海市杨浦区",
                "local_address_line3": "北京市房山区",
                "local_address_line4": "天津滨海高新区",
                "local_address_line5": "成都市成华区",
                "local_address_line6": "深圳市南山区",
                "local_address_line7": "南京市鼓楼区",
                "local_address_line8": "杭州市滨江区",
                "local_address_line9": "郑州市中原区",
                "postal_code": "611530",
                "address_types": [
                    "home_address"
                ],
                "is_primary": true,
                "is_public": true,
                "city_id_v2": "6863333254578046471",
                "district_id_v2": "6863333516579440141",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "Sandy"
                    }
                ],
                "address_line1": "丹佛测试地址-纽埃时区",
                "address_line2": "PoewH",
                "address_line3": "PoewH",
                "address_line4": "jmwJc",
                "address_line5": "jmwJc",
                "address_line6": "jmwJc",
                "address_line7": "jmwJc",
                "address_line8": "rafSu",
                "address_line9": "McPRG"
            }
        ],
        "marital_status": "single",
        "ethnicity_race": "han",
        "custom_fields": [
            {
                "field_name": "name",
                "value": "Sandy"
            }
        ],
        "native_region": "6862995757234914824",
        "hukou_type": "local_urban_residence",
        "hukou_location": "北京市海淀区北三环西路",
        "gender_id": "male",
        "date_of_birth": "2019-06-07T00:00:00.000Z",
        "date_entered_workforce": "2100-09-09",
        "expected_graduate_date": "2023-01-10",
        "citizenship_status_id_list": [
            "6862995757234914824"
        ],
        "work_experience": [
            {
                "company_name": "猎豹",
                "start_time": "2015-02-01",
                "end_time": "2017-02-01",
                "job_title": "产品经理",
                "description": "app",
                "department": "部门名称"
            }
        ],
        "education_info": [
            {
                "school_name": "长安大学",
                "education": "phd",
                "start_time": "2017-04-01",
                "end_time": "2018-04-01",
                "field_of_study": "医学影像技术",
                "degree": "phd"
            }
        ],
        "political_affiliation": "public"
    },
    "offer_info_update": {
        "onboarding_date": "2022-10-08",
        "ats_application_id": "7140946969586010376",
        "onboarding_location_id": "6977976687350924832",
        "onboarding_address_id": "6977976687350924832",
        "office_location_id": "6977976687350924833",
        "office_address_id": "6977976687350924832",
        "employment_type": "employee",
        "onboarding_method": "onsite",
        "work_emails": [
            {
                "email": "1234567@bytedance.com",
                "is_primary": true,
                "is_public": true,
                "email_usage": "work"
            }
        ],
        "cost_center_rates": [
            {
                "cost_center_id": "6950635856373745165",
                "rate": 100,
                "new_rate": 50.2
            }
        ],
        "custom_fields": [
            {
                "field_name": "name",
                "value": "[\"Sandy\"]"
            }
        ],
        "position_id": "697797668735092768",
        "probation_period": 6,
        "probation_start_date": "2022-07-29",
        "probation_end_date": "2023-04-07",
        "contract_start_date": "2022-10-08",
        "contract_end_date": "2025-10-07",
        "contract_type": "internship_agreement",
        "duration_type_id": "fixed_term",
        "signing_type_id": "new",
        "worker_id": "DDD00001",
        "check_in_time": "2024-12-31",
        "check_in_method": "onsite",
        "company": "6738317738688661772",
        "work_shift": "work_shift",
        "recruitment_type_id": "experienced_professionals",
        "compensation_type": "hourly",
        "pay_group_id": "6977976687350924833",
        "offer_hr_id": "7032210902531327521",
        "job_id": "6977976735715378724",
        "job_family_id": "6977972856625939999",
        "job_level_id": "6977971894960145950",
        "job_grade_id": "6738317738688661772",
        "employee_type_id": "6977973225846343171",
        "employee_subtype_id": "6150309523419405950",
        "direct_leader_id": "7032210902531327521",
        "dotted_line_manager_id": "6829541172930572684",
        "department_id": "7147562782945478177",
        "social_security_city": "6977976687350924833",
        "work_location_id": "6977976687350924833",
        "working_calendar": "6890452208593372141",
        "working_hours_type": "6890452208593372679",
        "seniority_date": "2022-10-08",
        "seniority_adjust_information_list": [
            {
                "seniority_adjustment": 0.5,
                "seniority_adjustment_type": "增加",
                "reasons_for_seniority_adjustment": "工厂停产需要减去半年工龄",
                "start_date": "2024-05-19",
                "end_date": "2024-11-18",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "Sandy"
                    }
                ]
            }
        ],
        "notice_period_probation_voluntary": {
            "wk_id": "4698019107896524633",
            "value": 1,
            "value_unit": "月"
        },
        "notice_period_probation_involuntary": {
            "wk_id": "4698019107896524633",
            "value": 1,
            "value_unit": "月"
        },
        "notice_period_positive_voluntary": {
            "wk_id": "4698019107896524633",
            "value": 1,
            "value_unit": "月"
        },
        "notice_period_positive_involuntary": {
            "wk_id": "4698019107896524633",
            "value": 1,
            "value_unit": "月"
        },
        "condition_worker": true,
        "company_sponsored_visa": true,
        "weekly_working_hours_v2": 8.5,
        "work_station": "5-1-2",
        "service_company": "6738317738688661772",
        "non_compete_covenant": true,
        "pathway": "7460865381179115052",
        "default_cost_center": {
            "cost_center_id": "6950635856373745165",
            "is_herit": false
        },
        "cost_allocation": {
            "effective_time": "2025-01-01",
            "expiration_time": "2025-02-01",
            "cost_center_rates": [
                {
                    "cost_center_id": "6950635856373745165",
                    "rate": 100,
                    "new_rate": 50.2
                }
            ]
        },
        "reuse_feishu_account": "reuse",
        "reused_feishu_account_id": "on_773dd2c4d14c5c980a4d89a2da5c86d3"
    },
    "standard_update_fields": [
        "basic_info_update.names"
    ],
    "custom_update_fields": [
        "custom_field1__c"
    ],
    "person_custom_update_fields": [
        "custom_field1__c"
    ]
}

响应

响应体

名称	类型	描述
`code`	`int`	错误码，非 0 表示失败
`msg`	`string`	错误描述
`data`	`\-`	-
└ `pre_hire_id`	`string`	待入职ID

响应体示例

json

{
    "code": 0,
    "msg": "success",
    "data": {
        "pre_hire_id": "7345005664477775407"
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1161000	系统错误	系统出现问题，如需帮助，请咨询技术支持。
400	1161001	职级无效	请填写有效的职级
400	1161002	序列无效	请填写有效的序列
400	1161003	职务无效	请填写有效的职务
400	1161004	Offer HR 无效	请填写有效的 Offer HR
400	1161005	直属上级无效	请填写有效的直属上级
400	1161006	入职地点无效	请填写有效的入职地点
400	1161007	办公地点无效	请填写有效的办公地点
400	1161008	招聘类型无效	请填写有效的招聘类型
400	1161009	人员类型无效	请填写有效的人员类型
400	1161010	雇佣类型无效	请填写有效的雇佣类型
400	1161011	期限类型无效	请填写有效的期限类型
400	1161012	签订类型无效	请填写有效的签订类型
400	1161013	社保城市无效	请填写有效的社保城市
400	1161014	公司主体无效	请填写有效的公司主体
400	1161015	部门无效	请填写有效的部门
400	1161016	证件号码和在职人员重复	请检查证件号码是否和在职人员重复
400	1161018	合同类型无效	请填写有效的合同类型
400	1167037	个人电话和在职人员重复	请检查个人电话是否和在职人员重复
400	1161019	成本中心内容重复	请检查成本中心
400	1161020	成本中心分摊比例必须大于0小于等于100	请检查成本中心分摊比例
400	1161021	成本中心数据不完整	请填写完整的成本中心数据
400	1161022	成本中心无效	请确认填写的是有效的成本中心
400	1161023	成本中心的分摊比例之和需等于 100%	成本中心的分摊比例之和需等于 100%
400	1161024	成本中心被停用	成本中心被停用
400	1161025	成本中心将被停用	成本中心将被停用
400	1161026	个人邮箱和在职人员重复	请检查个人邮箱是否和在职人员重复
400	1161027	个人邮箱和待入职人员重复	请检查个人邮箱是否和待入职人员重复
400	1161028	手机号和在职人员重复	请检查个人电话是否和在职人员重复
400	1161029	手机号和待入职人员重复	请检查个人电话是否和待入职人员重复
400	1161030	Offer id 不存在	请检查 Offer id
400	1161031	证件号码和待入职人员重复	请检查证件号码是否和待入职人员重复
400	1161032	国际区号无效	请填写有效的国际区号
400	1161033	手机号格式有误	请检查手机号
400	1161034	工作邮箱格式有误	请检查工作邮箱
400	1161035	工作邮箱域名有误	请检查工作邮箱域名
400	1161036	工作邮箱和在职人员重复	请检查工作邮箱是否和在职人员重复
400	1161037	工作邮箱和待入职人员重复	请检查工作邮箱是否和待入职人员重复
400	1161038	工作邮箱和离职人员重复	请检查工作邮箱是否和离职人员重复
400	1161039	地点用途有误	请检查填写地点的用途
400	1161040	入职地址的用途有误	请检查入职地址的用途
400	1161041	入职地点的用途错误	请检查入职地点的用途
400	1161042	办公地址的用途有误	请检查办公地址的用途
400	1161043	办公地点的用途有误	请检查办公地点的用途
400	1161044	工作地点的用途有误	请检查工作地点的用途
400	1161045	社保城市用途错误	请检查社保城市的用途
400	1161046	社保城市用途错误	请检查社保城市的用途
400	1161047	公积金缴纳地地点用途错误	请检查公积金缴纳地的用途
400	1161048	工号和待入职人员重复	请检查工号是否和待入职人员重复
400	1161049	工号格式错误	请检查工号
400	1161050	自动编码规则已启用，无法填写工号	自动编码规则已启用，无法填写工号
400	1161051	入职地址和入职地点没有关联关系	输入的入职地址和入职地点之间不存在层级关系，请前往「组织管理-地点」中确认后并重新填写信息
400	1161052	办公地址和办公地点没有关联关系	输入的办公地址和办公地点之间不存在层级关系，请前往「组织管理-地点」中确认后并重新填写信息
400	1161053	办公地址和工作地点没有关联关系	输入的办公地址和工作地点之间不存在层级关系，请前往「组织管理-地点」中确认后并重新填写信息
400	1161054	办公地点和工作地点没有关联关系	输入的办公地点和工作地点之间不存在层级关系，请前往「组织管理-地点」中确认后并重新填写信息
400	1161055	办公地址、办公地点和工作地点没有关联关系	输入的办公地址、办公地点和工作地点之间不存在层级关系，请前往「组织管理-地点」中确认后并重新填写信息
400	1161056	部门使用职务，职务需必填	部门使用职务，职务需必填
400	1161057	部门无需使用职务，职务需为空值	部门无需使用职务，职务需为空值
400	1161063	编制规划超编	编制规划超编
400	1161064	根据当前的自动编码规则，无法生成工号。请前往「设置-人事设置-自动编码设置」中修改规则	根据当前的自动编码规则，无法生成工号。请前往「设置-人事设置-自动编码设置」中修改规则
400	1161065	工号生成失败，请重试或者联系技术支持	工号生成失败，请重试或者联系技术支持
400	1161066	公司和人员类型为空，无法根据自动编码生成工号	公司和人员类型为空，无法根据自动编码生成工号
400	1161068	职务失效	请填写有效的职务
400	1161069	序列失效	请填写有效的序列
400	1161070	职级失效	请填写有效的职级
400	1161071	职务和序列不匹配	职务和序列不匹配
400	1161072	职务和职级不匹配	职务和职级不匹配
400	1161073	职务、序列和职级不匹配	职务、序列和职级不匹配
400	1161074	序列和职级不匹配	序列和职级不匹配
400	1161075	合同结束日期、合同开始日期和合同时长不一致	合同结束日期、合同开始日期和合同时长不一致
400	1161076	其他国籍包含主国籍	其他国籍包含主国籍
400	1161077	其他国籍内容重复	其他国籍内容重复
400	1161078	公民身份内容重复	公民身份内容重复
400	1161079	其他国籍无效	请填写有效的其他国籍
400	1161080	公民身份无效	请填写有效的公民身份
400	1161092	异常信息检查失败	异常信息检查失败
400	1161097	权限被拒绝，请联系技术支持	权限被拒绝，请联系技术支持
400	1161108	待入职人员已完成入职，无法更新信息	待入职人员已完成入职，无法更新信息
400	1161109	职等失效	请填写有效的职等
400	1161112	部门使用岗位，岗位需必填	部门使用岗位，岗位需必填
400	1161113	岗位不匹配	「部门、直属上级、虚线上级、职务、序列、职级、职等、工作地点、工时制度、人员类型」中存在与所选岗位不匹配的信息，请重新选择
400	1161114	岗位在入职日期及其之后不存在	岗位在入职日期及其之后不存在
400	1161115	岗位在入职日期及其之后存在停用版本	岗位在入职日期及其之后存在停用版本
400	1161116	更新待入职获取锁失败	重试更新待入职
400	1161142	通知期信息不合法	通知期信息不合法
400	1161143	通知期信息无效，不可编辑	通知期信息无效，不可编辑
400	1161144	通知期规则不匹配	通知期规则不匹配
400	1161145	你已填写默认成本中心（手动选择），“是否继承岗位/部门的默认成本中心”必须为空或者“否”	你已填写默认成本中心（手动选择），“是否继承岗位/部门的默认成本中心”必须为空或者“否”
400	1161146	是否继承岗位/部门的默认成本中心”填写为否，请补充默认成本中心（手动选择）	是否继承岗位/部门的默认成本中心”填写为否，请补充默认成本中心（手动选择）
400	1161147	入职日期缺失，无法补充默认成本中心或者成本分摊的生效日期	入职日期缺失，无法补充默认成本中心或者成本分摊的生效日期
400	1161148	部门/岗位上的默认成本中心为空，无法继承	部门/岗位上的默认成本中心为空，无法继承
400	1161149	成本分摊中的成本中心和分摊比例需填写完整	成本分摊中的成本中心和分摊比例需填写完整
400	1161160	该部门在入职日期时可能不存在或无效。	部门在入职日期时可能不存在或无效。
400	1161161	岗位在入职日期时可能不存在或无效。	岗位在入职日期时可能不存在或无效。

事件

事件

员工兼职

员工国际派遣

职位数据事件

事件

事件

事件

事件

事件

事件

事件

成本中心 · version

事件

事件

事件

事件

地点 · address

事件

事件

更新待入职 ​

请求 ​

请求头 ​

路径参数 ​

请求体 ​

请求体示例 ​

响应 ​

响应体 ​

响应体示例 ​

错误码 ​

更新待入职

请求

请求头

路径参数

请求体

请求体示例

响应

响应体

响应体示例

错误码