查询员工离职原因列表

该接口用于查询离职配置> 离职原因的选项信息，包括离职原因选项的唯一标识、名称和启用状态等信息。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v1/offboardings/query
HTTP Method	POST
接口频率限制	100 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	corehr:common_data.preset_data:read 获取预置数据信息 corehr:corehr:readonly 获取核心人事信息 corehr:corehr 更新核心人事信息 corehr:common_data.preset_data:write 更新预置数据信息

请求头

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

请求体

名称	类型	必填	描述
active	boolean	否	离职原因状态，为空时默认搜索所有状态的离职原因。可选项有: -true: 启用 -false: 停用 示例值：true
offboarding_reason_unique_identifier	string\[\]	否	离职原因唯一标识列表，用于过滤离职原因，为空时默认搜索所有离职原因，最多支持20个 示例值：["offboarding_reason_unique_identifier"]

请求体示例

{
    "active": true,
    "offboarding_reason_unique_identifier": [
        "offboarding_reason_unique_identifier"
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ items	offboarding_reason\[\]	离职原因列表
└ offboarding_reason_unique_identifier	string	离职原因唯一标识，可用于开放平台操作员工离职、搜索离职信息等接口入参中的离职原因。
└ name	i18n\[\]	名称
└ lang	string	名称信息的语言
└ value	string	名称信息的内容
└ active	boolean	是否启用，可选项有： - true - false
└ parent_offboarding_reason_unique_identifier	string	当前离职原因的父级原因唯一标识
└ created_time	string	创建时间，格式："YYYY-MM-DD HH-mm-ss"
└ updated_time	string	更新时间，格式："YYYY-MM-DD HH-mm-ss"

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "offboarding_reason_unique_identifier": "reason_for_offboarding_option8",
                "name": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ],
                "active": true,
                "parent_offboarding_reason_unique_identifier": "offboarding_reason_1",
                "created_time": "2021-08-20 20:28:23",
                "updated_time": "2022-01-07 17:21:06"
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1160103	general internal server error code	调用上下游系统错误，重试后仍报错，请咨询技术支持。
500	1160201	has approving offboarding	存在「审批中」或「待生效」的离职申请，请先撤销后再申请
500	1160203	no current contract	所选离职日期无生效中的合同，请确认合同信息后重新提交
500	1160204	has future contract	存在晚于离职日期生效的合同，请确认合同信息后重新提交
500	1160205	contract has actual end date	离职日期时的合同已存在实际结束日期，请确认合同信息后重新提交
500	1160210	has offboarding record	存在「审批中」或「待生效」的离职申请，请先撤销后再申请
500	1160602	offboarding is earlier than probation	存在晚于离职日期的转正记录，请重新选择离职日期或先撤销试用期转正申请
500	1160603	offboarding is earlier than transform	存在晚于离职日期的异动记录，请重新选择离职日期或先撤销异动申请
400	1160604	reason explanation length exceed maximum	离职原因说明长度超过最大限制(6000)
500	1160616	no valid job data	该员工没有合法的任职记录，请确认任职记录后重新提交
500	1161000	unknown error	调用上下游系统错误，重试后仍报错，请咨询技术支持。