Contents of this article are applicable to the following users
Product: Payroll
Platform: Web
Access Level: Owner
This help article covers how to resolve common IR8A submission errors. If there are any errors that are not covered in this article, please reach out to us via the help chat.
Creating IR8A Submission
Error: "Duplicate ID numbers within selected staff. [ID number]"
A: This means that among the staff who are selected for IR8A submission, there are staff with the same identity number.
To check affected staff, download mass edit staff details and search for the identity number shown in the error message
Update the affected staff's identity number on StaffAny
Create IR8A submission again
Validating / Submitting to IRAS
Error: “Failed to retrieve IR8A access token. Try to validate or submit again.”
A: This means there's an issue when you login to IRAS. You can try again by clicking on the Validate IR8A button. If the issue persists, please contact Singpass Helpdesk directly.
After Validating or Submitting to IRAS
You will see the yellow error box when there are any validation errors. Click on View to view and resolve the errors
Gross Commission
Error: Gross Commission Period From - Must be given as YYYYMMDD which falls within basis year and cannot be later than To Date.
A: Gross commission period must be filled for the staff must be filled if there are pay items with the "Gross Commission" IR8A code.
Go to section (d) 2. to fill up the start and end dates
At the same time, fill up the gross commission indicator. This field must be filled if gross commission period is filled
Error: Gross Commission Indicator - Must be O, M or B.
A: Gross commission indicator must be filled if gross commission period is filled.
O = Adhoc on StaffAny
M = Monthly on StaffAny
B = Both on StaffAny
FAQ
A staff has no join date and it caused an error during IR8A submission. After fixing the staff profile, do I need to delete and redo the submission?
No. Once you have updated the staff profile with the correct join date and citizenship/nationality, the submission will be auto-updated. You do not need to delete and resubmit. If the Edit button is greyed out, check that the staff's citizenship/nationality field is also filled in.
I have already submitted IR8A but missed out one staff. Can I add that staff to the existing submission?
No. A missed staff cannot be added to an existing submission. Instead, create a separate new IR8A submission for that one staff only and submit it. As per IRAS guidelines, a new submission for the missed staff will be accepted alongside the original.