离职员工
接口描述
本接口用于员工离职,员工实际离职日期(即员工不可再登录系统)为员工调用当前时间+公司员工离职延迟时间。 离职时间为指定日期的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 | 该工号找不到员工 | 无 |