---
title: "Setting Up and Usage Guide"
space: "Suprema Biostar Biometric Integration"
url: "https://docs.navari.co.ke/suprema-biostar/configuration"
updated: "2026-05-28"
---

# Setting Up & Using the Biostar Integration

## How It All Connects

Once the integration is configured, the flow is straightforward — an employee punches in at a Biostar device, that record gets pulled into Frappe HR as a check-in log, and Frappe HR takes it from there to mark attendance and feed payroll.

```
Biostar Device  →  Employee Check-in Log  →  Attendance  →  Payroll

```

Nothing in between requires manual input.

## Configuration

##  All settings live in a single place: **Biometric Settings**.

Navigate there via the search bar in your Frappe desk.


| Field          | Description                                                                                                  |
| -------------- | ------------------------------------------------------------------------------------------------------------ |
| **Username**   | Your BioStar 2 admin username                                                                                |
| **Password**   | Your BioStar 2 password — stored encrypted                                                                   |
| **TA URL**     | The URL of your BioStar Time & Attendance server. No trailing slash — e.g. `https://biostar.yourcompany.com` |
| **Start Date** | Default start date for manual attendance fetches                                                             |
| **End Date**   | Default end date for manual attendance fetches                                                               |
| **Is Active**  | Must be ticked for any sync to run. This is the master switch — nothing runs unless this is enabled          |


Fill in the fields, tick **Is Active**, and save. Saving does not trigger a sync — you control when data is fetched.

## Syncing Attendance

There are three ways to pull attendance data into Frappe HR, depending on what you need.

### Single Employee

Open an **Employee** record and click the **Fetch Attendance** button. A dialog will ask for a start and end date — the start date defaults to the last time that employee was synced, so you are never re-importing old data. Hit Fetch and the records appear under **Employee Checkin**.

Use this when an employee flags missing attendance or you want to spot-check before a larger sync.

### Multiple Employees 

In the **Employee list view**, filter by department, branch, or any other criteria. Select the employees you want, then go to **Actions → Fetch Attendance**. The system processes each employee in the background, so large batches run without timing out. If one employee's data isn't found in Biostar, the rest still sync fine.

### Automatic Sync

Once the integration is active, it runs on a daily schedule — fetching the current day's punch logs without any manual action needed. This is the intended day-to-day setup for most organisations.

## From Check-in to Payroll 

After check-in logs land in Frappe HR, the system handles the rest automatically — provided shifts are configured correctly.

Frappe HR compares each employee's check-in and check-out times against their assigned **Shift Type** and marks them as Present, Absent, or Half Day, and flags late entries or early exits where applicable. This produces an **Attendance** record for each employee per day.

Those attendance records then flow into payroll — absent days trigger Leave Without Pay deductions, and the Payroll Entry process reads the attendance summary when generating salary slips.

For this to work, each employee in Frappe HR needs a Shift Type assigned, with **Enable Auto Attendance** turned on.

## Overtime & Timesheets

If your organisation tracks overtime, Navari's companion app **nl-attendance-timesheet** extends this pipeline further it automatically generating timesheets and overtime calculations from the same check-in records. It is the natural next step once this integration is running.