| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
| Lines of code | 276 |
| Technical Name |
zk_connector_license |
| License | OPL-1 |
| Website | https://elblasy.app |
| Versions | 16.0 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Attendances (hr_attendance)
• Employees (hr) • Discuss (mail) |
| Lines of code | 276 |
| Technical Name |
zk_connector_license |
| License | OPL-1 |
| Website | https://elblasy.app |
| Versions | 16.0 17.0 18.0 19.0 |
ZK Attendance Connector
Bridge ZK Biometric Devices with Odoo HR Attendance
No Static IP - No Dynamic DNS - No Port Forwarding
Just install the desktop app on any PC in the same local network as your ZK devices. Enter the device local IP address (e.g. 192.168.1.206) and your cloud Odoo URL - done.
Compatible with Odoo 16 - 17 - 18 - 19
Automatically sync attendance records from ZK fingerprint devices to Odoo. No manual data entry. No CSV imports. Just connect your devices and go.
All-in-One Package - Desktop App + License Key Included
Your purchase includes the Odoo module, the Windows desktop companion app, and a license key - everything you need to connect your ZK devices to Odoo.
After purchase, contact app@elblasy.app with your order confirmation to receive your desktop app download link and license key.
Key Features
Batch Attendance Sync
Send hundreds of attendance records in a single API call. The module automatically determines check-in vs check-out based on Odoo's current attendance state.
Smart Check-in / Check-out
No need to configure punch types on the device. The module checks whether the employee has an open attendance record and toggles automatically.
Duplicate Prevention
Each record is checked against existing attendance data. If the same employee + timestamp already exists, it is automatically skipped. No duplicates ever.
Per-Record Sync Status
Every sync returns detailed results for each record: success (check-in/check-out), skipped (duplicate), or failed (with reason and employee name).
How It Works
| 1 | Install this module on your Odoo instance (16, 17, 18, or 19) |
| 2 | Set employee PINs in Odoo to match the user IDs on your ZK devices |
| 3 | Download and install the Windows desktop app on a PC in the same network as your ZK devices |
| 4 | Contact app@elblasy.app with your order confirmation to receive your license key |
| 5 | Enter your Odoo URL, device local IP, and credentials in the desktop app |
| 6 | Enable auto-sync for fully hands-free attendance tracking |
Desktop Companion App
Windows application included with your purchase
Modern UI
Dashboard, attendance viewer, device management, sync log, and settings. Dark and light themes. Arabic and English support.
Auto-Sync
Schedule automatic syncing at configurable intervals. Catches up missed days on restart. Per-device toggle. Retry queue for failed records.
Auto-Update
The app checks for updates on startup and can update itself with one click. Always stay on the latest version.
Supported Devices
Works with all ZKTeco biometric devices that support TCP/IP communication:
ZK U160, ZK UA400, ZK K40, ZK iClock, ZK MB360, ZK F18, ZK IN01-A, ZK SF100, and all other pyzk-compatible models
API Reference
POST /api/zk/attendance/sync - Batch attendance sync (requires Odoo session)
{
"records": [
{"pin": "123", "timestamp": "2026-03-09 08:00:00", "device": "Device 1"},
{"pin": "456", "timestamp": "2026-03-09 08:05:00", "device": "Device 1"}
]
}
Response:
{
"success": 2, "skipped": 0, "failed": 0,
"processed": [
{"pin": "123", "status": "success", "action": "check_in", "employee": "Ahmed Ali"},
{"pin": "456", "status": "success", "action": "check_out", "employee": "Sara Hassan"}
]
}
Get Started Today
Purchase includes: Odoo module + Windows desktop app + license key.
Contact us after purchase to receive your download link and activation key.
Developed by elblasy.app
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