ZKTeco is Pakistan's dominant biometric attendance brand. Walk into almost any corporate office, factory, or school in Lahore, Karachi, or Islamabad, and you will almost certainly find a ZKTeco fingerprint scanner or face recognition terminal at the entrance. These devices are reliable and affordable — but getting them to talk to your HR software automatically is where most companies struggle. This guide explains exactly how ZKTeco's ADMS (Attendance Data Management System) protocol works and how to set up a real-time integration with your HR system.
What Is the ZKTeco ADMS Protocol?
ADMS (Attendance Data Management System) is ZKTeco's built-in cloud push protocol. Instead of your HR software polling the device or requiring a local network connection, ADMS turns the device into an active sender: when an employee punches in or out, the device instantly pushes that attendance event to a web server via HTTP/HTTPS. This means attendance records appear in your HR software in real time — no manual exports, no USB data transfers, no local network headaches.
- ✓Works over the internet — no VPN or local network required
- ✓Attendance events pushed in real time (typically within 1-3 seconds)
- ✓Supported by most ZKTeco models released after 2018
- ✓Secure: supports HTTPS push with authentication token
- ✓Compatible with all ADMS-supporting HR platforms including Peoplifi
Step-by-Step ZKTeco ADMS Setup
Step 1: Connect the Device to Your Network
Plug the ZKTeco device into your router via an Ethernet cable or connect it to your Wi-Fi network using the device's built-in Wi-Fi settings. Confirm that the device has a valid IP address and can reach the internet. On the device, go to Menu → Comm → Ethernet (or Wi-Fi) and note the IP address assigned. Test internet connectivity by going to Menu → Comm → Cloud Server → Test — the device should report a successful connection.
- ✓For wired: use Cat5e/Cat6 Ethernet cable to router/switch
- ✓For Wi-Fi: Menu → Comm → Wi-Fi → enter SSID and password
- ✓Verify IP address and ensure it's on the correct subnet
- ✓Check that firewall rules allow outbound HTTPS (port 443) from the device
Step 2: Configure ADMS Cloud Server Settings on the Device
On the ZKTeco device, navigate to Menu → Comm → Cloud Server (may be labelled ADMS or Attendance Cloud on some models). Enter the server address provided by your HR software vendor — this will look like att.yourhrplatform.com or a specific IP with port. Enable ADMS, set the protocol to HTTPS, and enter your company authentication token if required. Save the settings. The device will immediately attempt to connect to the server.
- ✓Menu → Comm → Cloud Server → Enable ADMS: Yes
- ✓Server Address: enter the URL provided by your HR software
- ✓Port: typically 443 for HTTPS
- ✓Company/Auth Token: enter the unique token from your HR software settings
- ✓Save and allow device to restart if prompted
Step 3: Register Employees on the Device
Employees must be enrolled on the device so the biometric template (fingerprint or face scan) is linked to their employee ID. On the device, go to Menu → User Management → Add User. Enter the employee ID that matches the ID in your HR software exactly — this is the critical link between the physical device and the HR record. Enroll the fingerprint (recommended: enroll 2-3 fingers for redundancy) or face scan. Once saved, the employee's attendance punches will carry their employee ID, allowing the HR system to correctly attribute the attendance record.
- ✓Employee ID on device must exactly match employee ID in HR software
- ✓Enroll at least 2 fingerprints per employee for reliability
- ✓Face + fingerprint dual-mode enrollment recommended for sensitive environments
- ✓Department codes can be assigned for multi-location setups
- ✓Bulk enrollment via USB from HR software saves time for large teams
Step 4: Verify Real-Time Sync in Your HR Software
After enrolling employees and saving ADMS settings, have a test employee punch in on the device. Within 1-5 seconds, check your HR software's attendance log. You should see the punch event appear with the employee ID, timestamp, and device identifier. If no data appears, check the connection status in the HR software's device management panel — it will show whether the device is connected, last sync time, and any error messages.
Troubleshooting Common ZKTeco ADMS Issues
The most common integration problems are straightforward to diagnose once you know what to look for.
- ✓Device shows 'Disconnected': Check internet connectivity, verify server URL has no typos, confirm port 443 is open outbound
- ✓Punches appear but under wrong employee: Employee ID on device does not match HR software — re-enroll with correct ID
- ✓Intermittent sync: Device IP may have changed (use DHCP reservation in router to assign static IP)
- ✓No data after power cut: Device may need ADMS re-enabled after firmware reset — re-enter server settings
- ✓SSL errors: Ensure server has a valid SSL certificate; some older devices do not support TLS 1.3
- ✓Time mismatch: Sync device clock via NTP server (Menu → System → Date/Time → NTP sync)
Benefits of Biometric Integration: ROI and Buddy-Punching Prevention
The business case for biometric integration goes beyond convenience. Companies that integrate ZKTeco with their HR software typically see measurable ROI within the first payroll cycle.
- ✓Eliminates buddy punching: Only the enrolled employee's finger/face can register attendance
- ✓Eliminates manual attendance entry: Saves 2-4 hours per pay period for HR teams
- ✓Precise overtime calculation: To-the-minute punch data enables accurate overtime and late deductions
- ✓Audit trail: Every punch is timestamped with device ID — fully auditable for labor disputes
- ✓Remote device management: HR software can set attendance policies, push employee updates, and pull reports without visiting the device
- ✓Typical payroll accuracy improvement: 15-25% reduction in payroll errors from attendance disputes
How Peoplifi Integrates with ZKTeco in Minutes
Peoplifi supports ZKTeco ADMS integration out of the box. In the Devices section of your Peoplifi dashboard, click Add Device, select ZKTeco ADMS, and the system generates a unique server URL and authentication token for your company. Enter these on the device, and attendance data starts flowing immediately. Employee sync is bidirectional: add a new employee in Peoplifi and push their enrollment to the device remotely — no physical access to the device required. Peoplifi supports unlimited ZKTeco devices per account, making it ideal for businesses with multiple offices or factory floors across different cities.
Ready to automate your HR?
Peoplifi handles FBR Section 149, EOBI, biometric attendance, and payroll automatically — so your team can focus on people, not spreadsheets.
Start your free 7-day trial →