Real-Time Live Capture

Pull attendance logs from 15+ ZKTeco device series via PyZK (direct TCP/IP) or ADMS Cloud (HTTP push). Captures are processed instantly with duplicate punch prevention.

Employee-Device Mapping

Assign employees to specific ZKTeco devices. The system automatically routes attendance data to the correct employee record, eliminating manual matching.

Late Check-In Management

Configure grace periods, late penalties, and automated notifications. Employees flagged as late are tracked in a dedicated view with configurable thresholds.

Attendance Dashboard

Monthly calendar grid showing present, absent, late, and on-leave status at a glance. Color-coded cells make daily attendance review fast and intuitive.

Device Health Monitoring

Track device online/offline status, last communication timestamp, and error counts. Proactive alerts help you address connectivity issues before they affect payroll.

LCD Messages & Audio Feedback

Send custom LCD text messages and configure audio feedback on ZKTeco devices directly from Odoo. Communicate shift changes, announcements, or greetings.

Door Control Integration

Remotely unlock doors connected to ZKTeco devices. Manage access control alongside attendance for a unified workforce management experience.

Comprehensive Reports

Generate attendance reports in PDF and Excel formats. Filter by employee, department, date range, and attendance status for payroll-ready exports.

Installation & Setup

1. Install the module: Go to Apps -> Search for "oe_zk_biometric_attendance" -> Click Install
2. Configure permissions: Navigate to Settings -> Users & Companies -> Assign ZK Biometric Attendance Manager access to HR administrators
3. Initial configuration: Go to Attendance -> ZK Devices -> Create and enter your ZKTeco device IP address, port, and connection type (PyZK TCP/IP or ADMS Cloud)

Basic Usage

1. Add devices: Open ZK Devices, click Create, enter device name, IP address, port number, and select connection protocol. Test the connection to verify communication.
2. Map employees: Open each employee record, go to the ZK Biometric tab, and select the device and user ID assigned on the ZKTeco terminal.
3. Monitor attendance: Use the Attendance Dashboard to view daily status. Color-coded cells show present, absent, late, and on-leave employees at a glance.
4. Manage late check-ins: Configure grace periods and late thresholds in Settings. The Late Check-Ins view tracks violations and applies configured penalties.
5. Generate reports: Open Attendance Reports, select date range and filters, and export to PDF or Excel for payroll processing.

Tips & Best Practices

• Place ZKTeco devices on a stable network segment with static IP addresses for reliable PyZK communication
• Configure ADMS Cloud push for remote sites where direct TCP/IP access is not available
• Set up device health monitoring alerts to catch offline terminals before payroll runs
• Use the LCD message feature to broadcast shift changes and holiday schedules to all employees at device touchpoints
• Combine with OE HR suites for end-to-end workforce management and compliance reporting

Important Notes

Ensure ZKTeco devices are on the same network as your Odoo server for PyZK TCP/IP connections. For ADMS Cloud, verify that HTTP push is enabled on the device and firewall rules allow outbound connections. Employee user IDs on ZKTeco devices must match the IDs configured in Odoo for automatic log assignment to work correctly.

Q: Which ZKTeco device series are supported?

A: The module supports 15+ ZKTeco device series via PyZK, including inBio, inFace, SpeedFace, MB, K50, and others. ADMS Cloud integration supports any ZKTeco device that can push attendance logs via HTTP. Contact support for specific device compatibility.

Q: Can I use this module with remote or branch offices?

A: Yes. For remote sites, use ADMS Cloud HTTP push integration which works over the internet without requiring direct TCP/IP access to the device. Each device can be configured independently and assigned to specific employees or departments.

Q: How does late check-in management work?

A: Configure a grace period (e.g., 15 minutes after shift start) and optional late penalty rules. Employees who check in after the grace period are automatically flagged in the Late Check-Ins view. The system tracks violations per employee and date, making it easy to enforce attendance policies consistently.

Q: Can I export attendance data for payroll?

A: Yes. The attendance report wizard supports PDF and Excel export with filters for employee, department, date range, and attendance status. Reports include check-in and check-out times, total hours, late status, and leave information.

Q: What happens if a ZKTeco device goes offline?

A: The device health monitoring system tracks online/offline status and last communication timestamp. Offline devices are flagged in the dashboard. When the device reconnects, PyZK can pull any missed attendance logs automatically, preventing data loss.

Why Choose Odoo Engineering