Introduction

The ZKTeco Biometric Integration is a Frappe application that bridges ZKTeco network-enabled biometric hardware with FrappeHR's attendance management system. It replaces manual punch-card entry by automatically pulling transaction logs from one or more ZKTeco devices, mapping those logs to employee records in FrappeHR, and creating Employee Check-in documents all on a configurable schedule.

Key capabilities at a glance:

• Automated, scheduled data pull from ZKTeco device REST APIs
• JWT-based authentication with automatic token renewal
• Support for multiple devices managed from a single settings interface
• Punch state translation (device states converted to FrappeHR IN/OUT log types)
• Duplicate detection to prevent double-counting of the same punch event
• Bidirectional user status control on the physical device, tied to check-in/check-out state in FrappeHR
• Full audit trail via Frappe's Error Log and Scheduled Job Log infrastructure