更新员工辅岗

接口描述

本接口用于员工辅岗更新

限制・前提条件

关于和和部门间的关系、
所属部门必须在部门主数据中登录；
员工的主岗开始日需要在包含在部门的有效开始日和终了日之间；
在Spendia，辅岗没有被期间管理。；
从22年开始兼任A部门B部门，23年开始A部门的兼任结束，改为兼任B部门C部门时，需要通过更新API缩短或结束B部门的兼任，通过登录API重新注册C部门的兼任。

接口权限

本接口需要集团权限

请求URI

/api/openapi/users/secondary-post

请求方式

PUT

请求体示例

{
    "employeeId": "EMP-001",
    "companyCode": "",
    "departmentCode":"",
    "fromDate": "2020-01-01",
    "toDate": "1990-01-01",
    "job": "01",
    "staffType": "01",
    "approvalLevel": "111",
    "staffLevel": "1",
    "managerEmployeeId": "EMP-2",
    "postStatus": "N",
    "customFields": [
        {
            "fieldCode": "custom1",
            "value": "15"
        },
        {
            "fieldCode": "custom2",
            "value": "test"
        }
    ]
}

请求体字段

字段名	类型	必填	主键	约束	说明
employeeId	String	是	○		员工工号
companyCode	String	是	○		公司编码
departmentCode	String	是	○		部门编码
fromDate	String	是	○	日期格式: yyyy-MM-dd	开始日期
toDate	String	否		日期格式: yyyy-MM-dd	结束日期
job	String	否		值列表:职务,最大长度 50	职务
staffType	String	否		值列表:人员类型,最大长度 50	人员类型
approvalLevel	String	否		值列表:审批级别,最大长度 10位数字	审批级别
staffLevel	String	否		值列表:级别,最大长度 100	员工级别
managerEmployeeId	String	否			直属领导工号
postStatus	String	否		默认：有效	有效-Y 无效-N
customFields	CustomField[]	否		最多10个,不支持图片类型的字段	岗位扩展字段列表,fieldCode不能重复

CustomField

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

接口返回示例

成功

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

失败示例

{
    "message": "公司不存在",
    "errorCode": "121301"
}

字段说明

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

错误代码

errorCode	message	说明
0013	参数:{0},最大长度{1}	字段长度超出限制
120001	当前操作需要租户权限
120003	缺少必填项:{0}	必填字段不能为空
120210	Email不合法	无
120222	员工最多有10个扩展字段	无
120223	员工扩展字段编码不能为空	无
120224	员工扩展字段校验失败:{0}	无
120225	员工扩展字段值不能为空	无
120227	员工扩展字段编码不能重复	无
121301	公司不存在	无
121307	部门不存在	无
6013009	日期格式为:yyyy-MM-dd	无
6047034	该工号找不到员工	无
6047060	无效的直属领导工号	无
6047061	性别不存在	无
6047062	人员类型不存在	无
6047063	职务不存在	无
6047064	级别不存在	无
6061005	自定义字段:{0} 不能为空	无
6061006	自定义字段:{0} 的值填写不正确	无
6061007	自定义字段:{0} 的值未按扩展字段规则填写	无
6061008	自定义字段:{0} 的值整数位数请输入{1}位以内	无
6061009	自定义字段:{0} 的值浮点数位数请输入{1}位以内	无
6061010	自定义字段:{0} 的值时间格式不对	无
6061011	自定义字段:{0} 的值日期格式为YYYY-MM-dd	无
8702002	操作失败,存在未关联公司的部门	无
8702003	操作失败,员工归属公司与归属部门对应公司不一致	无
12458005	员工ID只能是20位以内字母、数字、-、_	无
12458006	输入的员工ID已存在，请重新输入	无
136791004	请输入20字以内的字符
6047055	无效的公司编码
120103	部门不存在
6047068	审批级别不存在
120015	开始日期不能大于结束日期
60390003	未找到员工的主岗(基准日期{0})
60390008	岗位已存在开始日期为{0}的期间
60390015	变更岗位开始日{0}为{1}跨越了一个期间(从{2}到{3})
6040005	公司无效
60390017	主岗在区间{0}到{1}内无效(从{2}到{3})
60390016	主岗在区间{0}到{1}内被禁用(从{2}到{3})
60390007	部门在区间{0}到{1}内无效(从{2}到{3})	因为所属部门在主岗有效期内不存在，所以不能登录
60390006	部门在区间{0}到{1}内被禁用(从{2}到{3})	因为所属部门在主岗有效期内无效，所以不能登录
60390012	岗位(期间从{0}到{1})的公司与部门在期间{2}到{3}内的对应公司不一致	因为指定的公司和部门所属公司不一致，登录不可
60390010	员工在区间{0}到{1}内已存在同一公司同一部门的有效岗位期间(从{2}到{3})
6047071	不存在有效的辅岗，失效处理失败	该员工通过公司编码，部门编码，开始日作为key查询该辅岗不存在，更新不可
60390019	存在岗位期间外的业务单据，保存失败	由于通过该辅岗位已经有起票的实际，终了日不可更新为单据基准日之前的日期
60390020	该岗位已存在业务单据，禁用失败	由于通过该辅岗位已经有起票的实际，不可禁用
120226	员工扩展字段编码不存在:{0}
120252	最多有10个扩展字段
6040014	邮箱已被占用
6047018	其他未知错误
6047021	电话号码已被使用
6047028	部门已失效
6047029	无法匹配公司
6047044	工号已存在
6047049	部门编码不能包含汉字
6047050	部门编码不能包含非法字符
6047051	部门编码不能超过36位
6047054	无效的部门编码
6047056	离职日期不能为空
6047057	待离职的员工工号不存在
9500006	{0}超出有效范围（1970/01/01 00：00:01～2038/01/19 03:14:07）
THIRD_PARTY_APPLICATION_004	无法识别的客户端标识或者该客户端没有权限