1. After installing the module, navigate to ZKTeco → Device Settings → Device Configuration. Configure your ZKTeco biometric device according to your network and communication settings.

2. To connect the device using a Direct IP connection, enter the device's IP Address, Port Number, Communication Password (if configured), and the appropriate Timezone. After entering the required information, save the configuration and test the connection to ensure successful communication between the device and Odoo.

2.1 After completing the device configuration, click the Test Connection button to verify communication between Odoo and the configured ZKTeco biometric device. If the connection is successful, the system will confirm that the device is ready for data synchronization.

2.2 Once the connection has been successfully established, click Synchronize Employees to import and synchronize employee records between Odoo and the connected ZKTeco biometric device. This ensures that employee information remains synchronized across both the device and Odoo.

3. If you need to connect the device using ADMS, select ADMS as the connection type, enter the device serial number, enable Is Password Set if a password is configured on the device, enter the device password, and select the appropriate timezone.

3.1 Select the appropriate option from Check Option based on your requirements. You can configure the device as a dedicated Check-In device, a dedicated Check-Out device, or use the same device for both check-in and check-out. Attendance log statuses will be recorded accordingly.

3.2 Click the Check Connection button to verify the connection between the system and the biometric device. If the connection is successful, the device will be marked as Active. If the device does not respond for more than 30 minutes, it will automatically be marked as Inactive.

3.3 Once the device is successfully connected, its status will be displayed as Active. You can refresh the device connection at any time by clicking the Refresh Connection button.

3.4 Click the Download Device Users button to import all registered users from the biometric device into Odoo.

3.5 Click the Export Employees to Device button to export employee records from Odoo to the connected biometric device.

3.6 Attendance Check-In and Check-Out Rules: Configure the attendance rules by selecting one of the following options: Check-In, Check-Out, or Both. These settings determine how attendance logs are interpreted and processed by the system.

4. Click the Fetch Face Data button to retrieve the facial data of all users registered on the biometric device.

4.1 Navigate to Device Settings → ZKTeco Face Templates to view the facial templates of all synchronized users.

5. Click Fetch Missing Logs. A pop-up wizard will appear. Select the required date and time range, then click Fetch Logs to retrieve any missing attendance logs from the biometric device.

5.1 To view attendance logs, navigate to Device Logs → Attendance Logs. This page displays all attendance records synchronized from the biometric device.

6. The Device Users page displays all users registered on the biometric device, along with their user names and user IDs.

6.1 After the device has been connected and users have been imported, if a device user is not linked to an employee, click the user to open the pop-up window. In the Employee field, select the corresponding employee to establish the synchronization.

7. The ZKTeco Device Status Codes page displays the attendance status codes used by the biometric device to identify check-in, check-out, break, overtime, and other attendance events.

8. The Attendance Logs button displays all attendance events received from the biometric device, while the Command Count button displays the commands that have been executed and sent to the device.

9. Navigate to Synchronization, then click Calculate Attendance to process employee attendance records.

9.1 Once the process is complete, attendance will be calculated automatically based on the attendance logs synchronized from the biometric device.

10. Navigate to Device Settings, then select Attendance States to view the attendance state configuration for all registered biometric devices.

11. Navigate to Device Settings → Fingerprint Templates to view the fingerprint templates of all device users, including the registered fingerprint and its corresponding finger index.

12. Navigate to Device Settings → Card Data to view the card information of all users registered on the biometric device.

13. Navigate to Device Logs → Attendance Logs to view all attendance records synchronized from the biometric device.

14. Navigate to Settings. Under the Attendances section, scroll down to locate Attendance Shift Settings and ZKTeco Attendance Biometric Device settings.

Enable User Minimal Attendance to calculate employee attendance on a daily basis.
Enable Multiple Shift to calculate multiple work shifts within a single attendance record.
If there is a timezone difference between the device and the server, enable TZ Update. Otherwise, leave this option disabled.
Enable Calculate Attendance by Status to calculate attendance based on the device status codes. It is recommended to keep this option enabled.

14.1 Attendance Check-In and Check-Out Rules: Configure the attendance rules for multiple shifts by defining the appropriate check-in and check-out time ranges for the system.

15. Navigate to Employees and open an employee record. Then select the ZKTeco Bio Devices tab to view the device information associated with that employee across all registered biometric devices. This information is available only if the employee has been created on the device and successfully synchronized.

16. Within the Biometric Data section, you can view the employee's biometric information, including the data synchronized from the connected biometric devices.

17. The Actions menu provides the following user management options for biometric devices:

17.1 Scan User with ZKTeco Device : This option checks whether the selected user exists on the biometric device. If the user is not found, the system will automatically enroll the user on the device. If the enrollment fails, you can review the logs for detailed information.

17.2 Update User with ZKTeco Device : This option updates the selected user's information, such as the user name and card details, on the biometric device. If the user does not already exist on the selected device, a new user will be created automatically.

17.3 Remove User with ZKTeco Device : This option removes the selected employee from the biometric device while leaving the employee record unchanged in Odoo.

These actions can be performed simultaneously for multiple biometric devices, allowing you to manage user synchronization efficiently across all selected devices.