search

smsalah / hr_pyzk

Odoo Module for Attendance from ZKTeco Devices
GNU General Public License v3.0
18 stars 22 forks source link

readme

Introduction

This repository contains an odoo module for attendance. it brings attendance from
zkteco machines and transfer them to hr attendance.

Here is how it workds

 

Important!

 

Install pyzk library first. the library is included in the module directory hr_pyzk/pyzk-master. you can also get it from the following link . You can also get it from  here. To install the library go to pyzk_master folder and run python setup.py.

Please Visit the image folder in the main folder of the module (hr_pyzk/images) to view different processes.

  1. Make sure you copy the module in addons folder of odoo. After the installation of the module make sure to make the user member of "Device/Manager" Security group.
  2. Create attendance devices. Please make sure password is defined on the machine.I think default password is nothing but I am not sure.If device status is defined Inactive the users and attendances will not be imported from it.
  3. After defining the device import device users using "User/Attendance Wizard".
  4. Define related odoo employees for device users. If Odoo employees are not defined the attendance will not be transferred.
  5. Import attendance from the device using "User/Attendance Wizard". Their are separate records for clock ins and clockouts for all users from all devices.
  6. Combine attendance using "User/Attendance Wizard". combining means relevant clocin and clock outs will be joined for each user. the logic work as follows.
    The system makes pairs between subsequent Clock in /clock out. If a user forget clocking out the system will look for the next clock out and ignore a repeating clock in even if it is legal.
  7. Transfer attendance to HR Attendance using "User/Attendance Wizard".
  8. Delete Attendance from selected device. Be carefull.
  9. You can create fingerprint user by clicking create user and than click "Create Fingerprint User".
  10. You can Edit existing users by clicking "Edit/Update Existing fingperint User" button in the user form view.

Compatible Devices