Technical File Format/Specifications

Payroll software vendors or employers who are using payroll system/ software can refer to the AIS file format/ specifications to ensure that their software can create and generate files and/ or API that comply with IRAS’ requirements.

File Format/ Specifications for YA 2019 Submission

Payroll software vendors or employers who are using payroll system/ software can refer to the following Year of Assessment (YA) 2019 file format/ specifications.

 S/NType of File Format Description 
1AIS Application Programming Interface (API) Service Specifications
2Text File Format (.txt)
3

Extensible Markup Language Format (.xml)

4Supporting Specifications/ Important Notes

Changes from YA 2019 onwards

The changes to TXT file formats with effect from YA 2019 are summarised below. Please update your payroll software to reflect the new field names where applicable.

S/NField NameFile FormatChange(s)
1

Telephone number

IR8A/ IR8S/ Appendix 8A/ Appendix 8B (Header)

Cannot be blank if supporting API Service

2Email address of authorised person

IR8A/ IR8S/ Appendix 8A/ Appendix 8B (Header)

Cannot be blank if supporting API Service

3

Actual Hotel accommodation/ Serviced Apartment within hotel building

Appendix 8A (Detail)

TXT format only

Change field name to:

Actual cost of Hotel accommodation/ Serviced Apartment within hotel building
4Non-monetary awards/ benefits e.g. non-cash gift or long service award exceeding $200

Appendix 8A (Detail)

TXT format only 

Corresponds to Item 4j in hardcopy form

Change field name to:
Other non-monetary awards/ benefits which do not fall within the above items

5Entrance/ transfer fees and annual subscription to social or recreational clubsAppendix 8A (Detail)  

Corresponds to Item 4f in hardcopy form

6Gains from assets, e.g. vehicles, property, etc. sold to employees at a price lower than open market value

Appendix 8A (Detail)

Corresponds to Item 4g in hardcopy form

7

Full cost of motor vehicles given to employees

Appendix 8A (Detail)

Corresponds to Item 4h in hardcopy form

8Car benefitsAppendix 8A (Detail)

Corresponds to Item 4i in hardcopy form

 

Email us at data_mgmt@iras.gov.sg if you have any enquiries on the Technical File Format/ Specifications.

RATE THIS PAGE

  • Strongly Disagree
  • Strongly Agree

Information is easy to understand.

Information is useful.

Information is easy to find.

 
Please email us if you would like us to respond to your enquiries.