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.
Note: The Biometric module is a premium feature that requires a Pro subscription.
Prerequisites
-
Pro subscription to Simplified HR
-
Access to admin privileges for configuration
-
Biometric device provider credentials (API details)
-
Device IDs and location information
Installing the 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
For detailed installation instructions, refer to the Marketplace Installation Guide.
Step 2: Access the module
Once installed, you can access the Biometric module from multiple locations:
-
My Library > Biometric
-
My Apps > Biometric
- Control Centre > Biometric (admin users only)
Configuring the 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
-
Control Centre > Biometric
-
-
Click the Configuration tab
Provider setup
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
Device connection details
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.
Device mapping
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
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.
To add a custom field, navigate to:
System > Module Setting > My Profile > Custom Field.
Setting up 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
Using Biometric reports
The Biometric Report provides comprehensive attendance data, including punch-in/out activities, locations, durations, and discrepancy identification.
Accessing reports
Prerequisites: You must have appropriate report permissions assigned.
- Go to Control Center > Reports
- Select My Apps > Biometric
Daily reports
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:
-
Member Name
-
Punch Location
-
First Punch Time
-
Last Punch Time
-
Total Duration (calculated between first and last punch)
Viewing 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
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
Weekly reports
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
Viewing detailed weekly data
Click the down arrow to expand and see day-wise information:
-
Biometric location
-
First punch time
-
Last punch time
-
Tracked time
-
Duration
Report management options
Filtering and navigation
-
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
Exporting data
Click Export To CSV to download attendance data as a CSV file for further analysis or record-keeping.
Clearing searches
Use the Clear button next to the search field to reset member name or email searches.
Biometric Activity Today
The Biometric Activity card, available in the My Activity section at the user’s end, displays all biometric events for the current day. It shows punch-in and punch-out statuses along with their timestamps and biometric locations.
Users can refresh this data by clicking on the Refresh button, which pulls the latest events that may not yet be synced. The refresh action can be performed at a 10-minute interval between two pulls.
Troubleshooting
Common issues and solutions
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
Missing punch data
-
Check device mapping configuration
-
Verify access card information settings
-
Ensure devices are properly connected and functioning
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
Next steps
-
Set up automated attendance reports for managers
-
Configure notifications for attendance discrepancies
-
Review [User Permissions Guide] for report access management
-
Explore [Desktop Application Integration] for comprehensive time tracking