ZKTeco Device Integration
Connect fingerprint and face-recognition biometric devices to sync attendance data automatically.
Overview
AttendUX integrates with ZKTeco biometric devices so you can pull clock-in / clock-out records directly into your attendance dashboard — no manual entry needed.
Supported models include: ZK-UA400, ZK-MB460, ZK-UFace800, ZK-iClock, and compatible models using the ZK protocol.
Adding a Device
Navigate to ZKTeco Devices → "+ Add Device" and fill in the device connection details.
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| Device Name | Text | ✅ | A friendly label for the device. | Main Entrance — ZK-UA400 |
| IP Address | Text | ✅ | The device's local IP address on your network. | 192.168.1.201 |
| Port | Number | ✅ | Communication port (default is 4370). | 4370 |
| Device Model | Dropdown | ✅ | Select the model from the dropdown or enter it manually. | ZK-UA400 |
| Branch | Dropdown | ✅ | Which branch the device is located at. | Cairo HQ |
Syncing Attendance
Once a device is connected you can pull new attendance records on demand.
Open the Device
Click on the device row in the ZKTeco Devices list.
Click "Sync Now"
The system connects to the device, downloads new records, and maps them to employees.
Review Results
A summary shows how many records were imported and any unmatched entries.
Sync All Devices
Use the "Sync All" button at the top of the device list to pull records from every connected device in one click.
Desktop Sync Agent
For networks where the cloud server cannot reach devices directly, use the AttendUX Desktop Sync Agent.
The agent runs on a Windows PC on the same network as the ZKTeco devices. It reads clock records locally and pushes them to the cloud securely.
See the Sync Agent documentation for setup instructions.
Troubleshooting
Common issues and their solutions when working with ZKTeco devices:
| Issue | Possible Cause | Solution |
|---|---|---|
| Cannot connect to device | Wrong IP address or device is off. | Verify the IP from the device screen. Ensure it is powered on and on the same network. |
| No records after sync | Employee IDs on device don't match the system. | Map device user IDs to AttendUX employee IDs in the device settings. |
| Connection timeout | Firewall blocking port 4370. | Allow port 4370 (TCP) through the firewall or router. |
| Duplicate records | Manual sync after auto-sync already ran. | The system de-duplicates automatically. No action needed. |
| Device appears offline | Network cable disconnected or Wi-Fi lost. | Check physical connections and ping the device IP. |