# 创建 Offer 传入 Offer 基本信息，创建 Offer。 ## 注意事项 - 创建 Offer 时，需传入本文档中标注为必传的参数，其余参数是否必传参考[获取 Offer 申请表信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/offer_application_form/get)的参数定义或在「飞书招聘」-「设置」-「Offer 设置」-「Offer 申请表设置」中进行查看。 - 若客户购买了飞书人事，且「飞书招聘」-「设置」-「Offer 设置」-「Offer 审批设置」中「Offer 薪酬信息来源」配置为“飞书人事「企业版」基础薪酬设置”，该接口将无法创建薪酬信息。 ## 请求 基本 |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/hire/v1/offers HTTP Method | POST 接口频率限制 | [10 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 更新 offer 信息(hire:offer) 字段权限要求 | **注意事项**：该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请
获取用户 user ID(contact:user.employee_id:readonly) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- 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" ### 查询参数 名称 | 类型 | 必填 | 描述 ---|---|---|--- user_id_type | string | 否 | 用户 ID 类型
**示例值**：open_id
**可选值有**：
- open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)
- union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id)
- user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)
- people_admin_id：以people_admin_id来识别用户
**默认值**：`open_id`
**当值为 `user_id`，字段权限要求**：
获取用户 user ID(contact:user.employee_id:readonly) department_id_type | string | 否 | 此次调用中使用的部门 ID 类型。
**示例值**："department_id"
**可选值有**：
- open_department_id：【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同
- department_id：【飞书】用来标识租户内一个唯一的部门
**默认值**：`open_department_id` job_level_id_type | string | 否 | 此次调用中使用的「职级 ID」的类型
**示例值**："department_id"
**可选值有**：
- people_admin_job_level_id：「人力系统管理后台」适用的职级 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。
- job_level_id：「飞书管理后台」适用的职级 ID，通过[获取租户职级列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_level/list)接口获取
**默认值**：`people_admin_job_level_id` job_family_id_type | string | 否 | 此次调用中使用的「序列 ID」的类型
**示例值**："people_admin_job_category_id"
**可选值有**：
- people_admin_job_category_id：「人力系统管理后台」适用的序列 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。
- job_family_id：「飞书管理后台」适用的序列 ID，通过[获取租户序列列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_family/list)接口获取
**默认值**：`people_admin_job_category_id` employee_type_id_type | string | 否 | 此次调用中使用的「人员类型 ID」的类型
**示例值**："people_admin_employee_type_id"
**可选值有**：
- people_admin_employee_type_id：「人力系统管理后台」适用的人员类型 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。
- employee_type_enum_id：「飞书管理后台」适用的人员类型 ID，通过[查询人员类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/employee_type_enum/list)接口获取
**默认值**：`people_admin_employee_type_id` ### 请求体 名称 | 类型 | 必填 | 描述 ---|---|---|--- application_id | string | 是 | 投递 ID，详情请参考：[获取投递列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list)
**示例值**："7013552389293279532" schema_id | string | 否 | Offer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可先从[获取职位设置](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/config)中拿到offer申请表ID，再从[获取 Offer 申请表信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/offer_application_form/get)接口中获取最新的模板ID。不填则会自动填充最新模版ID。
**示例值**："7013318077945596204" offer_type | int | 否 | Offer 类型
**示例值**：1
**可选值有**：
- 1：正式 Offer
- 2：实习 Offer basic_info | offer_basic_info | 是 | Offer 基本信息 department_id | string | 是 | 部门 ID，与入参中的`department_id_type`类型一致，详情请查看：[获取部门信息列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/list)
**示例值**："od-6b394871807047c7023ebfc1ff37cd3a" leader_user_id | string | 是 | 直属上级 ID，与入参`user_id_type`类型一致
**示例值**："ou_ce613028fe74745421f5dc320bb9c709" employment_job_id | string | 否 | 职务 ID，可通过[批量查询职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)接口获取。**请注意**：仅支持开通飞书人事企业版的客户使用
**示例值**："6807407987381831949" employee_type_id | string | 否 | 人员类型 ID，与入参`employee_type_id_type` 类型一致
**示例值**："6807407987381831949" job_family_id | string | 否 | 职位序列 ID，通过[获取租户序列列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_family/list)接口获取
**示例值**："6807407987381831949" job_level_id | string | 否 | 职位级别 ID，通过[获取租户职级列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_level/list)接口获取
**示例值**："6807407987381881101" probation_month | int | 否 | 试用期（月）
**示例值**：3 contract_year | int | 否 | 合同期(年)，推荐使用「contract_period」
**示例值**：3 contract_period | contract_period_info | 否 | 合同期（年/月） period_type | int | 是 | 合同周期类型
**示例值**：1
**可选值有**：
- 1：月
- 2：年 period | int | 是 | 合同时长
**示例值**：3
**数据校验规则**：
- 取值范围：`0` ～ `100` expected_onboard_date | string | 否 | 预计入职日期。以下示例值未转义，使用时请注意转义
**示例值**："{\"date\":\"2022-04-07\"}" onboard_address_id | string | 否 | 入职地点 ID，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list)
**示例值**："6897079709306259719" work_address_id | string | 否 | 办公地点 ID，详情请参考：[获取地址列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/list)
**示例值**："6897079709306259719" owner_user_id | string | 是 | Offer负责人 ID，与入参`user_id_type`类型一致
**示例值**："ou_ce613028fe74745421f5dc320bb9c709" recommended_words | string | 否 | Offer 推荐语
**示例值**："十分优秀，推荐入职" job_requirement_id | string | 否 | 招聘需求 ID，详情请查看：[获取招聘需求列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_requirement/list)
**示例值**："2342352224" job_process_type_id | int | 否 | 招聘流程类型 ID，可选值：「1:社招，2:校招」
**示例值**：2 attachment_id_list | string\[\] | 否 | 附件 ID 列表，暂无获取附件 ID 的方式，请勿使用
**示例值**：["6792436415209817600"] common_attachment_id_list | string\[\] | 否 | 通用附件 ID 列表，可使用[创建附件](https://open.feishu.cn/document/ukTMukTMukTM/uIDN1YjLyQTN24iM0UjN/create_attachment)接口创建的附件
**示例值**：["7483412052430997804"] attachment_description | string | 否 | 附件描述
**示例值**："张三的简历" operator_user_id | string | 是 | Offer操作人 ID，与入参`user_id_type`类型一致
**示例值**："ou_ce613028fe74745421f5dc320bb9c709" position_id | string | 否 | 岗位 ID，可通过[查询岗位信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/position/query) 获取（仅限飞书人事租户使用，若链接无法打开，则说明飞书人事未启用岗位，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)开通）
**示例值**："6897079709306259719" job_offered | string | 否 | 入职职位
**示例值**："入职职位" job_grade_id | string | 否 | 职等 ID，可通过[查询职等](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query) 获取（仅限飞书人事租户使用）
**示例值**："6897079709306259720" pathway_id | string | 否 | 通道 ID
**示例值**："6897079709306259719" salary_info | offer_salary_info | 否 | Offer 薪资信息 currency | string | 是 | 币种
**示例值**："CNY" basic_salary | string | 否 | 基本工资，当启用 Offer 申请表中的「薪资信息」模块时，「基本工资」字段为必传项
**示例值**："1000000" probation_salary_percentage | string | 否 | 试用期薪资百分比
**示例值**："0.8" award_salary_multiple | string | 否 | 年终奖月数
**示例值**："3" option_shares | string | 否 | 期权股数
**示例值**："30" quarterly_bonus | string | 否 | 季度奖金额，单位元、支持小数点后两位
**示例值**："3000" half_year_bonus | string | 否 | 半年奖金额，单位元、支持小数点后两位
**示例值**："10000" customized_info_list | offer_customized_info\[\] | 否 | 自定义信息 id | string | 否 | 自定义字段 ID
**示例值**："6972464088568269100" value | string | 否 | 自定义字段信息，以字符串形式传入，如：
1. 单选： "1"
2. 多选："[\"1\", \"2\"]"
3. 日期："{"date":"2022-01-01"}"
4. 年份选择："{"date":"2022"}"
5. 月份选择："{"date":"2022-01"}"
6. 单行文本："xxx "
7. 多行文本："xxx "
8. 数字："123"
9. 金额："123.1"
10. 附件："[{\"common_attachment_id\":\"通用附件 ID\"},...]"
**示例值**："1" ### 请求体示例 ```json { "application_id": "7013552389293279532", "schema_id": "7013318077945596204", "offer_type": 1, "basic_info": { "department_id": "od-6b394871807047c7023ebfc1ff37cd3a", "leader_user_id": "ou_ce613028fe74745421f5dc320bb9c709", "employment_job_id": "6807407987381831949", "employee_type_id": "6807407987381831949", "job_family_id": "6807407987381831949", "job_level_id": "6807407987381881101", "probation_month": 3, "contract_year": 3, "contract_period": { "period_type": 1, "period": 3 }, "expected_onboard_date": "{\"date\":\"2022-04-07\"}", "onboard_address_id": "6897079709306259719", "work_address_id": "6897079709306259719", "owner_user_id": "ou_ce613028fe74745421f5dc320bb9c709", "recommended_words": "十分优秀，推荐入职", "job_requirement_id": "2342352224", "job_process_type_id": 2, "attachment_id_list": [ "6792436415209817600" ], "common_attachment_id_list": [ "7483412052430997804" ], "attachment_description": "张三的简历", "operator_user_id": "ou_ce613028fe74745421f5dc320bb9c709", "position_id": "6897079709306259719", "job_offered": "入职职位", "job_grade_id": "6897079709306259720", "pathway_id": "6897079709306259719" }, "salary_info": { "currency": "CNY", "basic_salary": "1000000", "probation_salary_percentage": "0.8", "award_salary_multiple": "3", "option_shares": "30", "quarterly_bonus": "3000", "half_year_bonus": "10000" }, "customized_info_list": [ { "id": "6972464088568269100", "value": "1" } ] } ``` ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | offer_info | \- offer_id | string | Offer ID application_id | string | 投递 ID schema_id | string | Offer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可从「获取Offer申请表模板信息」接口中获取 offer_type | int | Offer 类型
**可选值有**：
- 1：正式 Offer
- 2：实习 Offer basic_info | offer_basic_info | Offer 基本信息 department_id | string | 部门 ID leader_user_id | string | 直属上级 ID，与入参`user_id_type`类型一致 employment_job_id | string | 职务 ID employee_type_id | string | 人员类型 ID job_family_id | string | 职位序列 ID，通过[获取租户序列列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/job_family/list)接口获取 job_level_id | string | 职位级别 ID probation_month | int | 试用期 contract_year | int | 合同期(年)，推荐使用「contract_period」 contract_period | contract_period_info | 合同期（年/月） period_type | int | 合同周期类型
**可选值有**：
- 1：月
- 2：年 period | int | 合同时长 expected_onboard_date | string | 预计入职日期 onboard_address_id | string | 入职地点 ID work_address_id | string | 办公地点 ID owner_user_id | string | Offer负责人 ID，与入参`user_id_type`类型一致 recommended_words | string | Offer 推荐语 job_requirement_id | string | 招聘需求 ID job_process_type_id | int | 招聘流程类型 ID，详情请查看：[获取招聘流程信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_process/list) attachment_id_list | string\[\] | 附件 ID 列表（废弃） common_attachment_id_list | string\[\] | 通用附件 ID 列表，可通过[获取附件信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/attachment/get)接口获取附件的详细信息 attachment_description | string | 附件描述 operator_user_id | string | Offer操作人 ID，与入参`user_id_type`类型一致 position_id | string | 岗位 ID，可通过[查询岗位信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/position/query) 获取（仅限飞书人事租户使用，若链接无法打开，则说明飞书人事未启用岗位，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)开通） job_offered | string | 入职职位 job_grade_id | string | 职等 ID pathway_id | string | 通道 ID salary_info | offer_salary_info | Offer 薪资信息 currency | string | 币种 basic_salary | string | 基本工资，当启用 Offer 申请表中的「薪资信息」模块时，「基本工资」字段为必传项 probation_salary_percentage | string | 试用期百分比 award_salary_multiple | string | 年终奖月数 option_shares | string | 期权股数 quarterly_bonus | string | 季度奖金额 half_year_bonus | string | 半年奖金额 customized_info_list | offer_customized_info\[\] | 自定义信息 id | string | 自定义字段 ID value | string | 自定义字段信息，以字符串形式传入，如：
1. 单选： "1"
2. 多选："[\"1\", \"2\"]"
3. 日期："{"date":"2022-01-01"}"
4. 年份选择："{"date":"2022"}"
5. 月份选择："{"date":"2022-01"}"
6. 单行文本："xxx "
7. 多行文本："xxx "
8. 数字："123"
9. 金额："123.1" ### 响应体示例 ```json { "code": 0, "msg": "success", "data": { "offer_id": "7016605170635213100", "application_id": "7013552389293279532", "schema_id": "7013318077945596204", "offer_type": 1, "basic_info": { "department_id": "od-6b394871807047c7023ebfc1ff37cd3a", "leader_user_id": "ou_ce613028fe74745421f5dc320bb9c709", "employment_job_id": "123", "employee_type_id": "2", "job_family_id": "6807407987381831949", "job_level_id": "6807407987381881101", "probation_month": 3, "contract_year": 3, "contract_period": { "period_type": 1, "period": 3 }, "expected_onboard_date": "{\"date\":\"2022-04-07\"}", "onboard_address_id": "6897079709306259719", "work_address_id": "6897079709306259719", "owner_user_id": "ou_ce613028fe74745421f5dc320bb9c709", "recommended_words": "十分优秀，推荐入职", "job_requirement_id": "2342352224", "job_process_type_id": 2, "attachment_id_list": [ "679243641520981760" ], "common_attachment_id_list": [ "7483412052430997804" ], "attachment_description": "张三的简历", "operator_user_id": "ou_ce613028fe74745421f5dc320bb9c709", "position_id": "6897079709306259719", "job_offered": "入职职位", "job_grade_id": "6897079709306259720", "pathway_id": "6897079709306259719" }, "salary_info": { "currency": "CNY", "basic_salary": "1000000", "probation_salary_percentage": "0.8", "award_salary_multiple": "3", "option_shares": "30", "quarterly_bonus": "3000", "half_year_bonus": "10000" }, "customized_info_list": [ { "id": "6972464088568269100", "value": "1" } ] } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 500 | 1002001 | 系统错误 | 请根据实际报错信息定位或咨询[技术支持](https://applink.feishu.cn/TLJpeNdW) 400 | 1002002 | 参数错误 | 检查参数是否正确，例如类型，大小 500 | 1002053 | offer already exist | Offer 已存在，不可重复创建 Offer 500 | 1002054 | application not exist | 投递不存在，检查投递 ID 是否正确 500 | 1002055 | application already terminated | 投递已终止，不可发起 Offer 500 | 1002056 | application stage abnormal | 投递阶段异常，检查投递状态 500 | 1002057 | schema not the latest version | 需传入最新版本的 schema_id 500 | 1002058 | offer attachment not exist | 附件不存在，检查附件信息 500 | 1002059 | schema not exist | schema不存在，检查 schema_id 500 | 1002061 | formula illegal | 检查公式信息 500 | 1002062 | miss in job process | 该投递阶段不支持创建 Offer 400 | 1002069 | 职务不存在 | 请检查`employment_job_id `参数 400 | 1002070 | 职务已停用 | 请检查`employment_job_id `参数 400 | 1002071 | 序列不存在 | 请检查`job_family_id `参数 400 | 1002072 | 序列已停用 | 请检查`job_family_id `参数 400 | 1002073 | 职级不存在 | 请检查`job_level_id `参数 400 | 1002074 | 职级已停用 | 请检查`job_level_id `参数 400 | 1002075 | 职等不存在 | 请检查`job_grade_id`参数 400 | 1002076 | 职等已停用 | 请检查`job_grade_id`参数 400 | 1002077 | 职务、序列不匹配 | 请检查`employment_job_id `、`job_family_id `参数 400 | 1002078 | 职务、职级不匹配 | 请检查`employment_job_id `、`job_level_id `参数 400 | 1002079 | 序列、职级不匹配(在序列与职级在生效时间内未查询到关联的生效职务) | 请检查`job_family_id `、`job_level_id `参数 400 | 1002080 | 职级、职等不匹配 | 请检查`job_level_id`、`job_grade_id`参数 400 | 1002082 | Offer 附件数量超过限制 | Offer 附件每个请求最多 20 个，请减少请求中的 Offer 附件数量 400 | 1002083 | Offer 附件对应的文件不存在 | 请检查附件 ID 是否合法