Submitting to IRAS via API

Send employment income records directly to IRAS from Officaid with a single click.

File with a single click

Once your tax submissions are ready and you've authenticated with CorpPass, sending them to IRAS takes just a few clicks. As a One-Stop Payroll vendor, Officaid connects directly to IRAS systems, transmitting your employment income records instantly and returning confirmation that your filing was received.

Before You Submit

Ensure everything is in order before transmitting to IRAS:

All submissions you want to file are in Draft status
You've reviewed each submission for accuracy
You're authenticated with CorpPass (the Submit To IRAS button is visible)
The correct Year of Assessment is selected in your filters

Once submitted, records cannot be edited. You'll need to file an Amendment or Revised submission to make corrections. Take time to verify everything before clicking submit.

Step-by-Step Guide

1 Navigate to Team → Tax from the main menu
2 Filter to show the Year of Assessment and Draft submissions you want to file
3 If not already authenticated, click Login With API and complete the CorpPass login
4 Use the checkboxes to select the submissions you want to send
5 Click Submit To IRAS
6 Review the confirmation prompt showing how many records will be submitted
7 Confirm to proceed with the submission

Officaid transmits your selected submissions to IRAS. The process typically completes within seconds. Once successful, the submissions update to Submitted status with the submission date recorded.

What Happens During Submission

When you click Submit To IRAS, Officaid packages your submission data and sends it to IRAS through their API. The transmission includes all the information from your tax submissions: employee details, income figures, and deductions.

IRAS validates the incoming data against their requirements. If everything passes validation, they accept the submission and return an acknowledgement. Officaid captures this acknowledgement and updates your records accordingly.

Successful Submissions

When a submission is accepted by IRAS:

The status changes from Draft to Submitted
The submission date is recorded on the record
The submission becomes read-only (no further edits)

You don't need to take any further action for successfully submitted records. IRAS has received the employment income information and will use it for tax assessment purposes.

Handling Errors

If IRAS rejects a submission, you'll see an error message indicating what went wrong. Common reasons for rejection include:

Missing required fields: Certain information is mandatory. Check that all required fields are populated in the submission.

Invalid data format: ID numbers, dates, or other fields may not match the expected format. Review the flagged fields and correct any formatting issues.

Duplicate submission: IRAS may reject a submission if it appears to duplicate an existing record. Consider whether you need an Amendment or Revised submission instead of an Original.

When a submission fails, it remains in Draft status. Review the error message, make the necessary corrections in Editing Tax Submission Details, and try submitting again.

Submitting in Batches

You can submit multiple records at once by selecting several submissions before clicking Submit To IRAS. This is efficient for annual filing when you need to process many employees.

Each submission is processed individually by IRAS. If some succeed and others fail, the successful ones will update to Submitted while the failed ones remain in Draft with their respective error messages.

For large batches, consider submitting in smaller groups. This makes it easier to identify and address any errors without searching through hundreds of records.

Frequently Asked Questions

How do I know the submission was received by IRAS?

Successfully submitted records show Submitted status with the submission date. This indicates IRAS acknowledged receipt of the data. You can also verify submissions through myTax Portal if you want independent confirmation.

Can I submit some employees now and others later?

Yes. Select only the employees you're ready to submit using the checkboxes. The remaining Draft submissions will stay in your list for future filing. There's no requirement to submit everyone at once.

What if I submitted incorrect information?

You'll need to file a correction. Generate a new tax submission for the affected employee, selecting either Amendment (to add/adjust) or Revised (to replace completely) as the Submission Type. See Original, Amendment, and Revised Submissions for guidance on which to use.

Is there a deadline for API submissions?

Employment income must be submitted to IRAS by 1 March each year for the preceding calendar year. The API follows the same deadline as manual submissions through myTax Portal. For the latest requirements, visit iras.gov.sg.

What's Next

After submitting your records, you may want to:

Tax Submission Statuses Explained - Understand the status lifecycle
Original, Amendment, and Revised Submissions - Learn how to make corrections if needed
Navigating the Tax Module - Review your submitted records

tax IRAS submission API