Multiple protocols
Connect compatible devices through TCP, UDP, ADMS/iClock push, or the secured HTTP punch API.
ZKT Biometric Attendance Device Integration (Odoo.sh, Custom Cloud, On-premise)
by Muhammad Mudassir https://mudassir.it.com
Odoo
$ 112.92
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Discuss (mail) • Employees (hr) |
| Lines of code | 5658 |
| Technical Name |
biometric_attendance_bridge |
| License | OPL-1 |
| Website | https://mudassir.it.com |
| Versions | 17.0 18.0 19.0 |
Biometric Attendance Bridge
Biometric devices, attendance punches, employees, and Odoo 17 - connected.
99 EUR ONE-TIME APP PRICE
Bring compatible biometric attendance machines into Odoo Attendances. Download users and punches, map employees, synchronize check-ins and check-outs, and manage device communication from one workspace.
What it does
Employee mapping
Download machine users, match them to Odoo employees, and optionally upload employee users to devices.
Attendance synchronization
Convert raw device punches into Odoo check-ins and check-outs using configurable status codes.
Scheduled automation
Use scheduled actions to retrieve device logs and synchronize pending attendance records.
Timezone aware
Store accurate UTC timestamps while configuring the local timezone independently for every device.
Operational controls
Inspect users, fingerprints, data logs, commands, device information, and safe-clear notifications.
How it works
Create the device
Choose TCP, UDP, or ADMS and configure network, serial, timezone, and status-code settings.
Connect and map
Download machine users and map each device identity to the correct Odoo employee.
Collect punches
Poll the device, accept ADMS pushes, or submit a token-authenticated HTTP punch.
Synchronize attendances
Transform raw check-in/check-out events into standard Odoo HR Attendance records.
Deployment compatibility
| Platform | Supported | Important notes |
|---|---|---|
| Odoo 17 Community | Yes | Install the Odoo Attendances application first. |
| Odoo 17 Enterprise | Yes | Compatible with the standard Attendances application. |
| On-premise / private cloud | Yes | Recommended for TCP/UDP devices on a private network. |
| Odoo.sh | Yes | ADMS push or a secured HTTP route is recommended. Direct TCP/UDP requires network reachability to the terminal. |
| Local development | Yes | The Odoo machine must be able to reach the terminal IP and port. |
| Odoo Online | No | Odoo Online does not allow custom Python modules. |
Installation
Add the module
Copy biometric_attendance_bridge into an Odoo 17 addons path or your Odoo.sh Git repository.
Restart and update
Restart Odoo, enable developer mode, and run Apps > Update Apps List.
Install
Search for Biometric Attendance Bridge and install it.
Configure networking
Permit the required TCP/UDP route or point the ADMS device to the public Odoo URL.
Security and networking
The custom punch endpoint requires a per-device secret in the X-Attendance-Token header. ADMS/iClock devices authenticate operationally through their configured serial number because many terminals do not support custom HTTP headers. Use HTTPS and network allowlists wherever possible.
Device compatibility
Designed for ZKTeco, ZKSoftware, and ZK-protocol biometric attendance terminals. Compatibility depends on the exact model, firmware, enabled protocol, network route, and whether the terminal is configured for TCP/UDP polling, ADMS/iClock push, or the secured HTTP punch API.
ZKTeco MB series
Common face, fingerprint, card, and password attendance terminals.
MB20MB20-VLMB2000MB360MB460MB560
ZKTeco K / LX / WL series
Popular entry-level fingerprint and card attendance devices.
K14K20K30K40LX50WL10WL20
ZKTeco IN / UA series
Network attendance terminals commonly used in offices and warehouses.
IN01IN05IN05-AUA300UA760UA860
ZKTeco iClock series
iClock attendance terminals using ZK attendance communication or ADMS/iClock push.
iClock 360iClock 560iClock 580iClock 680iClock 700TX628
ZKTeco UFace / iFace / SFace
Face and fingerprint terminals when attendance logs are available through the supported protocol.
UFace 202UFace 302UFace 402UFace 800iFace 302iFace 402SFace900
ZKTeco SpeedFace / Horus
Modern face recognition terminals when configured for compatible attendance log synchronization.
SpeedFace-V4LSpeedFace-V5LSpeedFace-V5L TDFaceDepotHorus E1Horus TL1
ZKTeco F / MA / VF series
Fingerprint, access, and outdoor attendance terminals with attendance-log support.
F18F19MA300MA500VF680SC700TF1700
ZK-based OEM devices
Many rebranded ZK attendance terminals can work when they expose the same compatible protocol.
ZKSoftwareZK protocolADMSiClockTCP 4370UDP 4370
Note: this is a practical compatibility list, not a hardware guarantee. Some firmware versions disable TCP/UDP, ADMS, or attendance-log access. Always test the exact terminal in a staging database before production rollout.
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Discuss (mail) • Employees (hr) |
| Lines of code | 5658 |
| Technical Name |
biometric_attendance_bridge |
| License | OPL-1 |
| Website | https://mudassir.it.com |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module