Tích hợp Máy chấm công Sinh trắc học
| Số dòng Code | 6530 |
| Tên kỹ thuật | to_attendance_device |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/app/18.0/to_attendance_device |
| Đọc mô tả cho | v 10.0 v 11.0 v 12.0 v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 |
| Yêu cầu các App | Attendances (hr_attendance) Discuss (mail) Employees (hr) |
| Bao gồm Các phụ thuộc | Mô-đun Cơ Sở |
ZKTeco biometric attendance integration for Odoo/Viindoo
Connect - sync - automate all attendance logs from ZKTeco devices into your HR system. Manage device users, support multiple devices - locations - timezones, keep safe audit trails and long term retention.
Supports TCP - UDP - optional "iCloud" push mode for devices. Streamline check-in workflows, reduce manual entry, and get payroll ready.
Key features
A production-ready attendance integration framework for ZKTeco devices. Flexible connectivity, safe synchronization, scalable across devices - locations - timezones, with permanent storage in Odoo/Viindoo.
Flexible connectivity
Connect via IP or domain using TCP or UDP. Optional "iCloud" mode lets devices push logs into the app.
On-device user management
Import - remove users, auto-map to employee profiles in Odoo. Track in - out - overtime states.
Multi-device - multi-site
Operate many ZKTeco devices across multiple locations and timezones, consolidate logs centrally.
Automated synchronization
Schedule or run manual pulls. Auto cleanup on device per configuration. Permanent storage in Odoo.
Secure connection
Password-based authentication when pairing devices with Odoo/Viindoo. Prevent unauthorized access and preserve integrity.
Broad device compatibility
Compatible with many ZKTeco and Ronald Jack models. Tested with SpeedFace, Uface, K-series, iFace, iClock, and more (see below).
Key benefits
Reduce manual entry, minimize errors, and shorten time-to-payroll.
Unify in - out - overtime data with HR records and Odoo Attendance.
Enable workforce analytics, support payroll and compliance needs.
Leverage existing devices, simple configuration, lower operating cost.
Connect devices
- Connect using IP or domain via TCP - UDP.
- Optional "iCloud" mode for device-to-app push.
- Secure with connection password to harden access.
User Management on Attendance Machines
- Support multiple ZKTeco attendance machines at different locations, time zones at various locations.
- Import - remove users to devices from employee lists.
- Automatically map users on attendance machines with employee profiles in Odoo.
- Support multiple attendance statuses (e.g., Check-in, Check-out, Start Overtime, End Overtime, etc.).
Attendance Data
- Automatically download attendance data from machines and synchronize it with the HR system in Odoo (users can configure automatic or manual synchronization).
- Automatically clear attendance data from machines according to the configuration or manually clear it.
- Permanently store attendance data in Odoo/Viindoo
"Icloud" option for Odoo 17+
Introduce ADSM iCloud Feature
Since Odoo 17, new feature was added call 'Icloud' to allow machine to push data into software. Before we only can get data from the machine, some client might get trouble when configure the machine because it need static IP and Modem configuration.
With this feature (optional, by default we still use either UDP or TCP one, we encourage to use this icloud option as the last one only because it has some security risk) you only need to configure in the machine by following instruction (this instruction use SpeedFace-H5L[P], but don't worry other machines have the same one):
Quick Guide
(this instruction use SpeedFace-H5L[P], but don't worry other machines have the same one):
- Go to 'Comm' setting of the machine
-
Select Cloud Server Setting and you will see some configuration:
- Enable Domain Name: enable this if you going to use domain name
- Server Address: enter IP address like 192.168.1.1 (check this by going to internet setting) or your domain name like example.viindoo.com
- Server Port: If it hosted online, probably '443' is fine or any port that your server has. In the local environment it should be the port to run Odoo config (8069 for example)
- Enable Proxy Server (Some machines have): activate Proxy, after that you will need to specify Server IP and Port of the proxy one
- HTTPS (Some machines have): Support https when pushing data, need to activate this unless you use local environment to develop. Note this, some machines might not have this, in that case it is necessary to change the nginx settings to prevent redirection to https for routers related to machines.
- Then go to machine manager to create a new one with protocol 'icloud', we have chosen the best setting for you so you do not need to do that
- Fill the 'Serial Number' (In the machine, go to 'System Info' → 'Device Info' to see the Serial Number)
- Hit button 'Upload Setting' to push setting into the machine
- From now on, your machine is ready to push data into the software
Supported Devices
Supports various models of ZKTeco machine.
Fully tested with the following devices:
- ZKTeco SENSEFACE 7A
- RONALD JACK B3-C
- ZKTeco K50
- ZKTeco MA300
- ZKTeco T4C
- ZKTeco G3
- RONALD JACK iClock260
- ZKTeco K14
- iFace702
- Uface 800 (worked with finger and face)
- ZKTeco K40
- ZKTeco K20
- ZKTeco U580
- ZKTeco F18
- ZKTeco F19
- iFace402/ID
- iFace800
- iClock3000
- iClock880-H
- iclock 700
- Ronald Jack T8
- Ronald jack 1000Plus
- ZKTeco MB20
- ZKteco IN0A-1
- Uface 800
- SpeedFace V5L
- Speedface H5L(P)
- VF680
- RSP10k1
- Uface 302
- ... (please advise us your machines. Tks!)
Devices reported working by customers:
- SpeedPalm-V5L
- SenseFace 7
- SenseFace 4
- SenseFace 3
- SenseFace 2A
- MB series
- F21
- F22
- SF400
- uFace series
- SilkBio series
- IN05 & IN05-A
- X628-C
- U300-C
- U260-C
- iClock680
- iClock360
- UA series
- WL series
- P series
- EFace10
- ... (Support devices with ADMS feature)
Watch Video Tutorial
Open the video introduction for ZKTeco biometric attendance integration odoo/Viindoo
Read User Guide
Explore Live Demo
Need a help for this module?
If you have questions, need any help, or have a customizations request, please contact us
Pre-Sales Question
- The module you are exploring: name and version
- Edition in use: CE, EE
- Your issue: trial, payment, installation, etc.
- Provide screenshots or videos, if available.
Support
- Your order number and attach a screenshot
- A description of the issue you're experiencing
- Your expectations for resolving the situation
- Include images or videos that replicate the issue
Technical requirements
Compatibility depends on firmware - protocol - distribution region. Test on a demo environment before rolling out to production.
Changelog
18.1.1.7 - compatibility and stability updates
- Improved TCP - UDP connection stability.
- Optimized sync for multiple attendance states.
- Updated guidance for the optional "iCloud" configuration.
Others info
Credit
Tons of thanks to Fananimi for his excellent pyzk library .
We took inspiration from it and extended it with additional features such as machine information, Python 3 support, and TCP/IP support, before integrating it into Odoo through this powerful Attendance Machine application.
Known Issues
To make this module work perfectly, your device must be accessible via the internet (if using an online platform like odoo.sh or a self-hosted instance).
Don't worry if the device is connected but still cannot download data, it could be one of following reason:
- Wrong device mode (we support mode call Time Attendance other mode like Access Control will not work)
- Lacking device configuration (by default some device will ignore the in/out checking stuff therefore we can not download your attendance data).
For troubleshooting, please contact us at https://viindoo.com/ticket/team/8 .
Who should use this
Companies with many devices
Operate multiple checkpoints and need centralized synchronization.
Large workforce
Lower manual workload, improve accuracy, stay payroll ready.
Compliance heavy environments
Require consistent, auditable attendance trails stored safely.
Cài đặt
- Truy cập Ứng dụng;
- Tìm từ khóa to_attendance_device;
- Bấm chọn Cài đặt.
Hướng dẫn sử dụng
Video hướng dẫn: Tích hợp Máy chấm công Sinh trắc học
Khái niệm
- Vị trí máy chấm công: là một model để lưu trữ vị trí nơi mà bạn lắp đặt máy chấm công bao gồm thông tin Tên vị trí và Múi giờ tại vị trí đặt máy chấm công (hỗ trợ việc ghi nhận dữ liệu vào/ra tại nhiều vị trí với múi giờ khác nhau).
- Trạng thái Vào/Ra: nơi để lưu trữ các trạng thái của hoạt động chấm công và có thể được định nghĩa bởi người dùng. Trạng thái có thể là Đăng nhập, Đăng xuất, Đăng nhập tăng ca, Đăng xuất tăng ca,... Truy cập Quản lý Vào/Ra ‣ Máy Chấm Công ‣ Trạng thái Vào/Ra để xem danh sách các trạng thái.
- Hoạt động Vào/Ra: nơi để phân loại các hoạt động chấm công vào/ra. Ví dụ: Làm việc bình thường, Tăng ca,... Truy cập Quản lý Vào/Ra ‣ Máy Chấm Công ‣ Hoạt động Vào/Ra để xem danh sách hoặc tạo mới các hoạt động.
- Người dùng thiết bị: nơi để lưu trữ thông tin về người dùng máy chấm công trên hệ thống và có liên kết những người dùng này với danh sách nhân viên trên phần mềm.
- Dữ liệu Vào/Ra: nơi để lưu trữ tất cả dữ liệu vào/ra được tải về từ máy chấm công. Nói cách khác, đây là cơ sở dữ liệu trung tâm của dữ liệu vào/ra của tất cả các máy chấm công. Các bản ghi này là cơ sở để tạo ra dữ liệu vào/ra của nhân viên. Trong quá trình tạo dữ liệu này, phần mềm sẽ kiểm tra tính hợp lệ của dữ liệu và đảm bảo dữ liệu vào/ra của nhân viên là đúng và hợp lệ.
- Quản lý Vào/Ra: dữ liệu Quản lý Vào/Ra được tạo tự động và định kỳ bằng hoạt động định kỳ Đồng bộ dữ liệu quản lý vào/ra, bao gồm các trường thông tin sau:
- Đăng nhập: thời gian đăng nhập;
- Đăng xuất: thời gian đăng xuất;
- Nhân viên: nhân viên liên quan;
- Thiết bị đăng nhập: máy chấm công ghi nhận dữ liệu đăng nhập;
- Thiết bị đăng xuất: máy chấm công ghi nhận dữ liệu đăng xuất.
- Máy chấm công: là menu lưu trữ thông tin của máy chấm công. Tại đây cung cấp khá nhiều tính năng hữu ích (xem thêm tại bài hướng dẫn sử dụng các tính năng trên giao diện Máy chấm công).
Tích hợp máy chấm công
Truy cập Máy chấm công > Quản lý Máy chấm công, ấn Tạo để khai báo thông tin máy chấm công.
Xem thêm bài viết về Tích hợp máy chấm công sinh trắc học vân tay của chúng tôi.
Liên kết người dùng máy chấm công với dữ liệu nhân viên trên phần mềm
Quản lý dữ liệu chấm công/điểm danh của nhân viên
Xem thêm tại bài viết về Theo dõi và quản lý dữ liệu vào/ra
Hệ thống có hành động tự động để:
- Tải Dữ liệu vào/ra từ máy chấm công về hệ thống Viindoo 30 phút 1 lần.
- Tải Dữ liệu vào/ra khi cho các Máy chấm công ở trạng thái Xác nhận.
- Tạo bản ghi về Dữ liệu vào/ra trong hệ thống Viindoo (Truy cập Quản lý Vào/Ra ‣ Máy Chấm Công ‣ Dữ liệu Vào/Ra).
- Tùy thuộc vào cài đặt tại máy chấm công, nó cũng có thể thực hiện các hoạt động sau:
- Tạo mới Nhân viên và liên kết với người dùng trong máy chấm công nếu người dùng này khai báo trên máy chấm công.
- Xóa dữ liệu vào/ra trên máy chấm công khi đến thời gian thiết lập.
- Đồng bộ dữ liệu quản lý vào/ra mỗi 30 phút 1 lần.
- Tìm các dữ liệu vào/ra hợp lệ từ dữ liệu tải về của máy chấm công.
- Tạo bản ghi chấm công hợp lệ cho nhân viên (Truy cập Quản lý Vào/Ra ‣ Quản lý Vào/Ra).
Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).
Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).
Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.
Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.