更新部门角色员工

接口描述

此接口用于对已存在部门,设置部门角色。部门角色必须提前设置完成。

限制・前提条件

上长信息必须在员工主数据中存在
关于参数的开始日、
无值时、不进行履历管理、用角色编码作为主键、覆盖更新、同一部门同一角色的上长只能设置一人;
有值时、更新的主键为角色编码,上长番号,开始日的组合、同一部门同一角色的上长可以设置多人。

接口权限

本接口需要集团权限

请求URI

/api/openapi/department/roles

请求方式

PUT

请求体示例

{
    "departmentCode": "3001",
    "departmentRoles": [
        {
            "departmentRoleCode": "6101",
            "employeeId": "EMP-001",
            "fromDate":"2021-03-03",
            "toDate":"2021-03-04",
            "isDelete":false
        },
        {
            "departmentRoleCode": "3002",
            "employeeId": "EMP-002",
            "fromDate":"2021-03-03",
            "toDate":"2021-03-04",
            "isDelete":false
        }
    ]
}

请求体字段

参数名 类型 是否必填 主键 规则 说明
departmentCode String 最大长度 36 部门编码
departmentRoles DepartmentRole[] 部门角色列表

DepartmentRole

参数名 类型 是否必填 主键 规则 说明
departmentRoleCode String 最大长度20 部门角色编码。部门经理编码为6101
employeeId String 最大长度32 员工工号
fromDate String 日期格式:yyyy-MM-dd 开始日。使用"isDelete"参数时,开始日必填
toDate String 日期格式:yyyy-MM-dd 结束日
isDelete Boolean 是否删除

接口返回示例

成功

{
    "message": "success",
    "oid": "d1de43ba-7cd6-496b-b07b-e16a2a5da7b9",
    "key": "TEC-1"
}

失败示例

{
    "message": "部门不存在",
    "errorCode": "6061002"
}

字段说明

字段名称 类型 说明
message String 返回信息说明
errorCode String 返回错误码
oid UUID 部门OID
key String 部门编码

错误代码

errorCode message 说明
120001 当前操作需要租户权限
120003 缺少必填项:{0}
120115 没有可用的部门角色
120116 部门角色编码不能重复
1202071 员工不存在:{0}
6013009 日期格式为:yyyy-MM-dd
6047054 无效的部门编码 在开始时点(空白时使用系统时间),该部门尚未存在时、更新失败并报错
61000014 角色员工不存在 员工主数据中、指定的上长不存在
120015 开始日期不能大于结束日期