Phase 1 Errors and Resolutions
Frequent Errors and their resolution for Einvoicing.
Sl. No  Error Message  Solution 

1  Address additional number must be 4 digit long. Please correct address additional number.  Please note, Additional number has been made mandatory, if the Buyer is (a) Registered VAT Dealer and (b) within Kingdom of Saudi Arabia. Additional Number should be 4 digit only. In case the Additional number is not readily available then same can be found on National Address Certificate 
2  Billing reference is mandatory if invoice type is Credit/Debit note. Please supply billing reference.  Billing Reference ID means 'Original Invoice Number'. Original invoice number is required to be mandatory provided in where document issued by the Supplier is either (a) Credit Note, or (b) Debit Note 
3  Building number is mandatory for buyer if Country code is SA. Please supply building number.  Please note, Building number has been made mandatory, if the Buyer is (a) Registered VAT Dealer and (b) within Kingdom of Saudi Arabia. Building Number should be 4 digit only. In case the building number is not readily available then same can be found on National Address Certificate 
4  Debit and credit note must contain the reason for this invoice type issuance. Please supply issuance reason for CREDIT/DEBIT note.  Reason is required to be provided in case of Debit and Credit Notes are issued which is as per Article 40 (paragraph 1) of KSA VAT regulations, Instances where a Credit and Debit Note is issued :
Condition  (a) This is required in case Invoice type Code is Debit Note or Credit Note. (b) Not required to be priovided if Invoice type Code is Tax Invoice 
5  Invalid amount specified for sum of invoice line amount, please correct the amount.  For calculation of Sum of Invoice Line net Amount, check the formula as below. Calculated by sum of all Invoice line net amounts in the Invoice without VAT Sum of Invoice line net amount = Σ Invoice line net amount. Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
6  Invalid amount specified for total amount due, please correct the amount.  For calculation of Payable Amount, check the formula Amount due for payment = Invoice total amount with VAT  Paid amount 
7  Invalid amount specified for total amount without VAT, please correct the amount.  Total Amount without VAT should be equal to Total Amount exclusive of VAT Amount.and the amount should be upto 2 decimal places 
8  Invalid amount specified for total VAT amount, please correct the amount.  This issue is being observed in cases where VAT Amount is not correctly calculated. If the VAT rate is 15%, in those cases, VAT Amount should be equal to Taxable Amount X VAT Rate /100. Any deviation from the above values would result in the error 
9  Invalid amount value, amount value must be positive for allowance charge base amount.  All Values in the document should be positive. Negative values are not being accepted by the ZATCA 
10  Invalid amount value, amount value must be positive for Invoice line VAT total.  All Values in the document should be positive. Negative values are not being accepted by the ZATCA 
11  Invalid amount value, amount value must be positive for Invoice total VAT amount.  All Values in the document should be positive. Negative values are not being accepted by the ZATCA 
12  Invalid amount value, amount value must be positive for Invoice total VAT in accounting.  All Values in the document should be positive. Negative values are not being accepted by the ZATCA 
13  Invalid amount value, amount value must be positive for item price amount.  The total discount subtracted from the Item gross price to calculate the Item net price. Only applies if the discount is provided per unit and if it is not included in the Item gross price. Condition  This field is mandatory if item has discount and should be positive values 
14  Invalid amount value, amount value must be positive for Line amount inclusive VAT.  All Values in the document should be positive. Negative values are not being accepted by the ZATCA 
15  Invoice line amount calculated using other values((Item net price ÷ base quantity)* item quantity  invoice line allowance amount) is not correct, please correct the values.  For Calculation of Invoice Line Net Amount, the formula is Item line net amount = [(Item net price ÷ Item price base quantity) × (Invoiced Quantity) − Invoice line allowance amount Please check whether all the details are appropriately provided. If you dont have base quantity, then same would be default 1 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
16  Invoiced Line Item Quantity must be a positive number. Please provide valid number for invoiced line item quantity.  All Values in the document should be positive. Negative values are not being accepted by the ZATCA 
17  Invoiced Quantity is mandatory. Please provide valid number for invoiced quantity.  The quantity of items that is charged in the Invoice line. Quantity is mandatory to be provided Note: For services Quantity would be 1 
18  Item vat category code is not valid. Please correct.  The VAT category code for the invoiced item is mandatory to be provided. Please refer details given in the Enum list which is provided in the Excel Template shared with you. You can provide one of the following data i.e., S, Z, E, O 
19  Line amount inclusive vat for line الرسومات المقدمة: أم القرى is not correct. Please correct.  For Calculation of Line Amount inclusive VAT, check the formula line amount inclusive VAT = Invoice line net amount + VAT line amount Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
20  Line amount inclusive vat for line الرسومات المقدمة: المدنيةحزمة is not correct. Please correct.  For Calculation of Line Amount inclusive VAT, check the formula line amount inclusive VAT = Invoice line net amount + VAT line amount Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
21  Line amount inclusive vat for line مطور نظام مضمن is not correct. Please correct.  For Calculation of Line Amount inclusive VAT, check the formula line amount inclusive VAT = Invoice line net amount + VAT line amount Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
22  Mandatory fields missing for VAT breakdown. Please send values of mandatory fields  Under VAT breakdown following fields are mandatory and need to be filled up

23  Please provide valid serial number for line identifier.  Invoice Line identifier is mandatory and its a unique identifier for the individual line within the Invoice i.e., Serial number of the Line item in the Invoice If you have 5 line items in the invoice then Line item identifier for each line can be 1 for 1st line item, 2 for 2nd line item and so on 
24  Please provide valid state/province code.  Buyer country subdivision is required to be provided Condition  Buyer Province/State is mandatory in case where document type is Standard (for all B2B transaction where buyer is a VAT Registered Entity). Details would be available in the National Address. 
25  Postal code must be 5 digit long. Please correct postal code.  Buyer postal code which would be 5 digits only Condition  Buyer Postal Code is mandatory in case where document type is Standard (for all B2B transaction where buyer is a VAT Registered Entity). Details would be available in the National Address 
26  Recipient vat Number must have 15 digits. The first and the last digits must be “3”. Please supply correct Vat Number  The Buyer's VAT identifier (also known as Buyer VAT identification number). VAT Number would be 15 digits as per ZATCA Requirement Condition  Buyer VAT Number is mandatory in case where document type is Standard (for all B2B transaction where buyer is a VAT Registered Entity). 
27  Street name in address is mandatory for buyer if Country code is SA. Please supply street name.  Buyer address line 1  the main address line in an address Condition  Buyer Street is mandatory in case where document type is Standard (for all B2B transaction where buyer is a VAT Registered Entity) and Buyer is in Kingdom of Saudi Arabia. Details would be available in the National Address 
28  Vat category tax amount should be equal to vat category taxable amount * (vat rate ÷ 100). Please correct values.  For calculation of VAT Category Tax Amount, check the formula provided VAT category tax amount = VAT category taxable amount × (VAT rate ÷ 100) Calculated by multiplying the VAT category taxable amount with the VAT category rate Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
29  VAT category taxable amount should be equal to (Sum of invoice line net amounts − Document level allowance amount). Please correct values.  For calculation of VAT Category Taxable Amount, check the formula provided VAT category taxable amount = ∑(Invoice line net amounts) − Document level allowance amount It should be sum of line net amount  (minus) allowances on document level (subject to a specific VAT category code and VAT category rate) Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
30  VAT line amount for line الرسومات المقدمة: أم القرى is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
31  VAT line amount for line الرسومات المقدمة: المدنيةحزمة is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
32  VAT line amount for line خاتم الماس is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
33  VAT line amount for line خاتم الماس نسائي (صغير ) is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
34  VAT line amount for line دبوس أنف ماسي عيار 22 is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
35  VAT line amount for line سوار is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
36  VAT line amount for line سوار من الاحجار الكريمة is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
37  VAT line amount for line طقم  حلق من الاحجار الكريمة is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
38  VAT line amount for line قلادة الماس is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
39  VAT line amount for line قلادة ثمينة is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
40  VAT line amount for line قلادة لؤلؤ is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
41  VAT line amount for line مطور نظام مضمن is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
42  VAT line amount for line هدايا عملات معدنية is not correct. Please correct.  For Calculation of VAT Line Amount, check the formula VAT line amount = Invoice line net amount x (multiply) Line VAT rate /100 Note: (1) Amount should be upto 2 decimal places (2) Maximum can be 14 digits 
Last modified 6mo ago