This document reorganizes the existing "Biometric Module Guide" knowledge base article into an Admin / Employee structure. All content, steps, field names, and rules below are taken directly from the source article at hello.besimplified.com — nothing has been added, removed, or invented. Only the grouping and headings have changed.
Note on Role Scope: The source article is almost entirely administrator-facing (installation, provider setup, device configuration, and reports). It describes exactly one employee-facing feature: the "Biometric Activity Today" card in My Activity, where users view and refresh their own current-day punch data. Configuration, reports, and troubleshooting for devices/providers are documented under Admin only.
Admin → Biometric
Overview
The Biometric module helps you track and manage employee attendance through automated punch-in and punch-out data collection. This comprehensive guide covers installation, configuration, and reporting features.
Important: The Biometric module is a premium feature that requires a Pro subscription.
Before You Begin — Prerequisites:
-
Pro subscription to Simplified HR.
-
Access to admin privileges for configuration.
-
Biometric device provider credentials (API details).
-
Device IDs and location information.
Install Biometric Module
Step 1: Install from Marketplace
-
Navigate to Marketplace in your Simplified HR application.
-
Search for and select the Biometric plugin.
-
Click Install to add the module to your account.
Important: For detailed installation instructions, refer to the Marketplace Installation Guide (hello.besimplified.com/hc/docs/articles/1756358900-marketplace).
Access Biometric Module
Step 2: Access the module
Once installed, you can access the Biometric module from multiple locations:
Configure Biometric Module
Admin users can customise the Biometric module to match your organization's specific requirements.
Accessing configuration settings:
-
Navigate to one of the following: My Apps > Biometric, My Library > Biometric, or Control Centre > Biometric.
-
Click the Configuration tab.
Configure Provider
Select your biometric provider:
-
Choose your provider from the dropdown menu.
-
Currently, Matrix's COSEC VYOM is integrated.
-
Contact support for integration with other providers.
Configure Device Connection
Enter the following information provided by your biometric service provider:
-
API URL — The endpoint for your biometric service.
-
Username — Authentication username.
-
Password — Authentication password.
Important: Verify all details are correct to ensure a successful connection with your biometric devices.
Map Biometric Devices
Add and configure biometric devices based on their physical locations:
-
Enter the device's physical location name.
-
Assign the corresponding device ID.
-
Repeat for each device in your organisation.
Configure Access Card Information
Configure how the system retrieves employee access card data:
-
Select the field containing access card information.
-
Optionally, create a custom field if needed.
Important: To add a custom field, navigate to: System > Module Setting > My Profile > Custom Field.
Configure Tracked Time Grace Period
The Tracked Time Grace Period allows you to set an acceptable variance between desktop application tracking and biometric system data.
How It Works
When the difference between tracked time and biometric data exceeds your configured threshold, a yellow indicator appears in reports, signalling potential discrepancies.
Configuring the Grace Period
-
Check Track differences between logged time and PunchIt duration.
-
Enter the allowable difference percentage in the field.
-
Click Save to apply your settings.
Review Time Discrepancies
Discrepancies are identified by comparing tracked/logged time against biometric punch duration. When the difference exceeds the configured Tracked Time Grace Period threshold, a yellow indicator appears in reports.
Important: This discrepancy indicator relates specifically to the variance between desktop/activity tracker time and biometric duration — it is separate from the red indicator, which flags an improper punch-in/punch-out process rather than a time variance.
Access Biometric Reports
The Biometric Report provides comprehensive attendance data, including punch-in/out activities, locations, durations, and discrepancy identification.
Important: Prerequisites: You must have appropriate report permissions assigned.
-
Go to Control Center > Reports.
-
Select My Apps > Biometric.
View Daily Biometric Report
Overview Section
The overview section of the Punchit report shows the number of members who have punched in and punched out for the selected day. It provides a quick snapshot of attendance activity for that specific date.
Summary Section
Shows detailed punch data for each member:
View Detailed Punch Events
Click the down arrow next to any member's record to expand and view:
-
All punch events with timestamps.
-
Associated access points.
-
Colour-coded status indicators.
Understand Punch Status Indicators
Each punch record includes a colored dot showing data accuracy:
-
Green Dot: No discrepancies detected; proper punch-in/out process followed.
-
Yellow Dot: Discrepancy between biometric duration and activity tracker time.
-
Red Dot: Punch-in/out discrepancy detected; improper process followed.
View Weekly Biometric Report
Overview Section
Shows overall activity match percentage, highlighting the ratio of matched vs. non-matched activities for the selected week.
Summary Section
Displays weekly data for each member:
-
Member name
-
Location counts
-
Total tracked time
-
Total duration
View Weekly Member Details
Click the down arrow to expand and see day-wise information:
-
Biometric location
-
First punch time
-
Last punch time
-
Tracked time
-
Duration
Filter Biometric Reports
Filtering and navigation options:
-
View Type: Switch between daily and weekly reports using the dropdown.
-
Location Filter: View data for specific locations only.
-
Date Selection: Use the date picker or navigation buttons to change dates.
-
Member Search: Find specific members by name or email ID.
Switch Daily and Weekly Reports
View Type is used to switch between daily and weekly reports using the dropdown.
Search Members in Reports
Member Search: Find specific members by name or email ID.
Clearing searches: Use the Clear button next to the search field to reset member name or email searches.
Export Biometric Report
Click Export To CSV to download attendance data as a CSV file for further analysis or record-keeping.
Troubleshoot Connection Problems
-
Verify API URL, username, and password are correct.
-
Ensure your biometric provider's system is accessible.
-
Contact support if using a provider other than Matrix's COSEC VYOM.
Troubleshoot Missing Punch Data
-
Check device mapping configuration.
-
Verify access card information settings.
-
Ensure devices are properly connected and functioning.
Troubleshoot Discrepancy Indicators
-
Review Tracked Time Grace Period settings.
-
Compare desktop app tracking with biometric system data.
-
Investigate the yellow and red dot indicators for specific members.