业务介绍
飞书人事是一款便捷高效的人事管理应用，提升组织能力，助力组织排兵布阵
- 清晰地呈现组织架构和汇报关系，完整地记录组织与人才的全生命周期信息
- 提供简洁高效流程引擎，自动化管理入转调离流程，告别线下审批与沟通
- 通过便捷易用的移动端体验，为管理者随时随地提供团队的数据洞察，辅助用人决策
围绕以上飞书人事的业务功能，我们提供了一系列安全、可靠的API，方便你调用或订阅来开发定制化功能，以满足你所在企业的个性化管理诉求，例如：
- 获取待入职信息，帮助新员工制作工卡
- 获取人员信息变更，同步到下游系统做消费
- 自研 OA 系统新建新公司主体，通过创建公司主体接口数据写入飞书人事
我们会对开放接口保持高频更新，如想获取最新信息可查看更新日志
接入流程
基本接入流程如下图所示，如需了解详细的 API 接入流程，参见流程概述。
| 步骤 | 操作方法 | |
|---|---|---|
| 1 | 创建应用 | 根据应用的使用场景选择创建企业自建应用或创建应用商店应用 |
| 2 | 申请权限 | 根据需要调用的接口文档中描述的「权限要求」到开发者后台申请应用权限 |
| 3 | 调用API | 目前大多数接口仅支持tenant_access_token的访问凭证，具体参见接口文档中的「请求头」-Authorization字段的描述 |
| 4 | 接口测试 | 你可以在 API 调试台中快速调试这些 API ，使用方法参见API 调试台使用指南 |
| 5 | 事件订阅 | 需要到开发者后台配置事件回调地址,确保回调地址公网可访问。可参考事件订阅概述 |
| 6 | 日志检索 | 当调用接口返回失败时，从返回的header部分获取 X-Tt-Logid: 20220501181xxx8035096193288FA。再到应用管理后台，用服务端日志检索 |
资源介绍
飞书人事开放平台能力，按层次划分为三部分
- 基础数据，包含基础常量、组织数据增删改、自定义对象/字段增上改、系统设置等能力，通过这些API 可以生产组织/人员相关的数据供上下游消费。
- 数据变更，包含入职流程流转、发起异动、发起离职、兼职/外派、组织架构调整等能力，通过这些API可以完成组织/人员相关的状态数据变更
- 数据消费，提供个人信息、雇佣信息、部门列表、异动记录等组织/员工数据的查询API 以及数据变更事件。
数据模型
人员领域：
组织领域：
| 资源 | 定义 |
|---|---|
| 员工 | 企业员工的所有信息，包含个人信息，雇佣信息，任职信息，雇佣信息为员工最新状态信息，任职信息包含员工在职期间所有的任职记录 |
| 组织 | 企业内部的结构和管理体系，可添加新的组织建立父子层级关系。组织包含很多实体：部门 - 公司 - 地点 - 成本中心 - 自定义组织 - 组织调整 - 编制规划 |
| 岗职 | 职位等级是用户属性字段。企业可根据组织架构实际情况来自定义管理职级信息。职务、职级、序列、职等、岗位 |
| 入职 | 员工在接受offer 后，正式加入公司的过程。这一过程通常包括多个步骤，确保新员工能够顺利融入组织。包括入职流程和入职信息完善 |
| 试用期 | 新员工在正式成为公司正式员工之前的一段评估期。试用期通常用于评估员工的工作表现和适应能力 |
| 异动 | 员工在组织内的各种人事变动。这些变动可以涉及：职位变动、部门调用、薪酬调整、工作地点变更 |
| 离职 | 员工与公司结束雇佣关系的过程。离职可以是自愿的（如辞职、退休）或非自愿的（如解雇、裁员） |
| 合同 | 合同是指雇主与员工之间达成的法律协议，明确双方的权利和义务 |
| 电子签 | 通过线上方式进行的签署协议或合同的过程，包含电子签模板和文件，具有法律效应 |
| 枚举常量 | 集合了各接口中用到的汇报关系、雇员类型、合同协议类型等枚举 |
| 基础数据 | 提供元数据、地理库、国籍、银行、货币等基础数据能力 |
常见问题
| 问题 | 解决方案 |
|---|---|
| 接口报错："TenantID xxx not found. Please cheeck if the tenant has activated this app" | 未开通飞书人事企业版 |
| 人员、入职都有自定义字段，如何传参？ | 参考 自定义字段使用说明 |
| 不同国家的姓名规则如何填写 | 参考 飞书人事姓名填写规则 |
| 不同国家的地址规则如何填写 | 参考飞书人事地址填写规则 |