OpenAPI

升级内容 1：支持附件上传接口

业务场景&问题：

● 没有附件上传，导致附件无法预览和下载

解决方案：

请求body（业务接口查询参数，需要开发）

● 支持附件上传，一次上传一个附件

升级内容 2：支持选项类字段批量导入选项

业务场景&问题：

● 客户外部有较多选项需要自动同步，目前主要提供给二开使用

解决方案：

新增「批量导入指定字段选项」OpenAPI ，具体调用参数见上线后openAPI文档。

特殊说明：

● 单次导入上限：100

● 单字段内选项上限：1000

升级内容 3：出勤月报记录支持接口写入

业务场景&问题：

客户使用外部系统进行月报统计时，系统没有提供对外的标准接口可供客户自行对接写入系统，仅可通过Excel导入系统，使用效率较低

解决方案：

新增出勤月报写入接口

接口说明：第三方通过该接口写入员工出勤月报数据

基本信息

请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/statistics/report/month/write

请求频率：20次/秒/企业，1000次/分钟/企业

请求方式：POST

请求头 Header

请求参数 Query Param

请求体 Request Body

响应体 Response Body

返回结果data说明

【错误校验】

● 封存状态、变更状态、发送状态、确认状态及员工信息数据不支持写入。确认状态到封存时间将变成自动确认。

● 月报写入后若字段与原值有差异，则产生一条变更记录。若写入结果与原值一致，则不产生变更记录--原逻辑，需验证

○ 变更记录的操作时间为写入时间，操作人以接口写入为准。来源为接口写入

升级内容 4：任职接口支持回显离职员工停用部门

业务场景&问题：

任职数据接口，已离职员工如果部门停用了，无法通过接口获取部门ID和名称

解决方案：

● 离职员工，部门停用，返回部门ID，以及离职日期部门对应名称

● 离职员工，职位停用，返回职位ID，以及离职日期职位对应名称

● 在职/离职员工，选项字段（员工类型、工作地点、职务、职级、管理职级、单选、事件原因、离职原因）停用时，返回对应ID，以及对应ID的枚举

● 在职/离职员工，人员字段（直接上级、导师、虚线上级、自定义人员字段）离职时，返回对应员工ID和姓名

PS：旧接口不兼容，需要使用新版本，只需要替换接口地址接口

薪酬

升级内容 1：薪酬填报可引用指定薪资核算活动的薪资项目作为参考项目

业务场景&问题：

● 部门管理者填报部分薪资项目时，需要参考历史数据进行填报，当前填报时无法关联展示历史薪酬活动中的指定薪资字段值，手动查找效率低且容易出错

解决方案：

● 薪酬填报中【选择展示项目】中增加「工资项」展示

● 

● 点击「工资项」展示后可选择当前已归档的薪酬核算活动中的工资项目作为展示字段

● 

● 进入填报活动后，所有展示状态均为只读状态，不可编辑

○ 展示顺序上员工信息在前，工资项在后

○ 填报时若薪酬核算活动取消归档后重新计算，将实时变更填报活动中的参考项目的值

○ 员工在关联薪酬活动中存在对应数据，正常展示历史字段值

○ 员工在关联薪酬活动中无对应数据（如新员工、该期未参与活动），显示“-”，不影响正常填报

● 导入填报项目时，增加配置：可选择是否导出展示项目

○ 勾选时导入模板中带出展示项目。修改参考项目导入系统时不会修改系统数据

○ 未勾选时导入模版保持现状

● 

○ 导出展示项目时的模板

假勤

升级内容 1：打卡记录增加打卡经纬度字段

业务场景&问题：

● 外勤人员打卡时会出现未知地点打卡，HR无法判断打卡记录是否有效

解决方案：

● 打卡记录自定义列中增加：经度、纬度字段

○ 所属分组：打卡记录

○ 若打卡记录无经纬度数据，则显示“-”

■ 当前仅移动端打卡和接口写入有经纬度记录

■ 

升级内容 2：外勤打卡的时间范围限制配置可拆分出差和外出

业务场景&问题：

外勤打卡关联出差或外出审批单的场景，目前对出差和外出两种场景分配配置外勤打卡范围，导致打卡时间范围配置不灵活，无法满足企业的差异化管理需求

解决方案：

1. 将原来的"关联出差/外出记录"配置拆分为两个独立配置项：

a. 关联出差记录 + 出差打卡时间范围

b. 关联外出记录 + 外出打卡时间范围

c. 勾选后，要成功进行外勤打卡需关联审批申请。若仅勾选一项，则员工必须关联该类型申请。

d.

2. 新考勤组启用外勤打卡后默认不勾选。历史考勤组数据若客户已有配置规则，则外出和出差均勾选，且配置内容需要与客户已有配置保持一致

3. 「打卡限制」配置支持进行批量复制

4. 员工进入外勤打卡页面时，系统根据当前时间和考勤组配置的时间范围，分别过滤出差记录和外出记录，只展示符合条件的审批单。

a. 若考勤组配置的出差和外出申请时间不同时，则需要根据打卡时间判断可选择的审批单

i. 例如

1. 考勤组配置：

a. 出差：申请日期当天（00:00-23:59）

b. 外出：开始前60分钟，结束后60分钟

2. 员工审批记录：

a. 出差记录：2月20日 09:00-18:00

b. 外出记录：2月20日 14:00-16:00

3. 当前时间：2月20日 13:00

4. 过滤结果：

a. ✅ 出差记录可见（在申请日期当天）

b. ❌ 外出记录不可见（当前时间13:00不在13:00-17:00范围内）

升级内容 3：多次上下班按天请假时请假小时数逻辑优化

业务场景&问题：

多次上下班的班次，当天有半天请假（上午-上午或下午-下午）时，未剔除班次间的间隔时间，导致当天的请假小时数超过下午的工作时间

解决方案：

1. 优化请假小时数的统计逻辑

a. 若当天为多次上下班时，考勤日当天有半天的请假时

i. 请假天数=0.5天。请假小时数=（中间时间~最晚下班时间）中与工作时段取交集

绩效

升级内容 1：绩效固定指标脱离模板变为考核方案配置

业务场景&问题：

客户绩效通常按岗位进行设置固定考核指标，目前绩效模板和固定指标是1:1配置的，导致客户会设置很多绩效模板。

解决方案：

1、固定的考核项变为基于考核方案设置，考核方案中可以按适用范围设置固定指标，配置可实现按岗位设置固定指标。

2、一个绩效模板可以添加多个考核方案，在配置绩效活动时根据设置的评估组对应的适用范围会与考核方案配置的适用范围自动对应匹配，如果有员工存在多个考核方案则会引导手动调整。实现一个人对应一套考核方案。（仅限于绩效模板，试用期模板不变）

详细功能：

【绩效模板设置】

· 绩效模板增加对应的考核方案数量字段，可点击展开查看当前绩效模板对应的考核方案列表。

· 绩效模板操作项中新增添加考核方案功能，并与停用绩效模板功能一起收起在三个点中。

· 点击添加考核方案可为该绩效模板添加对应的考核方案。

· 对于基础信息中未配置在考核方案中维护的绩效模板，不可添加考核方案。

【绩效模板设置-考核方案列表】

· 列表中默认筛选启用中的考核方案，可以点击左上角切换筛选停用的和全部的考核方案。

· 列表中展示考核方案的主要信息（名称、适用范围、所属模板、管理员），可操作项为编辑、停用，可以点击添加考核方案为该绩效模板添加。

【绩效模板设置-添加考核方案】

· 点击添加考核方案弹窗填写考核方案内容，考核方案名称必填，建议填写对应适用范围的考核方案名字，容易区分，如：xx部门xx岗位月度绩效考核方案。

· 适用范围默认全体员工，即对绩效活动评估组下的全体员工适用。可自行制定员工范围，进一步的在绩效活动-评估组中细化考核不同人员的不同固定指标。

· 考核项可以手动添加，也可以从指标库中引用。此时手动添加的考核项字段内容来源于绩效模板中的配置，相应的，维度下如果开启了自动计算，那么需在考核项中选择对应的计算规则。

· 填写后点击保存即可。

· 指标库引入的操作，与原来的交互一致。

【绩效模板-基础信息】

· 绩效模板配置时，基础信息中可以选择固定考核内容是在考核方案中维护还是在考核表中维护，在考核表中维护就与旧逻辑一致，选择考核方案中维护就需在模板配置完成后添加对应的考核方案。

· 对于租户现有的绩效模板，镜像是不允许修改此处的，对于非镜像默认还是按在考核表中维护，可手动修改为在考核方案中维护，此时在添加考核方案时会自动将原固定指标内容回写进去，方便快速创建考核方案。

【绩效模板-考核表配置】

· 当基础信息选择在考核方案中维护时考核表配置中展示提示信息，即不在此处配置。

· 当基础信息选择在考核表中维护时考核项与旧功能一致，可直接添加固定考核指标，此处增加了自动计算规则的联动配置，取消掉原自动计算规则的配置。

· 若绩效模板配置了考核方案，在删除维度、调整维度字段内容、调整维度权重时都会对应影响考核方案中的考核项。

· 在绩效活动的模板镜像中无论是否开启活动，只要有考核方案，都无法修改维度权重。

【绩效活动】

· 在绩效活动设置评估组时若有员工同时满足了多个考核方案则会提示去制定。

· 点击去指定后可以指定重复员工应该对应的评估组与考核方案，支持多选批量指定。

· 批量指定选择的员工有误时会再单独弹窗提示重新选择。

【绩效活动-被评估人列表】

· 导入被评估人的模板中增加了考核方案字段，需填写考核方案名称。

· 导入后若一个员工有多个考核方案则会在异常中提示，此时需指定考核方案。

· 在页面中添加被评估人时同样需选择考核方案。

升级内容 2：绩效评估总评语支持链接解析

业务场景&问题：

绩效评估时，总结是飞书文档写的，希望链接进来，方便管理者评估时直接点击查看，目前不支持链接解析，只能通过复制链接文本，体验不佳

解决方案：

● 绩效待办详情的多行文本和总评语都会生效，需要注意，尽量让链接和文字直接保留一个空格

电子签

升级内容 1：电子签文件模板支持设置自定义字段必填

业务场景&问题：

「补充信息」分组下的自定义字段不支持设置必填

解决方案：

1. 编辑文件模板，新增了「补充信息」分组下的自定义字段，并添加到文件中后，点击「确定」弹出「设置必填项」弹窗

a. 弹窗支持直接设置自定义字段为必填项

b. 文件模板的电子签设置也支持设置自定义字段为必填项

设置必填项后，在发起签署时会校验字段的必填。

审批

升级内容 1：审批表单访问性能优化：新增只读态审批表单，默认打开只读

业务场景&问题：

审批表单打开慢

解决方案：

1. 新增「只读」模式表单，只读模式下将过滤以下逻辑，用于提升表单加载效率（慢case下6s可优化至2.5s左右，常规case 2秒左右可优化至1-1.5秒）：

a. 过滤所有表单未使用的数据内容

b. 不在触发非必要的计算接口调用

c. 什么时候触发只读模式？

i. 条件1: 当前流程节点无任意字段编辑权限时

ii. 条件2: 当前流程节点有字段编辑权限 && 表单必填项均已填写 && 节点设置「默认只读模式加载」

iii. 以上任意条件满足都默认「只读」，否则，按原逻辑加载

2. 支持自定义节点优先打开模式：无需编辑时，优先「只读」 ——上线后默认开，如果有需要可手动将需要编辑的节点关闭

3. 上线后，第一次触发只读模式时引导

升级内容 2：支持批量设置（导入）审批节点字段权限

业务场景&问题：

节点字段权限不支持批量设置，逐个节点修改操作繁琐，效率低

解决方案：

新增「导入表单字段权限」功能：

注：不要修改表单表头信息，按需更新支持设置的项即可