添加人员

支持在单个接口中进行人员全信息添加，包括人员的基本信息，雇佣信息，入职任职记录及其他分组信息

Tip: - 此接口参数校验规则与【人事系统-人员档案配置】的校验规则一致，字段是否必填以【人事系统-人员档案配置】为准。建议参照【飞书人事-我的团队-添加人员】页面来传参
若开启工号自动编码规则则无需输入人员“工号”，系统将自动进行工号生成；若手动输入工号，则会按照手动输入工号内容进行人员档案建立

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/employees
HTTP Method	POST
接口频率限制	20 次/分钟
支持的应用类型	custom,isv
权限要求调用该 API 所需的权限。开启其中任意一项权限即可调用	`corehr:employee.add:write` 添加人员

请求头

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

查询参数

名称	类型	必填	描述
`client_token`	`string`	否	操作的唯一标识，用于幂等的进行更新操作，格式为标准的 UUIDV4。此值为空表示将发起一次新的请求，此值非空表示幂等的进行更新操作。示例值：fe599b60-450f-46ff-b2ef-9f6675625b97 数据校验规则： - 长度范围：`1` ～ `100` 字符
`rehire`	`boolean`	否	是否为离职重聘 - false：系统直接标为非离职重聘人员，不再做重复判断 - true：要求 rehire_employment_id 示例值：true
`rehire_employment_id`	`string`	否	离职重聘员工雇佣 ID 可通过【搜索员工信息】接口获取示例值：7140964208476371111
`force_submit`	`boolean`	否	是否强制提交 - true：是，跳过超编等校验 - false：否，被拦截报错示例值：false 默认值：`false`
`ignore_working_hours_type_rule`	`boolean`	否	是否忽略工时制度自动生成规则 - 值为 false 时，以下字段必填： - emp_contract_record.first_party - employment_record.work_location - employment_record.employee_type - employment_record.job_family - employment_record.job - employment_record.job_level - employment_record.department 示例值：true 默认值：`false`

请求体

名称	类型	必填	描述
`personal_info`	`profile_setting_personal_info`	否	个人信息
└ `personal_basic_info`	`profile_setting_personal_basic_info`	否	基本信息
└ `legal_name`	`profile_setting_name`	否	法定姓名。 - 【飞书人事姓名填写规则】
└ `additional_name_type`	`string`	否	补充姓名类型枚举值可以通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person_name" - custom_api_name = "additional_name_type" 示例值："emergency_contact_name"
└ `country_region`	`string`	否	国家 / 地区 ID 如果填写了法定姓名对象，则该字段必填可通过【查询国家/地区信息】接口获取示例值："6862995757234914824"
└ `full_name`	`string`	否	全名示例值："王大帅"
└ `hereditary`	`string`	否	姓氏称谓示例值："王"
└ `middle_name`	`string`	否	中间名示例值："大"
└ `secondary`	`string`	否	第二姓氏示例值："王"
└ `social`	`string`	否	尊称枚举值可以通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person_name" - custom_api_name = "social" 示例值："ii"
└ `tertiary`	`string`	否	婚后姓氏示例值："王"
└ `local_first_name_2`	`string`	否	名 - 第二本地文字示例值："五"
└ `local_middle_name`	`string`	否	本地中间名示例值："大"
└ `local_primary`	`string`	否	姓 - 本地文字示例值："黄"
└ `local_primary_2`	`string`	否	姓 - 第二本地文字示例值："王"
└ `local_secondary`	`string`	否	第二姓氏 - 本地文字示例值："王"
└ `title`	`string`	否	头衔枚举值可以通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person_name" - custom_api_name = "title" 示例值："Mr"
└ `local_first_name`	`string`	否	名 - 本地文字示例值："四"
└ `custom_local_name`	`string`	否	自定义姓名（本地文字）示例值："王大帅"
└ `custom_western_name`	`string`	否	自定义姓名（西方文字）示例值："王大帅"
└ `first_name`	`string`	否	名示例值："帅"
└ `name_primary`	`string`	否	姓示例值："王"
└ `preferred_name`	`profile_setting_name`	否	常用姓名。 - 【飞书人事姓名填写规则】
└ `additional_name_type`	`string`	否	补充姓名类型枚举值可以通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person_name" - custom_api_name = "additional_name_type" 示例值："emergency_contact_name"
└ `country_region`	`string`	否	国家 / 地区 ID 如果填写了常用姓名对象，则该字段必填可通过【查询国家/地区信息】接口获取示例值："6862995757234914824"
└ `full_name`	`string`	否	全名示例值："王大帅"
└ `hereditary`	`string`	否	姓氏称谓示例值："王"
└ `middle_name`	`string`	否	中间名示例值："大"
└ `secondary`	`string`	否	第二姓氏示例值："王"
└ `social`	`string`	否	尊称枚举值可以通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person_name" - custom_api_name = "social" 示例值："ii"
└ `tertiary`	`string`	否	婚后姓氏示例值："王"
└ `local_first_name_2`	`string`	否	名 - 第二本地文字示例值："五"
└ `local_middle_name`	`string`	否	本地中间名示例值："大"
└ `local_primary`	`string`	否	姓 - 本地文字示例值："黄"
└ `local_primary_2`	`string`	否	姓 - 第二本地文字示例值："王"
└ `local_secondary`	`string`	否	第二姓氏 - 本地文字示例值："王"
└ `title`	`string`	否	头衔枚举值可以通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person_name" - custom_api_name = "title" 示例值："mr"
└ `local_first_name`	`string`	否	名 - 本地文字示例值："四"
└ `custom_local_name`	`string`	否	自定义姓名（本地文字）示例值："王大帅"
└ `custom_western_name`	`string`	否	自定义姓名（西方文字）示例值："王大帅"
└ `first_name`	`string`	否	名示例值："帅"
└ `name_primary`	`string`	否	姓示例值："王"
└ `additional_name`	`string`	否	别名示例值："王帅"
└ `gender`	`string`	否	性别枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person" - custom_api_name = "gender" 示例值："female"
└ `nationality_v2`	`string`	否	国籍 ID 可通过【查询国籍信息】接口获取示例值："6862995757234914826"
└ `ethnicity_race`	`string`	否	民族 / 种族枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person" - custom_api_name = "ethnicity_race" 示例值："han"
└ `phone`	`profile_setting_phone`	否	个人电话
└ `international_area_code`	`string`	否	国际电话区号枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "phone" - custom_api_name = "international_area_code" 示例值："86_china"
└ `phone_number`	`string`	否	电话号码如果填写了个人电话对象，则该字段必填示例值："13000000000"
└ `email`	`string`	否	个人邮箱示例值："1234567@example.feishu.cn"
└ `date_of_birth`	`string`	否	出生日期示例值："2006-01-02"
└ `marital_status`	`string`	否	婚姻状况枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person" - custom_api_name = "marital_status" 示例值："married"
└ `is_disabled`	`boolean`	否	是否残疾示例值：false
└ `disable_card_number`	`string`	否	残疾证号 is_disabled 为 true 时必填示例值："92838277746172888312"
└ `is_martyr_family`	`boolean`	否	是否为烈属示例值：false
└ `martyr_card_number`	`string`	否	烈属证号 is_martyr_family 为 true 时必填示例值："00001"
└ `is_old_alone`	`boolean`	否	是否为孤老示例值：false
└ `born_country_region`	`string`	否	出生国家/地区示例值："6862995757234914825"
└ `political_affiliation`	`string`	否	政治面貌枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person_info_chn" - custom_api_name = "political_affiliation" 示例值："other"
└ `native_region`	`string`	否	籍贯（省份/行政区 ID）可通过【查询省份/行政区信息】接口获取示例值："6862995757234914827"
└ `date_entered_workforce`	`string`	否	参加工作日期示例值："2006-01-02"
└ `first_entry_time`	`string`	否	首次入境日期示例值："2006-01-02"
└ `leave_time`	`string`	否	预计离境日期示例值："2006-01-02"
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `additional_nationalities`	`string\[\]`	否	其他国籍（地区）ID 示例值：["6862995757234914827"]
└ `emergency_contacts`	`profile_setting_emergency_contact\[\]`	否	紧急联系人数据校验规则： - 长度范围：`0` ～ `100`
└ `legal_name`	`string`	否	姓名示例值："王大帅"
└ `relationship`	`string`	否	关系枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "emergency_contact" - custom_api_name = "relationship" 示例值："parent"
└ `is_primary`	`boolean`	否	主要联系人示例值：true
└ `phone`	`profile_setting_phone`	否	电话
└ `international_area_code`	`string`	否	国际电话区号枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "phone" - custom_api_name = "international_area_code" 示例值："86_china"
└ `phone_number`	`string`	否	电话号码如果填写了电话对象，则该字段必填示例值："13000000000"
└ `email`	`string`	否	邮箱示例值："1234567@example.feishu.cn"
└ `address`	`profile_setting_address`	否	地址
└ `address_type`	`string`	否	地址类型枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "address" - custom_api_name = "address_type" 示例值："home_address"
└ `country_region`	`string`	否	国家 / 地区 ID 如果填写了地址对象，则该字段必填可通过【查询国家/地区信息】接口获取示例值："6862995757234914824"
└ `region`	`string`	否	主要行政区 ID 可通过【查询省份/行政区信息】接口获取示例值："6863326815667095047"
└ `region_subdivision_1`	`string`	否	主要行政区往下细分 1 层的行政区示例值："行政区1"
└ `region_subdivision_2`	`string`	否	主要行政区往下细分 2 层的行政区示例值："行政区2"
└ `city_v2`	`string`	否	城市V2 ID 可通过【查询城市信息】接口获取示例值："6862995757234914829"
└ `city_text`	`string`	否	城市（文本）示例值："北京市"
└ `local_city_text`	`string`	否	城市（仅文本，非拉丁语系的本地文字）示例值："北京市"
└ `city_subdivision_1`	`string`	否	城市往下细分 1 层的行政区示例值："行政区 1"
└ `city_subdivision_2`	`string`	否	城市往下细分 2 层的行政区示例值："行政区 2"
└ `district_v2`	`string`	否	区/县 V2 ID 可通过【查询区/县信息】接口获取示例值："6862995757234914831"
└ `postal_code`	`string`	否	邮政编码示例值："611530"
└ `address_line_1`	`string`	否	地址行 1 如果填写了地址对象，则该字段必填示例值："丹佛测试地址 - 纽埃时区"
└ `local_address_line_1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："丹佛测试地址 - 纽埃时区"
└ `address_line_2`	`string`	否	地址行 2 示例值："PoewH"
└ `local_address_line_2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："PoewH"
└ `address_line_3`	`string`	否	地址行 3 示例值："PoewH"
└ `local_address_line_3`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："PoewH"
└ `address_line_4`	`string`	否	地址行 4 示例值："jmwJc"
└ `local_address_line_5`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_6`	`string`	否	地址行 6 示例值："jmwJc"
└ `local_address_line_6`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_7`	`string`	否	地址行 7 示例值："jmwJc"
└ `local_address_line_7`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_8`	`string`	否	地址行 8 示例值："jmwJc"
└ `local_address_line_8`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："rafSu"
└ `address_line_9`	`string`	否	地址行 9 示例值："McPRG"
└ `local_address_line_9`	`string`	否	地址行 9（非拉丁语系的本地文字）示例值："McPRG"
└ `local_address_line_4`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_5`	`string`	否	地址行 5 示例值："jmwJc"
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `bank_accounts`	`profile_setting_bank_account\[\]`	否	银行账户数据校验规则： - 长度范围：`0` ～ `100`
└ `country_region`	`string`	否	国家 / 地区 ID 可通过【查询国家/地区信息】接口获取示例值："6862995757234914824"
└ `bank_name`	`string`	否	银行名称示例值："中国农业银行"
└ `branch_name`	`string`	否	支行名称示例值："中国农业银行支行"
└ `account_holder`	`string`	否	开户人姓名如果填写了银行账号对象，则该字段必填示例值："孟十五"
└ `bank_account_number`	`string`	否	银行账号如果填写了银行账号对象，则该字段必填示例值："6231200000001223"
└ `bank_account_usages`	`string\[\]`	否	银行卡用途枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "bank_account" - custom_api_name = "bank_account_usage" 示例值：["payment"] 数据校验规则： - 长度范围：`1` ～ `100`
└ `bank_account_type`	`string`	否	银行卡类型枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "bank_account" - custom_api_name = "bank_account_type" 示例值："savings"
└ `bank_id`	`string`	否	银行 ID 可通过【查询银行信息】接口获取示例值："6862995757234914832"
└ `branch_id`	`string`	否	银行支行 ID 可通过【查询支行信息】接口获取示例值："6862995757234914833"
└ `payment_type`	`string`	否	分配方式，枚举值示例值："percent,balance,amount" 可选值有： - `percent`: 按比例分配 - `amount`: 按金额分配 - `balance`: 默认卡
└ `payment_rate`	`string`	否	分配比例，0～100，保留两位小数示例值："80.28"
└ `payment_amount`	`string`	否	分配金额，保留两位小数示例值："5000"
└ `priority`	`string`	否	优先级，不能低于0 示例值："1"
└ `nationals`	`profile_setting_national\[\]`	否	证件数据校验规则： - 长度范围：`0` ～ `100`
└ `country_region`	`string`	否	国家 / 地区 ID 如果填写了证件对象，则该字段必填可通过【查询国家/地区信息】接口获取示例值："6862995757234914824"
└ `national_id_type`	`string`	否	国家证件类型 ID 如果填写了证件对象，则该字段必填可通过【批量查询国家证件类型】接口获取示例值："6863330041896371725"
└ `national_id_number`	`string`	否	证件号码如果填写了证件对象，则该字段必填示例值："1231131333"
└ `issued_date`	`string`	否	证件签发日期示例值："2020-04-01"
└ `issued_by`	`string`	否	证件签发机构示例值："北京市公安局"
└ `expiration_date`	`string`	否	证件到期日期示例值："2020-05-21"
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `resident_taxes`	`profile_setting_resident_tax\[\]`	否	居民身份信息数据校验规则： - 长度范围：`0` ～ `100`
└ `year_resident_tax`	`string`	否	年度如果填写了居民身份信息对象，则该字段必填示例值："2006-01-02"
└ `tax_country_region`	`string`	否	国家 / 地区 ID 如果填写了居民身份信息对象，则该字段必填可通过【查询国家/地区信息】接口获取示例值："6862995757234914824"
└ `resident_status`	`string`	否	居民身份枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "resident_tax" - custom_api_name = "resident_status" 示例值："tax_residence"
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `dependents`	`profile_setting_dependent\[\]`	否	家庭成员数据校验规则： - 长度范围：`0` ～ `100`
└ `legal_name`	`string`	否	姓名示例值："王大帅"
└ `date_of_birth`	`string`	否	生日示例值："2006-01-02"
└ `relationship_with_dependent`	`string`	否	关系如果填写了家庭成员对象，则该字段必填枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "dependent" - custom_api_name ="relationship_with_dependent" 示例值："parent"
└ `gender`	`string`	否	性别枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "dependent" - custom_api_name = "gender" 示例值："female"
└ `phone`	`profile_setting_phone`	否	电话
└ `international_area_code`	`string`	否	国际电话区号枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "phone" - custom_api_name = "international_area_code" 示例值："86_china"
└ `phone_number`	`string`	否	电话号码示例值："13000000000"
└ `job`	`string`	否	岗位示例值："岗位"
└ `child_birth_certificates`	`profile_setting_file\[\]`	否	出生证明数据校验规则： - 长度范围：`0` ～ `100`
└ `file_id`	`string`	否	文件 ID - 可通过【上传文件】接口获取 - 只传该字段即可，大小、类型等字段可以不传递示例值："150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
└ `mime_type`	`string`	否	文件 MIME 类型示例值："zip"
└ `name`	`string`	否	文件名示例值："附件.zip"
└ `size`	`string`	否	文件大小（KB）示例值："1000"
└ `token`	`string`	否	文件 Token 示例值："0a423bc7ea7c4a439d066bf070616782"
└ `employer`	`string`	否	工作单位示例值："飞书"
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `address`	`profile_setting_address`	否	联系地址
└ `address_type`	`string`	否	地址类型枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "address" - custom_api_name = "address_type" 示例值："home_address"
└ `country_region`	`string`	否	国家 / 地区 ID 可通过【查询国家/地区信息】接口获取示例值："6862995757234914824"
└ `region`	`string`	否	主要行政区 ID 可通过【查询省份/行政区信息】接口获取示例值："6863326815667095047"
└ `region_subdivision_1`	`string`	否	主要行政区往下细分 1 层的行政区示例值："行政区 1"
└ `region_subdivision_2`	`string`	否	主要行政区往下细分 2 层的行政区示例值："行政区 2"
└ `city_v2`	`string`	否	城市 V2 ID 可通过【查询城市信息】接口获取示例值："6862995757234914829"
└ `city_text`	`string`	否	城市（文本）示例值："北京市"
└ `local_city_text`	`string`	否	城市（仅文本，非拉丁语系的本地文字）示例值："北京市"
└ `city_subdivision_1`	`string`	否	城市往下细分 1 层的行政区示例值："行政区 1"
└ `city_subdivision_2`	`string`	否	城市往下细分 2 层的行政区示例值："行政区 2"
└ `district_v2`	`string`	否	区/县 V2 ID 可通过【查询区/县信息】接口获取示例值："6862995757234914831"
└ `postal_code`	`string`	否	邮政编码示例值："611530"
└ `address_line_1`	`string`	否	地址行 1 示例值："丹佛测试地址 - 纽埃时区"
└ `local_address_line_1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："丹佛测试地址 - 纽埃时区"
└ `address_line_2`	`string`	否	地址行 2 示例值："PoewH"
└ `local_address_line_2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："PoewH"
└ `address_line_3`	`string`	否	地址行 3 示例值："PoewH"
└ `local_address_line_3`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："PoewH"
└ `address_line_4`	`string`	否	地址行 4 示例值："jmwJc"
└ `local_address_line_5`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_6`	`string`	否	地址行 6 示例值："jmwJc"
└ `local_address_line_6`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_7`	`string`	否	地址行 7 示例值："jmwJc"
└ `local_address_line_7`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_8`	`string`	否	地址行 8 示例值："jmwJc"
└ `local_address_line_8`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："rafSu"
└ `address_line_9`	`string`	否	地址行 9 示例值："McPRG"
└ `local_address_line_9`	`string`	否	地址行 9（非拉丁语系的本地文字）示例值："McPRG"
└ `local_address_line_4`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_5`	`string`	否	地址行 5 示例值："jmwJc"
└ `hukou`	`profile_setting_hukou`	否	户口
└ `hukou_type`	`string`	否	户口类型枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "person_info_chn" - custom_api_name = "hukou_type" 示例值："local_urban_residence"
└ `hukou_location`	`string`	否	户口所在地示例值："北京"
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `contact_addresses`	`profile_setting_address\[\]`	否	联系地址数据校验规则： - 长度范围：`0` ～ `100`
└ `address_type`	`string`	否	地址类型枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "address" - custom_api_name = "address_type" 示例值："home_address"
└ `country_region`	`string`	否	国家 / 地区 ID 如果填写了地址对象，则该字段必填可通过【查询国家/地区信息】接口获取示例值："6862995757234914824"
└ `region`	`string`	否	主要行政区 ID 可通过【查询省份/行政区信息】接口获取示例值："6863326815667095047"
└ `region_subdivision_1`	`string`	否	主要行政区往下细分 1 层的行政区示例值："行政区 1"
└ `region_subdivision_2`	`string`	否	主要行政区往下细分 2 层的行政区示例值："行政区 2"
└ `city_v2`	`string`	否	城市 V2 ID 可通过【查询城市信息】接口获取示例值："6862995757234914829"
└ `city_text`	`string`	否	城市（文本）示例值："北京市"
└ `local_city_text`	`string`	否	城市（仅文本，非拉丁语系的本地文字）示例值："北京市"
└ `city_subdivision_1`	`string`	否	城市往下细分 1 层的行政区示例值："行政区 1"
└ `city_subdivision_2`	`string`	否	城市往下细分 2 层的行政区示例值："行政区 2"
└ `district_v2`	`string`	否	区/县 V2 ID 可通过【查询区/县信息】接口获取示例值："6862995757234914831"
└ `postal_code`	`string`	否	邮政编码示例值："611530"
└ `address_line_1`	`string`	否	地址行 1 如果填写了地址对象，则该字段必填示例值："丹佛测试地址 - 纽埃时区"
└ `local_address_line_1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："丹佛测试地址 - 纽埃时区"
└ `address_line_2`	`string`	否	地址行 2 示例值："PoewH"
└ `local_address_line_2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："PoewH"
└ `address_line_3`	`string`	否	地址行 3 示例值："PoewH"
└ `local_address_line_3`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："PoewH"
└ `address_line_4`	`string`	否	地址行 4 示例值："jmwJc"
└ `local_address_line_5`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_6`	`string`	否	地址行 6 示例值："jmwJc"
└ `local_address_line_6`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_7`	`string`	否	地址行 7 示例值："jmwJc"
└ `local_address_line_7`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_8`	`string`	否	地址行 8 示例值："jmwJc"
└ `local_address_line_8`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："rafSu"
└ `address_line_9`	`string`	否	地址行 9 示例值："McPRG"
└ `local_address_line_9`	`string`	否	地址行 9（非拉丁语系的本地文字）示例值："McPRG"
└ `local_address_line_4`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："jmwJc"
└ `address_line_5`	`string`	否	地址行 5 示例值："jmwJc"
└ `custom_groups`	`profile_setting_custom_group\[\]`	否	自定义分组数据校验规则： - 长度范围：`0` ～ `100`
└ `group_name`	`string`	否	分组名示例值："custom_obj__c"
└ `items`	`profile_setting_custom_group_item\[\]`	否	分组数据数据校验规则： - 长度范围：`0` ～ `1000`
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `citizenship_statuses`	`profile_setting_citizenship_status\[\]`	否	公民身份列表
└ `country_region`	`string`	否	国家/地区ID 示例值："7324333990030034476"
└ `citizenship_status`	`string`	否	公民身份类型示例值："公民"
`employment_info`	`profile_setting_employment_info`	否	工作信息
└ `basic_info`	`profile_setting_employment_basic_info`	否	基本信息
└ `employee_number`	`string`	否	员工编号示例值："1000000"
└ `effective_time`	`string`	否	入职日期示例值："2021-01-01"
└ `regular_employee_start_date`	`string`	否	转正式员工日期示例值："2021-02-01"
└ `seniority_date`	`string`	否	资历起算日期示例值："2020-01-01"
└ `work_email`	`string`	否	工作邮箱示例值："12456@test.com"
└ `phone`	`profile_setting_phone`	否	工作电话
└ `international_area_code`	`string`	否	国际电话区号枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "phone" - custom_api_name = "international_area_code" 示例值："86_china"
└ `phone_number`	`string`	否	电话号码如果填写了工作电话对象，则该字段必填示例值："13000000000"
└ `user_geo`	`string`	否	数据驻留地开通了飞书数据驻留服务的企业，该字段为必填示例值："cn"
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式 - 请参考【自定义字段说明】示例值："123"
└ `probation_info`	`profile_setting_probation_info`	否	试用期信息
└ `probation_start_date`	`string`	否	试用期开始日期示例值："2021-01-01"
└ `probation_expected_end_date`	`string`	否	试用期预计结束日期示例值："2021-02-01"
└ `actual_probation_end_date`	`string`	否	试用期实际结束日期示例值："2021-02-01"
└ `employment_record`	`profile_setting_employment_record`	否	任职记录
└ `employee_type`	`string`	否	人员类型 ID 可通过【批量查询人员类型】接口获取示例值："6890452208593372679"
└ `department`	`string`	否	部门 ID 可通过【批量查询部门】接口获取示例值："6890452208593372679"
└ `direct_manager`	`string`	否	直属上级雇佣 ID 可通过【搜索员工信息】接口获取示例值："6893014062142064135"
└ `working_hours_type`	`string`	否	工时制度 ID 可通过【批量查询工时制度】接口获取示例值："6890452208593372600"
└ `cost_centers`	`profile_setting_cost_center\[\]`	否	成本中心分摊信息数据校验规则： - 长度范围：`0` ～ `100`
└ `id`	`string`	否	支持的成本中心 ID，详细信息可通过【搜索成本中心信息】接口查询获得示例值："6950635856373745165"
└ `rate`	`int`	否	分摊比例示例值：100 数据校验规则： - 取值范围：`0` ～ `100`
└ `direct_manager_effective_time`	`string`	否	直属上级入职日期示例值："2020-01-01"
└ `dotted_line_manager`	`string`	否	虚线上级雇佣 ID 可通过【搜索员工信息】接口获取示例值："6893014062142064136"
└ `dotted_line_manager_effective_time`	`string`	否	虚线上级入职日期示例值："2020-01-01"
└ `job`	`string`	否	职务 ID 可通过【批量查询职务】接口获取示例值："6890452208593372679"
└ `job_family`	`string`	否	序列 ID 可通过【批量查询序列】接口获取示例值："6890452208593372680"
└ `job_level`	`string`	否	职级 ID 可通过【批量查询职级】接口获取示例值："6890452208593372681"
└ `job_grade`	`string`	否	职等 ID 可通过【查询职等】接口获取示例值："6890452208593372682"
└ `work_location`	`string`	否	工作地点 ID 可通过【批量查询地点】接口获取示例值："6890452208593372683"
└ `weekly_working_hours`	`int`	否	周工作时长示例值：100 数据校验规则： - 取值范围：`0` ～ `168`
└ `position`	`string`	否	岗位ID 示例值："6890452208593372684"
└ `pathway`	`string`	否	通道ID 示例值："6890452208593372684"
└ `emp_contract_record`	`profile_setting_emp_contract_record`	否	合同记录
└ `contract_number`	`string`	否	合同协议编号示例值："6919737965274990093"
└ `contract_type`	`string`	否	合同类型枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "contract" - custom_api_name = "contract_type" 示例值："labor_contract"
└ `first_party`	`string`	否	甲方公司 ID 引用 Company 的 ID，详细信息可通过【批量查询公司】接口查询获得示例值："6892686614112241165"
└ `effective_time`	`string`	否	合同开始日期如果填写了合同对象，则该字段必填示例值："2006-01-02"
└ `duration_type`	`string`	否	期限类型枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "contract" - custom_api_name = "duration_type" 示例值："fixed_term"
└ `contract_end_date`	`string`	否	合同结束日期示例值："2050-01-01"
└ `custom_groups`	`profile_setting_custom_group\[\]`	否	自定义分组数据校验规则： - 长度范围：`0` ～ `100`
└ `group_name`	`string`	否	分组名示例值："custom_obj__c"
└ `items`	`profile_setting_custom_group_item\[\]`	否	分组数据数据校验规则： - 长度范围：`0` ～ `1000`
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `custom_org_groups`	`job_data_custom_org\[\]`	否	自定义组织记录
└ `effective_time`	`string`	是	生效时间示例值："2024-07-02"
└ `start_reason`	`string`	否	原因示例值："新增人员" 数据校验规则： - 最大长度：`1000` 字符
└ `custom_org_with_rates`	`create_emp_custom_org\[\]`	是	自定义组织列表数据校验规则： - 长度范围：`1` ～ `100`
└ `id`	`string`	是	自定义组织ID 示例值："7260357352426782739"
└ `rate`	`number(float)`	否	比例如果是非比例的可不填写示例值：50.1 数据校验规则： - 取值范围：`0` ～ `100`
└ `object_api_name`	`string`	是	自定义组织类型示例值："custom_org_01"
└ `seniority_adjust_informations`	`seniority_adjust_information_edit\[\]`	否	司龄调整信息数据校验规则： - 长度范围：`0` ～ `100`
└ `seniority_adjustment_type`	`string`	是	调整类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：seniority_adjust_information - custom_api_name：seniority_adjustment_type 示例值："increase" 可选值有： - `increase`: 增加 - `decrease`: 减少
└ `start_date`	`string`	否	开始日期 - 格式： yyyy-mm-dd 示例值："2024-01-01"
└ `end_date`	`string`	否	结束日期 - 格式： yyyy-mm-dd 示例值："2024-01-02"
└ `reasons_for_seniority_adjustment`	`string`	否	调整原因示例值："工厂停产需要减去半年工龄"
└ `seniority_adjustment`	`number(float)`	是	调整值 - 精确度：两位小数 - 单位：年示例值：1.01 数据校验规则： - 取值范围：`0` ～ `100`
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 具体支持的对象请参考【自定义字段说明】数据校验规则： - 长度范围：`0` ～ `180`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值, 是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："["custom_enum_0__c"]"
└ `default_cost_center`	`default_cost_center_record`	否	默认成本中心
└ `reason`	`string`	否	变更原因示例值："默认成本中心变更"
└ `is_inherit`	`boolean`	否	是否继承示例值：true
└ `cost_center_id`	`cost_center_id`	否	默认成本中心
└ `wk_id`	`string`	否	成本中心示例值："7382048365313261588"
└ `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
`career`	`profile_setting_career`	否	履历信息
└ `educations`	`profile_setting_education\[\]`	否	教育经历数据校验规则： - 长度范围：`0` ～ `100`
└ `school`	`string`	否	学校示例值："北京大学"
└ `school_enum`	`string`	否	学校枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "education" - custom_api_name = "school_name" 示例值："school-177"
└ `start_date`	`string`	否	开始日期示例值："2011-09-01"
└ `end_date`	`string`	否	结束日期示例值："2015-06-30"
└ `level_of_education`	`string`	否	学历枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "education" - custom_api_name = "level_of_education" 示例值："masters_degree"
└ `field_of_study`	`string`	否	专业示例值："软件工程"
└ `degree`	`string`	否	学位枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "education" - custom_api_name = "degree" 示例值："bachelors_degree"
└ `field_of_study_enum`	`string`	否	专业枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "education" - custom_api_name = "field_of_study_name" 示例值："field_of_study-2"
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `work_experiences`	`profile_setting_work_experience\[\]`	否	工作经历数据校验规则： - 长度范围：`0` ～ `100`
└ `company_organization`	`profile_setting_i18n`	否	公司 / 组织
└ `zh_cn`	`string`	否	中文示例值："中文名"
└ `en_us`	`string`	否	英文示例值："english name"
└ `department`	`profile_setting_i18n`	否	部门
└ `zh_cn`	`string`	否	中文示例值："中文名"
└ `en_us`	`string`	否	英文示例值："english name"
└ `start_date`	`string`	否	开始日期示例值："2020-01-01"
└ `end_date`	`string`	否	结束日期示例值："2020-02-01"
└ `job`	`profile_setting_i18n`	否	岗位
└ `zh_cn`	`string`	否	中文示例值："中文名"
└ `en_us`	`string`	否	英文示例值："english name"
└ `description`	`profile_setting_i18n`	否	工作描述
└ `zh_cn`	`string`	否	中文示例值："中文名"
└ `en_us`	`string`	否	英文示例值："english name"
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
└ `custom_groups`	`profile_setting_custom_group\[\]`	否	自定义分组数据校验规则： - 长度范围：`0` ～ `100`
└ `group_name`	`string`	否	分组名示例值："custom_obj__c"
└ `items`	`profile_setting_custom_group_item\[\]`	否	分组数据数据校验规则： - 长度范围：`0` ～ `1000`
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"
`data_attachment`	`profile_setting_data_attachment`	否	资料附件
└ `personal_records`	`profile_setting_personal_record\[\]`	否	资料附件记录数据校验规则： - 长度范围：`0` ～ `100`
└ `profile_type`	`string`	否	资料类型 - 枚举值可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "personal_profile" - custom_api_name = "profile_type" - 仅【飞书人事-档案配置-资料附件】存在的字段编码可用示例值："profile_type_1"
└ `files`	`profile_setting_file\[\]`	否	文件列表数据校验规则： - 长度范围：`0` ～ `100`
└ `file_id`	`string`	否	文件 ID - 可通过【上传文件】接口获取 - 只传该字段即可，大小、类型等字段可以不传递示例值："150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
└ `mime_type`	`string`	否	文件 MIME 类型示例值："zip"
└ `name`	`string`	否	文件名示例值："附件.zip"
└ `size`	`string`	否	文件大小（KB）示例值："1000"
└ `token`	`string`	否	文件 Token 示例值："0a423bc7ea7c4a439d066bf070616782"
└ `custom_groups`	`profile_setting_custom_group\[\]`	否	自定义分组数据校验规则： - 长度范围：`0` ～ `100`
└ `group_name`	`string`	否	分组名示例值："custom_obj__c"
└ `items`	`profile_setting_custom_group_item\[\]`	否	分组数据数据校验规则： - 长度范围：`0` ～ `1000`
└ `custom_fields`	`profile_setting_custom_field\[\]`	否	自定义字段 - 请参考自定义字段说明数据校验规则： - 长度范围：`0` ～ `100`
└ `field_name`	`string`	是	字段名示例值："custom_field_1__c"
└ `value`	`string`	否	字段值是 JSON 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："123"

请求体示例

json

{
    "personal_info": {
        "personal_basic_info": {
            "legal_name": {
                "additional_name_type": "emergency_contact_name",
                "country_region": "6862995757234914824",
                "full_name": "王大帅",
                "hereditary": "王",
                "middle_name": "大",
                "secondary": "王",
                "social": "ii",
                "tertiary": "王",
                "local_first_name_2": "五",
                "local_middle_name": "大",
                "local_primary": "黄",
                "local_primary_2": "王",
                "local_secondary": "王",
                "title": "Mr",
                "local_first_name": "四",
                "custom_local_name": "王大帅",
                "custom_western_name": "王大帅",
                "first_name": "帅",
                "name_primary": "王"
            },
            "preferred_name": {
                "additional_name_type": "emergency_contact_name",
                "country_region": "6862995757234914824",
                "full_name": "王大帅",
                "hereditary": "王",
                "middle_name": "大",
                "secondary": "王",
                "social": "ii",
                "tertiary": "王",
                "local_first_name_2": "五",
                "local_middle_name": "大",
                "local_primary": "黄",
                "local_primary_2": "王",
                "local_secondary": "王",
                "title": "mr",
                "local_first_name": "四",
                "custom_local_name": "王大帅",
                "custom_western_name": "王大帅",
                "first_name": "帅",
                "name_primary": "王"
            },
            "additional_name": "王帅",
            "gender": "female",
            "nationality_v2": "6862995757234914826",
            "ethnicity_race": "han",
            "phone": {
                "international_area_code": "86_china",
                "phone_number": "13000000000"
            },
            "email": "1234567@example.feishu.cn",
            "date_of_birth": "2006-01-02",
            "marital_status": "married",
            "is_disabled": false,
            "disable_card_number": "92838277746172888312",
            "is_martyr_family": false,
            "martyr_card_number": "00001",
            "is_old_alone": false,
            "born_country_region": "6862995757234914825",
            "political_affiliation": "other",
            "native_region": "6862995757234914827",
            "date_entered_workforce": "2006-01-02",
            "first_entry_time": "2006-01-02",
            "leave_time": "2006-01-02",
            "custom_fields": [
                {
                    "field_name": "custom_field_1__c",
                    "value": "123"
                }
            ],
            "additional_nationalities": [
                "6862995757234914827"
            ]
        },
        "emergency_contacts": [
            {
                "legal_name": "王大帅",
                "relationship": "parent",
                "is_primary": true,
                "phone": {
                    "international_area_code": "86_china",
                    "phone_number": "13000000000"
                },
                "email": "1234567@example.feishu.cn",
                "address": {
                    "address_type": "home_address",
                    "country_region": "6862995757234914824",
                    "region": "6863326815667095047",
                    "region_subdivision_1": "行政区1",
                    "region_subdivision_2": "行政区2",
                    "city_v2": "6862995757234914829",
                    "city_text": "北京市",
                    "local_city_text": "北京市",
                    "city_subdivision_1": "行政区 1",
                    "city_subdivision_2": "行政区 2",
                    "district_v2": "6862995757234914831",
                    "postal_code": "611530",
                    "address_line_1": "丹佛测试地址 - 纽埃时区",
                    "local_address_line_1": "丹佛测试地址 - 纽埃时区",
                    "address_line_2": "PoewH",
                    "local_address_line_2": "PoewH",
                    "address_line_3": "PoewH",
                    "local_address_line_3": "PoewH",
                    "address_line_4": "jmwJc",
                    "local_address_line_5": "jmwJc",
                    "address_line_6": "jmwJc",
                    "local_address_line_6": "jmwJc",
                    "address_line_7": "jmwJc",
                    "local_address_line_7": "jmwJc",
                    "address_line_8": "jmwJc",
                    "local_address_line_8": "rafSu",
                    "address_line_9": "McPRG",
                    "local_address_line_9": "McPRG",
                    "local_address_line_4": "jmwJc",
                    "address_line_5": "jmwJc"
                },
                "custom_fields": [
                    {
                        "field_name": "custom_field_1__c",
                        "value": "123"
                    }
                ]
            }
        ],
        "bank_accounts": [
            {
                "country_region": "6862995757234914824",
                "bank_name": "中国农业银行",
                "branch_name": "中国农业银行支行",
                "account_holder": "孟十五",
                "bank_account_number": "6231200000001223",
                "bank_account_usages": [
                    "payment"
                ],
                "bank_account_type": "savings",
                "bank_id": "6862995757234914832",
                "branch_id": "6862995757234914833",
                "payment_type": "percent,balance,amount",
                "payment_rate": "80.28",
                "payment_amount": "5000",
                "priority": "1"
            }
        ],
        "nationals": [
            {
                "country_region": "6862995757234914824",
                "national_id_type": "6863330041896371725",
                "national_id_number": "1231131333",
                "issued_date": "2020-04-01",
                "issued_by": "北京市公安局",
                "expiration_date": "2020-05-21",
                "custom_fields": [
                    {
                        "field_name": "custom_field_1__c",
                        "value": "123"
                    }
                ]
            }
        ],
        "resident_taxes": [
            {
                "year_resident_tax": "2006-01-02",
                "tax_country_region": "6862995757234914824",
                "resident_status": "tax_residence",
                "custom_fields": [
                    {
                        "field_name": "custom_field_1__c",
                        "value": "123"
                    }
                ]
            }
        ],
        "dependents": [
            {
                "legal_name": "王大帅",
                "date_of_birth": "2006-01-02",
                "relationship_with_dependent": "parent",
                "gender": "female",
                "phone": {
                    "international_area_code": "86_china",
                    "phone_number": "13000000000"
                },
                "job": "岗位",
                "child_birth_certificates": [
                    {
                        "file_id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200",
                        "mime_type": "zip",
                        "name": "附件.zip",
                        "size": "1000",
                        "token": "0a423bc7ea7c4a439d066bf070616782"
                    }
                ],
                "employer": "飞书",
                "custom_fields": [
                    {
                        "field_name": "custom_field_1__c",
                        "value": "123"
                    }
                ],
                "address": {
                    "address_type": "home_address",
                    "country_region": "6862995757234914824",
                    "region": "6863326815667095047",
                    "region_subdivision_1": "行政区 1",
                    "region_subdivision_2": "行政区 2",
                    "city_v2": "6862995757234914829",
                    "city_text": "北京市",
                    "local_city_text": "北京市",
                    "city_subdivision_1": "行政区 1",
                    "city_subdivision_2": "行政区 2",
                    "district_v2": "6862995757234914831",
                    "postal_code": "611530",
                    "address_line_1": "丹佛测试地址 - 纽埃时区",
                    "local_address_line_1": "丹佛测试地址 - 纽埃时区",
                    "address_line_2": "PoewH",
                    "local_address_line_2": "PoewH",
                    "address_line_3": "PoewH",
                    "local_address_line_3": "PoewH",
                    "address_line_4": "jmwJc",
                    "local_address_line_5": "jmwJc",
                    "address_line_6": "jmwJc",
                    "local_address_line_6": "jmwJc",
                    "address_line_7": "jmwJc",
                    "local_address_line_7": "jmwJc",
                    "address_line_8": "jmwJc",
                    "local_address_line_8": "rafSu",
                    "address_line_9": "McPRG",
                    "local_address_line_9": "McPRG",
                    "local_address_line_4": "jmwJc",
                    "address_line_5": "jmwJc"
                }
            }
        ],
        "hukou": {
            "hukou_type": "local_urban_residence",
            "hukou_location": "北京",
            "custom_fields": [
                {
                    "field_name": "custom_field_1__c",
                    "value": "123"
                }
            ]
        },
        "contact_addresses": [
            {
                "address_type": "home_address",
                "country_region": "6862995757234914824",
                "region": "6863326815667095047",
                "region_subdivision_1": "行政区 1",
                "region_subdivision_2": "行政区 2",
                "city_v2": "6862995757234914829",
                "city_text": "北京市",
                "local_city_text": "北京市",
                "city_subdivision_1": "行政区 1",
                "city_subdivision_2": "行政区 2",
                "district_v2": "6862995757234914831",
                "postal_code": "611530",
                "address_line_1": "丹佛测试地址 - 纽埃时区",
                "local_address_line_1": "丹佛测试地址 - 纽埃时区",
                "address_line_2": "PoewH",
                "local_address_line_2": "PoewH",
                "address_line_3": "PoewH",
                "local_address_line_3": "PoewH",
                "address_line_4": "jmwJc",
                "local_address_line_5": "jmwJc",
                "address_line_6": "jmwJc",
                "local_address_line_6": "jmwJc",
                "address_line_7": "jmwJc",
                "local_address_line_7": "jmwJc",
                "address_line_8": "jmwJc",
                "local_address_line_8": "rafSu",
                "address_line_9": "McPRG",
                "local_address_line_9": "McPRG",
                "local_address_line_4": "jmwJc",
                "address_line_5": "jmwJc"
            }
        ],
        "custom_groups": [
            {
                "group_name": "custom_obj__c",
                "items": [
                    {
                        "custom_fields": [
                            {
                                "field_name": "custom_field_1__c",
                                "value": "123"
                            }
                        ]
                    }
                ]
            }
        ],
        "citizenship_statuses": [
            {
                "country_region": "7324333990030034476",
                "citizenship_status": "公民"
            }
        ]
    },
    "employment_info": {
        "basic_info": {
            "employee_number": "1000000",
            "effective_time": "2021-01-01",
            "regular_employee_start_date": "2021-02-01",
            "seniority_date": "2020-01-01",
            "work_email": "12456@test.com",
            "phone": {
                "international_area_code": "86_china",
                "phone_number": "13000000000"
            },
            "user_geo": "cn",
            "custom_fields": [
                {
                    "field_name": "custom_field_1__c",
                    "value": "123"
                }
            ]
        },
        "probation_info": {
            "probation_start_date": "2021-01-01",
            "probation_expected_end_date": "2021-02-01",
            "actual_probation_end_date": "2021-02-01"
        },
        "employment_record": {
            "employee_type": "6890452208593372679",
            "department": "6890452208593372679",
            "direct_manager": "6893014062142064135",
            "working_hours_type": "6890452208593372600",
            "cost_centers": [
                {
                    "id": "6950635856373745165",
                    "rate": 100
                }
            ],
            "direct_manager_effective_time": "2020-01-01",
            "dotted_line_manager": "6893014062142064136",
            "dotted_line_manager_effective_time": "2020-01-01",
            "job": "6890452208593372679",
            "job_family": "6890452208593372680",
            "job_level": "6890452208593372681",
            "job_grade": "6890452208593372682",
            "work_location": "6890452208593372683",
            "weekly_working_hours": 100,
            "position": "6890452208593372684",
            "pathway": "6890452208593372684"
        },
        "emp_contract_record": {
            "contract_number": "6919737965274990093",
            "contract_type": "labor_contract",
            "first_party": "6892686614112241165",
            "effective_time": "2006-01-02",
            "duration_type": "fixed_term",
            "contract_end_date": "2050-01-01"
        },
        "custom_groups": [
            {
                "group_name": "custom_obj__c",
                "items": [
                    {
                        "custom_fields": [
                            {
                                "field_name": "custom_field_1__c",
                                "value": "123"
                            }
                        ]
                    }
                ]
            }
        ],
        "custom_org_groups": [
            {
                "effective_time": "2024-07-02",
                "start_reason": "新增人员",
                "custom_org_with_rates": [
                    {
                        "id": "7260357352426782739",
                        "rate": 50.1
                    }
                ],
                "object_api_name": "custom_org_01"
            }
        ],
        "seniority_adjust_informations": [
            {
                "seniority_adjustment_type": "increase",
                "start_date": "2024-01-01",
                "end_date": "2024-01-02",
                "reasons_for_seniority_adjustment": "工厂停产需要减去半年工龄",
                "seniority_adjustment": 1.01,
                "custom_fields": [
                    {
                        "field_name": "custom_field_1__c",
                        "value": "[\"custom_enum_0__c\"]"
                    }
                ]
            }
        ],
        "default_cost_center": {
            "reason": "默认成本中心变更",
            "is_inherit": true,
            "cost_center_id": {
                "wk_id": "7382048365313261588"
            }
        },
        "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
                }
            ]
        }
    },
    "career": {
        "educations": [
            {
                "school": "北京大学",
                "school_enum": "school-177",
                "start_date": "2011-09-01",
                "end_date": "2015-06-30",
                "level_of_education": "masters_degree",
                "field_of_study": "软件工程",
                "degree": "bachelors_degree",
                "field_of_study_enum": "field_of_study-2",
                "custom_fields": [
                    {
                        "field_name": "custom_field_1__c",
                        "value": "123"
                    }
                ]
            }
        ],
        "work_experiences": [
            {
                "company_organization": {
                    "zh_cn": "中文名",
                    "en_us": "english name"
                },
                "department": {
                    "zh_cn": "中文名",
                    "en_us": "english name"
                },
                "start_date": "2020-01-01",
                "end_date": "2020-02-01",
                "job": {
                    "zh_cn": "中文名",
                    "en_us": "english name"
                },
                "description": {
                    "zh_cn": "中文名",
                    "en_us": "english name"
                },
                "custom_fields": [
                    {
                        "field_name": "custom_field_1__c",
                        "value": "123"
                    }
                ]
            }
        ],
        "custom_groups": [
            {
                "group_name": "custom_obj__c",
                "items": [
                    {
                        "custom_fields": [
                            {
                                "field_name": "custom_field_1__c",
                                "value": "123"
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "data_attachment": {
        "personal_records": [
            {
                "profile_type": "profile_type_1",
                "files": [
                    {
                        "file_id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200",
                        "mime_type": "zip",
                        "name": "附件.zip",
                        "size": "1000",
                        "token": "0a423bc7ea7c4a439d066bf070616782"
                    }
                ]
            }
        ],
        "custom_groups": [
            {
                "group_name": "custom_obj__c",
                "items": [
                    {
                        "custom_fields": [
                            {
                                "field_name": "custom_field_1__c",
                                "value": "123"
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

响应

响应体

名称	类型	描述
`code`	`int`	错误码，非 0 表示失败
`msg`	`string`	错误描述
`data`	`\-`	-
└ `employment_id`	`string`	雇佣信息 ID 可通过【搜索员工信息】接口获取详细信息
└ `contract_id`	`string`	合同 ID 可通过【批量查询合同】接口获取详细信息
└ `job_data_id`	`string`	任职信息 ID 可通过【批量查询员工任职信息】接口获取详细信息

响应体示例

json

{
    "code": 0,
    "msg": "success",
    "data": {
        "employment_id": "6862995757234914824",
        "contract_id": "6862995757234914824",
        "job_data_id": "6862995757234914824"
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1160001	系统错误。请稍后重试或联系技术支持。	请稍后重试或联系技术支持。
400	1160002	参数校验失败	请按照错误返回提示，修改信息后重新提交。
400	1160003	数据过期	人员表单字段必填要求发生变化，请按照必填要求重新提交。
400	1160004	业务规则校验失败	请按照错误返回提示，修改信息后重新提交。
400	1160005	业务规则校验失败	请按照错误返回提示，修改信息后重新提交。
400	1160006	需要超编确认	可用的编制规划数不足，需进行超编确认，若允许超编请设置 “force_submit” 为 true 确认人员添加
400	1160007	不允许超编	可用的编制规划数不足，禁止提交。
400	1160008	幂等 token 重复	token 信息重复

事件

事件

员工兼职

员工国际派遣

职位数据事件

事件

事件

事件

事件

事件

事件

事件

成本中心 · version

事件

事件

事件

事件

地点 · address

事件

事件

添加人员 ​

请求 ​

请求头 ​

查询参数 ​

请求体 ​

请求体示例 ​

响应 ​

响应体 ​

响应体示例 ​

错误码 ​

添加人员

请求

请求头

查询参数

请求体

请求体示例

响应

响应体

响应体示例

错误码