Phase 1 Errors and Resolutions
Frequent Errors and their resolution for E-invoicing.
Last updated
Frequent Errors and their resolution for E-invoicing.
Last updated
| 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 :
Cancellation or suspension of the supplies after its occurrence either wholly or partially
In case of essential change or amendment in the supply, which leads to the change of the VAT due;
Amendment of the supply value which is pre-agreed upon between the supplier and consumer;
In case of goods or services refund.
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
VAT category taxable amount
Currency for VAT category taxable amount
VAT category tax amount
Currency for category tax amount
VAT category code
VAT category rate
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