Help and Support

Phase 1 Errors and Resolutions

Frequent Errors and their resolution for E-invoicing.

Sl. NoError MessageSolution

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

  1. VAT category taxable amount

  2. Currency for VAT category taxable amount

  3. VAT category tax amount

  4. Currency for category tax amount

  5. VAT category code

  6. 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

PreviousCommon Errors and ResolutionNextPhase 2 Errors and Resolutions

Last updated