Skip to content

Common tax and e-invoicing errors and how to fix them

What the usual VAT, ZATCA and UAE messages mean and what to do.

5 min read Real screens, fictional sample data Updated 18 November 2026

On this page

VAT returns

  • “This document is dated in a filed VAT return period”: the period is locked. Record the change in an open period, for example with a credit note, or ask an admin to unlock that return.
  • “A VAT return can only be filed after its period has ended.”: wait until the day after the period ends.
  • “A filed VAT return already covers part of this period.”: choose a period that does not overlap a filed return.
  • Sales in a box marked “emirate not set” (UAE): set the Emirate (UAE) in VAT settings.

ZATCA onboarding

  • “Complete and save the business details first.” or “Save a valid 15-digit VAT number in the business details first.”: finish Business details. A Saudi VAT number has 15 digits and starts and ends with 3.
  • “The OTP has 6 digits.” or no compliance certificate: generate a fresh OTP in the Fatoora portal; it expires after one hour.
  • “Some compliance checks failed.”: read the error codes on the failed samples, fix the data and run the checks again.

ZATCA rejections

  • “ZATCA did not clear this invoice, so it was not issued”: the invoice is still a draft. Fix the cause in the message and issue it again.
  • Buyer address missing the street, building number, district, city or postal code (BR-KSA-63): complete the customer’s address on the contact. A Saudi building number has 4 digits and a postal code 5 digits.
  • Buyer VAT number must be 15 digits starting and ending with 3 (BR-KSA-44), or no VAT number or other ID (BR-KSA-81): correct the TRN/VAT Number on the contact.
  • “A standard tax invoice needs the buyer name (BR-KSA-42).”: add the customer’s name.
  • Credit note without the original invoice or a reason: issue credit notes from the original invoice and give the reason.
  • ZATCA error on a simplified invoice: usually ZATCA was unreachable. Click Report again or wait for the hourly retry.

UAE e-invoicing

  • “This invoice was not issued because the UAE e-invoice failed … check(s)”: read the rule codes, fix the data and issue again.
  • IBR-132-AE: a TRN must be 15 digits, starting with 1 and ending with 03. Check your TRN and the customer’s TRN/VAT Number.
  • IBR-128-AE or IBR-143-AE: a UAE address needs a street, a city and a valid emirate.
  • IBR-127-AE: an invoice with an amount due needs a Due Date. IBR-125-AE: every line needs a description.
  • IBR-150-AE: enter the trade licence number in the business details.
  • “UAE e-invoicing is not connected to a service provider.”: finish the setup and click Go live.

Ask about the product

Ask what the software can do, how a task works, or which countries and languages it supports. Answers come from these guides.

Thinking…

The AI assistant is not available right now. Search the guides or talk to our team. Contact support

AI can make mistakes. Check the linked guides.

Still need help?

Our support team reads every message and answers in plain language.

Contact support
Chat with AI