离职员工

接口描述

本接口用于员工离职,员工实际离职日期(即员工不可再登录系统)为员工调用当前时间+公司员工离职延迟时间。 离职时间为指定日期的23:59:59

生效时间可在【管理员模式】-> 【集团模式】-> 【设置】-> 【安全设置】中,进行配置。

接口权限

本接口需要集团权限

请求URI

/api/openapi/users/leave

请求方式

DELETE

请求体示例

{
    "employeeId": "EMP-001",
    "leavingDate": "2020-1-1"
}

请求体字段

字段名 类型 必填 主键 约束 说明
employeeId String 员工工号
leavingDate String 日期格式: yyyy-MM-dd 如果传值,则员工在传值日期离职。
如果为空,则本接口调用日期+配置离职延迟时间 离职。

接口返回示例

成功

{
    "message": "success",
    "oid": "cbd0bf2f-b355-4c2b-818b-6811d683ed40",
    "key": "EMP-001"
}

失败示例

{
    "message": "当前操作需要租户权限",
    "errorCode": "120001"
}

字段说明

字段名称 类型 说明
message String 返回信息说明
errorCode String 返回错误码
oid UUID 员工OID
key String 员工工号

错误代码

errorCode message 说明
120001 当前操作需要租户权限
120003 缺少必填项:{0} 必填字段不能为空
6013009 日期格式为:yyyy-MM-dd
6047034 该工号找不到员工