Skip to Content
Menu

ZKTeco Attendance machine integration

by
Odoo

108.27

v 17.0 Third Party 71
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Attendances (hr_attendance)
Employees (hr)
Discuss (mail)
Lines of code 2547
Technical Name azk_zkteco_attendance
LicenseAGPL-3
Websitehttps://azka.tech
Versions 13.0 14.0 15.0 16.0 17.0 18.0
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 2547
Technical Name azk_zkteco_attendance
LicenseAGPL-3
Websitehttps://azka.tech
Versions 13.0 14.0 15.0 16.0 17.0 18.0

Important Note:
Users in each machines must be different from other machine users, i.e : user cant not use multiple machine to check-in, out
This addon Supports the integration with fingerprint machines of ZKTeco Biopro MV30. 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.

NOTE: this modules works on PaaS (aka Odoo.sh) or on-premises and does not work on the SaaS version. It depends on pyzk which installs automatically. If it didn't install then copy the content of requirements.txt into the main requirements file


NOTE: 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


Process

  • 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 (Important Note: users in each machines must be different from other machine users, i.e : user cant not use multiple machine to check-in, out).

Configuration

  • 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.

Azkatech Suggested Apps

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 or have a question related to your purchase, please use the support page.
There are no ratings yet!
by
AITLAMSALI Alaa
on 7/8/24, 12:13 PM

Thanks for your reply
- My Odoo is V17 Community hosted on Cloud VPS (Virtual Private Server)
- Test compatibility I didn't buy yet but supplier gave ma available models in market in Morocco : MB20/ID and MB360/ID 
- For connectivity I can pay a documentation to explain that part, I think there"s also one method called Dynamic DNS to link the static IP address with internet domain name

Sincerely

Re:
by
Shadi Moadad
on 7/8/24, 1:22 PM Author

Dear Alaa, the dynamic DNS could work if you are assigned a public IP that changes. But make sure it is a public IP. if that's the case then yes it works, you just set the port forwarding on your router that have that public IP and the dynamic DNS.

As for the machine, usually all ZKTeco that supports TCP/IP works fine with the module.




by
Shadi Moadad
on 7/8/24, 10:11 AM Author

Dear Alaa,

Here are the answers to your questions

  • You do not need to buy the Biotime software. Just make sure it is ZKTeco.
  • To make sure our software works with your machine, you can download the link on the description (on this page) and connect via IP.
  • We do not connect via SQL too.
  • If Odoo is on cloud then you need to be able to give access for cloud to your machine and this can be done via two ways:
    • if you have a static internet IP then your IT can do port forwarding to the machine itself. 
    • If you do not have a static IP you need to create a reverse tunnel. This can be either  be achieved via a freeware like ngrok that can be installed on a machine (but requires subscription from 3rd party to have a fixed url) or if you have a robust team in house they can create a reverse tunnel (however the overhead to do it is more expensive then getting the ngrok subscription)

by
AITLAMSALI Alaa
on 7/8/24, 8:43 AM

- Does we need to buy the Biotime Software with the Devices ??


- Are you using SQL to connect or API ? because with the API supplier told me I need to buy the Biotime native software with it which is expensive .

- If we have Odoo on cloud and the device in local network how we can connect ?

Thanks for your answer


Sincerely

Re:
by
Shadi Moadad
on 7/8/24, 11:30 AM Author

Here are the answers to your questions

  • You do not need to buy the Biotime software. Just make sure it is ZKTeco.
  • To make sure our software works with your machine, you can download the link on the description (on this page) and connect via IP.
  • We do not connect via SQL too.
  • If Odoo is on cloud then you need to be able to give access for cloud to your machine and this can be done via two ways:
    • if you have a static internet IP then your IT can do port forwarding to the machine itself. 
    • If you do not have a static IP you need to create a reverse tunnel. This can be either  be achieved via a freeware like ngrok that can be installed on a machine (but requires subscription from 3rd party to have a fixed url) or if you have a robust team in house they can create a reverse tunnel (however the overhead to do it is more expensive then getting the ngrok subscription)



Dudas IP
by
Roberto SPOC Odoo RIMOVA
on 4/25/24, 2:16 PM

Por mas que intento logro ver mi biometrico desde odoo, como es la configuracion de las ip, uso SH y mi red es con  unifail

Re: Dudas IP
by
Shadi Moadad
on 4/26/24, 4:48 AM Author

Dear Dudas, if you are hosted on Odoo.sh then you need to either have a direct access to the attendance machine e.g. you shall have a static IP address and do a port forwarding from that external IP to the machine IP.

Another solution is to use tunnel software, e.g. ngrok.com and you connect to the attendance machine as tcp protocol and it gives you a public IP and port to use in Odoo.sh configuration page