HR Admin Training

Troubleshooting device sync issues

Fix biometric devices that stop sending punches to HelloHRMS.

Use this checklist when punches appear on the device but not in HelloHRMS attendance.

  1. Verify device is active in HelloHRMS
    Attendance → Devices → confirm device Is Active is checked and serial number matches the physical device exactly (no extra spaces).
  2. Check network connectivity
    Device must reach the internet. Ping gateway from device diagnostics if available. Corporate firewalls often block outbound HTTP — allow heyhrms.com on port 443.
  3. Validate server URL on device
    Path must be /hellohrms/iclock/cdata (or your actual subfolder). Wrong path returns 404 and device may silently retry.
  4. Confirm employee mapping
    Unmapped PINs are received but not linked. Map the user ID and test a fresh punch.
  5. Check device clock
    If device time is far off, punches may land on wrong dates. Sync NTP/timezone on the terminal.
  6. Review server logs
    Ask your administrator to check PHP error logs under hellohrms/storage/logs for iclock endpoint errors. Restart device after URL or firewall changes.