---
title: "6. Employee Setup"
space: "CAMS Biometric Integration"
url: "https://docs.navari.co.ke/cams-biometric/employee-setup"
updated: "2026-05-27"
---

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:

1. Determine the correct log type (IN vs OUT) based on the time of the punch relative to the shift window
2. Link the Employee Check-in record to the correct shift
3. Update the `last_sync` date 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.