Taxpayer Validator Errors

Overview

This page lists all Taxpayer Validation (ERR) error codes that may be returned when a submitted document’s taxpayer details — such as Supplier or Buyer TIN, identity type, and General TIN classification — fail validation.

Each error includes the error code, a description of the error, possible causes, and the proposed solution to resolve it.

Note! Error codes and messages may be updated from time to time as new validation rules are introduced. Always refer to the latest version of this page for the most accurate list.

Error Codes

Error Code	Error Description	Possible Causes	Proposed Solution
ERR206	NRIC/ARMY mismatch or not exist in HITS	The supplied TIN exists in the tax system; however, the NRIC/ARMY number provided does not match the taxpayer profile associated with that TIN.	• Verify the NRIC/ARMY number against official records • Ensure the correct ID Type is selected • Search the taxpayer profile using MyTax Portal or Search TIN API
ERR208	General TIN (020) is not applicable for foreign supplier	The submission uses General TIN 020 for a foreign supplier. General TIN 020 is intended for buyers only and cannot be used to represent a foreign supplier.	• Verify whether the party is a supplier or buyer • For foreign suppliers, use General TIN 030 where General TIN usage is applicable
ERR211	General TIN (020) is not applicable for foreign supplier for consolidated invoice.	A consolidated invoice has been submitted using General TIN 020 for a foreign supplier. General TIN 020 is only valid for buyer scenarios and cannot be used for foreign suppliers, including consolidated invoice transactions.	• Review consolidated invoice setup and taxpayer classification • Ensure foreign suppliers use the appropriate General TIN.
ERR213	General TIN (010) is not applicable for foreign supplier	Foreign suppliers cannot be represented using General TIN 010. The supplied General TIN does not comply with foreign supplier requirements.	• For foreign suppliers, use General TIN 030 where applicable.
ERR217	Supplier’s details cannot be general TIN (010) for issuance of individual e-Invoice	In a self-billed transaction, supplier information contains General TIN 010 combined with an actual BRN, which is not permitted.	• Obtain the actual supplier TIN through Search TIN API and replace General TIN 010.
ERR220	General TIN (30) is only allowed for supplier field for self-billed scenario.	A self-billed e-Invoice contains a foreign supplier but the General TIN provided is not 030.	• For foreign suppliers in self-billed scenarios, use General TIN 030
ERR222	Only general TIN (010) is allowed for NRIC/ARMY.	The submitted General TIN and identity type combination is invalid. Only General TIN 010 is permitted for NRIC/ARMY scenarios.	• Replace the General TIN with 010 when NRIC or ARMY is used
ERR228	General TIN (010) is not allowed for NON-consolidated e-invoice	General TIN 010 is being used in a non-consolidated e-Invoice scenario where actual taxpayer information is required.	• Confirm whether the document is consolidated or non-consolidated. • For non-consolidated invoices, use the actual taxpayer TIN and resubmit.
ERR229	General TIN (030) is only allowed for foreign supplier	General TIN 030 is reserved exclusively for foreign suppliers. The submitted buyer information uses a supplier-specific General TIN.	• Verify whether the party is a buyer or supplier. • Use the appropriate General TIN or actual TIN
ERR236	Where General TIN (010) and ID Type BRN/NRIC = NA, applicable for Classification Code 004 only	The document uses General TIN 010 with ID Type BRN or NRIC set to “NA”. This combination is only permitted when the e-Invoice Classification Code is 004. Any other classification code will fail validation	• Verify whether Classification Code 004 is applicable to the transaction. • If Classification Code is not 004, provide the actual taxpayer identification information.
ERR237	Buyer’s details cannot be general TIN (010) for issuance of individual e-Invoice	The buyer information contains General TIN 010 together with an actual BRN. This combination is not permitted for individual e-Invoice issuance.	• Replace General TIN 010 with the actual taxpayer TIN obtained via Search TIN API. • If an actual BRN is provided, ensure the corresponding actual TIN is used.
ERR246	TIN and identity type combination is invalid.	The identity number exists, but the TIN provided is not associated with the supplied identity type in the taxpayer registry. The system cannot establish a valid relationship between the TIN and ID information.	• Validate the taxpayer TIN using Search TIN API • Confirm the identity type used in the request • Retrieve latest taxpayer details from MyTax Portal • Update submission with the correct TIN and identity type combination.
ERR401	Supplier TIN is invalid. Kindly use the Search TIN function to get the correct TIN	The supplier BRN is valid; however, the submitted Supplier TIN cannot be matched to any taxpayer record. The invalid TIN might be due to formatting or typo issue.	• Obtain the supplier latest TIN through Search TIN API or MyTax Portal • Ensure supplier BRN and TIN belong to the same taxpayer profile • Resubmit using validated information.
ERR406	Buyer TIN is invalid. Kindly use the Search TIN function to get the correct TIN	The buyer BRN is valid; however, no matching taxpayer TIN can be found for the supplied Buyer TIN. The supplied TIN is invalid or incorrectly formatted.	• Search for the buyer TIN using Search TIN API or MyTax Portal • Verify the BRN belongs to the intended taxpayer • Refer to the FAQ for valid TIN format
ERR255	General TIN (040) is applicable for BRN NA only	General TIN 040 can only be used when BRN value is NA. Any other BRN combination is invalid.	• If General TIN 040 is required, set BRN to NA. Otherwise, use the appropriate actual TIN and BRN combination.

Notes

Use the Search Taxpayer's TIN API to verify the correct TIN before submitting a document.