ZKTeco Odoo Integration: Real-Time Biometric Attendance Sync with ADMS Explained


Get a Module


The Attendance Problem That's Costing Businesses Thousands

Every business reaches a breaking point with manual attendance management and most don't realise how much it's costing them until the damage is done. Paper registers get falsified. Spreadsheets carry forward errors for weeks before anyone catches them. Buddy punching where one employee clocks in on behalf of another drains payroll budgets silently. And even companies that invested in ZKTeco biometric hardware often find themselves in the same position: someone still has to manually export attendance data from the device, format it, and import it into their ERP every single day.

That manual step small as it sounds introduces delays, discrepancies, and an unnecessary dependency on human memory. Multiply that across multiple locations, dozens of devices, and hundreds of employees, and you have a systemic problem hiding in plain sight. There is a smarter way. And it starts with making your ZKTeco device and Odoo actually talk to each other.


What is ZKTeco? 

ZKTeco is one of the world's leading manufacturers of biometric security and time-attendance hardware. From fingerprint scanners to advanced face recognition terminals, ZKTeco devices are trusted by thousands of businesses globally from small retail outlets to large manufacturing plants precisely because they are affordable, durable, and accurate.


The Gap: ZKTeco Works. Odoo Works. But They Don't Talk.

Odoo is a powerful open-source ERP platform used by businesses worldwide to manage HR, payroll, inventory, sales, and more. Its Odoo HR Attendance module is designed to track employee working hours, calculate overtime, and feed into payroll automatically.

But out of the box, Odoo and ZKTeco devices operate in complete isolation. There is no native bridge. The typical workaround involves downloading attendance logs from the ZKTeco device, converting the file into a compatible format, and manually uploading it into Odoo sometimes daily, sometimes weekly, and often inaccurately.

This disconnection creates real business risk: payroll errors, compliance gaps, and an HR team that spends more time reconciling data than managing people. What's needed is a direct, live connection between ZKTeco hardware and Odoo and that's exactly what this module delivers.


Introducing the Creyox ZKTeco Biometric Integration Module

The Smart ZKTeco Attendance Systemis a production-grade ZKTeco Odoo integrationdeveloped by Creyox Technologies for Odoo. It eliminates the manual data transfer gap entirely by establishing a real-time, bidirectional connection between your ZKTeco biometric devices and Odoo HR Attendance using the industry-standard ADMS protocol.

No middleware. No third-party software. No daily CSV exports. Just accurate, automated, real-time attendance tracking built directly into Odoo.


How ADMS Live Sync Works

ADMS, short for Attendance Data Management System, is a push-based communication protocol built into ZKTeco devices. Rather than waiting for someone to pull data from the device, ADMS actively pushes attendance records to a server the moment a punch is registered.

Here is how the flow works with this module:

Employee punches in (fingerprint or face recognition on the ZKTeco terminal) → ZKTeco device pushes the record via ADMS to Odoo in real time → Odoo HR Attendance module instantly creates the attendance entry timestamped, employee-matched, and stored securely.

The result is a fully automated pipeline. From the moment an employee places their finger on the scanner to the moment the attendance record appears in Odoo, no human intervention is required. This is what genuine real-time attendance tracking looks like in practice.


Key Features Deep Dive

Real-Time ADMS Sync

Every fingerprint or ZKTeco face recognition punch is pushed live to the Odoo HR attendance module the moment it occurs. Records are timestamped at source, deduplicated to prevent ghost entries, and stored with tamper-proof integrity ensuring your payroll data is always accurate and audit-ready.​​

Remote Device Management

One of the most overlooked costs of managing biometric hardware is the time spent physically visiting devices. With this module, HR and IT teams can remotely enroll employees, push or fetch biometric templates, reboot devices, and clear logs all from within the Odoo interface. Remote biometric enrollment in Odoo means your team spends less time in server rooms and more time on work that matters.

Auto-Checkout Engine

Forgotten checkouts are a perennial HR headache. The auto-checkout engine automatically closes any open attendance record at a configured time, ensuring no employee is ever shown as still "checked in" at midnight simply because they forgot to punch out. Clean records, every day, without manual correction.

Grace Period & Night Shift Intelligence

Real workplaces don't run on perfect schedules. The module supports configurable grace windows for both late arrivals and early departures, giving HR managers the flexibility to accommodate real-world scenarios without triggering false violations. Night shift attendance in Odoo is handled with cross-midnight logic that correctly attributes shifts spanning two calendar days eliminating the common issue of split records for overnight workers.

Multi-Timezone Support

For businesses operating across regions or countries, each ZKTeco device can be configured with its own timezone. Punch timestamps are normalized correctly regardless of where in the world the device is located, keeping your global attendance data consistent and comparable.

Sync Health Monitor

Silence from a biometric device can mean it is offline or it can go unnoticed entirely until HR realizes attendance records are missing for an entire day. The Sync Health Monitor uses a live heartbeat mechanism to display the real-time online or offline status of every connected ZKTeco device. When a device goes dark, you know immediately before it becomes a reporting problem.

Built-In Attendance Reports

The module ships with four enterprise-grade reports accessible directly from Odoo: Daily Attendance Summary, Absence Report, Daily Attendance Detail, and a full Excel export. HR managers can generate, review, and share attendance data without touching a third-party reporting tool.


Step-by-Step Setup Overview

Getting started with the module is straightforward, even for teams without deep technical expertise:

Step 1 — Install the Module Install ZKTeco Biometric Integration from the Odoo App Store into your Odoo instance (compatible with both Odoo.sh and On-Premise deployments).

Step 2 — Configure Your ZKTeco Device In your ZKTeco device's network settings, point the ADMS server address to your Odoo instance URL. The module handles device discovery automatically and creates a contact record for each connected device.

Step 3 — Configure Attendance Rules Set your grace periods, auto-checkout time, timezone per device, and night shift parameters from within the Odoo attendance configuration panel. Once saved, the system is live and every subsequent punch flows directly into Odoo in real time.


Who Should Use This Module?

This integration is purpose-built for:

  • HR Directors and Managers who need accurate, real-time attendance data without manual reconciliation
  • IT Administrators responsible for managing ZKTeco device infrastructure across one or multiple locations
  • Odoo Functional Consultants building comprehensive HR and payroll solutions for clients already using ZKTeco hardware
  • Operations Leaders in Manufacturing, Retail, and Logistics where shift-based work, night shifts, and multi-location device management are everyday realities
  • Any business currently running ZKTeco devices that wants to eliminate the manual data transfer step between hardware and ERP


Compatibility

The Smart ZKTeco Attendance System is fully compatible with:

  • Odoo all versions 
  • Odoo.sh (cloud-hosted deployments)
  • On-Premise Odoo installations
  • ZKTeco devices supporting the ADMS push protocol


Stop Managing Attendance Manually

Manual attendance management is not just inefficient, it is a liability. Every spreadsheet error, every missed export, every buddy punch is a cost your business is absorbing silently. The Creyox ZKTeco Biometric Integration module removes that liability entirely by making your ZKTeco hardware and Odoo work as a single, seamless system.

Real-time ADMS sync. Remote device management. Intelligent automation for grace periods, night shifts, and auto-checkout. Enterprise reporting built in. All inside Odoo with nothing to manually maintain.

If your business runs ZKTeco biometric devices and Odoo, there is no reason these two systems should not be working together right now.


Frequently Asked Questions

The Smart ZKTeco Attendance System is compatible with any ZKTeco device that supports the ADMS push protocol which includes the majority of ZKTeco fingerprint and face recognition terminals released in recent years, including the K-series, F-series,

No. That is one of the core design principles of this module. The integration connects your ZKTeco device directly to Odoo using the ADMS protocol, there is no third-party bridge, no additional server, and no external software license required. Everything is managed entirely within your Odoo instance, whether you are running Odoo.sh or an On-Premise deployment.

ZKTeco devices store punch logs locally on the device itself. When your internet connection is restored and the ADMS link re-establishes, the buffered punches are pushed through to Odoo automatically. The Sync Health Monitor built into the module will also alert you in real time when a device goes offline so your HR team knows immediately rather than discovering a data gap days later.

Yes, and this is one of the most technically differentiated features of the module. Standard attendance systems often split cross-midnight shifts into two separate calendar-day records, creating reconciliation headaches for HR. The night shift intelligence engine in this module uses configurable period detection logic to correctly attribute a shift that starts before midnight and ends after it as a single continuous attendance record accurate for payroll, clean for reporting.

The Smart ZKTeco Attendance System is compatible with all Odoo Versions, and works with both Community and Enterprise editions. It is deployable on Odoo.sh (Odoo's cloud platform) as well as On-Premise self-hosted installations.



Sign in to leave a comment