Overview
This module connects Odoo HR Attendance to a BioTime 8.5 time-clock server so that fingerprint and card punches become Odoo attendance records. An administrator registers the server address and credentials, employees are matched by an employee code, and scheduled jobs sync employees and attendances and close open records. It plugs into the HR and Attendance apps. HR officers use it to avoid manual entry. The benefit is automatic, reliable attendance from the biometric device.
Usage steps
- 1
Register the BioTime server
In the server form the administrator enters the server name, IP, port, admin username and password, department code, area code and the UTC offset. Only one server can be active at a time or a validation error appears. Chatter is available on the server record.
- Server IP, port, credentials
- Department and area codes
- One active server only
- 2
Test the connection
The Ping server button requests a token from the BioTime server and shows the result. Errors from the server are shown to the user as messages. The token is stored for later calls.
- Button: Ping server
- Token requested
- Error messages shown
- 3
Match employees by code
Each employee carries a ZK employee code. New employees can be sent to the BioTime server by a scheduled job, and employees removed from the device can be removed there too. The employee views show the code field.
- Field: employee code
- Sync new employees
- Remove from device
- 4
Sync attendance records
The Sync Attendances cron fetches punches page by page from the server and creates Odoo check-in and check-out records with the device IDs. The last sync time is kept on the server. Attendance rows carry a not recorded flag and the server reference.
- Cron: Sync Attendances
- Device IDs kept
- Last sync time stored
- 5
Close open attendances
A Close Attendances cron closes attendance records that were left open. The Sync Employees cron keeps the employee list aligned. Together they keep the attendance list clean without manual work.
- Cron: Close Attendances
- Cron: Sync Employees
- No manual work
Screens
Illustrative mockups with placeholder data.
—
Added by this module
Roles
| Role |
|---|
| HR officer |
| Attendance manager |
| System administrator |
Dependencies
Want to know more or try this app? Contact us
We can arrange a demo or a trial and answer your questions about BioTime Attendance.
