Each employee in FrappeHR must be linked to their biometric identity. There are two mandatory configurations per employee.
6.0 Biometric ID Mapping
Every employee registered on the CAMS biometric device has a User ID assigned during device enrollment. This same ID must be entered in FrappeHR so the system can match incoming punches to the correct employee record.
Where to set it:
- Open the Employee doctype for the relevant employee
- Go to the Attendance tab (or HR Settings section, depending on your Frappe version)
- Find the field Attendance Device ID (Biometric/RF tag ID)
- Enter the exact User ID that was registered on the biometric device
Best practice: Use the employee's system ID (e.g. EMP-0001) as the biometric device User ID when enrolling them, so there is a natural one-to-one correspondence. This minimises mapping errors.
What happens if this field is empty? If an employee punches a device but their biometric User ID is not mapped in FrappeHR, the punch will be received but no Employee Check-in record will be created. The error will be logged.
6.1 Shift Assignment
Shift assignment is equally critical. The integration uses shift data to:
- Determine the correct log type (IN vs OUT) based on the time of the punch relative to the shift window
- Link the Employee Check-in record to the correct shift
- Update the
last_syncdate on the shift assignment after each successful punch
How to assign a shift:
- Open the Employee record
- Navigate to HR > Shift Management > Shift Assignment
- Create a Shift Assignment for the employee, selecting the appropriate Shift Type
- Ensure the shift covers the expected working hours accurately
Note: Employees without an active shift assignment at the time of a punch may have their check-in recorded but shift linking will be incomplete. Always keep shift assignments current.