Refer to this section to resolve common IR8A errors.
Error:
LIN Grp 1 (LIN=1). RFF Grp 1. If ID Type(RFF AWM)=5 (i.e. Malaysian I/C) or 6 (i.e. Passport No), Employee's designation(NAD PE) must be DIRECTOR or Variations of DIRECTOR
Explanation:
The employee ID type is declared as either '5'(for Malaysian I/C) or '6'(for Passport No) in RFF AWM field, but the employee’s designation declared in NAD PE field position 50-79 does not contain the word 'DIRECTOR’. If the employee is not a director, please consult the employee for another type of ID he/she has, e.g. work permit, NRIC, or FIN No.
Error:
LIN Grp 1 (LIN=16). MOA Grp 1. Salary (MOA 776) Salary can not be negative or more than 9 digits
Explanation:
The value declared does not follow the acceptable format of the field. In this example, the salary declared is possibly negative, has decimals, or has more than 9 bytes in the Original text file. Salary cannot be negative in Original file, and it should only have 9 bytes without any decimals.
If the value you are declaring has decimals, but the acceptable format does not allow any decimals, please perform necessary rounding as follow:
a. If the value is of type income, i.e. what an employee receives, then please round the value down.
b. If the value is of type donation/contribution, i.e. what an employee gives out, then please round the value up.
Please refer to IRAS Interface File Specification for details on acceptable format of each field.
Error:
LIN Grp 1 (LIN=1). Length of Postal Code (refer to no. 11, segment type is NAD PE, position 587 - 592) must be 6 (all numeric).
Explanation:
The postal code either has incorrect format (has less than 6 digits or not all numeric) or declared at a wrong position in the text file. Postal code should be declared in NAD PE field position 587-592. Please ensure that postal code has 6 digits of numeric and declared at the right position.
Please also check that all of the NAD continuation lines have 255 bytes and CRLF. Shorter or longer continuation lines will cause the data to be shifted, wrongly positioned, and hence cannot be properly read by PAT system.
Refer to below guideline for declaring NAD segment.
Each line is 255 bytes long + Carriage Return. If the NAD segment details exceed 255 bytes, it should appear on the next line(s) as a continuation, i.e. NAD*, where * denotes a continuation.
For Payee Name Line 1, the Pos is 225-259.
Since the Payee Name Line 1 exceeds 255 bytes, the remaining 4 bytes of the Payee Name Line 1 will be written at Pos 6 of the 2nd NAD (i.e. NAD* starts at Pos 1).
To compute the exact position on the continuation line, use the following formula :
<Starting Pos> - (255 * n) + (5 * n), where n = refers to the number of continuation lines
2nd NAD (Example)
a. Pos 260-294 (Payee Name Line 2) shd be at Pos 10 of 2nd NAD (i.e. 260 - 255 + 5 = 10)
b. Pos 438-469 (Street Name) shd be at Pos 188 of 2nd NAD (i.e. 438 - 255 + 5 = 188)
3rd NAD (Example)
a. Pos 508-510 (Level No) shd be at Pos 8 of 3rd NAD (i.e 508 - (255 * 2) + (5*2) = 8 )
b. Pos 543-547 (Unit No) shd be at Pos 43 of 3rd NAD (i.e. 543 - (255 * 2) + (5*2) = 43)
c. Pos 587-592 (Postal Code) shd be at Pos 87 of 3rd NAD ( i.e 587 - (255*2)+(5*2) = 87)
Error:
LIN Grp 1 (LIN=1). NAD Grp 1. Invalid Entry in Country, error is 345
Explanation:
The country code declared in invalid or not defined.
The error can also be caused by data shifting in NAD PE segment due to improper declaration of NAD PE segment. For example, the data is right-shifted by 3 characters, so that the last three digits of postal code are read as the country code. Please refer to IR8A Error 3 for details.
The list of common country code used is provided below. Please see the complete list of country codes in Annex A of IRAS Interface File Specification.
303=Indonesia
304=Malaysia
305=Philippines
306=Thailand
331=Japan
334=Taiwan
336=China
110=United Kingdom
503=United States of America
701=Australia
705=New Zealand
999=Others
Error:
LIN Grp 1 (LIN=1). If Unformatted address is given and country code is entered, the Address Type indicator (refer to no: 9, segment type is RFF, qualifier is AWB, position 9 -11) should be F
Explanation:
The address type indicated in RFF AWB field does not match to the address data provided in NAD PE segment. In this example, unformatted address and country code are declared in the text file, but the address type is not 'F'(for Foreign Address)
Please refer to validation rule of address type below.
a. If address type is L (for Local Address), Block/House No, Street Name, and Postal code fields (segment type NAD PE, position 403 - 412, 438 - 469, 587 - 592) cannot be blank. Level No and Unit No are optional. However, if Unit No is declared, then Level No must be declared, and vice-versa.
b. If address type is F (for Foreign Address), unformatted address and country code (segment type NAD PE, position 120 - 219, 593 - 595) cannot be blank.
c. If address type is C (for C/O Address), unformatted address and postal code (segment type NAD PE, position 120 - 219, 587 - 592) cannot be blank
d. If address type is N (for No Address), unformatted address, block/house no, street name, level no, unit no, postal code, and country code address (segment type NAD PE, position 120 - 219 and 403-595) must all be blank.
The error can also be caused by data shifting in NAD PE segment due to improper declaration of NAD PE segment. For example, the data is right-shifted by 3 characters, so that the last three digits of postal code are read as the country code. Please refer to IR8A Error 3 for details.
Error:
LIN Grp 1 (LIN=1).If Unit No is entered, Level No (refer to no: 10, segment type is NAD PE, position 508-510) cannot be blank.
Explanation:
Exactly one of Unit No or Level No is declared, but not both. Level No and Unit No are optional. However, if Unit No is declared, then Level No must be declared, and vice-versa. Thus, they should be both blank or both declared.
Error:
LIN Grp 1 (LIN=5) CPF/Designated Pension/Fund amt (MOA 368) not equal to zero then Name of designated pension (FTX AEW) cant not blank.
Explanation:
A value not equal to 0 is declared in "CPF/designated pension/fund" field (MOA 368) of the text file, but the " Name of designated pension/fund to which employee made contribution" field (FTX AEW) is blank. If the "CPF/designated pension/fund" amount is declared, the "Name of designated pension/fund to which employee made contribution" field cannot be blank. If the amount corresponds to CPF contribution, the user can declare "CPF", "Central Provident Fund", or its variation as the name.