Setting Up and Usage Guide
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.