ZK-Biometric Device Integration

v 18.0 Third Party 165

Availability	Odoo Online Odoo.sh On Premise
Odoo Apps Dependencies	• Attendances (hr_attendance) • Employees (hr) • Discuss (mail)
Lines of code	8028
Technical Name	`vitou_zk_attendance_free`
License	AGPL-3
Website	https://apps.odoo.com/apps/modules/browse?search=vitou

You bought this module and need support? Click here!

Availability	Odoo Online Odoo.sh On Premise
Odoo Apps Dependencies	• Attendances (hr_attendance) • Employees (hr) • Discuss (mail)
Lines of code	8028
Technical Name	`vitou_zk_attendance_free`
License	AGPL-3
Website	https://apps.odoo.com/apps/modules/browse?search=vitou

ZK Fingerprint Integration with Odoo

This module is used to integrate from odoo with zk-tico fingerprint device to download all staff attendance from device to odoo system.

Key Highlights

Device Setup and Integration

Can support ZK fingerprint device, with multi device, can use one device or can set one for ckeckin and other for checkout.

Dowonload Attendance

Can download all staff attendance from fingerprint device,

Advancetage

1- Download Attendance from device

2- Generate Work Hour base on checkin and checkout automatically without rouster.

3- Copy to odoo buildin module attandance.

4- Print Monthly Attendance by deparment list from day 1rst to end of Month.

Manual how to setup and use.

In Python you need to install: attrgetter, pytz, zk, numpys
- in cmd, Cd to: C:\Program Files\Python312
- Pip3.12 install zklib
- pip install numpy
- python -m pip install Pyzk --upgrade
Extact Zip File
Copy and Past in folder custom_addons
Restart Odoo Service
Login Odoo as system administrator
Navigate to Apps
Update Apps List
Search as keyword vitou or ZK-Biometric Device Integration
Click Activate
Then see the user manual bellow

Installation

Setup User to access this module

Setup ZK Device

Setup Shift

Setup Employee

Fixed Shift:

Donwload Attendance from Device of fixed shift, checkin and checkout only morning and afternoon

Fix Shift:

Generate Attendance in list

Fixed Shift:

Apply done before copy to Attendance Odoo list, and lock the record from delete or edit

Fixed Shift:

Copy from this list to build-in module attendance list

Print Monthly Attendance

Flexible Shift:

Manage Attendance, same way as fix shift (flexible shift is checkin and checkout shift can rotate 24 hours, like moning, afternoon, evening and night, and we have to use 2 devices, one for checkin and one for checkout

Please log in to comment on this module

The author can leave a single reply to each comment.
This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.

Ratings
Discuss

kdanish@epteck.com

on 7/30/25, 6:37 AM

There are some bugs a shown below

Odoo Server Error
RPC_ERROR
Odoo Server Error
Occured on xxxx:8069 on model vitouzkf.download.att and id 265 on 2025-07-30 10:33:28 GMT
Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/odoo/http.py", line 1976, in _transactioning
    return service_model.retrying(func, env=self.env)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/odoo/service/model.py", line 156, in retrying
    result = func()
             ^^^^^^
  File "/usr/lib/python3/dist-packages/odoo/http.py", line 1943, in _serve_ir_http
    response = self.dispatcher.dispatch(rule.endpoint, args)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/odoo/http.py", line 2191, in dispatch
    result = self.request.registry['ir.http']._dispatch(endpoint)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/odoo/addons/base/models/ir_http.py", line 333, in _dispatch
    result = endpoint(**request.params)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/odoo/http.py", line 740, in route_wrapper
    result = endpoint(self, *args, **params_ok)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/odoo/addons/web/controllers/dataset.py", line 42, in call_button
    action = call_kw(request.env[model], method, args, kwargs)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3/dist-packages/odoo/api.py", line 533, in call_kw
    result = getattr(recs, name)(*args, **kwargs)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/odoo/odoo/custom-addons/vitou_zk_attendance_free/models/action/download_att.py", line 92, in action_download_attendance
    self.env[func_mod].is_my_saft()
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
AttributeError: 'vitouzkf.func' object has no attribute 'is_my_saft'

The above server error caused the following client error:
RPC_ERROR: Odoo Server Error
    RPC_ERROR
        at makeErrorFromResponse (http://xxx:8069/web/assets/debug/web.assets_web.js:29861:19)
        at XMLHttpRequest.<anonymous> (http://xxx:8069/web/assets/debug/web.assets_web.js:29915:27)

Re:

Vitou Ream

on 7/30/25, 8:04 AM Author

kdanish

fixed it ready can try it gain,

regards

There is Bug in This Module Download,pdf problem,,,work time problem

Rafiur Rahman Rafit

on 7/28/25, 5:51 AM

i downloaded it,,,,,ok,,,,i think it is inspire by cybros module,,,but good,,,,,,but there is bug also

i am fixing some of your bugs

Re: There is Bug in This Module Download,pdf problem,,,work time problem

Vitou Ream

on 7/28/25, 7:49 AM Author

Thank you for your comment and ratting, hope it will help.

How did you fixed this bug?

Kamal HAMMADI

on 8/7/25, 9:02 AM

AttributeError: 'vitouzkf.func' object has no attribute 'is_my_saft'

Re: How did you fixed this bug?

Vitou Ream

on 8/7/25, 8:38 PM Author

Hi Kamai,

I will double check this issue,

and you can fix yourself just find this function is_my_saft in all module and comment or delete it, it will work.

best regard