Availability |
Odoo Online
Odoo.sh
On Premise
|
Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
Community Apps Dependencies | Show |
Lines of code | 9928 |
Technical Name |
an_push_attendance_enterprise |
License | LGPL-3 |
Website | https://github.com/ahmednour |
Availability |
Odoo Online
Odoo.sh
On Premise
|
Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
Community Apps Dependencies | Show |
Lines of code | 9928 |
Technical Name |
an_push_attendance_enterprise |
License | LGPL-3 |
Website | https://github.com/ahmednour |
ZKTeco, ESSL & ADMS Push Attendance Integration - Enterprise
by Ahmed Nour - OdooSA
Ultimate Enterprise Solution with AI Analytics, Multi-Site Management & Advanced Security Features - No IP/DNS Required!


Compatible with
🚀 Revolutionary Push Technology
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.
⚠️ IMPORTANT DEVICE COMPATIBILITY NOTICE
Not all ZKTeco devices support Advanced and Enterprise features.
Advanced features like remote enrollment, door control, messaging, work codes, and photo verification require specific device models with firmware support for these extended Push Protocol commands.
🔍 ALWAYS REQUEST A DEMO FIRST
Before purchasing Advanced or Enterprise versions, contact us for a demo to test compatibility with your specific devices.
✅ What we test in the demo:
- Your device model compatibility with advanced features
- Firmware version and Push Protocol support
- Network connectivity and command execution
- Feature availability for your specific use case
🏢 Enterprise Features
Ultimate enterprise solution with AI-powered analytics and multi-site management
Door Control & Access Management
- Remote Door Control - Unlock/lock doors remotely with duration settings
- Access Control Rules - Time-based, user-based, department-based restrictions
- Multi-Door Support - Manage multiple doors per device
- Access Logging - Complete unlock logs with user tracking
- Schedule-Based Access - Weekday/time restrictions with holiday handling
Device Messaging & Notifications
- Text Messages - Send SMS and display messages with duration control
- Bell/Alarm Control - Bell commands with repeat and duration settings
- Voice Messages - Voice announcements with language and speed control
- Emergency Notifications - Emergency alerts with acknowledgment requirements
- Message Scheduling - Scheduled message delivery with automation
Work Codes & Attendance Types
- Custom Work Codes - Complete work code management with 8 default types
- Multiple Attendance Types - Regular, overtime, project, training, meeting, break, leave
- Project/Task Tracking - Integration with project management
- Overtime Management - Configurable overtime rates and tracking
- Device Synchronization - Push work codes to devices via Push Protocol
Attendance Photos & Face Verification
- Photo Capture & Storage - Binary photo storage with thumbnails
- Face Quality Scoring - Quality metrics and match scores
- Verification Workflow - Manual verification with status tracking
- Temperature Recording - Body temperature support for health monitoring
- Photo Retention Policies - Automatic cleanup based on retention periods
🚀 Advanced Module Features
All advanced capabilities included in Enterprise edition
Remote Biometric Enrollment
- Remote Fingerprint Enrollment - Enroll all 10 fingers remotely without physical device access
- Face Recognition - Remote face template registration and management
- Multi-Modal Biometrics - Support for palm and iris recognition
- Template Quality Validation - Ensure high-quality biometric data
- Real-time Status Tracking - Monitor enrollment progress
Advanced Command System
- Priority Command Queue - Urgent, High, Normal, Low priority levels
- Auto-retry Mechanism - Automatic failure recovery
- Timeout Monitoring - 30-minute timeout with alerts
- Batch Processing - Execute multiple commands simultaneously
- Command Analytics - Track success rates and performance
Bulk Operations
- Mass User Synchronization - Sync all users across multiple devices
- Department-based Sync - Selective synchronization by department
- Biometric Data Transfer - Transfer templates between devices
- New/Modified Users Sync - Smart sync for recent changes only
- Conflict Resolution - Handle duplicate data intelligently
Device Control & Management
- Remote Device Control - Reboot, unlock doors, trigger alarms
- Data Management - Clear logs, users, or factory reset
- Emergency Alerts - Broadcast messages to all devices
- SMS & Voice Messages - Send notifications through devices
- Advanced Reporting - Generate and retrieve device reports
See Advanced Features in Action

See Enterprise Features in Action

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
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.
🔄 Attendance Recheck Tool KEY
Wizard to reprocess selected attendance periods with different algorithms when needed.
Quick Setup & Configuration
Configuring the ZKTeco Device
This module works with all ZKTeco devices that support the Push protocol. Follow these steps:
- Access Device Settings
Navigate to the Communication settings on your ZKTeco device. - Configure Server Connection
Enter your Odoo server's IP address or domain name, and the appropriate port. - Enable Push Protocol
Make sure the device is set to push attendance data to the server. - Test Connection
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:
- Auto-Detection in Action
Devices are automatically detected when they connect to your Odoo server! - Link Employees
Map your Odoo employees to the users in your ZKTeco device. - Configure Attendance Options
Set up check-in/check-out detection based on your organizational needs. - Start Tracking
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!
Screenshots
Real-time attendance tracking interface

Complete attendance management with real-time synchronization
Device management interface

Monitor and manage all connected devices from a centralized interface
Schedule management

Advanced scheduling and policy management features
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
Works with ALL ZKTeco Push-compatible 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
Professional Support Available
Ahmed Nour
Email: ahmednour@outlook.com
WhatsApp: +966 536 929 391
Website: odoosa.net
Odoo Apps: View All My Modules
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