Troubleshooting

Solutions for common issues you may encounter when using AttendUX.

User Guide Troubleshooting

Login Issues

Problems signing in to the dashboard or mobile app:

Wrong Password

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.

Account Locked

After 5 failed login attempts, the account is temporarily locked for 15 minutes. Wait and try again, or ask your admin to unlock it.

Invalid Company Code

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:

Cannot Check In

Ensure you are within the geofence area, your shift has started, GPS is enabled with high accuracy, and you haven't already checked in.

Wrong Check-In Time Recorded

Check that your device time zone matches the company settings. The server records time based on the configured time zone, not the device clock.

Missing Attendance Record

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.

Automatic Checkout Happened

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:

Face Not Recognized

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.

Camera Not Opening

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:

Marked as Outside Geofence

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.

Location Not Being Detected

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:

Device Not Connecting

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.

Device Connected But Not Syncing

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:

Incorrect Salary Calculation

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.

Bonus or Deduction Not Applied

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.

Tip: Still need help? Contact our support team at support@attendux.com or through the in-app chat.