Device Communication
SyncID communicates with ZKTeco devices over your local network to manage employees, collect attendance records, and monitor device health. This page describes the operations SyncID can perform and how connectivity works.
Connection
Section titled “Connection”SyncID connects to each device over TCP on port 4370 (configurable per device). The connection is always initiated by SyncID — devices do not need to reach the SyncID server.
When you add a device in SyncID, it immediately attempts to establish a connection. If the device is reachable and responds, it is marked as Online.
Supported operations
Section titled “Supported operations”Employee management
Section titled “Employee management”| Operation | Description |
|---|---|
| Read employees | Retrieves the list of employees currently enrolled on a device |
| Enroll employee | Pushes an employee (name, ID, card number, biometric data) to a device |
| Update employee | Modifies an existing employee’s data on the device |
| Remove employee | Deletes an employee from the device |
Attendance records
Section titled “Attendance records”| Operation | Description |
|---|---|
| Collect records | Downloads attendance punch records from a device |
| Clear records | Removes collected records from the device to free storage |
| Real-time monitoring | Receives punch events as they happen via a live connection |
Biometric data
Section titled “Biometric data”| Operation | Description |
|---|---|
| Fingerprint enrollment | Initiates fingerprint capture directly on the device |
| Transfer templates | Copies fingerprint and face templates between SyncID and devices |
Device management
Section titled “Device management”| Operation | Description |
|---|---|
| Read device info | Retrieves serial number, firmware version, and capacity details |
| Sync time | Corrects the device clock to match the server time |
| Restart device | Sends a remote restart command |
| Power off device | Sends a remote shutdown command |
Punch modes
Section titled “Punch modes”Devices record each attendance event with a verify method and a direction:
Authentication methods
Section titled “Authentication methods”| Method | Description |
|---|---|
| Fingerprint | Employee verified via fingerprint sensor |
| Face | Employee verified via infrared face recognition |
| RFID Card | Employee verified via proximity card |
| PIN | Employee verified via numeric code |
Punch directions
Section titled “Punch directions”| Direction | Meaning |
|---|---|
| Check-In | Start of work |
| Check-Out | End of work |
| Break-Out | Start of break |
| Break-In | End of break |
| OT-In | Start of overtime |
| OT-Out | End of overtime |
Real-time vs polling
Section titled “Real-time vs polling”SyncID supports two methods for collecting attendance records:
- Real-time monitoring — SyncID maintains a persistent connection to the device and receives events instantly as employees punch in or out. Best for environments with stable network connectivity.
- Polling — SyncID periodically connects to the device, downloads new records, and disconnects. More tolerant of intermittent network issues.
Both methods can be used simultaneously for different devices.
Related
Section titled “Related”- Supported models — device compatibility and specifications
- Adding devices — how to register and configure devices