Biometric Device Attendance Integration for Odoo

This Odoo module integrates biometric attendance devices with the Odoo HR attendance system. It enables syncing users, fetching attendance records, and creating employee and attendance records in Odoo based on biometric data. The module supports retry mechanisms, logging, and error handling for better fault tolerance.

Features

1. Attendance Sync

• Biometric Device Connection: Connects to biometric devices (e.g., ZKTeco) using IP address and port.
• Retry Mechanism: Includes a retry mechanism to attempt reconnection to the biometric device up to 3 times in case of network issues.
• Attendance Filtering: Attendance data can be filtered based on a user-specified date range.
• Employee Creation: Automatically creates new employees in Odoo if they are not already present in the system.
• Duplicate Attendance Prevention: Prevents duplicate attendance records by checking for existing ones before creating new records.
• Attendance Check-in/Check-out: Handles both check-in and check-out attendance based on the punch type from the biometric device.
• Employee Sync Across Devices: Syncs employee records across multiple biometric devices.

2. Logging & Error Handling

• Comprehensive Logging: Logs details related to device connection, attendance record processing, and encountered errors.
• Error Notifications: Notifies the user if errors occur during attendance record creation.
• Detailed Error Logs: Captures and logs exceptions for debugging purposes.
• Notification System: Users are notified of significant events or errors, though recent logs indicate potential issues with notification functionality (e.g., notify_info attribute errors).

3. Device Integration Updates

• Integration with Biotime 8.5: Planned replacement of the ZKTeco library (pyzk) with JWT API integration from Biotime 8.5.
• Enhanced Synchronization: Updated logic to improve synchronization efficiency between devices and the Odoo system.
• Notification Issue: The current system logs include an error related to user notification via notify_info, where the method is missing. This issue needs addressing in future updates.

Installation

Follow these steps to install the module:

1. Clone the repository into your Odoo custom add-ons directory:
2. Install Dependencies: Ensure that the required dependencies (such as the ZKTeco SDK) are installed.
3. Update Odoo to recognize the new module:

   ./odoo-bin -c odoo.conf -u all

4. Configure the Biometric Device: Set the IP address and port of the biometric device in the module configuration.

Usage

The module offers functionalities for downloading attendance, syncing employees across devices, and viewing logs.

1. Download Attendance: Navigate to the Biometric Device menu and select Download Attendance. The system will connect to the

   Our Services

   We offer comprehensive Customization, Migration, and Upgrade services to tailor Odoo to your specific business needs and ensure smooth transitions to the latest versions.

   Author Information

   This module was created by Samy.

   Contact me at: https://linktr.ee/Prof.M.Samy