ZKBioTime Attendance Pro
by Skill Jobs https://skill.jobs , Md Mahmudul Huq Topu https://skill.jobs
Odoo
$ 146.61
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
| Lines of code | 849 |
| Technical Name |
zktecho_attendance_pro |
| License | OPL-1 |
| Website | https://skill.jobs |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
| Lines of code | 849 |
| Technical Name |
zktecho_attendance_pro |
| License | OPL-1 |
| Website | https://skill.jobs |
ZKBioTime Attendance Pro (ZKTeco) Odoo 18
Synchronize attendance punches from ZKBioTime into Odoo and generate clean hr.attendance records. Includes raw punch log storage for auditing and safe overwrite logic to avoid duplicates and overlaps.
Odoo 18
HR Attendance
ZKBioTime API
Support: dev2@skill.jobs
License: LGPL-3
License: LGPL-3
Key Features
- Secure ZKBioTime API integration (server settings in Odoo)
- Raw punch log storage for audit and troubleshooting
- Safe overwrite mode to clean overlaps and duplicates
- Daily sync via wizard (manual) and cron (automatic)
- Calendar, list, pivot and graph views
- Low attendance alerts (email template included)
Employee Matching
The module can match employees using common identifiers (depending on your configuration):
- BioTime personnel/code (recommended)
- Employee barcode
- Employee ID (fallback)
How It Works
- Configure your ZKBioTime server connection in Odoo settings.
- Run manual sync for a date range or enable scheduled sync (cron).
- The module fetches punch logs and stores them as raw audit entries.
- It generates clean hr.attendance records using first-in / last-out logic (per day).
- Overwrite mode removes overlaps and closes open sessions to keep data consistent.
Important: Always test sync on a limited date range first. If you already have attendance data in Odoo,
enable overwrite carefully according to your HR policy.
Configuration
Server Settings
Navigate to your module menu: Attendance â ZKBioTime
Configure:
Configure:
- ZKBioTime base URL (example: http://SERVER:PORT)
- Username / Password (or token, depending on your BioTime API)
- Timeout and pagination size
- Optional department filtering
- Low attendance threshold + email recipients
Scheduled Sync (Cron)
Activate the provided scheduled action in Odoo:
Settings => Technical => Scheduled Actions (developer mode required).
Troubleshooting
| Issue | Possible cause | What to do |
|---|---|---|
| No data syncing | Mapping mismatch or no punches in BioTime | Verify employee identifiers and confirm punches exist for the selected dates |
| Incorrect times | Timezone mismatch | Check BioTime timezone, Odoo timezone and server timezone |
| Connection errors | Network/firewall blocked | Confirm BioTime URL is reachable from the Odoo server |
| Duplicates / overlaps | Existing records conflict with new data | Re-sync the affected date range using overwrite mode |
Need help? Email dev2@skill.jobs
and include: Odoo version, BioTime version, error screenshot, and a short description of your setup.
Screenshots
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.
Please log in to comment on this module