Skip to Content

BB ZKTeco Bridge - Odoo.sh

by
Odoo

$ 117.52

v 19.0 Third Party
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
LicenseLGPL-3
Websitehttps://www.bbtech.ae
Versions 18.0 19.0
You bought this module and need support? Click here!
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
LicenseLGPL-3
Websitehttps://www.bbtech.ae
Versions 18.0 19.0
BB ZKTeco Bridge

BB ZKTeco Bridge

BB ZKTeco Bridge — Odoo (Odoo.sh)

This module enables integration between a biometric device and 18 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.

Auto Parts Management

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.attendance records 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

Explore the key features and interfaces of the BB ZKTeco Bridge

ZK Punches / Monitoring

This image shows the User Access Rights configuration screen in Odoo, specifically related to the ZK Punches / Monitoring functionality. The page is accessed through Settings → Users & Companies → Users, where the selected user (Youssef Awad) has various roles assigned. In the highlighted red section under “Other,” the Human Resources category displays the role ZK Bridge Manager, which grants the user permissions to monitor and manage biometric punch data synchronized from ZKTeco devices. This typically includes viewing attendance punches, tracking real-time monitoring logs, and managing device integration settings. The interface also summarizes user statistics such as Groups, Access Rights, Record Rules, linked Employee profile, and Karma points, reflecting Odoo’s structured role-based access control system.

Settings / Token & Mapping

This image shows the Settings / Token & Mapping configuration screen related to the ZK Bridge integration in Odoo. The page is used to manage authentication tokens and field mapping between ZKTeco biometric devices and the Odoo system. In this section, administrators can generate or configure secure API tokens to establish communication between the device bridge and the server. The mapping settings allow proper alignment of biometric punch data—such as employee ID, device ID, punch time, and attendance status—with corresponding fields in Odoo’s Human Resources module. This configuration ensures accurate synchronization, secure data transfer, and proper monitoring of attendance records within the system.

Attendance Result / HR Attendance

This image shows the Attendance Result / HR Attendance screen in Odoo, displaying synchronized attendance data received from ZKTeco biometric devices. The interface presents processed punch records that have been converted into official HR attendance entries. It typically includes details such as employee name, check-in time, check-out time, working hours, and attendance status. This section allows HR managers to review, verify, and manage employee attendance results after data synchronization through the ZK Bridge. The screen ensures that raw biometric punch logs are accurately transformed into structured HR attendance records for payroll calculation, reporting, and workforce monitoring.

Request Installation Support Chat with Expert
Binary Bridge Technology Services

Get expert assistance from Binary Bridge Technology Services your trusted Odoo partner with years of experience in enterprise implementations.

Professional Odoo Solutions | Enterprise Security | Expert Support
📧 Email: odoo@bbtech.ae | 📱 WhatsApp: +971 56 128 6321 | 🌐 Website: www.bbtech.ae

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.