ZKTeco Attendance machine integration

Introduction

This integration of Odoo attendance with ZKTeco attendance machine will help in managing your HR work more efficiently, from tracking the worked hours along with automated and dynamic creation of the employees into the ability to download the attendance data and check in/out of your employees in a few clicks with its multiple verification modes and access features.

If your get the error "ModuleNotFoundError: No module named 'zk'" then make sure to do the following:

• Open shell window:
  • if on odoo.sh then select your environment and press on "Shell"
  • if on premises then open an ssh window and make sure to activate your python environment
• Run: pip3 install pyzk

Notes:

• Before purchasing this module, make sure that your machine is compatible via this ZKTeco Compatibility tester
  https://drive.google.com/drive/folders/1butFR0-_7lWh0OL5N63PELL2-d5UH35E?usp=sharing
  If not supported get in touch with us
• Users in each machines must be different from other machine users, i.e : user cant not use multiple machine to check-in, out

• Select attendance machine >> machine configuration
• Define the machine configuration
• Add the real IP address of the machine, the port number and password (if exists), then use the action of testing connection to make sure that the IP and port are working.
• Note: you can use another IP which redirect to an internal IP inside your network. This IP could be obtained by Ngrok account.
• Test the connection
• Specify the connection time out
• Auto Create the Employee: The application will create the employee on Odoo if the employee ID on the machine is not linked to any Employee card (Device ID)
• Download Attendance: This action is used to synchronize the attendance from the machine to the system.
• Clear Device Data: This action will delete the attendance records from the machine database.
• Add Multiple Integrated Machines: User can define multiple machines to import that data from
  Note: users in each machines must be different from other machine users, i.e : user cant not use multiple machine to check-in, out.

• ZKteco working hours
• Make sure employee working hours are correctly configured.
• The system will use the Day of week, hour from, hour to to detect checkin/checkout.
• If no day of week found then takes by default the first one.
• ZKTeco Attendance
• Intelligent system that automatically detect check-in/checkout from working hours configured as per above
• In case of conflict, a record will not be imported thus preventing errors with Odoo attendance rules.
• Possible to re-import many times the same data, this module will detect it and skip them
• Fast to import: it just processes the records that was not yet import (since ZKTeco machines returns all data stored on them)
• Create / Delete machine users.
• It just works.
• ZKTeco Users Creation On Attendance Machine
• If employee has device ID which not exists on machine, the user will be created successfully
• If employee does not have device ID, the machine will assign an auto generated Device ID and the user will be created successfully
• If employee has device ID used for another employee, an error will pop up indicating that the device ID is bound to another employee
• If employee hase device ID and there is a machine user with same device ID and name, an error will pop up indicating that employee is already created.
• User can select multiple employees from the list and perform creation action.
• ZKTeco Users Deletion On Attendance Machine
• If employee has device ID which exists on machine, the user will be deleted successfully
• If employee has device ID which not exists on machine, an error will pop up indicating that the user does not exists.
• If employee does not have device ID , an error will pop up indicating that device Id is not set.
• In order to download employees on the ZKteco device, select the employees and "Create User On Machine".