Spendia开放接口

创建员工辅岗

接口描述

本接口用于员工辅岗创建

限制・前提条件

关于和和部门间的关系、
所属部门必须在部门主数据中登录；
员工的主岗开始日需要在包含在部门的有效开始日和终了日之间；
在Spendia，辅岗没有被期间管理。22年A部门，23年开始变动到B部门，分别生成2条记录登录；
参数的开始终了期间内，对该员工下同一公司・部门的主岗・辅岗是否存在进行校验。
存在的场合，不能新规登录。调用更新的API进行更新。

接口权限

本接口需要集团权限

请求URI

/api/openapi/users/secondary-post

请求方式

POST

请求体示例


{
    "employeeId": "EMP-001",
    "companyCode": "",
    "departmentCode":"",
    "fromDate": "2020-01-01",
    "toDate": "1990-01-01",
    "job": "01",
    "staffType": "01",
    "approvalLevel": "111",
    "staffLevel": "1",
    "managerEmployeeId": "EMP-2",
    "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 否 直属领导工号
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})
60390006 部门在区间{0}到{1}内被禁用(从{2}到{3}) 因为所属部门在主岗有效期内无效，所以不能登录
60390007 部门在区间{0}到{1}内无效(从{2}到{3}) 因为所属部门在主岗有效期内不存在，所以不能登录
60390012 岗位(期间从{0}到{1})的公司与部门在期间{2}到{3}内的对应公司不一致 因为指定的公司和部门所属公司不一致，登录不可
60390010 员工在区间{0}到{1}内已存在同一公司同一部门的有效岗位期间(从{2}到{3}) 该员工同过公司编码，部门编码作为key，在开始终了范围内已经存在其他的辅岗，登录不可
6047054 无效的部门编码
9500006 {0}超出有效范围（1970/01/01 00：00:01～2038/01/19 03:14:07）
60390018 存在主岗有效范围外的辅岗(从{0}到{1}) 开始日在主岗之前的辅岗，登录不可
120226 员工扩展字段编码不存在:{0}
120252 最多有10个扩展字段
6040014 邮箱已被占用
6047018 其他未知错误
6047021 电话号码已被使用
6047028 部门已失效
6047029 无法匹配公司
6047044 工号已存在
6047049 部门编码不能包含汉字
6047050 部门编码不能包含非法字符
6047051 部门编码不能超过36位
6047054 无效的部门编码
6047056 离职日期不能为空
6047057 待离职的员工工号不存在
THIRD_PARTY_APPLICATION_004 无法识别的客户端标识或者该客户端没有权限

← 更新员工辅岗 →