ZKTeco Integration | ZKTeco Biometric Attendance Integration | Odoo-ZKTeco Biometric Integration
by Dotsprime System https://dotsprime.com/
Odoo
$ 110.86
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
| Lines of code | 6780 |
| Technical Name |
dps_zkteco_biometric_integration |
| License | OPL-1 |
| Website | https://dotsprime.com/ |
| Versions | 15.0 16.0 17.0 18.0 19.0 |
ZKTeco Integration | ZKTeco Biometric Attendance Integration | Odoo-ZKTeco Biometric Integration
- Biometric device configuration: Our apps completely support the ADMS system to improve communication between devices and software.
- Traditionally, attendance data relied on static IPs and modem configurations. With ADMS, devices now transmit data directly to the software, eliminating the need for static IPs and modem setups.
Our apps completely support ADMS-enabled ZKTeco biometric devices.
The following are the ZKTeco devices that we tested:
- ZKTeco uFace Series: uFace202, uFace302, uFace402, uFace600, uFace800, uFace800Plus, (Provide your model)
- ZKTeco F Series: F09, F16, F18, F19, F21, F22, F25, F26, F28, F35, (Provide your model)
- ZKTeco MB Series: MB10, MB20, MB30, MB130, MB160, MB10-VL, MB360, MB2000, MB560-VL, (Provide your model)
- ZKTeco Mini Series: MiniAC Plus, MiniTA, MiniAC, (Provide your model)
- ZKTeco EFace Series: EFace 10, (Provide your model)
- ZKTeco iClock Series: iClock 680, iClock 700, (Provide your model)
- ZKTeco SpeedFace Series: SpeedFace V5, SpeedFace-V3L, SpeedFace-V5L, SpeedFace M4, SpeedFace-mini, (Provide your model)
- ZKTeco BioFace Series: ProBio Plus Series, (Provide your model)
- ZKTeco ProMA Series: ProBio Plus Series, (Provide your model)
- ZKTeco FaceDepot Series: FaceDepot-7BL, FaceDepot-4A, FaceDepot-7C, (Provide your model)
- ZKTeco K Series: K40, K40 Pro, K45, K45 Pro, K60, K999 PRO, (Provide your model)
- ZKTeco S Series: S500, S560, S880, S900, S922, (Provide your model)
- ZKTeco HORUS Series: HORUS TL1, HORUS E1, (Provide your model)
- ZKTeco iFace Series: iFace 900, iFace 950, iFace 302, (Provide your model)
- ZKteco BioPro Series:ZKteco BioPro MV30, ZKteco BioPro SA20, (Provide your model)
Key Features of "ZKTeco Integration | ZKTeco Biometric Attendance Integration"
- Log Status Identification Based on Device: This feature determines the status of each log entry whether it is a checkin or check out by analyzing the configuration of the device that recorded it. It supports both single purpose devices (designed for either checkin or checkout only) and combined devices that handle both checkin and checkout operations, ensuring accurate log categorization regardless of device type.
- Color-Coded Log Statuses: Attendance logs are visually distinguished using different colors according to their status (e.g., check-in, check-out, late, absent). This color-coding allows users to quickly and easily identify the type and state of each log at a glance, improving readability and efficiency in monitoring attendance.
- Flexible Device Connection Methods: The system supports multiple ways to connect attendance devices, either through ADMS (Automatic Device Management System) or via a direct IP connection. This flexibility ensures seamless integration with different device setups, making installation and management easier and more adaptable to various network environments.
- Attendance Calculation Based on Log Status and Sequence: The system calculates attendance accurately by considering both the status of each log (check-in or check-out) and the chronological order of logs. This ensures precise tracking of working hours, late arrivals, early departures, and overall attendance, even when multiple logs are recorded in a day.
- Timezone Correction Option:The system allows users to adjust log times when a timezone mismatch occurs. By selecting the appropriate user timezone, log entries are automatically corrected, ensuring accurate attendance records regardless of the device or server local time.
- Fetch Device Users: This feature allows users to fetch all registered users directly from biometric devices into Odoo. It streamlines user management by automatically syncing device data with the system, eliminating manual entry and ensuring accurate user records.
- Refresh Device Connection with a Single Click: This feature allows users to instantly refresh the connection between Odoo and the ZKTeco device without restarting the service or reconfiguring the device. It helps quickly recover from temporary network issues and ensures uninterrupted attendance synchronization.
- ZKTeco Devices Support ADMS over HTTP/HTTPS: The integration fully supports ZKTeco devices operating in ADMS mode using secure HTTP/HTTPS protocols. This enables reliable and real-time communication between devices and Odoo without complex network setups, ensuring secure data transmission.
- No Private IP Required :Unlike traditional biometric integrations, this solution does not require a private or static IP address. Devices can communicate directly with Odoo via ADMS, reducing infrastructure costs and simplifying deployment, especially for remote or distributed locations.
- Attendance Calculation Based on Status Codes: Attendance is calculated using device-generated status codes such as check-in, check-out, break, overtime, and more. This ensures accurate interpretation of employee activity and enables precise attendance, overtime, and shortfall calculations.
- Fetch Missing Punching Logs: The system can retrieve any punch logs that were missed or not previously recorded, ensuring that all attendance data is complete and up-to-date. This helps maintain accurate records even if device connectivity or errors caused gaps in logging.
- Fetch Biometric Data: The system allows users to fetch biometric data from devices, including cards, fingerprints, and facial recognition data. This ensures that all user identification information is synchronized and up-to-date within the system for accurate attendance tracking and user management.
- Device User Management from Odoo: The system enables users to create, update, or delete device users directly from Odoo, eliminating the need to manage users separately on each biometric device. This centralizes user management, saving time and ensuring consistency across all connected devices.
- Dynamic Overtime Rounding: The system provides a configurable option to dynamically round overtime hours. This ensures that overtime calculations are flexible, accurate, and aligned with organizational policies.
- Check-in Time Rounding and Multi-Shift Support: The system allows rounding of check-in times for accurate attendance calculation and provides support for multiple shifts at the device level. This ensures flexible handling of complex work schedules and consistent attendance tracking across different shifts.
- Download Reports: The system allows users to download daily and attendance reports in a convenient format. This provides easy access to attendance data for analysis, record-keeping, and decision-making.
- Automatic Device Connection Status Update: The system automatically updates the connection status of devices every 30 minutes, ensuring that users always have up-to-date information on whether devices are online or offline. This helps in proactive monitoring and maintenance of device connectivity.
- Export Employees from Device: The system allows users to export employee data directly from biometric devices, enabling easy backup, sharing, or migration of user information. This ensures that employee records are readily accessible outside the device for administrative purposes.
- Check-in and Check-out Time Period Configuration: The system provides a configurable time period for devices that handle both check-in and check-out. This ensures accurate identification of logs by defining the allowed time ranges for check-in and check-out, preventing overlap or misclassification of attendance records.
- Automatic Fetching of Missed Logs: The system automatically retrieves any missing logs every 15 minutes if they were not captured earlier due to device or technical issues. This ensures that attendance records remain complete and up-to-date without manual intervention.
- Working Schedule and Weekend Configuration:The system allows users to define working hours and configure weekends within the working schedule, even for schedules that span the entire week. This flexibility ensures accurate attendance tracking according to organizational policies and varying work patterns.
- Multiple Shift Check-In and Check-Out Calculation: The system supports organizations with multiple shifts by accurately calculating check-in and check-out times based on assigned shift schedules. It handles early, late, overnight, and overlapping shifts, ensuring precise attendance records for all employees.
-
Attendance Report Highlighting: Attendance reports use highlighted backgrounds to clearly distinguish different types of entries, including:
- Absent days
- Present days
- Weekends
- Employees present on weekends
- This visual differentiation allows users to quickly interpret attendance patterns and exceptions without scanning each entry manually.
Screenshot
1.) After installing the module, go to the ZKTeco menu, click on Device Settings, and then open Device Configuration to configure the device.
2. If you need to connect the device using an IP address, enter the device IP address, port number, password (if set), and the correct timezone.e
2.1 Then, click on the Test Connection button to check the connection with the configured device.
2.2 Once the connection is successful, click on Synchronize Employees to sync employees with the device.
If you need to connect using ADMS, select ADMS, enter the device serial number, enable Is Password Set if a password is configured, provide the device password, and select the correct timezone..
3.1 Select your preferred option from Check Option based on your requirement. You can configure the device for a specific check-in or check-out, or use the same device for both check-in and check-out. Choose the appropriate option, and the log status will be displayed accordingly.
3.2 Click the Check Connection button to test the connection between the system and the device. Once clicked, the system will verify the connection and mark the device as active. If the device does not respond for more than 30 minutes, it will be automatically marked as inactive.
3.3 Once the device is connected, it will be shown as active. You can refresh the device connection at any time by clicking on Refresh Connection.
3.4 Click the Download Device Users button to fetch users from the device into the system.
3.5 Click the Export Employees to Device button to export employees to the device.
3.6 Attandance checkin and checkout rules: Here you can add check in and checkout time for the system. 1> check in 2> checkout 3> Both.
4. Click the Fetch Face Data button to fetch face data of all users registered on the device.
4.1 Within Device Settings, click on the ZKTeco Face Templates menu to view the usersâ face data.
5. Click Fetch Missing Logs. A pop-up wizard will appearâselect the required time period and then click Fetch Logs to retrieve missing logs from the device for the specified duration.
5.1 To view attendance logs, go to the Device Logs menu and click on Attendance Logs to see the device attendance records.
6. On the Device Users page, you can see all users associated with the device, along with their user name and user ID.
6.1 Once the device is connected and users are fetched, if a user is not synced with the device, click on that user to open a pop-up. In the Employee field, select the correct and related employee for that user.
7. The ZKTeco Device Status Code page displays the device status codes used for check-in and check-out in the device attendance logs.
8. The Attendance Logs button displays the device event logs, and the Command Count button shows the commands executed that were created by the user.
9. Click on Synchronization, then select Calculate Attendance to calculate attendance.
9.1 Once clicked, attendance will be calculated based on the existing logs fetched from the device.
10. Click on Device Settings, then select Attendance States to view the attendance states of all devices.
11. Go to the Device Settings menu and click on Fingerprint Templates. This will display the fingerprint templates of device users, showing the actual finger along with its index.
12. Go to the Device Settings menu and click on Card Data. This will display the Card Data of device users.
13. Go to Device Logs, then click on Attendance Logs to view the attendance logs fetched from the device.
14. Go to the main menu and click on Settings. From the Attendances section, scroll down and locate Attendance Shift Settings and ZKTeco Attendance Biometric Device. Enable User Minimal Attendance to calculate attendance on a daily basis. Enable Multiple Shift if you want to calculate multiple shifts within a single attendance record. If there is a timezone difference while calculating attendance, enable TZ Update. Otherwise, leave it disabled. Enable Calculate Attendance by Status to calculate attendance based on status codes, and make sure this option is turned on.
14.1 Attandance checkin and checkout rules: Here you can add check in and checkout time for the system for multiple shift.
15. Go to Employees and open an employee record. Then click on the ZKTeco Bio Devices menu. Here, you can see the device details for that employee across all registered devices, provided the employee is created as a user on those devices and has been synced.
16. Inside the Biometric Data section, you can view the biometric details of the employee.
17. Inside the Actions menu, there are three options:
17.1 Scan User with ZKTeco Device â This checks whether the user exists on the device. If the user is not found, the system will enroll the user. If the user is not created, you can review the logs for details.
17.2 Update User with ZKTeco Device â This is used to update the userâs name and card details on the device. If the user does not already exist, a new user will be created on the selected device.
17.3 Remove User with ZKTeco Device â This action removes the employee from the selected device.
You can execute these actions for multiple devices at once.
Screenshot
1. For reports, go to the Reports menu and click on Employee Attendance Report. A wizard will open where you can select an employee and a date range for the report. If no employee is selected, the report will be generated for all employees. You can generate the report based on attendance data or device logs.
2. Click on Daily Reports to generate daily reports. You can generate reports based on a selected time period and employee.
2.1 Click on Daily Reports to generate daily reports.
following reports are available:
1.Attendance Report
2.Absence Report
3.Daily Summary Report
4.Calculated Attendance Difference
Screenshot
1 Attandance advance dashboard.
2 Preview of Attandance excel reports.
3 Attandance excel reports send by mail.
Release Update - JAN 02, 2026
Version - v19.0.0.1.2
Version - v19.0.0.1.2
- Check compatiblity with the F35, iFace900 module of zkteco and make working.
Release Update - December 30, 2025
Version - v19.0.0.1.1
Version - v19.0.0.1.1
- Add Translation in Arabic, Spanish, French and improve some code for custom Report.
Release Update - December 23, 2025
Version - v19.0.0.0.9
Version - v19.0.0.0.9
- Release stable version of the Zkteco attandance machine.
Release Update - December 20, 2025
Version - v19.0.0.0.8
Version - v19.0.0.0.8
- Test device with multiple device and make update in code.
Release Update - December 15, 2025
Version - v19.0.0.0.7
Version - v19.0.0.0.7
- Multiple shift check in and checkout code. And check compatiblity with multiple models of Zkteco. And add calculation in attandance report.
Release Update - December 10, 2025
Version - v19.0.0.0.6
Version - v19.0.0.0.6
- Added dashboard advance option.
Release Update - December 5, 2025
Version - v19.0.0.0.5
Version - v19.0.0.0.5
- Added multiple report and recheck code.
Release Update - November 30, 2025
Version - v19.0.0.0.4
Version - v19.0.0.0.4
- Small fixing in the issue and make device more accurate.
Release Update - November 20, 2025
Version - v19.0.0.0.3
Version - v19.0.0.0.3
- Added code Advance device management and concnetion security
Release Update - November 10, 2025
Version - v19.0.0.0.2
Version - v19.0.0.0.2
- Added report for attandance.
Release Update - October 10, 2025
Version - v19.0.0.0.1
Version - v19.0.0.0.1
- Added code for Device connection.
Release Update - October 1st, 2025
Version - v19.0.0.0.0
Version - v19.0.0.0.0
- Initial Release.
NOTE: If you have any inquiries concerning this application, please feel free to reach out to us. If you need assistance in resolving errors with any other applications, it will require additional modifications for bug fixes and to ensure compatibility.
Our Service
If you are looking for any Customsation, Support, Implementation, Migration, Odoo Training (Technical-Functional), Odoo Version Migration, Odoo Database Migration, Odoo Support, Odoo Fixing, Odoo Bug fixing, Any query plz Contact us We are ready to help you.
Contact us for support
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
ReportS
Version Log
Please log in to comment on this module