Common Zoho Payroll Errors and Resolutions:

14. This employee has been synced from Zoho People. To initiate the exit for them, please mark them as exited in Zoho People.

1. Update Employee Exit Details in Zoho People
   • Update Date of Exit (DOE) and Employee Status
   • Ensure DOE is not in a payroll-processed month
     
     
2. Perform Instant Sync
   • Navigate to:
     Settings → Zoho Apps → People → Instant Sync
   • Resolve any sync errors
     
     
3. Process Termination in Zoho Payroll
   • Go to Home → To-Do section
   • Complete termination before running the regular pay run

15. Employment Type: Value in the field does not match with the data type supported by us.

• Ensure values are case-sensitive and exact
• Avoid custom values or extra spaces
• Assign a default value and retry sync if needed

16. The Gratuity amount should show on pro-rata basis on monthly basis with Payroll sheet and need to create one column where employee’s accrual gratuity should show on monthly basis.

1. Create a Benefit component under Salary Components
2. Manually calculate monthly gratuity
3. Add it as Employer Contribution in employee profile

17. Enter a valid Routing Number/SWIFT Code.

• Check custom field validations under:
  Settings → Preferences → Employee
• Ensure routing number follows valid format

18. There is an Employee who got promoted with a salary increase from 10th June 2025. How do I update the same in Zoho People and Zoho Payroll so her salary is calculated accurately? Because in Payroll, it asks directly for Month of Salary revision and not date.

• Enable Date-based Salary Revision (Early Access)
• Share Org ID with support team for backend enablement

19. Employee has already been enrolled with xyxyxyxx@zzz.com.

1. Remove the email from Zoho Expense
2. Add the employee in Zoho Payroll
3. Perform sync to reflect across services

20. Invalid Salary Rate has been provided [error on importing Salary Revision].

• Ensure salary revision is based on Number
• Modify import file accordingly

21. You need to update your work locations if they are in free zones - Shown in Pending Tasks under Regular Payroll.

• Navigate to:
  Settings → Work Locations
• Select location → Enable “Mark as Free Zone”

22. This employee's email address is no longer available in the Zoho accounts. Hence, they cannot access their portal. Revoke the portal access and update the active email address.

• Revoke portal access in Zoho Payroll
• Update employee email
• Proceed with exit process if applicable

23. The PAN already exists. Ensure the PAN provided for each employee is unique.

• Remove PAN from exited/inactive employee profile
• Ensure PAN uniqueness across records

24. The system calculated Fixed Allowance cannot be less than zero. Check and enter valid salary details.

 

• Restructure salary components
• Ensure Fixed Allowance covers employer contributions

25. Email could not be updated as it is associated with another user:

1. Remove the email from User/Admin list
2. Update employee email
3. Re-add as User/Admin if required