Note: This is an add-on module for Perfex CRM. It is not a standalone script and requires Perfex CRM to function.

Hardware Compatibility Note: This module is specifically designed for ZKTeco biometric hardware devices that support ADMS / Push Mode communication. It acts as a secure HTTP receiver endpoint for your biometric hardware to push real-time punch logs directly into Perfex CRM.

Overview

The ZKTeco Biometric Attendance Module for Perfex CRM seamlessly connects your physical biometric devices with Perfex CRM via ADMS push mode for automated real-time attendance logging, staff mapping, and performance metrics.

Designed as a plug-and-play add-on utilizing ADMS push mode, this module eliminates manual record-keeping by automatically synchronizing device punches, detecting late arrivals, early exits, half-days, and calculating working hours variance (+/-). Administrators can monitor daily logs, generate advanced date-filtered reports, and manage shift configurations directly within the CRM interface while maintaining high system performance and reliability.

Demo

Admin Login: https://perfex.codeonstring.com/admin
Email: [email protected]
Password: 123456789

How to Use

Configure your ZKTeco device’s ADMS / Push Server setting to point to your CRM endpoint (https://yourdomain.com/biometric_attendance/api/cdata). Link device User PINs to CRM staff members under Biometric Attendance > Staff Mapping. Incoming punches will automatically calculate check-ins, check-outs, status badges, and working hour variances across both the live Dashboard and Advanced Reports.

Features

• Seamless integration with Perfex CRM (v3.1.0 and above)
• Real-time ADMS Push Mode HTTP endpoint integration for ZKTeco biometric hardware
• Dedicated Staff Mapping interface to map device User PINs directly to CRM staff profiles
• Automated daily consolidated logs tracking first check-in and last check-out times
• Smart late entry detection with configurable grace period thresholds
• Automated early exit detection with configurable grace period tolerances
• Automatic half-day status detection when worked hours fall below 50% of shift expectations
• Dynamic Working Hours Variance (+/-) tracking for overtime and hour shortages
• Full active staff listing with automatic absent detection for missing daily check-ins
• Real-time Dashboard showing today’s workforce activity
• Advanced Attendance Reports with date range filtering, staff and status filters
• Quick installation and setup – no coding knowledge required
• No core file modifications – fully modular and update-safe

What’s Included

• ZKTeco Biometric Attendance Module
• Documentation
• Free lifetime updates and 6 months support

Requirements

• Perfex CRM version 3.1.0 or higher
• ZKTeco Biometric hardware device supporting ADMS / Push Mode

Documentation

For detailed instructions on installation, endpoint setup, and device configuration, please refer to the online documentation at: https://perfex.codeonstring.com/biometric-attendance-documentation

Support

Comprehensive documentation is included. For further assistance, feel free to reach out to us at [email protected]

Change Log

Version 1.0.0
    - Initial Release