Qoyod
Pricing

E-Invoice Rejection in ZATCA Phase 2: 10 Common Errors and How Qoyod Catches Them Before Submission

Most accounting systems save your invoice exactly as you entered it, then the error surfaces too late: when it reaches the Zakat, Tax and Customs Authority (ZATCA). In Phase 2 e-invoicing, it is not enough for the numbers to add up; every field ZATCA requires must be present in the correct format. A small gap in an identifier, address, or reason code can mean the entire invoice is rejected.

Rejection is not just an error message. Every rejected invoice means a payment delay of 3 to 5 days, an extra hour or two to correct and resubmit it, and sometimes penalties. Because Qoyod follows ZATCA’s system updates first, it introduced a family of compliance alerts that check your invoice in real time and warn you of any likely error before submission, reducing the risk of rejection instead of dealing with it after the fact.

What does “invoice rejection” mean in Phase 2?

Phase 2 e-invoicing works through two different mechanisms depending on the invoice type. Tax invoices between businesses (B2B) go through the Clearance model, where the authority approves the invoice before it is shared with the customer. Simplified invoices for the end consumer (B2C) follow the Reporting model within 24 hours of issuance.

In the clearance model, if the invoice does not meet the requirements, ZATCA returns it with an “invoice error” status and does not approve it. Importantly, a rejected invoice cannot be edited and resent as-is. The correction is always through issuing a credit note and then creating a new, correct invoice. That is why preventing the error before submission is far cheaper than handling it after rejection.

To understand the regulatory bodies and the role of each platform, the Qawaem platform guide explains the relationship between filing financial statements and e-invoicing, while the ZATCA FATOORA integration guide covers the authority’s technical requirements in detail.

Why are invoices rejected? The most common errors

Most rejections do not come from complex accounting errors, but from simple data-entry mistakes that can be avoided. These fall into four main categories.

Four categories that cause invoice rejection
Missing or incorrect identifiers
A national ID, commercial register, or tax number that is missing or in an invalid format.
Incomplete addresses
Address data that does not meet the structured-address fields ZATCA requires.
Missing reason codes
No exemption reason code or zero-rate tax reason code on exempt line items.
Invalid dates and deadlines
A future issue date, or missing the reporting deadline for a simplified invoice.

What makes these errors costly is that they are both simple and repetitive. A business that issues dozens of invoices a day may deal with a small rejection rate that looks harmless, yet it adds up to lost working hours and delayed payments across the month. Worse, the impact does not stop at your invoice; it extends to your relationship with a customer who is waiting for a correct invoice to meet their own tax obligations.

The common thread across these categories is that they do not surface at data entry in traditional systems; they surface at submission, when time is already short. And each one of these errors is enough on its own to send the invoice back. That is why Qoyod designed the alerts to work at the very moment you enter the data, not after the invoice is saved and submitted.

How Qoyod keeps pace with ZATCA

Phase 2 requirements are not static; they evolve with every wave and every update the authority issues. What was optional yesterday may become mandatory today, such as requiring the national ID on health and education invoices. Because keeping up with these changes manually is nearly impossible for finance teams, Qoyod takes on that job for you.

Between February and May 2026, Qoyod shipped a sequence of updates, each one addressing a specific cause of rejection. Together they form a complete package called Compliance Alerts: ten checks that run automatically on every invoice, with no prior setup. You can follow every update in detail on the Qoyod updates page.

This approach means you do not need to read every new circular from the authority and then adjust the way you work. The update reaches you ready inside the system, and its effect shows up directly on the invoice screen you work on every day. For a deeper look at the cost of compliance and how to plan for it, see our e-invoice pricing guide for Saudi Arabia.

Compliance Alerts: 10 checks before submission

The ten alerts fall into three types based on the invoice status and the level of risk. The first type is mandatory and blocks saving or submission until the data is completed, the second is a strong warning that does not block but highlights the rejection risk, and the third is guidance that steers you to fix the data while letting you proceed.

The three alert types
Mandatory
The invoice cannot be saved or submitted until the required field is completed. A core ZATCA requirement.
Warning
A high probability of rejection. Shown prominently and does not block saving, but you are strongly advised to fix it before submitting.
Guidance
A non-blocking alert that guides you to correct missing or incorrect data while letting you proceed.
Alert Type Details
Mandatory National ID for Health and Education VAT Exemptions Mandatory View details ↓
Identifier Format Validation Guidance View details ↓
Future Issue Date Warning Warning View details ↓
Entering the Zero-Rate Tax Reason Code Guidance View details ↓
Customer Tax Address Validation Guidance View details ↓
24-Hour Deadline Alert for Simplified Invoices Guidance View details ↓
VAT Exemption Reason Code Alert Guidance View details ↓
Government Entity Additional Identifier Guidance View details ↓
Seller Additional Identifier (BT-29) Guidance View details ↓
Missing Customer ID on Government Invoices Guidance View details ↓

Below is a detailed explanation of each alert, with a live example of how it appears inside the invoice and a link to its release page.

01

Mandatory

Mandatory National ID for Health and Education VAT Exemptions

When you choose a health or education VAT exemption, the customer’s national ID becomes a required field. ZATCA introduced this requirement recently, and many invoices were being sent without it and rejected later. Qoyod prevents saving the invoice until you enter the ID, so you avoid rejection at the source.
Example inside the invoice
Customer national IDNone

The invoice cannot be saved until the customer’s national ID is entered.

02

Guidance

Identifier Format Validation

When you enter any identifier such as the national ID, commercial register, or tax number, Qoyod instantly checks its format for length, type, and prefix. The alert appears directly on the field before you move to any other step, so you never discover the error too late.
Example inside the invoice
Tax number30012…

The tax number format is invalid; it must be 15 digits.

03

Warning

Future Issue Date Warning

If the invoice date is later than today, a clear warning appears. The invoice is saved, but the alert stays visible until you correct the date, because ZATCA rejects future-dated invoices on submission.
Example inside the invoice
Invoice date2026/08/15

The date is later than today; the invoice may be rejected on submission.

04

Guidance

Entering the Zero-Rate Tax Reason Code

When a line item has 0% tax, ZATCA requires a reason code such as export of goods or international transport. Qoyod reminds you to choose the correct code before submission, so the invoice arrives valid and avoids rejection due to a missing code.
Example inside the invoice
Line tax: 0% · Reason codeNone

Choose the correct zero-rate tax reason code before submitting to ZATCA.

05

Guidance

Customer Tax Address Validation

Phase 2 requires a structured address with specific fields: building number, street, district, city, and postal code. If the saved customer address is incomplete, an alert asks you to update the record before submission.
Example inside the invoice
Customer addressIncomplete

Address data is incomplete; add the building number and postal code.

06

Guidance

24-Hour Deadline Alert for Simplified Invoices

Simplified tax invoices (B2C) must be reported to ZATCA within 24 hours of issuance. Qoyod tracks this deadline automatically and alerts you as it approaches or passes without submission, so you avoid a silent violation.
Example inside the invoice
Time left3 hours

Submit the simplified invoice before the 24-hour deadline expires.

07

Guidance

VAT Exemption Reason Code Alert

When you mark a line item as VAT-exempt, Qoyod checks for the correct reason code. If the code is missing or inappropriate, an alert appears with a dropdown of the codes approved by ZATCA.
Example inside the invoice
Line status: exempt · Exemption codeNone

Choose the approved exemption reason code from the list.

08

Guidance

Government Entity Additional Identifier

Government (B2G) invoices require an additional identifier for the entity. If it is not saved, an input field appears directly inside the invoice without leaving the customer record, and it is saved automatically after entry.
Example inside the invoice
Entity additional ID[enter]

Add the government entity’s additional identifier right here.

09

Guidance

Seller Additional Identifier (BT-29)

BT-29 is an additional identifier for the seller (account owner) required in Phase 2. If it is not saved in the account settings, an alert appears while creating the invoice with the option to add it immediately from the same screen.
Example inside the invoice
Seller ID (BT-29)None

Add the seller’s additional identifier to complete your Phase 2 data.

10

Guidance

Missing Customer ID on Government Invoices

When you create an invoice for a government customer, Qoyod checks for the customer’s primary identifier. If it is missing, an alert asks you to add it, because its absence leads to rejection.
Example inside the invoice
Customer: government · IDNone

Add the government customer’s ID to avoid invoice rejection.

Notice that the fields recurring across these alerts are the official identifiers: the tax number, the commercial register, and the national ID. The accuracy and format of these identifiers are the first line of defense against rejection, which is why more than half of the alerts focus on them.

What the alerts mean for each type of business

The impact of the alerts differs by the nature of your business and the type of invoices you issue. What is a daily risk for a retail store may be rare for a business that deals only with government entities. Here is how the alerts serve each main segment.

Business-to-business (B2B)

If you issue tax invoices to other businesses, your biggest pain is that errors only appear once the authority reviews the invoice, forcing you to redo the work and sometimes pay a penalty. Here the identifier-format and customer-tax-address alerts catch the gaps at entry, so the invoice reaches the authority complete the first time. The result is a shorter approval cycle and cleaner relationships with your corporate customers.

Government invoices (B2G)

Government invoices carry higher value and lower volume, but a single error can delay a ministry payment for weeks. The problem is that government identifiers are specific, and forgetting the additional identifier or the primary customer ID is easy. Three of the alerts address this directly, letting you fill the additional identifier from inside the invoice itself without leaving the customer record, and warning you when the primary identifier is missing before the authority rejects the invoice.

Simplified invoices for consumers (B2C)

Restaurants, pharmacies, and service stores that sell through a point of sale system issue simplified tax invoices at high volume every day. With that volume it is easy to miss the 24-hour reporting deadline, a silent violation that draws no immediate error from the authority. The deadline alert tracks every simplified invoice automatically and warns you before time runs out.

Health and education sectors

Businesses in the health and education sectors that use VAT exemptions face a fundamental change in the way they work. After issuing their exempt invoices without needing the customer’s national ID, the national ID has become mandatory when a health or education exemption is selected. The mandatory alert here blocks saving the invoice until the field is completed, protecting these businesses from the repeated rejection that used to happen after submission.

Practical examples the alert prevents

To make it concrete, here are real situations that recur in finance teams, and how the right alert steps in before the situation turns into a rejected invoice.

An accountant enters a tax number for a new customer that is missing one digit. In a traditional system the number is saved as-is and the problem is discovered at submission. With Qoyod, the identifier-format alert appears on the field directly, so the accountant fixes the number before even completing the invoice.

A clinic issues an exempt invoice for a patient without entering the national ID. The invoice would have been sent and rejected later, but the mandatory alert blocks saving and asks for the national ID, so the invoice comes out correct on the first attempt. Likewise, when an employee dates an invoice with tomorrow’s date by mistake, the future-date warning appears before submission instead of the authority sending it back.

Common mistakes finance teams make

Even organized teams fall into recurring mistakes under daily work pressure. The first is relying on memory to track the authority’s shifting requirements, which makes errors a matter of time rather than probability. The second is entering customer data in a hurry without checking that the address is complete or the identifier is valid, because the effect only shows up later.

The third mistake is treating simplified invoices as trivial because they look simple, when their time window is the most likely to be missed. The fourth is leaving exemption or zero-rate reason codes empty, assuming they are optional. Compliance alerts address these four patterns specifically, because they move the check from the end of the process to its start, where the fix is easier and cheaper.

How do the alerts work? Three steps, no setup

From creation to correct submission
1
You create the invoice
Enter and save the invoice exactly the way you always do.
2
Qoyod checks it
The system scans the invoice automatically in the background, with no prior setup.
3
It guides you to the fix
If something is wrong, a clear message shows the incorrect part and how to fix it, right there.

The most important part of this mechanism is that it asks nothing extra of you. There is no button to switch on and no settings to configure. The alerts work from the moment you create the invoice. You carry on with your usual work, and the system handles the check in the background.

How do these updates help you in practice?

The impact of the alerts is direct and tangible on your daily cycle. The first thing they achieve is reducing the risk of rejection, since common errors are caught at entry rather than at submission, so you avoid the correct-and-resubmit cycle from the outset in most cases.

The second impact is saving time. Instead of one or two hours spent reviewing and correcting a rejected invoice, the system flags the error in seconds while you are still on the invoice screen. The third impact is protecting cash flow, because an invoice that is correct the first time means faster approval and on-time payment, without the 3-to-5-day delay that accompanies every rejection.

The fourth impact is peace of mind. Your finance officer no longer has to memorize every new requirement, because the system tracks the updates on their behalf and guides them the moment it matters. That eases the pressure on small teams that process dozens of invoices a day.

What happens if an invoice is actually rejected?

The alerts reduce the risk of rejection to a large extent, but they do not eliminate the possibility entirely, especially in cases outside the ten checks. So it is important to know the correct correction path when a rejection does happen, because handling it incorrectly can double the delay.

An invoice the authority returns with an “invoice error” status cannot be edited and resent as-is. The correction is always through issuing a credit note that reverses the incorrect invoice, then creating a new, correct invoice. For standard tax invoices between businesses, Qoyod creates and links the credit note automatically, while you issue the new invoice. For simplified invoices, the credit note is created manually and then a new invoice is issued.

The advantage is that Qoyod shows the status of each invoice and the reason for rejection clearly, so you are never left guessing what happened. Even so, preventing rejection from the start through the alerts remains far cheaper than this path, because it spares you both the credit note and the new invoice.

How Qoyod helps you comply

Compliance alerts are part of a wider invoicing system inside Qoyod built entirely for Phase 2. The system provides a direct integration with ZATCA that exchanges invoices with the authority automatically, with full support for both the Clearance model for tax invoices and the Reporting model for simplified invoices.

Alongside the alerts, Qoyod offers a simulation environment that lets you test your invoices’ compliance before going live, with no risk to your real data. And when a real rejection occurs, the system shows the invoice status and the rejection reason clearly, and helps you correct it through credit notes and new invoices under the authority’s approved mechanism.

All of this sits within a ZATCA-certified accounting system used by more than 25,000 Saudi establishments, covering the full work cycle from invoicing to reporting. If you run a restaurant or a store that issues simplified invoices at high volume, our e-invoice cost guide shows how this applies to your sector.

Send your invoices with confidence
Try Qoyod free and let the alerts check your invoices before they reach ZATCA, or browse the latest updates to stay informed.

Frequently asked questions

Am I required to use compliance alerts?

The guidance alerts are not mandatory and you can proceed past them, but they save you a great deal of time and effort and reduce the risk of rejection. One alert, however, is mandatory by the authority’s own requirement: the national ID for health and education exemptions.

Are there any extra costs for the feature?

There are no additional fees. Compliance alerts are activated automatically, with no setup required.

What if I submit the invoice without seeing the alert?

The alert appears before submission to give you a chance to fix the issue. But if you bypass it and submit an invoice with an error, the authority may return it with an error status, and the correction is then through a credit note and a new invoice, with a possible penalty in some cases.

How much time will the alerts save me?

Every rejected invoice typically costs a payment delay of 3 to 5 days, plus an hour or two to correct and resubmit it. Catching the error before submission usually saves all of that time.

Do the alerts work with simplified B2C invoices?

Yes. Among the alerts is one dedicated to the 24-hour deadline for simplified invoices, as Qoyod tracks the deadline automatically and warns you before it expires so no reporting delay occurs.

Do the alerts guarantee the invoice is always accepted?

The alerts cover the common errors in format, data completeness, and dates, which are the most frequent causes of rejection, so they reduce the risk significantly. But they do not replace your final review, and they do not cover every single one of the authority’s requirements.

Do I need to configure the alerts after every update from the authority?

No. Qoyod follows the authority’s updates and adds the new checks automatically inside the system, so they reach you ready with no action on your part. You can follow what is released on the Qoyod updates page.

Conclusion

In Phase 2 e-invoicing, the difference between an accepted invoice and a rejected one is often a single missing field or an absent code. And because every rejection costs time, a payment delay, and possibly a penalty, catching the error before submission is the more economical solution.

Qoyod’s ten compliance alerts do this for you: they check every invoice in real time, warn you of any likely error, and guide you to the fix in the same place, with no setup. And as the authority’s requirements evolve, Qoyod keeps pace and adds the new checks automatically, so your invoice is correct the first time.

Whether you are an existing Qoyod user who wants the assurance that these checks are running in your account, or a business looking for a system that handles compliance on your behalf, the message is the same: compliance is no longer a task done at month-end, but a continuous check that happens with every invoice. And when that check is built into your daily tool, it turns from a source of worry into a feature that works quietly in the background.

Share this article
Subscribe to Qoyod's latest posts

Get the latest posts and updates delivered to your inbox.

By subscribing, you agree to our privacy policy. You can unsubscribe at any time.
جاهز لتطبيق ما قرأته؟

قيود يدير محاسبتك بدقة وامتثال كامل لهيئة الزكاة والضريبة والجمارك

جرّب قيود مجانًا لمدة 14 يومًا — بدون بطاقة ائتمان.

Ready to put this into practice?

Qoyod handles your accounting accurately and stays ZATCA-compliant.

Try Qoyod free for 14 days — no credit card required.