/hr_pyzk

Odoo Module for Attendance from ZKTeco Devices

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

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

 

  • Firmware Version : Ver 6.21 Nov 19 2008 Platform : ZEM500 DeviceName : U580
  • Firmware Version : Ver 6.60 Apr 9 2010 Platform : ZEM510_TFT DeviceName : T4-C
  • Firmware Version : Ver 6.60 Dec 1 2010 Platform : ZEM510_TFT DeviceName : T4-C
  • Firmware Version : Ver 6.60 Mar 18 2011 Platform : ZEM600_TFT DeviceName : iClock260
  • Platform : ZEM560_TFT Firmware Version : Ver 6.60 Feb 4 2012 DeviceName :
  • Firmware Version : Ver 6.60 Oct 29 2012 Platform : ZEM800_TFT DeviceName : iFace402/ID
  • Firmware Version : Ver 6.60 Mar 18 2013 Platform : ZEM560 DeviceName : MA300
  • Firmware Version : Ver 6.60 Dec 27 2014 Platform : ZEM600_TFT DeviceName : iFace800/ID
  • Firmware Version : Ver 6.60 Nov 6 2017 (remote tested with correct results) Platform : ZMM220_TFT DeviceName : (unknown device) (broken info but at least the important data was read)
  • Firmware Version : Ver 6.60 Jun 9 2017 Platform : JZ4725_TFT DeviceName : K20 (latest checked correctly!)
  • Firmware Version : Ver 6.60 Aug 23 2014 Platform : ZEM600_TFT DeviceName : VF680 (face device only, but we read the user and attendance list!)