升级内容
编制
升级内容 1:支持设置未添加编制时是否允许占编
业务场景&问题:
现状:假设部门5个编制,设置了多维度控编(按职级控编),P1级占2个编制,P2级占3个编制。如果部门没有满编,那么可以招P3、P4、P5的人员
期望:设置了多维度控编,则仅能针对设置的编制维度招人,未设置的维度不能招人。例如,部门有5个编制,P1级占2个编制,P2级占3个编制。则招人时(发起招聘需求 or 添加新员工),只能招2个P1和3个P2,不能招其他级别的人员
解决方案:
支持设置未添加编制时,是否允许占编,可分别对部门整体编制、细分编制进行设置,如下图:
若配置为「视为编制数为 0」:则不允许任何占编时机的事件落地,例如无法入职、异动调入
若配置为「视为不控制编制」:则允许占编时机的时间落地,并不校验是否超编
需要注意:
对于部门整体编制当配置为「视为编制数为 0」时,计算逻辑为:未添加编制的部门,本部门和所有下级部门均不允许所有占编时机落地
对于细分维度编制当配置为「视为编制数为 0」时,计算逻辑为:在所有占编时机的事件落地时(例如入职、异动调入),会校验该员工是否命中了本部门的某个细分维度编制,命中了且未超编,方允许事件落地;否则不允许落地,举例如下:
例 1:细分维度字段仅有「职级」,当前前台有的编制数据:P2 的计划编制数 = 10,P3 的计划编制数 = 10,则 P2、P3 的员工入职时则认为有编制且会校验是否超编,P4、P5 的员工入职则认为无编制
例 2:细分维度字段是「职级」+「职务」,前台所有细分维度的编制数据:P2 + 产品经理 的计划编制数 = 10,P2 + 研发 的计划编制数 = 10,P3 + 产品经理 的计划编制数 = 10,则 P2 + 运营、P3 + 研发的员工入职则认为无编制
例 3:细分维度字段是「职级」+「职务」,前台所有细分维度的编制数据:P2 + 产品经理 的计划编制数 = 10,P2 + 研发 的计划编制数 = 10,则 P2 + 职务为空的员工入职则认为无编制
例 4:细分维度字段是「职级」+「职务」,前台所有细分维度的编制数据:P2 的计划编制数 = 10,产品经理 的计划编制 = 10,P3 + 研发 的计划编制数 = 10,则 P2 + 运营、P3 + 产品经理的员工入职则认为有编制且会校验是否超编,P4 + 运营则认为无编制
假勤
升级内容 1:支持发假记录写入/更新/撤销接口
业务场景&问题:
部分员工使用其他系统进行管理,需要将发假记录写入到moka,后续离职清算时需要计算
解决方案:
接口地址:假勤接口API – Moka People API在线文档 (mokahr.com)
注意:发假数量仅支持>0的数据
会存在以下校验:
错误校验 | 校验内容 | 提示信息 |
必填校验 | 必填字段是否校验,若为撤销时仅校验发假记录id | 请求失败,XXX必填字段内容缺失 |
员工 | 是否存在 | 请求失败,员工不存在 |
员工当前没有出勤规则 | 出勤规则不存在 | |
假期类型 | 应为员工当前的出勤规则中关联的休假规则,适用的假期类型 | 请求失败,员工不适用该假期类型 |
发假数量 | 是否>0 | 请求失败,不支持写入非正数的发假记录 |
生效日期与失效日期 | 生效日期需≤失效日期 | 生效日期必须小于等于失效日期 |
写入后会生成发假记录,员工对应假期类型的余额会自动变更
发假记录来源需标记为【接口同步】的发假记录,发假记录明细中可以筛选查看
升级内容 2:请假记录写入/更新接口优化
业务场景&问题:
部分员工使用其他系统进行管理,需要将请假记录写入到moka且不依据考勤规则计算请假时长,请假时长以写入的为准
解决方案:
支持外部写入的请假记录,不校验休假规则,在原请假记录接口的基础上增加了3个字段,若写入了请假时长,则不校验休假规则(但写入的情景)
增加的参数名称 | 类型 | 是否必填 | 备注 |
duration | decimal | 否 | 请假时长; 如果写入请假时长,则以写入的数据为准;不写入请假时长则根据休假规则进行计算; |
unit | int | 否 | 请假单位,天或小时 1:天 2:小时 说明:日报数据统计时会统计到【请假时长归属日期】,建议拆分为每天的数据进行写入,即单位为天时≤1,单位为小时时≤24 |
leaveDate | String | 否 | 请假时长归属日期,yyyy-mm-dd,用于统计请假时长统计使用,若为空则默认为请假开始日期 |
校验的差异如下:
错误校验 | 写入请假时长时是否校验 | 校验内容 |
必填校验 | 是 | 必填字段是否校验,若为撤销时仅校验审批id |
员工 | 是 | 是否存在 |
是 | 员工当前没有出勤规则 | |
是 | 员工的请假日期状态为已离职 | |
请假类型 | 是 | 应为员工当前的考勤规则中关联的休假规则,适用的假期类型 |
请假日期+时间 | 是 | 结束日期+时间≤开始日期+时间 |
是 | 请假时间段与已有请假数据重复 | |
请假日期+时间 | 否 | 请假期间内的日期没有排班 说明:请假按工作日计算时需要校验,按自然日计算不需要校验 |
否 | 请假开始时间不在工作时间内 | |
否 | 请假结束时间不在工作时间内 | |
否 | 请假不符合请假单位 | |
否 | 不满足最小时长 | |
请假时长 | 是 | 假期余额不足 若请假时长为空时,需根据请假开始和结束日期自动计算 |
是 | 若请假时长有值,则需校验请假单位是否有值 |
写入后会生成请假记录,若请假时长有值时,不需要以休假规则计算,直接按写入的时长落地
请假记录状态无论是审批中或通过,需计算请假时长,若为【余额限制】类型的假期类型时,需扣除对应的假期账户额度
请假记录来源需标记为【接口同步】的请假记录
审批通过或撤销的请假记录需触发员工期间内考勤核算和月报核算
若请假时长有值时,则出勤日报统计以【请假时长归属日期】进行统计
例如:员工班次为9月4日22:00-次日08:00,员工请假为09-05 02:00-08:00,请假时长6个小时,若【请假时长归属日期】写入了09-04,则日报统计在09-04,若未写入则统计在09-05
升级内容 3:停用考勤组名称可编辑
业务场景&问题:
考勤组停用后无法启用(避免启用后员工考勤组重新批量匹配,历史考勤结果存在异常),但名称会校验所有考勤组,新建考勤组想复用原考勤组名称时无法实现。
解决方案:
支持停用考勤组可编辑考勤组名称