HelloHRMS accepts attendance punches from compatible biometric terminals using the industry-standard ADMS / iClock push protocol. Supported brands: ZKTeco, eSSL (ZK-compatible firmware), and RealTime.
How it works
- You register the device in HelloHRMS (serial number + brand).
- The device pushes attendance logs to your server over HTTP/HTTPS.
- HelloHRMS maps the device user ID (PIN) to an employee and writes attendance records.
Server endpoint
Devices should point to: https://your-domain.com/hellohrms/iclock/cdata (adjust if your install path differs). Use port 80 or 443 depending on your SSL setup.
-
Gather device information
On each terminal open Menu → System → Device Info and note the Serial Number (SN). Ensure the device has internet access (Ethernet or Wi-Fi).
-
Allow outbound traffic
Devices initiate outbound connections — open firewall rules so the terminal can reach your HelloHRMS domain on port 80 or 443. No inbound port forwarding to the device is required.
-
Register in HelloHRMS
HR Admin → Resources → Attendance → Devices tab → Add Device. Enter brand, serial number, display name, and location. Copy the connection URL shown on screen.
-
Configure ADMS on the device
On the device, open Cloud Server / ADMS settings. Paste your HelloHRMS server address and path (/hellohrms/iclock/cdata). Set push interval to 30–60 seconds. Save and reboot if prompted.
-
Map employees to device PINs
Each enrolled user on the device has a User ID / PIN. In HelloHRMS Devices tab, map each PIN to the correct employee. Unmapped punches are stored but will not appear on attendance until mapped.
-
Verify first punch
Have a test employee punch in. Within one push interval, check Attendance matrix for today's clock-in. If missing, see Troubleshooting device sync issues in this Knowledge Base.