# 直接创建待入职 使用指定数据创建一个待入职人员信息。 ## 请求 基本 |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/corehr/v2/pre_hires HTTP Method | POST 接口频率限制 | [1000 次/分钟、50 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用**
开启任一权限即可 | 更新核心人事信息(corehr:corehr)
读写待入职人员信息(corehr:pre_hire:write) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) Content-Type | string | 是 | **固定值**："application/json; charset=utf-8" ### 请求体 名称 | 类型 | 必填 | 描述 ---|---|---|--- basic_info | basic_info | 是 | 个人信息 name | name | 否 | 常用名 full_name | string | 否 | 全名
**示例值**："李一一" first_name | string | 否 | 名
**示例值**："一" middle_name | string | 否 | 中间名
**示例值**："一" name_primary | string | 否 | 姓
**示例值**："李" local_first_name | string | 否 | 名 - 本地文字
**示例值**："一" local_middle_name | string | 否 | 本地中间名
**示例值**："一" local_primary | string | 否 | 姓 - 本地文字
**示例值**："李" country_region_id | string | 否 | 国家 / 地区，可以通过接口[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获得
**示例值**："6862995757234914824" custom_local_name | string | 否 | 本地文字的自定义姓名
**示例值**："李一一" custom_western_name | string | 否 | 西方文字的自定义姓名
**示例值**："YiyiLi" additional_name | string | 否 | 别名
**示例值**："别名" phone_number | string | 否 | 手机号
**示例值**："138xxxx1234" international_area_code | string | 否 | 区号，枚举值可查询[获取字段详情](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" email | string | 否 | 个人邮箱
**示例值**："xxx@bytedance.com" date_of_birth | string | 否 | 生日
**示例值**："2011-09-09" personal_id_number | string | 否 | 证件号（待废弃，建议使用national_id_list， 如果与national_id_list同时传值，则national_id_list会被忽略）
**示例值**："3101xxxx1234567890" personal_id_type | string | 否 | 证件类型（待废弃，建议使用national_id_list， 如果与national_id_list同时传值，则national_id_list会被忽略），可以通过[批量查询国家证件类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/national_id_type/list)接口获取
**示例值**："6862995757234914823" date_entered_workforce | string | 否 | 参加工作日期，格式："YYYY-MM-DD"
**示例值**："2010-09-09" gender_id | string | 否 | 性别，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name = person
- custom_api_name = gender
**示例值**："male" nationality_v2_id | string | 否 | 国籍（新），可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获得
**示例值**："6862995757234914824" additional_nationality_id_list | string\[\] | 否 | 其他国籍，可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获得
**示例值**：["6862995757234914824"] citizenship_status_id_list | string\[\] | 否 | 公民身份，如需获取具体值，请联系人员档案管理员
**示例值**：["6862995757234914824"] home_address | string | 否 | 家庭地址（待废弃）
**示例值**："xx市xx街道xx路xx号" worker_id | string | 否 | 人员编号
**示例值**："DDD00001" user_geo | string | 否 | 数据驻留地（部分租户开通此功能），枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取。
按如下参数查询即可：
- object_api_name = pre_hire
- custom_api_name = user_geo
**示例值**："cn" legal_name | name | 否 | 法定姓名 full_name | string | 否 | 全名
**示例值**："李一一" first_name | string | 否 | 名
**示例值**："一" middle_name | string | 否 | 中间名
**示例值**："一" name_primary | string | 否 | 姓
**示例值**："李" local_first_name | string | 否 | 名 - 本地文字
**示例值**："一" local_middle_name | string | 否 | 本地中间名
**示例值**："一" local_primary | string | 否 | 姓 - 本地文字
**示例值**："李" country_region_id | string | 否 | 国家 / 地区，可以通过接口[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获得
**示例值**："6862995757234914824" custom_local_name | string | 否 | 本地文字的自定义姓名
**示例值**："李一一" custom_western_name | string | 否 | 西方文字的自定义姓名
**示例值**："YiyiLi" additional_name | string | 否 | 别名
**示例值**："别名" additional_name | name | 否 | 别名 full_name | string | 否 | 全名
**示例值**："李一一" first_name | string | 否 | 名
**示例值**："一" middle_name | string | 否 | 中间名
**示例值**："一" name_primary | string | 否 | 姓
**示例值**："李" local_first_name | string | 否 | 名 - 本地文字
**示例值**："一" local_middle_name | string | 否 | 本地中间名
**示例值**："一" local_primary | string | 否 | 姓 - 本地文字
**示例值**："李" country_region_id | string | 否 | 国家 / 地区
**示例值**："6862995757234914824" custom_local_name | string | 否 | 本地文字的自定义姓名
**示例值**："李一一" custom_western_name | string | 否 | 西方文字的自定义姓名
**示例值**："YiyiLi" additional_name | string | 否 | 别名
**示例值**："别名" resident_tax_list | resident_tax_for_update\[\] | 否 | 纳税身份信息 tax_country_region | string | 否 | 国家 / 地区ID，可以通过接口[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获得
**示例值**："6862995757234914824" resident_status | string | 否 | 居民身份，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name = resident_tax
- custom_api_name = resident_status
**示例值**："tax_residence" tax_address | address_for_update | 否 | 纳税地址 country_region_id | string | 是 | 国家 / 地区，可以通过接口[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获得
**示例值**："6862995757234914824" region_id | string | 否 | 主要行政区，可以通过接口[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)获得
**示例值**："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\[\] | 是 | 地址类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：- 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 | 否 | 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情
**示例值**："6863333254578046471" district_id_v2 | string | 否 | 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情
**示例值**："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 | 否 | 出生国家/地区，可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取
**示例值**："cn" 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 | 是 | 关系 ，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：dependent
- custom_api_name：relationship_with_dependent
**示例值**："parent" gender | string | 否 | 性别 ，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：person
- custom_api_name：gender
**示例值**："male" date_of_birth | string | 否 | 生日
**示例值**："2020-01-01" national_ids | national_id_for_update\[\] | 否 | 证件号码
**数据校验规则**：
- 长度范围：`1` ～ `1000` country_region_id | string | 是 | 国家/地区，可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取
**示例值**："6862995757234914824" national_id_type_id | string | 是 | 国家证件类型，可以通过[批量查询国家证件类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/national_id_type/list)接口获取
**示例值**："6863330041896371725" national_id_number | string | 是 | 证件号码
**示例值**："1231131333" issue_date | string | 否 | 证件签发日期，格式："YYYY-MM-DD"
**示例值**："2020-04-01" expiration_date | string | 否 | 证件到期日期，格式："YYYY-MM-DD"
**示例值**："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 | 否 | 配偶工作状态，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 是 | 手机区号，枚举值可查询[获取字段详情](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" phone_number | string | 是 | 电话号码
**示例值**："010-12345678" device_type | string | 是 | 设备类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：phone
- custom_api_name：device_type
**示例值**："mobile_phone" phone_usage | string | 是 | 电话用途，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- custom_api_name：phone_usage
- object_api_name：phone
**示例值**："home" is_primary | boolean | 是 | 主要电话，若有多个电话，只能有一个电话的「is_primary」为true
**示例值**：true is_public | boolean | 是 | 公开电话
**示例值**：true address | address_for_update | 否 | 联系地址 country_region_id | string | 是 | 国家/地区，可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取
**示例值**："6862995757234914824" region_id | string | 否 | 主要行政区，可以通过接口[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)获取
**示例值**："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\[\] | 是 | 地址类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- custom_api_name：address_type
- object_api_name：address
**示例值**：["home_address"]
**数据校验规则**：
- 长度范围：`1` ～ `1000` is_primary | boolean | 是 | 主要地址
**示例值**：true is_public | boolean | 是 | 公开地址
**示例值**：true city_id_v2 | string | 否 | 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情
**示例值**："6863333254578046471" district_id_v2 | string | 否 | 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情
**示例值**："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 | 否 | 宗教信仰，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 是 | 银行账号
**示例值**："62312xxxx0001223" account_holder | string | 是 | 开户人姓名
**示例值**："孟十五" country_region_id | string | 否 | 国家/地区，可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取
**示例值**："6862995745889322510" bank_account_usages | string\[\] | 否 | 银行卡用途，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- custom_api_name：bank_account_usage
- object_api_name：bank_account
**示例值**：["payment"]
**数据校验规则**：
- 长度范围：`0` ～ `100` bank_account_type | string | 否 | 银行卡类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- custom_api_name：bank_account_type
- object_api_name：bank_account
**示例值**："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 | 是 | 国家/地区，可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取
**示例值**："6862995757234914824" national_id_type_id | string | 是 | 国家证件类型，可以通过[批量查询国家证件类型](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/national_id_type/list)接口获取
**示例值**："6863330041896371725" national_id_number | string | 是 | 证件号码
**示例值**："12311xxxx31333" 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 | 否 | 资料类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：personal_profile
- custom_api_name：profile_type
**示例值**："profile_type_1_101_101011" files | file\[\] | 否 | 资料文件列表
**数据校验规则**：
- 长度范围：`0` ～ `1000` id | string | 否 | 上传文件ID，可以通过[上传文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/upload)接口获取
**示例值**："6655aa1b2ec326f983b91f9d_f9974583040c4b05ae71f92f5df16bbc" emergency_contact_list | emergency_contact_for_update\[\] | 否 | 紧急联系人 legal_name | string | 否 | 紧急联系人姓名
**示例值**："王冰" relationship | string | 否 | 紧急联系人与本人亲属关系，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：emergency_contact
- custom_api_name：relationship
**示例值**："parent" phones | phone_for_update\[\] | 否 | 电话
**数据校验规则**：
- 长度范围：`0` ～ `1000` international_area_code | string | 是 | 国际电话区号，枚举值可查询[获取字段详情](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" phone_number | string | 是 | 电话号码
**示例值**："010-12345678" device_type | string | 是 | 设备类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：phone
- custom_api_name：device_type
**示例值**："mobile_phone" phone_usage | string | 是 | 电话用途，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 是 | 国家 / 地区，可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取
**示例值**："6862995757234914824" region_id | string | 否 | 主要行政区，可以通过[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取
**示例值**："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\[\] | 是 | 地址类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 否 | 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情
**示例值**："6863333254578046471" district_id_v2 | string | 否 | 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情
**示例值**："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 | 是 | 邮箱用途，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 是 | 国家 / 地区，可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取
**示例值**："6862995757234914824" region_id | string | 否 | 主要行政区，可以通过[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取
**示例值**："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\[\] | 是 | 地址类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 否 | 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情
**示例值**："6863333254578046471" district_id_v2 | string | 否 | 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情
**示例值**："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 | 否 | 婚姻状况，枚举值可查询[获取字段详情](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" ethnicity_race | string | 否 | 民族 / 种族，枚举值可查询[获取字段详情](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" native_region | string | 否 | 籍贯，可以通过[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取
**示例值**："6822114062122064111" hukou_type | string | 否 | 户口类型，枚举值可查询[获取字段详情](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" hukou_location | string | 否 | 户口所在地
**示例值**："北京市海淀区北三环西路" custom_fields | object_field_data\[\] | 否 | person对象上的自定义字段，可以通过[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)接口获得 field_name | string | 是 | 字段名
**示例值**："custom_field_1__c" value | string | 是 | 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05])
**示例值**："Sandy" expected_graduate_date | string | 否 | 预计毕业日期
**示例值**："2023-01-10" political_affiliation | string | 否 | 政治面貌，枚举值可查询[获取字段详情](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
**示例值**："public" offer_info | offer_info | 是 | 职位信息 offer_id | string | 否 | Offer ID，仅支持飞书招聘 ID，可以通过飞书招聘[获取Offer列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/offer/list)接口获取，如果未使用飞书招聘请置空
**示例值**："7032210902531327521" offer | string | 否 | Offer id查找类型ID
**示例值**："7032210902531327521" offer_hr_id | string | 否 | Offer HR 雇佣 ID，可以通过[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口获取
**示例值**："7032210902531327521" department_id | string | 否 | 部门 ID，可以通过[批量查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)接口获取
**示例值**："7147562782945478177" direct_leader_id | string | 否 | 直属领导的雇佣 ID，可以通过[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口获取
**示例值**："7032210902531327521" dotted_line_manager_id | string | 否 | 虚线上级ID，可以通过[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口获取
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
**示例值**："7032210902531327521" job_id | string | 否 | 职务 ID，可以通过[批量查询职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)接口获取
**示例值**："6977976735715378724" job_family_id | string | 否 | 序列 ID，可以通过[批量查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)接口获取
**示例值**："6977972856625939999" job_level_id | string | 否 | 职级 ID，可以通过[批量查询职级](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)接口获取
**示例值**："6977971894960145950" job_title | string | 否 | 职务头衔（待废弃）
**示例值**："java" 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" duration_period | number(float) | 否 | 合同期限时长
**示例值**：3 duration_unit | string | 否 | 合同期限单位，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name = pre_hire
- custom_api_name = duration_unit
**示例值**："year" onboarding_date | string | 否 | 入职日期，格式："YYYY-MM-DD"
**示例值**："2022-10-08" onboarding_location_id | string | 否 | 入职地点 ID，可以通过[批量查询地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)接口获取
**示例值**："6977976687350924832" office_location_id | string | 否 | 办公地点 ID，可以通过[批量查询地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)接口获取
**示例值**："6977976687350924832" recruitment_type_id | string | 否 | 招聘来源，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：pre_hire
- custom_api_name：recruitment_type
**示例值**："experienced_professionals" probation_period | string | 否 | 试用期时长（单位：月）
**示例值**："6" employee_type_id | string | 否 | 人员类型 ID，可以通过接口[批量查询人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取
**示例值**："6977973225846343171" employee_subtype_id | string | 否 | 人员子类型id
**示例值**："6977973225846343171" employment_type_id | string | 否 | 雇佣类型，请注意该字段为必填，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：pre_hire
- custom_api_name：employment_type
**示例值**："employee" work_email | string | 否 | 工作邮箱
**示例值**："joshua@bytedance.com" duration_type_id | string | 否 | 期限类型， 枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：pre_hire
- custom_api_name：duration_type
**示例值**："fixed_term" signing_type_id | string | 否 | 签订类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：pre_hire
- custom_api_name：signing_type
**示例值**："new" entry_mode | string | 否 | 入职方式，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：pre_hire
- custom_api_name：onboarding_method
**示例值**："onsite" social_security_city_id | string | 否 | 社保城市 ID，可以通过[批量查询地点](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)接口获取
**示例值**："6977976687350924833" contract_type | string | 否 | 合同类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：pre_hire
- custom_api_name：contract_type
**示例值**："internship_agreement" company | string | 否 | 公司 ID，可以通过[批量查询公司](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)接口获取
**示例值**："6738317738688661772" cost_center_rate | job_data_cost_center\[\] | 否 | 成本中心分摊信息
- 待废弃，建议使用cost_allocation cost_center_id | string | 否 | 成本中心 ID，可以通过[搜索成本中心信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口获取
**示例值**："6950635856373745165" rate | int | 否 | 分摊比例（%），大于0小于等于100的正整数
**示例值**：100 new_rate | number(float) | 否 | 分摊比例（%）
**示例值**：50.2 job_grade_id | string | 否 | 职等ID，可以通过[查询职等](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)接口获取
**示例值**："6738317738688661772" custom_fields | object_field_data\[\] | 否 | pre_hire对象上的自定义字段，可以通过[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)接口获得 field_name | string | 是 | 字段名
**示例值**："name" value | string | 是 | 字段值，请转换为字符串数组的方式写入
**示例值**："[\"Sandy\"]" service_company | string | 否 | 任职公司，可以通过[批量查询公司](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)接口获取
**示例值**："6738317738688661772" work_shift | string | 否 | 排班，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：pre_hire
- custom_api_name：work_shift
**示例值**："work_shift" compensation_type | string | 否 | 薪资类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：pre_hire
- custom_api_name：compensation_type
**示例值**："hourly" work_location_id | string | 否 | 工作地点ID，可以通过[批量查询地点](https://open.larkoffice.com/document/server-docs/corehr-v1/organization-management/location/list)接口获取
**示例值**："6977976687350924833" onboarding_address_id | string | 否 | 入职地址ID，可以通过[批量查询地点](https://open.larkoffice.com/document/server-docs/corehr-v1/organization-management/location/list)接口获取
**示例值**："6977976687350924833" office_address_id | string | 否 | 办公地址ID，，可以通过[批量查询地点](https://open.larkoffice.com/document/server-docs/corehr-v1/organization-management/location/list)接口获取
**示例值**："6977976687350924833" position_id | string | 否 | 岗位ID
**示例值**："6977976687350924833" working_calendar_id | string | 否 | 工作日历ID
**示例值**："6977976687350924833" working_hours_type | string | 否 | 工时制度，可以通过[批量查询工时制度](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)接口获得
**示例值**："6890452208593372679" pay_group_id | string | 否 | 薪资组
**示例值**："6977976687350924833" flow_id | string | 否 | 入职流程ID
**示例值**："64377642c0ec3f23c79c6916" check_in_time | string | 否 | 签到日期，格式："YYYY-MM-DD"
**示例值**："2024-12-31" check_in_method | string | 否 | 签到方式，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：pre_hire
- custom_api_name：onboarding_method
**示例值**："onsite" seniority_date | string | 否 | 司龄起算日期
**示例值**："2024-08-01" seniority_adjust_information_list | prehire_seniority_adjust_information\[\] | 否 | 司龄调整信息
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) seniority_adjustment | number(float) | 否 | 调整值
- 精确度：两位小数
- 单位：年
- 自动计算逻辑：如果这个值为空，司龄调整的开始日期和结束日期均不为空，会自动计算出调整值
**示例值**：0.5
**数据校验规则**：
- 取值范围：`0` ～ `100` seniority_adjustment_type | string | 是 | 调整类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 否 | 试用期内通知期（主动离职)
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
**示例值**：xxx wk_id | string | 否 | ID
**示例值**："4698019107896524633" value | int | 否 | 数值
**示例值**：1
**数据校验规则**：
- 取值范围：`1` ～ `65535` value_unit | string | 否 | 单位
**示例值**："月" notice_period_probation_involuntary | notice_period_detail | 否 | 试用期内通知期（被动离职）
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
**示例值**：xxx wk_id | string | 否 | ID
**示例值**："4698019107896524633" value | int | 否 | 数值
**示例值**：1
**数据校验规则**：
- 取值范围：`1` ～ `65535` value_unit | string | 否 | 单位
**示例值**："月" notice_period_positive_voluntary | notice_period_detail | 否 | 转正后通知期（主动离职）
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
**示例值**：xxx wk_id | string | 否 | ID
**示例值**："4698019107896524633" value | int | 否 | 数值
**示例值**：1
**数据校验规则**：
- 取值范围：`1` ～ `65535` value_unit | string | 否 | 单位
**示例值**："月" notice_period_positive_involuntary | notice_period_detail | 否 | 转正后通知期（被动离职）
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
**示例值**：xxx wk_id | string | 否 | ID
**示例值**："4698019107896524633" value | int | 否 | 数值
**示例值**：1
**数据校验规则**：
- 取值范围：`1` ～ `65535` value_unit | string | 否 | 单位
**示例值**："月" condition_worker | boolean | 否 | 是否外部人员
**示例值**：true non_compete_covenant | boolean | 否 | 是否包含竞业条款
**示例值**：true company_sponsored_visa | boolean | 否 | 需要公司办理签证
**示例值**：true work_station | string | 否 | 工位
**示例值**："5-1-2" pathway | string | 否 | 通道
**示例值**："7460865381179115052" default_cost_center | prehire_default_cost_center_update | 否 | 默认成本中心
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) cost_center_id | string | 是 | 成本中心 ID，可以通过[搜索成本中心信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口获取
**示例值**："6950635856373745165" is_herit | boolean | 是 | 是否继承岗位/部门的默认成本中心
**示例值**：false cost_allocation | cost_allocation | 否 | 成本分摊
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) 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，可以通过[搜索成本中心信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search)接口获取
**示例值**："6950635856373745165" rate | int | 否 | 分摊比例(整数)
**示例值**：100 new_rate | number(float) | 否 | 分摊比例
**示例值**：50.2 talent_id | string | 否 | 人才ID，仅支持飞书招聘人才 ID，可以通过飞书招聘[获取人才列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/list)接口获取，如果未使用飞书招聘请置空
**示例值**："8234698927348" reuse_feishu_account | string | 否 | 是否复用飞书账号，支持传入“reuse”或者“not_reuse”，当字段为“reuse”时，需要传入reused_feishu_account_id
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
**示例值**："reuse" reused_feishu_account_id | string | 否 | 复用的飞书账号，仅支持Lark Union ID，可以通过[搜索员工信息
](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/directory-v1/employee/search)接口获取
- 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
**示例值**："on_773dd2c4d14c5c980a4d89a2da5c86d3" education_info | education_info\[\] | 否 | 教育经历 school_name | string | 否 | 学校名称
**示例值**："长安大学" education | string | 否 | 学历，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：education
- custom_api_name：level_of_education
**示例值**："phd" start_time | string | 否 | 开始时间，格式："YYYY-MM-DD"
**示例值**："2017-04-01" end_time | string | 否 | 结束时间，格式："YYYY-MM-DD"
**示例值**："2018-04-01" field_of_study | 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" degree | string | 否 | 学位，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- object_api_name：education
- custom_api_name：degree
**示例值**："phd" work_experience | work_experience\[\] | 否 | 工作经历 company_name | string | 否 | 公司名称
**示例值**："猎豹" start_time | string | 否 | 开始时间，格式："YYYY-MM-DD"
**示例值**："2015-02-01" end_time | string | 否 | 结束时间，格式："YYYY-MM-DD"
**示例值**："2017-02-01" job_title | string | 否 | 岗位
**示例值**："产品经理" description | string | 否 | 工作描述
**示例值**："负责岗位日常工作，遵守公司制度，确保工作按时保质完成" department | 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" ats_application_id | string | 否 | 招聘应用 ID，仅支持飞书招聘 ID，可以通过[获取投递列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list)接口获取
**示例值**："7140946969586010376" application | string | 否 | 查找类型招聘应用ID
**示例值**："7140946969586010376" out_biz_id | string | 否 | 外部业务唯一编码，用于支持幂等创建
- 外部接入方需要保证id的唯一，相同id最多唯一对应一个待入职数据
- 如果id对应的待入职数据已经存在，执行创建操作则直接返回待入职id，且不会更新本次传入的数据到待入职
**示例值**："7140946969586010376" ### 请求体示例 ```json { "basic_info": { "name": { "full_name": "李一一", "first_name": "一", "middle_name": "一", "name_primary": "李", "local_first_name": "一", "local_middle_name": "一", "local_primary": "李" }, "phone_number": "138xxxx1234", "international_area_code": "86_china", "email": "xxxx@bytedance.com", "date_of_birth": "2011-09-09", "personal_id_number": "311xxxx23127", "date_entered_workforce": "2100-09-09", "gender_id": "male", "nationality_id": "6862995xxxx34914824", "home_address": "home addr", "worker_id": "6862995757234914824" }, "offer_info": { "offer_id": "7032210902531327521", "offer_hr_id": "7032210902531327521", "department_id": "7147562782945478177", "direct_leader_id": "7032210902531327521", "job_id": "6977976735715378724", "job_family_id": "6977972856625939999", "job_level_id": "6977971894960145950", "job_title": "java", "probation_start_date": "2022-07-29", "probation_end_date": "2023-04-07", "contract_start_date": "2022-10-08", "contract_end_date": "2025-10-07", "onboarding_date": "2022-10-08", "onboarding_location_id": "6977976687350924832", "office_location_id": "6977976687350924832", "recruitment_type_id": "experienced_professionals", "probation_period": "6", "employee_type_id": "6977973225846343171", "employment_type_id": "6977973225846343171", "work_email": "xxxx@bytedance.com", "duration_type_id": "6977973225846343171", "signing_type_id": "6738317738688661772", "entry_mode": "1", "social_security_city_id": "xxx", "contract_type": "6738317738688661772", "company": "6738317738688661772", "custom_fields": [ { "field_name": "name", "value": "Sandy" } ] }, "education_info": [ { "school_name": "长安大学", "education": "phd", "start_time": "2017-04-01", "end_time": "2018-04-01", "field_of_study": "医学影像技术" } ], "work_experience": [ { "company_name": "猎豹", "start_time": "2015-02-01", "end_time": "2017-02-01", "job_title": "产品经理", "description": "app" } ], "ats_application_id": "7140946969586010376", "out_biz_id": "7140946969586010376" } ``` ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | \- | \- pre_hire_id | string | 待入职 ID ### 响应体示例 ```json { "code": 0, "msg": "success", "data": { "pre_hire_id": "6966234786251671053" } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 500 | 1161000 | 系统错误 | 系统出现问题，如需帮助，请咨询[技术支持](https://applink.feishu.cn/TLJpeNdW)。 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 | 1161081 | 数据驻留地无效 | 请填写有效的数据驻留地 400 | 1161092 | 异常信息检查失败 | 异常信息检查失败 400 | 1161109 | 职等失效 | 请填写有效的职等 400 | 1161110 | 职等和职级不匹配 | 职等和职级不匹配 400 | 1161111 | 流程无效 | 请填写有效的流程 400 | 1161112 | 部门使用岗位，岗位需必填 | 部门使用岗位，岗位需必填 400 | 1161113 | 岗位不匹配 | 「部门、直属上级、虚线上级、职务、序列、职级、职等、工作地点、工时制度、人员类型」中存在与所选岗位不匹配的信息，请重新选择 400 | 1161114 | 岗位在入职日期及其之后不存在 | 岗位在入职日期及其之后不存在 400 | 1161115 | 岗位在入职日期及其之后存在停用版本 | 岗位在入职日期及其之后存在停用版本 400 | 1161118 | 工作邮箱与飞书企业邮箱中已存在的邮箱重复 | 工作邮箱与飞书企业邮箱中已存在的邮箱重复 400 | 1161119 | 工作邮箱与系统中的离职人员重复，可在飞书企业邮箱回收站中查看此邮箱 | 工作邮箱与系统中的离职人员重复，可在飞书企业邮箱回收站中查看此邮箱 400 | 1161120 | 暂无被操作人工作邮箱编辑权限，可在「飞书管理后台」的飞书人事应用管理界面，找到应用权限以修改通讯录设置 | 暂无被操作人工作邮箱编辑权限，可在「飞书管理后台」的飞书人事应用管理界面，找到应用权限以修改通讯录设置 400 | 1161121 | 「工作邮箱」格式不正确，字母需为小写 | 「工作邮箱」格式不正确，字母需为小写 400 | 1161122 | 「工作邮箱」格式不正确，存在特殊字符 | 「工作邮箱」格式不正确，存在特殊字符 400 | 1161123 | 「工作邮箱」格式不正确 | 「工作邮箱」格式不正确 400 | 1161124 | 「工作邮箱」格式不正确，总长度需小于等于 20 位 | 「工作邮箱」格式不正确，总长度需小于等于 20 位 400 | 1161125 | 「工作邮箱」在账号 LDAP 已存在 | 「工作邮箱」在账号 LDAP 已存在 400 | 1161126 | 邮箱前缀包含敏感词 | 邮箱前缀包含敏感词 400 | 1161127 | 与系统中已存在的邮箱重复 | 与系统中已存在的邮箱重复 400 | 1161131 | 手机号为空 | 手机号为空 400 | 1161142 | Notice period is invalid | 你已填写默认成本中心（手动选择），“是否继承岗位/部门的默认成本中心”必须为空或者“否” 400 | 1161143 | Notice period is invalid with not editable condition | 是否继承岗位/部门的默认成本中心”填写为否，请补充默认成本中心（手动选择） 400 | 1161144 | Notice period rule not match | 入职日期缺失，无法补充默认成本中心或者成本分摊的生效日期 400 | 1161145 | 你已填写默认成本中心（手动选择），“是否继承岗位/部门的默认成本中心”必须为空或者“否” | 部门/岗位上的默认成本中心为空，无法继承 400 | 1161146 | 是否继承岗位/部门的默认成本中心”填写为否，请补充默认成本中心（手动选择） | 成本分摊中的成本中心和分摊比例需填写完整 400 | 1161147 | 入职日期缺失，无法补充默认成本中心或者成本分摊的生效日期 | 入职日期缺失，无法补充默认成本中心或者成本分摊的生效日期 400 | 1161148 | 部门/岗位上的默认成本中心为空，无法继承 | 部门/岗位上的默认成本中心为空，无法继承 400 | 1161149 | 成本分摊中的成本中心和分摊比例需填写完整 | 成本分摊中的成本中心和分摊比例需填写完整 400 | 1161150 | offer_id与offer查找字段不匹配 | offer_id与offer查找字段不匹配 400 | 1161151 | ats_application_id与application查找字段不匹配 | ats_application_id与application查找字段不匹配 400 | 1161152 | offer查找字段有值时offer_id (text) 必填 | offer查找字段有值时offer_id (text) 必填 400 | 1161153 | application查找字段有值时ats_application_id (text)必填 | application查找字段有值时ats_application_id (text)必填 400 | 1161160 | 部门在入职日期时可能不存在或无效 | 部门在入职日期时可能不存在或无效 400 | 1161161 | 岗位在入职日期时可能不存在或无效 | 岗位在入职日期时可能不存在或无效