考勤
考勤模块按日跟踪员工的出勤、工作时间、加班和时间相关数据。每条考勤记录捕获员工的签到时间、签退时间、当天状态和备注信息。
记录考勤
有三种方式记录考勤：从考勤列表、从员工详情页或通过员工门户（自助服务）。
从考勤列表
- 在侧边栏导航到 HRM > 考勤。
- 点击右上角的创建考勤记录。
- 填写表单：
- 员工 — 从下拉菜单中选择员工（仅显示在职员工）。
- 日期 — 默认为今天。修改以记录过去日期的考勤。
- 签到 — 员工开始工作的时间。默认为配置的工作开始时间（如 09:00）。
- 签退 — 员工结束工作的时间。默认为配置的工作结束时间（如 17:00）。
- 状态 — 当天的考勤状态：出勤、缺勤、半天、迟到或请假中。
- 备注 — 可选备注（如"因预约提前离开"）。
- 点击创建。
工作分钟数和加班时间根据签到和签退时间自动计算。您无需手动输入。
信息
每位员工每天只能有一条考勤记录。如果所选员工和日期已存在记录，您需要编辑现有记录。
从员工详情页
- 打开员工详情页。
- 转到考勤选项卡。
- 点击标记考勤（右上角）。
- 员工已预选。填写日期、签到/签退时间 、状态和备注。
- 点击创建。
编辑考勤记录
- 在考勤列表中，点击要编辑的记录。
- 根据需要修改字段——更新签到或签退时间将自动重新计算工作分钟数和加班时间。
- 保存更改。
批量编辑
- 在考勤列表中，使用复选框选择多条记录。
- 点击操作下拉菜单中的批量编辑。
- 更新要在所有选中记录中更改的字段。
自动计算字段
当您提供签到和签退时间时，系统自动计算：
| 字段 | 计算方式 |
|---|---|
| 工作分钟数 | 签退时间与签到时间之间的差值 |
| 加班时间 | 超过每日标准工作时间的工作分钟数（在设置中配置） |
| 状态 | 可根据签到时间相对于工作开始时间和总工作时间自动确定 |
状态类型
| 状态 | 描述 |
|---|---|
| 出勤 | 员工工作了全天且准时到达 |
| 迟到 | 员工在配置的工作开始时间宽限期后到达 |
| 半天 | 员工工作时间少于半天阈值 |
| 缺勤 | 员工未签到 |
| 请假中 | 员工正在批准的休假中 |
员工自助签到
拥有员工门户访问权限的员工可以自行记录考勤，无需管理员操作。
工作原理
当员工以员工角色登录时，可以在考勤区域创建考勤记录。系统对门户用户的工作方式有所不同：
- 员工字段隐藏——系统自动将记录关联到已登录的员工。
- 状态字段隐藏——状态由管理员设定，而非员工。
- 员工填写签到时间、签退时间和可选的备注。
签到 / 签退 API
系统还提供专用的签到和签退端点，可用于集成（如自助终端、移动应用或生物识别系统）：
- 签到 — 记录当前时间 为员工今天的签到时间。防止同一天重复签到。
- 签退 — 记录当前时间为员工的签退时间。需要先有签到记录。自动计算工作分钟数和加班时间。
支持的签到方式包括：
manual— 通过应用程序输入biometric— 来自生物识别设备qr_code— 通过二维码扫描api— 通过 API 集成提交
每次签到和签退操作都会创建一条考勤日志条目，记录时间戳、方式、IP 地址和设备信息，用于审计目的。
注意
员工不能在同一天签到两次。如果签到已存在，系统将返回错误。同样，签退需要已有签到记录，且不能执行两次。
查看和筛选考勤
考勤列表视图
导航到 HRM > 考勤 查看所有考勤记录的表格。表格显示：
- 员工姓名（链接到员工档案）
- 日期
- 签到时间
- 签退时间
- 状态（彩色标记）
表格按日期降序排列（最近的在前）。
保存的视图
考勤列表提供三个预设视图供切换：
| 视图 | 描述 |
|---|---|
| 所有考勤 | 显示所有考勤记录，无筛选 |
| 出勤 | 仅显示状态为出勤、迟到或半天的记录 |
| 缺勤 | 仅显示状态为缺勤的记录 |
筛选
使用筛选面板按以下条件缩小考勤记录范围：
- 状态 — 按一个或多个状态筛选（出勤、缺勤、半天、迟到、请假中）
- 日期 — 按特定日期或日期范围筛选
- 工作分钟数 — 按工作分钟数筛选（如大于 480）
- 加班时间 — 按加班小时数筛选
从员工详情页查看
- 打开员工详情页。
- 点击考勤选项卡。
- 记录以卡片形式显示，展示日期、状态标记 、签到/签退时间、工作时间和加班时间。
- 使用顶部的月份选择器按月筛选记录——仅显示所选月份的记录。
- 向下滚动加载更多记录（无限滚动）。
导出考勤数据
- 在考勤列表中，点击右上角的下拉菜单。
- 选择导出考勤记录。
- 选择您偏好的格式并下载文件。
信息
导出需要导出考勤权限。
导入考勤数据
- 在考勤列表中，点击右上角的下拉菜单。
- 选择导入考勤记录。
- 上传符合要求格式的 CSV 或 Excel 文件。
- 映射列并完成导入。