Troubleshooting
Solutions for common issues you may encounter when using AttendUX.
Login Issues
Problems signing in to the dashboard or mobile app:
Use the "Forgot Password" link to reset your password. Passwords are case-sensitive. If the issue persists, ask your admin to reset it from the dashboard.
After 5 failed login attempts, the account is temporarily locked for 15 minutes. Wait and try again, or ask your admin to unlock it.
Make sure you're entering the correct company code (slug). It's case-sensitive. Contact your admin if you're unsure of the code.
Attendance Issues
Issues with check-in, check-out, and attendance records:
Ensure you are within the geofence area, your shift has started, GPS is enabled with high accuracy, and you haven't already checked in.
Check that your device time zone matches the company settings. The server records time based on the configured time zone, not the device clock.
If using ZKTeco devices, verify the Sync Agent is running and connected. For mobile, ensure you had internet connection at the time of check-in.
If you forgot to check out, the system auto-checks you out at the shift end time. Contact your admin to adjust the record if needed.
Face Recognition Issues
Problems with biometric face verification:
Ensure good lighting, remove sunglasses or masks, hold the phone at arm's length, and face the camera directly. If the problem persists, ask your admin to re-register your face photo.
Grant camera permission to the AttendUX app in your phone settings. Restart the app if the camera was being used by another application.
Location / GPS Issues
Problems with geofence and location detection:
Make sure you are physically within the designated work area. If you believe the geofence radius is too small, ask your admin to increase it in Branch Management.
Enable GPS on your device, set location mode to High Accuracy (Android) or allow precise location (iOS). Ensure the AttendUX app has location permission set to "Always" or "While Using".
ZKTeco Device Issues
Problems with biometric attendance devices:
Verify the device is powered on and on the same network. Check the IP address in the device settings. Try pinging the device from the computer running the Sync Agent.
Ensure the Sync Agent is running and the API key is valid. Check the Sync Agent logs for errors. Verify that employees are registered on the device with matching IDs.
Payroll Issues
Problems with salary calculations and payroll:
Verify the employee's base salary, deduction rules, and bonus settings. Check that all attendance records are present for the pay period. Re-generate the payroll after corrections.
Ensure the bonus/deduction was created within the correct date range and assigned to the right employee or department. Check that the payroll period covers the bonus date.
General Tips
If you're experiencing an issue not listed above, try these general steps:
• Clear your browser cache and cookies. • Try a different browser or incognito mode. • Check your internet connection. • Make sure you're using the latest app version. • Restart the application or device.