The Navari FrappeHR Biostar Integration bridges the gap between physical access control infrastructure and your HR system. In most organisations, biometric terminals (fingerprint scanners, face recognition devices, iris scanners) sit on one side of the room — collecting punches all day — while the HR team is on the other side, manually keying in attendance or importing CSV files. This app eliminates that gap entirely.
What It Does
- Authenticates securely with a Suprema BioStar 2 Time & Attendance server
- Pulls employee check-in/check-out logs for any date range you specify
- Writes those logs directly into Frappe HR's Employee Checkin doctype
- Keeps track of the last sync date per employee so you never double-import
- Gives you both a manual trigger (for ad hoc runs) and a scheduled task (for automatic nightly/daily syncs)
Who Is It For?
Any organisation that:
- Runs Frappe HR (standalone) or ERPNext with Frappe HR enabled
- Uses Suprema BioStar 2 as their physical access/time-attendance platform
- Wants attendance to flow automatically into payroll without manual intervention
What It Is Not
This app does not manage biometric enrolment (registering fingerprints on devices). That remains a Biostar administrator function. The app is purely a data bridge: it reads from Biostar, writes to Frappe HR.
How It Works
The integration follows a clean request-response pattern over HTTPS:
Step 1 > Authentication: The app POSTs the Biostar username and password (stored encrypted in the Biometric Settings doctype) to the BioStar 2 TA API login endpoint. On success, it receives a session cookie/token.
Step 2 > Data Fetch: Using the session token, the app calls the attendance report endpoint, passing the configured start and end dates. Biostar returns a JSON payload containing all check-in/check-out events for that period.
Step 3 > Parsing & Matching: The app iterates over the returned records. For each record, it looks up the corresponding Frappe HR employee (matching by the employee ID that was enrolled in Biostar). Records with no matching employee are skipped and logged.
Step 4 > Write to Frappe HR: For each valid check-in event, the app creates a new Employee Checkin document with the log type (IN/OUT) and timestamp. Frappe HR's built-in auto-attendance engine then processes these checkins against assigned shift types to produce Attendance records.
Step 5 > Auto-Attendance & Payroll: Once checkins exist in Frappe HR, the standard Frappe HR pipeline kicks in shift matching, late entry/early exit detection, overtime, and ultimately payroll processing.