Phase 2 Errors and Resolutions

​
List of common E-invoice generation error messages, their cause and resolutions.
Serial No.
Error Sourc
Error Message
Error Cause
Resolution
1
Cleartax
Supply date can not be after end date. Please correct supply/end date.
The supply end date is later than the supply date.
Check the supply date & end date.
2
Cleartax
Street name in address is mandatory for seller. Please supply street name.
Street name is not provided in seller details.
Check the invoice details & provide seller street name details.
3
Cleartax
A Device ID already exist with same VAT and EGS serial number.
Serial & EGS number used is present in the system. 
Check & Use Serial & EGS number which doesn't match with the already existing once.
4
Cleartax
Billing reference is mandatory if invoice type is Credit/Debit note. Please supply billing reference.
Billing reference ID is not provided.
Provide reference to original invoice number.
5
Cleartax
Building number is mandatory for buyer if Country code is SA. Please supply building number.
Building number is not provided.
Provide building number.
6
Cleartax
Buyer country code must be SA if invoice transaction type is other than export.
If the invoice type is not export then country code must be SA.
Check & provide country as SA if the invoice is not an export invoice.
7
Cleartax
Debit and credit note must contain the reason for this invoice type issuance. Please supply issuance reason for CREDIT/DEBIT note.
Reason of issuance of credit/Debit note is not provided.
Provide the reason for issuance of credit/debit note.
8
Cleartax
For the given country code 'SA’ the buyer postal code should be 5 digits long. Please correct postal code.
Buyer postal should be 5 digits long.
Check to see if the postal code is provided and is 5 digit long when the country code is SA.
9
Cleartax
Group VAT number or buyer VAT number must be provided, both fields can not be empty . Please supply Vat Number.
VAT or group VAT is not provided. 
Provide either VAT or Group VAT if the invoice is an standard invoice.
10
Cleartax
If it is an export invoice, the buyer VAT registration number and the buyer group VAT registration number must not exist in the invoice.
For export invoices , Buyer VAT or Group VAT must not exist on the invoices.
Check & remove the buyer VAT or group VAT if it exist on the invoice.
11
Cleartax
Incorrect vat Exemption reason code for provided vat category code. Please correct values.
Provided Exemption reason code is incorrect for the Vat Category Code.
Provide the exemption reason code which are acceptable as per ZATCA.
12
Cleartax
Invalid amount specified for *****, please correct the amount. 
Calculated amount is not correct.
Check the calculation & provide the Value.
13
Cleartax
Invalid Currency Code for ******, currency code must be same as document currency code.
Check the currency ID, it should match with document currency.
Provided currency ID in the **** field should match with document currency.
14
Cleartax
Line amount inclusive vat for line ***** is not correct. Please correct.
Line amount inclusive is not correct.
Check if line amount inclusive of VAT is equal to Invoice line net Amount + VAT line amount.
15
Cleartax
Recipient vat Number must have 15 digits. The first and the last digits must be “3”. Please supply correct Vat Number.
Recipient VAT number is not correct.
Recipient group group vat Number must have 15 digits. The first and the last digits must be “3”, the eleventh digit must be “1” in case of Group VAT.
16
ZATCA
VAT line amount for line is not correct. Please correct.
Calculated VAT line amount is not correct.
Check if Invoice line net amount * Invoiced item VAT rate= VAT Line Amount or not. 
17
ZATCA
Unable to execute Business Rules validation.
Some of the mandatory field is missing in the request body.
Check if all the mandatory fields are present in the request. 
18
ZATCA
Each VAT breakdown (BG-23) shall have a VAT category tax amount (BT-117).
VAT tax amount should be provided for each category code.
Check to see if VAT category tax amount is provided for the relevant category provided in the request.
19
ZATCA
Each VAT breakdown (BG-23) shall have a VAT category taxable amount (BT-116).
VAT taxable amount should be provided for each category code.
Check to see if VAT category taxable amount is provided for the relevant category provided in the request.
20
ZATCA
Schema validation failed; XML does not comply with UBL 2.1 standards in line with ZATCA specifications.
XML validation doesn't comply with ZATCA standards.
One or more mandatory tags is missing in the request payload.
21
ZATCA
The buyer name (BT-44) must be present in the tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2.
Buyer name is not present in the tax invoice.
Provide the buyer name in the tax invoice.
22
ZATCA
The VAT category tax amount (BT-117) In a VAT breakdown (BG-23) where the VAT category code (BT-118) equals "Exempt from VAT" shall equal 0 (zero).
Where VAT category code is exempt from tax and VAT tax amount is not Zero.
Where VAT category code is exempt from tax check whether VAT tax amount is Zero or not.

Serial No.	Error Sourc	Error Message	Error Cause	Resolution
1	Cleartax	Supply date can not be after end date. Please correct supply/end date.	The supply end date is later than the supply date.	Check the supply date & end date.
2	Cleartax	Street name in address is mandatory for seller. Please supply street name.	Street name is not provided in seller details.	Check the invoice details & provide seller street name details.
3	Cleartax	A Device ID already exist with same VAT and EGS serial number.	Serial & EGS number used is present in the system.	Check & Use Serial & EGS number which doesn't match with the already existing once.
4	Cleartax	Billing reference is mandatory if invoice type is Credit/Debit note. Please supply billing reference.	Billing reference ID is not provided.	Provide reference to original invoice number.
5	Cleartax	Building number is mandatory for buyer if Country code is SA. Please supply building number.	Building number is not provided.	Provide building number.
6	Cleartax	Buyer country code must be SA if invoice transaction type is other than export.	If the invoice type is not export then country code must be SA.	Check & provide country as SA if the invoice is not an export invoice.
7	Cleartax	Debit and credit note must contain the reason for this invoice type issuance. Please supply issuance reason for CREDIT/DEBIT note.	Reason of issuance of credit/Debit note is not provided.	Provide the reason for issuance of credit/debit note.
8	Cleartax	For the given country code 'SA’ the buyer postal code should be 5 digits long. Please correct postal code.	Buyer postal should be 5 digits long.	Check to see if the postal code is provided and is 5 digit long when the country code is SA.
9	Cleartax	Group VAT number or buyer VAT number must be provided, both fields can not be empty . Please supply Vat Number.	VAT or group VAT is not provided.	Provide either VAT or Group VAT if the invoice is an standard invoice.
10	Cleartax	If it is an export invoice, the buyer VAT registration number and the buyer group VAT registration number must not exist in the invoice.	For export invoices , Buyer VAT or Group VAT must not exist on the invoices.	Check & remove the buyer VAT or group VAT if it exist on the invoice.
11	Cleartax	Incorrect vat Exemption reason code for provided vat category code. Please correct values.	Provided Exemption reason code is incorrect for the Vat Category Code.	Provide the exemption reason code which are acceptable as per ZATCA.
12	Cleartax	Invalid amount specified for *****, please correct the amount.	Calculated amount is not correct.	Check the calculation & provide the Value.
13	Cleartax	Invalid Currency Code for ******, currency code must be same as document currency code.	Check the currency ID, it should match with document currency.	Provided currency ID in the **** field should match with document currency.
14	Cleartax	Line amount inclusive vat for line ***** is not correct. Please correct.	Line amount inclusive is not correct.	Check if line amount inclusive of VAT is equal to Invoice line net Amount + VAT line amount.
15	Cleartax	Recipient vat Number must have 15 digits. The first and the last digits must be “3”. Please supply correct Vat Number.	Recipient VAT number is not correct.	Recipient group group vat Number must have 15 digits. The first and the last digits must be “3”, the eleventh digit must be “1” in case of Group VAT.
16	ZATCA	VAT line amount for line is not correct. Please correct.	Calculated VAT line amount is not correct.	Check if Invoice line net amount * Invoiced item VAT rate= VAT Line Amount or not.
17	ZATCA	Unable to execute Business Rules validation.	Some of the mandatory field is missing in the request body.	Check if all the mandatory fields are present in the request.
18	ZATCA	Each VAT breakdown (BG-23) shall have a VAT category tax amount (BT-117).	VAT tax amount should be provided for each category code.	Check to see if VAT category tax amount is provided for the relevant category provided in the request.
19	ZATCA	Each VAT breakdown (BG-23) shall have a VAT category taxable amount (BT-116).	VAT taxable amount should be provided for each category code.	Check to see if VAT category taxable amount is provided for the relevant category provided in the request.
20	ZATCA	Schema validation failed; XML does not comply with UBL 2.1 standards in line with ZATCA specifications.	XML validation doesn't comply with ZATCA standards.	One or more mandatory tags is missing in the request payload.
21	ZATCA	The buyer name (BT-44) must be present in the tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2.	Buyer name is not present in the tax invoice.	Provide the buyer name in the tax invoice.
22	ZATCA	The VAT category tax amount (BT-117) In a VAT breakdown (BG-23) where the VAT category code (BT-118) equals "Exempt from VAT" shall equal 0 (zero).	Where VAT category code is exempt from tax and VAT tax amount is not Zero.	Where VAT category code is exempt from tax check whether VAT tax amount is Zero or not.

Phase 1 Errors and Resolutions

ZAKAT - FAQ - Phase I

Last modified 6mo ago