创建部门

接口描述

此接口用于创建新部门

限制・前提条件

有指定上位部门时，请注意执行顺序(上位部门先登录)

接口权限

本接口需要集团权限

请求URI

/api/openapi/departments

请求方式

POST

请求体示例

{
    "code": "TEC-1",
    "name": "技术一部",
    "companyCode": "COM002",
    "parentDepartmentCode": "TEC",
    "fromDate": "2021-03-03",
    "customFields": [
        {
            "fieldCode": "country",
            "value": "CN"
        }
    ]
}

请求体字段

Department

参数名	类型	必填	主键	约束	说明
code	String	是	○	最大长度 36	部门编码
name	String	是		最大长度 50	部门名称
companyCode	String			最大长度 36	所属公司编码
parentDepartmentCode	String			最大长度 36	父级部门编码
fromDate	String			日期格式：yyyy-MM-dd	部门开始日期
customFields	CustomField[]			最多10个	部门扩展字段列表

CustomField

参数名	类型	必填	主键	约束	说明
fieldCode	String	○	○	最大长度 50	自定义字段编码
value	String			最大长度 200	自定义字段值，如果自定义字段设定为必填，则该值不可为空

接口返回示例

成功

{
    "message": "success",
    "oid": "3249b50a-1e29-4cae-93ea-bfec4955fafa",
    "key": "TEC-1"
}

失败示例

{
    "message": "部门编码已存在",
    "errorCode": "120107"
}

字段说明

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

错误代码

errorCode	message	说明
0013	参数:{0},最大长度{1}
120001	当前操作需要租户权限
120003	缺少必填项:{0}
120228	部门最多有10个扩展字段
120229	部门扩展字段编码不能为空
120230	部门扩展字段值不能为空
120231	部门扩展字段编码不存在:{0}
120232	部门扩展字段编码不能重复
6047048	部门编码已存在
6047055	无效的公司编码
6061006	自定义字段:{0} 的值填写不正确
9312007	无效的上级部门编码
9312008	不能指定自己及子部门为上级部门
6013009	日期格式为:yyyy-MM-dd
9312004	部门名称中不允许包含特殊字符
6040004	公司为空或已失效
2009	获取clientId失败
120015	开始日期不能大于结束日期
120107	部门编码已存在
123302	部门编码不存在
6044012	同级别部门不能超过999个	同一个上级部门的下面，最多可以登录999个下级部门
6057001	编码不能包含汉字
6057002	编码不能包含非法字符
6057003	编码长度不能超过36位
6061002	部门不存在
6061005	自定义字段:{0} 不能为空
6061007	自定义字段:{0} 的值未按扩展字段规则填写
6061008	自定义字段:{0} 的值整数位数未按扩展字段规则填写
6061009	自定义字段:{0} 的值浮点数位数未按扩展字段规则填写
6061010	自定义字段:{0} 的值时间格式不对
6061011	自定义字段:{0} 的值日期格式不对
8702003	操作失败,员工归属公司与归属部门对应公司不一致
12020015	租户不存在
61000002	部门已经存在{0}到{1}的期间
61000003	缩短期间内({0}~{1})存在有效员工
61000004	当前基准日期下没有组织架构版本
61000005	缩短期间内({0}~{1})存在有效子部门
61000006	部门已存在开始日期为{0}的期间
61000015	字段:{0}，请不要输入【英文字母，数字，-，_】 以外的字符
61000007	父级部门在{0}~{1}期间内不存在或已停用	下级部门的有效期间不能在上级部门的有效期间以外