更新在职员工为待离职

本接口用于为在职员工办理离职，将其更新为「待离职」状态。「待离职」员工不会自动离职，需要使用「离职员工」API操作离职和资源转交。 使用user_access_token时默认为管理员用户，仅「人事管理模式」的管理员可操作。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/directory/v1/employees/:employee_id/to_be_resigned
HTTP Method	PATCH
接口频率限制	10 次/分钟
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	directory:employee.to_be_resigned:write 更新待离职员工
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 directory:employee.base.external_id:read 查看员工自定义 ID

请求头

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

路径参数

名称	类型	描述
employee_id	string	员工ID，与employee_id_type类型保持一致 示例值："cad2cafa" 数据校验规则： - 长度范围：1 ～ 255 字符

查询参数

名称	类型	必填	描述
employee_id_type	string	否	用户 ID 类型 示例值：open_id 可选值有： - open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - employee_id: 企业内在职员工的唯一标识。支持自定义，未自定义时系统自动生成。ID支持修改。 获取employee_id的方式： - 企业管理员在 管理后台 > 组织架构 > 成员与部门 页面，点击 成员详情，查询员工ID - 通过 批量获取员工列表 的接口，通过手机号或邮箱查询员工ID。 默认值：open_id 当值为 employee_id，字段权限要求： directory:employee.base.external_id:read 查看员工自定义 ID
department_id_type	string	否	部门ID类型 示例值：open_department_id 可选值有： - department_id: 用来标识租户内一个唯一的部门 - open_department_id: 用来在具体某个应用中标识一个部门，同一个部门 在不同应用中的 open_department_id 相同。 默认值：open_department_id

请求体

名称	类型	必填	描述
employee	set_employee_pre_resigned	是	在职员工流转到待离职
└ resign_date	string	是	离职日期 示例值："2024-06-21"
└ resign_reason	string	是	离职原因 示例值："1" 可选值有： - 1: 薪酬不符合预期 - 2: 工作时间过长 - 3: 不满意工作内容 - 4: 不认可上级或管理层 - 5: 职业发展机会有限 - 6: 对公司文化缺乏认同 - 7: 组织架构调整（主动离职） - 8: 合同到期 - 9: 跳槽 - 10: 转行 - 11: 家庭原因 - 12: 健康状况不佳 - 13: 工作地点原因 - 14: 其他(主动离职) - 15: 意外 - 16: 身故 - 17: 解雇 - 18: 试用期不通过 - 19: 工作表现不佳 - 20: 工作产出低 - 21: 组织架构调整（被动离职） - 22: 违纪 - 23: 违法 - 24: 其他（被动离职） - 25: 其他（其他）
└ resign_type	string	是	离职类型 示例值："1" 可选值有： - 1: 主动 - 2: 被动 - 3: 其他
└ resign_remark	string	否	离职备注 示例值："留学深造" 数据校验规则： - 长度范围：0 ～ 255 字符

请求体示例

{
    "employee": {
        "resign_date": "2024-06-21",
        "resign_reason": "1",
        "resign_type": "1",
        "resign_remark": "留学深造"
    }
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

错误码

HTTP状态码	错误码	描述	排查建议
400	2221246	User staff status not updated	用户状态并未更新，已是待离职
400	2221213	Resign date invalid or earlier than join date or empty	请检查日期非空且格式正确，或者离职日期是否早于入职日期
400	2221214	Resign reason invalid or not match resign type	离职原因和离职类型不匹配
400	2221231	Resign type invalid or not match resign reason	离职原因和离职类型不匹配