| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
| Community Apps Dependencies |
Show
•
Attendance Absents Report
• Attendance Report UI Enhancements • Biometric Device Integration • Daily Attendance Report • Early Leave Report • Employee Attendance Report • HR Attendance Dashboard • HR Vacation Balance (Per Year) • Late Arrival Report • Missing Punch Report • Monthly Late Summary • Time Control Report |
| Lines of code | 5905 |
| Technical Name |
zk_moh_attendance_mohammed_installer |
| License | LGPL-3 |
| Versions | 18.0 19.0 |

ZKTeco Biometric Attendance Suite for Odoo
Enterprise Biometric Attendance Management - One-Click Installer
ZKTeco Biometric Attendance Suite is a complete attendance management solution for organizations using ZKTeco fingerprint and face recognition devices. It connects biometric devices directly with Odoo, automates attendance processing, and provides professional reports, dashboards, Excel/PDF exports, and branch-aware access control.
Supported Versions: Odoo 18.0 and Odoo 19.0 - separate packages.
Tagline: Connect. Synchronize. Analyze.
Why Choose This App?
- One-click installation for all attendance features
- Direct TCP/IP integration with ZKTeco devices
- Unlimited biometric devices and employees
- Public IP and local network device support
- Multi-branch and multi-company ready
- Late, early leave, absence, and missing punch detection
- Per-employee working hours and shift-aware reporting
- Professional HR dashboard and attendance analysis
- Excel and PDF export for reports
- Device-based access control for branch users
Supported Devices
The system supports ZKTeco biometric devices using TCP/IP communication. Devices can be connected through a local network or public IP address, with configurable communication ports such as 4370, 4371, 4372, or any port configured on the device.
- ZKTeco fingerprint devices
- ZKTeco face recognition devices
- TCP/IP communication
- Local network and remote branch connectivity
- Tested with ZKTeco uFace series
The biometric device must be reachable from the Odoo server network.
One-Click Installer
Install the complete biometric attendance solution using a single installer module. The installer automatically deploys the required attendance, reporting, dashboard, export, and UI helper modules without manual dependency handling.
Installer Module: zk_moh_attendance_mohammed_installer
- ZKTeco device integration core
- Attendance synchronization engine
- Daily attendance reports
- Late arrival and early departure reports
- Missing punch and absence reports
- Monthly late summary
- Attendance dashboard and analysis
- Excel and PDF export
- HR vacation balance integration
- Modern UI helper module included
Modern UI Helper Included
The included UI helper module improves the look and usability of report buttons, export actions, and attendance screens, giving HR users a clean and professional experience.
- Clean action buttons
- Improved report usability
- Consistent button behavior
- Professional interface for HR users
Branch-Aware Access Control
Control visibility by device and branch. HR managers can access all devices and employees, while branch users can only access employees and devices assigned to their branch.
- HR Manager / Admin: full access to all devices, employees, and reports
- HR Employee / Branch User: restricted access based on assigned device(s)
- No need for multiple databases per branch
- Centralized attendance control with secure visibility rules
Shift-Aware Attendance Processing
Define each employee's working schedule directly from the employee profile. Attendance reports automatically evaluate late arrival, early leave, and working time based on the employee's own start and end work time.
Example: an employee working 08:00-16:00 and another employee working 17:00-23:00 are evaluated correctly according to their own schedule.
Reports, Dashboard & Export
- Daily attendance report
- Late arrival report
- Early leave report
- Missing punch report
- Absent report
- Monthly late summary
- HR dashboard analytics
- Attendance analysis views
- Excel and PDF export
Installation
- Copy the installer module to your Odoo addons directory
- Restart the Odoo service
- Enable Developer Mode
- Go to Apps â Update Apps List
- Install ZKTeco Biometric Attendance Suite
All required sub-modules are installed automatically by the one-click installer.
Screenshots & Feature Overview
1. Main Menu
The main menu provides centralized access to all features included in the biometric attendance suite. HR teams can quickly open device management, employee records, attendance reports, dashboards, analytics, and system configuration from one organized interface.
- Simple navigation for HR users and administrators
- All attendance modules grouped in one place
- Fast access to reports, dashboards, and configuration tools
2. Biometric Device Management
Manage an unlimited number of biometric devices from a single Odoo interface. Devices can be connected using local network IPs or public IP addresses for remote branches, with fully configurable communication ports.
- Unlimited ZKTeco device registration
- Public IP and LAN IP support
- Configurable device port
- Attendance download period per device
- Centralized multi-branch device management
3. Device Setup & Configuration
Configure every biometric device and perform device operations directly from Odoo. Administrators can synchronize employees, download attendance logs, test device connectivity, restart the device, and manage device logs without physical access to the device.
Configuration Fields
- Name: identifies the biometric device inside Odoo
- Device IP: supports both public IP and local network IP addresses
- Port Number: communication port used to connect with the device
- Working Address: links the device to a specific branch or location
- Download From / Download To: defines the attendance synchronization date range
Device Operation Buttons
- Set Time: synchronizes the biometric device time with the Odoo server
- Sync Employees: imports and updates employees from the biometric device into Odoo
- Download Data: downloads attendance transactions and prepares them for reporting
- Clear Odoo Logs: removes imported logs from Odoo only
- Clear Device Logs: clears attendance logs from the biometric device
- Clear Both: clears logs from both Odoo and the biometric device
- Restart: remotely restarts the biometric device
- Test Connection: verifies the IP and port connection between Odoo and the device
4. Biometric Log
The biometric log keeps synchronized employee and biometric reference information used by the attendance engine. It helps match attendance transactions with the correct employee and provides a reliable reference for reporting and synchronization.
- View synchronized biometric employee records
- Match device transactions with employee profiles
- Support synchronization from multiple devices
- Reduce duplicate records using biometric identifiers
- Improve accuracy of attendance reports and analytics
5. Employee Configuration - Daily Working Time
The employee profile includes dedicated daily working time settings. HR can define each employee's Work Start and Work End time directly from the employee form. All attendance reports automatically depend on these values, making late arrival, early leave, missing punch, total worked time, and attendance summary calculations accurate for each employee's schedule.
- Define daily start time and end time for every employee
- Reports are calculated based on the employee's assigned working hours
- Supports different shifts for different employees, departments, or branches
- Attendance summary shows check-in, check-out, total worked time, and working address
- Color indicators help HR quickly identify normal, late, early, or incomplete attendance records
- Integrated directly inside the standard Odoo employee profile
This ensures that every employee is evaluated according to their own schedule instead of using one fixed company time for everyone.
6. User Settings - HR Admin and Branch User Permissions
The user settings screen controls biometric attendance permissions for each Odoo user. The system supports two main security levels: HR Admin users with full access across all branches, and Region HR / Branch Users with limited access based on their assigned working address and biometric device permissions.
- HR Admin: full control over all branches, all biometric devices, all employees, reports, settings, and attendance data
- Region HR / Branch User: access only to employees and attendance records linked to assigned working address or device(s)
- Support for assigning one device or multiple devices to the same HR user
- Branch users cannot view or manage employees from other branches
- Specific permissions can be enabled or disabled per user without giving full administrator access
- Centralized security management inside the standard Odoo user access rights screen
This permission structure allows companies to manage multiple branches in one Odoo database while keeping employee data secure and separated by location.
7. Vacation Management
The system includes a fully integrated Vacation Management module, allowing HR departments to manage employee leave directly from the employee profile. Vacation balances, leave history, and vacation types are maintained within the same system, providing complete visibility of employee attendance and leave records from one centralized platform.
- Employee vacation management directly from the employee profile
- Automatic vacation balance calculation
- Annual, sick, hourly, half-day, and custom leave types
- Complete vacation history for every employee
- Vacation balance dashboard and reporting
- Integrated attendance and leave management
7.1 Employee Vacation Management
Each employee profile includes a dedicated Vacation tab where HR administrators can register and manage employee leave. Every approved vacation automatically updates the employee's remaining balance while maintaining a complete leave history for future reference.
7.2 Vacation Balance Dashboard
Monitor vacation balances across the organization from a centralized dashboard. HR managers can quickly review available, used, and remaining leave for all employees.
7.3 Vacation Balance Records
Review detailed vacation balances for each employee, including allocated leave, consumed leave, and remaining entitlement.
7.4 Vacation History
Maintain a complete history of all vacation transactions, providing full traceability for HR administration, auditing, and employee record management.
7.5 Vacation Type Configuration
Create and configure unlimited vacation types such as Annual Leave, Sick Leave, Hourly Leave, Half-Day Leave, Emergency Leave, and any custom leave categories required by your organization.
8. Daily Attendance Report
The daily attendance report provides a clear view of employee check-in, check-out, working time, and attendance status for each day. HR teams can filter, review, and export daily attendance data for payroll and administrative use.
- Daily check-in and check-out overview
- Employee, date, and branch information
- Clean report layout for HR review
- Excel and PDF export support
9. Late Arrival Report
Automatically detect employees who arrive after their scheduled start time. The report helps HR monitor punctuality and calculate late minutes based on each employee's working schedule.
- Automatic late arrival detection
- Late minutes calculation
- Shift-aware evaluation
- Useful for payroll and HR performance tracking
10. Early Leave Report
Identify employees who leave before their scheduled end time. The report helps organizations monitor early departures and improve attendance control across departments and branches.
- Automatic early leave detection
- Early leave duration calculation
- Employee and branch visibility
- Supports HR review and payroll decisions
11. Missing Punch Report
Detect incomplete attendance records such as missing check-in or missing check-out. This helps HR quickly correct attendance issues before payroll processing.
- Identify missing check-in records
- Identify missing check-out records
- Reduce manual attendance verification
- Improve payroll accuracy
12. Absent Report
The absent report automatically lists employees with no attendance transactions for the selected date. HR teams can quickly identify full-day absences and export the results for follow-up.
- Automatic full-day absence detection
- Date-based absent reporting
- Clear employee absence list
- Excel and PDF export support
13. Monthly Late Summary
Summarize accumulated late minutes for each employee during the month. This report is useful for payroll deductions, HR evaluation, and management review.
- Monthly employee late summary
- Total late minutes calculation
- Employee-level performance overview
- Payroll and management reporting support
14. Time Control
Configure attendance control rules used by the reporting engine. Time control helps standardize how late arrivals, early leaves, and attendance exceptions are evaluated.
- Working time control configuration
- Late and early leave rule support
- Flexible attendance policy management
- Consistent reporting logic across the company
15. HR Dashboard
The HR dashboard gives management a visual overview of attendance performance. It provides quick insight into present employees, absent employees, late arrivals, and other key attendance indicators.
- Real-time attendance overview
- Visual HR performance indicators
- Fast management decision support
- Clear dashboard for daily monitoring
16. Attendance Analysis
Analyze attendance data using professional reporting views. HR teams can review trends, compare attendance behavior, and monitor workforce performance across employees, departments, and branches.
- Attendance trend analysis
- Employee and department insights
- Management-level reporting
- Supports better workforce decisions
17. Additional Employee Attendance Reports
Generate detailed attendance reports by employee, department, or company-wide scope. These reports support HR review, internal audits, and attendance history analysis.
- Single employee attendance report
- Single department attendance report
- All departments attendance report
- All employees attendance report
- Professional report output for HR documentation
Business Benefits
- Reduce manual attendance processing
- Improve attendance accuracy and transparency
- Centralize all biometric devices in one Odoo system
- Support multiple branches without multiple databases
- Detect late arrivals, early leaves, absences, and missing punches automatically
- Provide reliable data for HR, payroll, and management decisions
- Save time with Excel/PDF exports and professional dashboards
Support
Need assistance with installation, configuration, or customization? Our team is ready to help.
Email: mohammedkhoshnaw1710@gmail.com
Phone / WhatsApp: +964 750 499 2084
Business Hours:
Sunday - Thursday
9:00 AM - 5:00 PM (Baghdad Time)
Please log in to comment on this module