飞书开放平台 Server API 文档

主题

创建 Offer ​

传入 Offer 基本信息，创建 Offer。

注意事项 ​

  • 创建 Offer 时，需传入本文档中标注为必传的参数，其余参数是否必传参考获取 Offer 申请表信息的参数定义或在「飞书招聘」-「设置」-「Offer 设置」-「Offer 申请表设置」中进行查看。
  • 若客户购买了飞书人事，且「飞书招聘」-「设置」-「Offer 设置」-「Offer 审批设置」中「Offer 薪酬信息来源」配置为“飞书人事「企业版」基础薪酬设置”，该接口将无法创建薪酬信息。

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/offers
HTTP MethodPOST
接口频率限制10 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用hire:offer 更新 offer 信息
字段权限要求> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头 ​

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

查询参数 ​

名称类型必填描述
user_id_typestring否用户 ID 类型
示例值：open_id
可选值有：
- open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ - people_admin_id: 以people_admin_id来识别用户
默认值：open_id
当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
department_id_typestring否此次调用中使用的部门 ID 类型。
示例值："department_id"
可选值有：
- open_department_id: 【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同 - department_id: 【飞书】用来标识租户内一个唯一的部门
默认值：open_department_id
job_level_id_typestring否此次调用中使用的「职级 ID」的类型
示例值："department_id"
可选值有：
- people_admin_job_level_id: 「人力系统管理后台」适用的职级 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_level_id: 「飞书管理后台」适用的职级 ID，通过获取租户职级列表接口获取
默认值：people_admin_job_level_id
job_family_id_typestring否此次调用中使用的「序列 ID」的类型
示例值："people_admin_job_category_id"
可选值有：
- people_admin_job_category_id: 「人力系统管理后台」适用的序列 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_family_id: 「飞书管理后台」适用的序列 ID，通过获取租户序列列表接口获取
默认值：people_admin_job_category_id
employee_type_id_typestring否此次调用中使用的「人员类型 ID」的类型
示例值："people_admin_employee_type_id"
可选值有：
- people_admin_employee_type_id: 「人力系统管理后台」适用的人员类型 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - employee_type_enum_id: 「飞书管理后台」适用的人员类型 ID，通过查询人员类型接口获取
默认值：people_admin_employee_type_id

请求体 ​

名称类型必填描述
application_idstring是投递 ID，详情请参考：获取投递列表
示例值："7013552389293279532"
schema_idstring否Offer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可先从获取职位设置中拿到offer申请表ID，再从获取 Offer 申请表信息接口中获取最新的模板ID。不填则会自动填充最新模版ID。
示例值："7013318077945596204"
offer_typeint否Offer 类型
示例值：1
可选值有：
- 1: 正式 Offer - 2: 实习 Offer
basic_infooffer_basic_info是Offer 基本信息
  └ department_idstring是部门 ID，与入参中的department_id_type类型一致，详情请查看：获取部门信息列表
示例值："od-6b394871807047c7023ebfc1ff37cd3a"
  └ leader_user_idstring是直属上级 ID，与入参user_id_type类型一致
示例值："ou_ce613028fe74745421f5dc320bb9c709"
  └ employment_job_idstring否职务 ID，可通过批量查询职务接口获取。请注意：仅支持开通飞书人事企业版的客户使用
示例值："6807407987381831949"
  └ employee_type_idstring否人员类型 ID，与入参employee_type_id_type 类型一致
示例值："6807407987381831949"
  └ job_family_idstring否职位序列 ID，通过获取租户序列列表接口获取
示例值："6807407987381831949"
  └ job_level_idstring否职位级别 ID，通过获取租户职级列表接口获取
示例值："6807407987381881101"
  └ probation_monthint否试用期（月）
示例值：3
  └ contract_yearint否合同期(年)，推荐使用「contract_period」
示例值：3
  └ contract_periodcontract_period_info否合同期（年/月）
    └ period_typeint是合同周期类型
示例值：1
可选值有：
- 1: 月 - 2: 年
    └ periodint是合同时长
示例值：3
数据校验规则：
- 取值范围：0 ～ 100
  └ expected_onboard_datestring否预计入职日期。以下示例值未转义，使用时请注意转义
示例值："{\"date\":\"2022-04-07\"}"
  └ onboard_address_idstring否入职地点 ID，详情请参考：获取地址列表
示例值："6897079709306259719"
  └ work_address_idstring否办公地点 ID，详情请参考：获取地址列表
示例值："6897079709306259719"
  └ owner_user_idstring是Offer负责人 ID，与入参user_id_type类型一致
示例值："ou_ce613028fe74745421f5dc320bb9c709"
  └ recommended_wordsstring否Offer 推荐语
示例值："十分优秀，推荐入职"
  └ job_requirement_idstring否招聘需求 ID，详情请查看：获取招聘需求列表
示例值："2342352224"
  └ job_process_type_idint否招聘流程类型 ID，可选值：「1:社招，2:校招」
示例值：2
  └ attachment_id_liststring\[\]否附件 ID 列表，暂无获取附件 ID 的方式，请勿使用
示例值：["6792436415209817600"]
  └ common_attachment_id_liststring\[\]否通用附件 ID 列表，可使用创建附件接口创建的附件
示例值：["7483412052430997804"]
  └ attachment_descriptionstring否附件描述
示例值："张三的简历"
  └ operator_user_idstring是Offer操作人 ID，与入参user_id_type类型一致
示例值："ou_ce613028fe74745421f5dc320bb9c709"
  └ position_idstring否岗位 ID，可通过查询岗位信息 获取（仅限飞书人事租户使用，若链接无法打开，则说明飞书人事未启用岗位，请联系技术支持开通）
示例值："6897079709306259719"
  └ job_offeredstring否入职职位
示例值："入职职位"
  └ job_grade_idstring否职等 ID，可通过查询职等 获取（仅限飞书人事租户使用）
示例值："6897079709306259720"
  └ pathway_idstring否通道 ID
示例值："6897079709306259719"
salary_infooffer_salary_info否Offer 薪资信息
  └ currencystring是币种
示例值："CNY"
  └ basic_salarystring否基本工资，当启用 Offer 申请表中的「薪资信息」模块时，「基本工资」字段为必传项
示例值："1000000"
  └ probation_salary_percentagestring否试用期薪资百分比
示例值："0.8"
  └ award_salary_multiplestring否年终奖月数
示例值："3"
  └ option_sharesstring否期权股数
示例值："30"
  └ quarterly_bonusstring否季度奖金额，单位元、支持小数点后两位
示例值："3000"
  └ half_year_bonusstring否半年奖金额，单位元、支持小数点后两位
示例值："10000"
customized_info_listoffer_customized_info\[\]否自定义信息
  └ idstring否自定义字段 ID
示例值："6972464088568269100"
  └ valuestring否自定义字段信息，以字符串形式传入，如： 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"
        }
    ]
}

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
dataoffer_info-
  └ offer_idstringOffer ID
  └ application_idstring投递 ID
  └ schema_idstringOffer 申请表模板 ID，用于描述申请表单结构的元数据定义，即对申请表内容的描述。用户每一次更改 Offer 申请表模板信息，都会生成新的 schema_id，创建 Offer 时应传入最新的 schema_id，可从「获取Offer申请表模板信息」接口中获取
  └ offer_typeintOffer 类型
可选值有：
- 1: 正式 Offer - 2: 实习 Offer
  └ basic_infooffer_basic_infoOffer 基本信息
    └ department_idstring部门 ID
    └ leader_user_idstring直属上级 ID，与入参user_id_type类型一致
    └ employment_job_idstring职务 ID
    └ employee_type_idstring人员类型 ID
    └ job_family_idstring职位序列 ID，通过获取租户序列列表接口获取
    └ job_level_idstring职位级别 ID
    └ probation_monthint试用期
    └ contract_yearint合同期(年)，推荐使用「contract_period」
    └ contract_periodcontract_period_info合同期（年/月）
      └ period_typeint合同周期类型
可选值有：
- 1: 月 - 2: 年
      └ periodint合同时长
    └ expected_onboard_datestring预计入职日期
    └ onboard_address_idstring入职地点 ID
    └ work_address_idstring办公地点 ID
    └ owner_user_idstringOffer负责人 ID，与入参user_id_type类型一致
    └ recommended_wordsstringOffer 推荐语
    └ job_requirement_idstring招聘需求 ID
    └ job_process_type_idint招聘流程类型 ID，详情请查看：获取招聘流程信息
    └ attachment_id_liststring\[\]附件 ID 列表（废弃）
    └ common_attachment_id_liststring\[\]通用附件 ID 列表，可通过获取附件信息接口获取附件的详细信息
    └ attachment_descriptionstring附件描述
    └ operator_user_idstringOffer操作人 ID，与入参user_id_type类型一致
    └ position_idstring岗位 ID，可通过查询岗位信息 获取（仅限飞书人事租户使用，若链接无法打开，则说明飞书人事未启用岗位，请联系技术支持开通）
    └ job_offeredstring入职职位
    └ job_grade_idstring职等 ID
    └ pathway_idstring通道 ID
  └ salary_infooffer_salary_infoOffer 薪资信息
    └ currencystring币种
    └ basic_salarystring基本工资，当启用 Offer 申请表中的「薪资信息」模块时，「基本工资」字段为必传项
    └ probation_salary_percentagestring试用期百分比
    └ award_salary_multiplestring年终奖月数
    └ option_sharesstring期权股数
    └ quarterly_bonusstring季度奖金额
    └ half_year_bonusstring半年奖金额
  └ customized_info_listoffer_customized_info\[\]自定义信息
    └ idstring自定义字段 ID
    └ valuestring自定义字段信息，以字符串形式传入，如： 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状态码错误码描述排查建议
5001002001系统错误请根据实际报错信息定位或咨询技术支持
4001002002参数错误检查参数是否正确，例如类型，大小
5001002053offer already existOffer 已存在，不可重复创建 Offer
5001002054application not exist投递不存在，检查投递 ID 是否正确
5001002055application already terminated投递已终止，不可发起 Offer
5001002056application stage abnormal投递阶段异常，检查投递状态
5001002057schema not the latest version需传入最新版本的 schema_id
5001002058offer attachment not exist附件不存在，检查附件信息
5001002059schema not existschema不存在，检查 schema_id
5001002061formula illegal检查公式信息
5001002062miss in job process该投递阶段不支持创建 Offer
4001002069职务不存在请检查employment_job_id 参数
4001002070职务已停用请检查employment_job_id 参数
4001002071序列不存在请检查job_family_id 参数
4001002072序列已停用请检查job_family_id 参数
4001002073职级不存在请检查job_level_id 参数
4001002074职级已停用请检查job_level_id 参数
4001002075职等不存在请检查job_grade_id参数
4001002076职等已停用请检查job_grade_id参数
4001002077职务、序列不匹配请检查employment_job_id 、job_family_id 参数
4001002078职务、职级不匹配请检查employment_job_id 、job_level_id 参数
4001002079序列、职级不匹配(在序列与职级在生效时间内未查询到关联的生效职务)请检查job_family_id 、job_level_id 参数
4001002080职级、职等不匹配请检查job_level_id、job_grade_id参数
4001002082Offer 附件数量超过限制Offer 附件每个请求最多 20 个，请减少请求中的 Offer 附件数量
4001002083Offer 附件对应的文件不存在请检查附件 ID 是否合法

内容来源：飞书开放平台 · 自动爬取整理

本镜像仅供学习与查阅，文档版权归飞书所有