| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
| Lines of code | 4571 |
| Technical Name |
an_push_attendance |
| License | LGPL-3 |
| Website | https://odoosa.net |
| Versions | 12.0 13.0 14.0 15.0 16.0 17.0 18.0 |
ZKTeco, ESSL & ADMS Push Attendance Integration
Real-time attendance tracking with ZKTeco, ESSL & any device supporting ADMS Push SDK - No IP/DNS Required!
Compatible with:
Overview
This module provides seamless integration between Odoo and ZKTeco biometric devices using the Push Protocol, eliminating the need for complex network configurations and allowing for real-time attendance tracking even when your Odoo server is behind a firewall or on localhost.
Real-time attendance tracking
Fingerprint management
Advanced fingerprint features
Why Choose This Module?
Unlike other ZKTeco integration modules for Odoo, this module uses the Push Protocol with several key advantages:
- No Public IP or DNS Required - Your Odoo server can be on localhost or behind a firewall.
- Device-Initiated Connection - The ZKTeco device pushes data to your Odoo server.
- Real-Time Updates - Attendance records appear instantly in your Odoo system.
- Lower Server Load - No constant polling or device status checks required.
- Improved Security - No need to expose your Odoo server to the public internet.
- Full Device Support - Works with all ZKTeco Push-compatible devices.
Key Features
Device Management
Manage multiple devices from a single Odoo instance with detailed device information tracking and synchronization.
Biometric Templates
Complete management of fingerprint and face templates with automatic synchronization between devices.
Attendance Processing
Smart attendance processing with automatic check-in/out detection based on employee schedules.
User Management
Automatically map device users to Odoo employees with comprehensive privilege management.
Security Features
SSL encryption support, command validation, and comprehensive permission system for device management.
Advanced Settings
Flexible configuration options for synchronization, processing, and integration with other Odoo modules.
Complete Feature List
📡 Auto Device Detection KEY
Devices are automatically detected and registered when they connect to your Odoo server.
🔄 Real-time Synchronization
Attendance logs are transferred instantly to Odoo when employees scan their fingerprints.
📊 Device Status Monitoring
Track device status (online/offline/warning) with color-coded visual indicators and automated alerts.
🌐 No IP/DNS Required KEY
Works even when Odoo is on localhost or behind a firewall - no network configuration needed.
📱 Multi-device Support
Connect unlimited ZKTeco and ESSL devices to a single Odoo instance.
👆 Fingerprint Template Management KEY
Store and manage employee fingerprint templates directly in Odoo with secure storage.
👤 Face Recognition Templates
Full support for facial recognition templates with version tracking and synchronization.
🗂️ User Picture Management
Store and manage employee photos synchronized from devices with automatic updates.
🔐 Biometric Data Security
Secure storage and handling of sensitive biometric information with proper access controls.
⏱️ Smart Check-in/out Detection KEY
Intelligent algorithms to determine check-in vs check-out based on time or device status.
👥 Auto Employee Synchronization
Automatically map device users to Odoo employees using barcodes, PINs, or custom fields.
📚 Batch Attendance Processing
Efficient handling of large attendance record batches with optimized database operations.
🔄 Check-in/Check-out Pairing
Intelligent pairing of check-in and check-out records for accurate attendance tracking.
📋 First Check Policy POLICY
Configure how the first check of the day is processed with flexible policy options.
📝 Fingerprint Status Policy POLICY
Define policies for handling fingerprint verification status codes from devices.
⏰ Shift Period Detection POLICY
Automatically detect morning/afternoon shifts based on configurable time thresholds.
🛡️ Duplicate Protection Policy POLICY
Smart detection and handling of duplicate attendance records with configurable grace periods.
📅 Multi-Policy Support
Configure multiple attendance policies for different employee groups and locations.
🔍 Operation Logging
Detailed logging of all device operations for audit and troubleshooting purposes.
🖥️ Device Command Management
Send commands to devices remotely (reboot, info request, data download, etc.).
🔔 Admin Notifications
Automatic email notifications when new devices connect to your system or issues occur.
🔒 Advanced Security Features
Role-based access control for device management and attendance data.
⏱️ Timezone Management
Proper handling of different time zones between devices and server for accurate timestamps.
🔄 Push Protocol Support
Implementation of ZKTeco and ESSL push protocols with full compatibility.
⚙️ Automatic Configuration
Self-configuring devices with minimal manual setup required.
🛠️ Error Handling
Robust error detection and recovery mechanisms for reliable operation.
🧩 HR Attendance Integration
Seamless integration with Odoo's HR attendance module for complete workforce management.
📍 Work Location Support
Link devices to specific work locations for better attendance management.
📆 Resource Calendar Integration
Works with Odoo's resource calendar for shift management and scheduling.
🔄 Attendance Recheck Tool KEY
Wizard to reprocess selected attendance periods with different algorithms when needed.
🧾 Custom Status Codes
Support for custom device status codes to differentiate check-in/out events and special cases.
📊 Attendance Analytics
Visual dashboards and reports for analyzing attendance data and patterns.
Quick Setup & Configuration
Configuring the ZKTeco Device
This module works with all ZKTeco devices that support the Push protocol. Follow these steps:
Navigate to the Communication settings on your ZKTeco device.
Enter your Odoo server's IP address or domain name, and the appropriate port.
Make sure the device is set to push attendance data to the server.
Once configured, your device will automatically connect to Odoo.
Configuring the Odoo Module
After installing the module, follow these steps to set up your Odoo environment:
Devices are automatically detected when they connect to your Odoo server!
Map your Odoo employees to the users in your ZKTeco device.
Set up check-in/check-out detection based on your organizational needs.
Once configured, the system will automatically record attendance as employees use the device.
Attendance Log Handling & Policy Options
The system provides multiple configuration options to manage employee check-in and check-out logs effectively, with advanced policy settings for different organizational needs:
1. Flexible Period (Default Policy)
Best for most organizations using a single device for both check-in and check-out:
- Automatically alternates between check-in and check-out logs.
- First record is considered as Check-in, second as Check-out.
- Configurable grace period to avoid duplicate records.
- Simple to set up and maintain.
2. Device Status Code Based
For devices that support multiple status codes:
- Use different status codes for check-in and check-out.
- Define the appropriate status codes in the configuration.
- The system matches the attendance log's status code.
- Great for multi-purpose devices.
3. First Check Time Policy POLICY
For organizations with fixed shifts:
- Define specific time windows for check-in (e.g., 7-9 AM).
- Records within this window are automatically treated as check-ins.
- Records outside this window are processed as check-outs if a check-in exists.
- Perfect for organizations with fixed shift timings.
4. Schedule Based Policy
For organizations with multiple shifts:
- Configure employee work schedules in the HR module.
- The system determines check-in/out based on defined shifts.
- Supports overnight shifts and multiple check-ins per day.
- Ideal for complex shift patterns and 24/7 operations.
5. Fingerprint Status Policy POLICY
For advanced biometric verification control:
- Define how different fingerprint verification statuses are handled.
- Configure policies for each verification type (1:1, 1:N, password, etc.).
- Set acceptance thresholds for different verification methods.
- Enhance security by rejecting low-confidence verifications.
6. Duplicate Protection Policy POLICY
For preventing duplicate attendance records:
- Configure grace periods to prevent duplicate punches.
- Set different grace periods for check-in vs. check-out.
- Intelligent detection of repeated scans within configurable timeframes.
- Option to automatically mark or ignore duplicate records.
The powerful attendance recheck tool allows administrators to reprocess attendance records with different algorithms or policy settings
Policy Combination Support
The module allows you to combine multiple policies for maximum flexibility:
Create the perfect attendance policy configuration for your organization's unique needs!
Feature Demonstrations
See how the ZKTeco Push Attendance Integration works in real-world scenarios
Real-time attendance tracking
Fingerprint management
Device administration
Live Module Demonstration
See the module in action with real-world examples
Real-time attendance tracking
Fingerprint management
ZKTeco device operation
Module Screenshots & Features
Explore the key interfaces and functionality of the ZKTeco Push Attendance module
Real-time attendance tracking interface
Complete attendance management with real-time synchronization
Fingerprint management system
Efficiently manage employee biometric templates across multiple devices
ZKTeco device operation
Monitor and manage all connected devices from a centralized interface
Module vs. Other Solutions
| Feature | This Module | Other Solutions |
|---|---|---|
| IP/DNS Configuration | Not Required ✓ | Required ✗ |
| Firewall Compatibility | Works Behind Firewalls ✓ | Needs Port Forwarding ✗ |
| Data Transfer | Real-time Push ✓ | Polling ✗ |
| Device Support | All ZKTeco Models ✓ | Limited Models ✗ |
| Biometric Management | Complete ✓ | Limited ✗ |
| Auto Device Detection | Supported ✓ | Not Supported ✗ |
| Face Template Management | Full Support ✓ | Limited/None ✗ |
| Odoo 16-17 Performance | Optimized ✓ | Basic ✗ |
| Odoo 17 Support | Fully Optimized ✓ | Limited/None ✗ |
| Odoo 18 Compatibility | Compatible ✓ | Often Not Compatible ✗ |
Supported Devices
2.4" TFT Devices (ZLM60 Platform)
BioPro SA40, SC800
2.8" TFT and 3" TFT Devices
BioPro Series: ST30, MH20, MH30, MH40, ST40, ST40-A, SA10, SA20, SA30
MB Series: MB1000, MB2000, MB160, MB360, MB460, MB10, MB20
IN Series, UA Series, K Series, C Series, F Series
3.5" TFT Devices
iClock Series: iClock260, iClock360, iClock580, iClock660, iClock680, iClock700, iClock880, iClock990
S Series: S500, S560, S880, S900, S922
4.3" TFT Devices
iFace Series, iFace Plus Series
Green Label and Visible Light Facial Devices
G Series, SpeedFace Series, FaceDepot, ProMA Series, ProFace X Series, Horus Series, BioFace Series
Extension Reader Support
ZK9500, SLK20R (USB Connection)
Video Tutorials
Watch comprehensive tutorials showing how to set up and use the module
About the Author
Ahmed Nour
🌐 https://odoosa.net
Need Help?
We're here to assist you with any questions or custom implementation needs
Get Premium Support
Purchase includes access to ongoing module updates and priority support. For custom implementation, training, or additional device setup, contact us directly.
Please log in to comment on this module