| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
| Lines of code | 529 |
| Technical Name |
bb_zkteco_bridge |
| License | LGPL-3 |
| Website | https://www.bbtech.ae |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
| Lines of code | 529 |
| Technical Name |
bb_zkteco_bridge |
| License | LGPL-3 |
| Website | https://www.bbtech.ae |
| Versions | 18.0 19.0 |
BB ZKTeco Bridge — Odoo (Odoo.sh)
Odoo 19 Odoo.sh ZKTeco HR Attendance
This module enables integration between a biometric device and Odoo 19 deployed on Odoo.sh by using an external Bridge application (Linux / macOS / Windows) to fetch device logs and push them to Odoo securely.
Note: Bridge setup and configuration steps are provided in README.md.
Main Functionality
- Receive device punches via a secure endpoint (
/zk/punch) using a shared token. - Store raw punches in Odoo for audit and traceability.
- Employee mapping using device PIN/User ID mapped to an employee field (e.g., Badge/Barcode or Identification No.).
- Duplicate protection using unique event IDs to avoid repeated imports.
- Optional processing (cron) to convert punches into
hr.attendancerecords based on defined rules.
Designed for Odoo.sh Users
Odoo.sh environments do not allow direct device libraries or network services inside Odoo. This solution keeps Odoo clean and cloud-ready by using a Bridge runner installed on: Linux, macOS, or Windows.
For full bridge setup instructions (including scheduling and troubleshooting), please refer to README.md.
How It Works (High-Level)
- Configure network settings (IP/Port) and ensure it is reachable from the Bridge machine.
- Install and run the Bridge on Linux/macOS/Windows (see README.md).
- Bridge reads logs from Machine and sends them to Odoo using the configured token.
- Odoo stores punches and can generate HR Attendance entries automatically (optional cron).
Screenshots
Add your screenshots inside the module static folder and keep these filenames:
Please log in to comment on this module