ZATCA rejections¶
There is no Clix code list for this
Clix does not translate ZATCA rejections into its own catalogue. What you see is ZATCA's own text, passed through unchanged. This page teaches you to read it rather than listing codes that would go stale the moment ZATCA changed them.
What the badge is telling you¶
Every invoice you issue goes to ZATCA. A standard (B2B) invoice is cleared: ZATCA checks it before it is valid. A simplified (B2C) invoice is reported: it is valid when you issue it, and ZATCA checks it afterwards. The badge on the invoice shows ZATCA's answer.
| Badge | Meaning | Your invoice |
|---|---|---|
Green tick — Cleared / Reported |
ZATCA accepted it | Valid |
Amber — Reported · warnings |
Accepted, with remarks | Valid |
Red ✕ — Not cleared / Not reported |
ZATCA refused it | Not valid |
| Pending, or Response not received | ZATCA has not answered yet | Not settled. Wait |
ZATCA answers every invoice in one of three ways: accepted, accepted with warnings, or rejected. A rejected invoice has at least one fatal error and is not a valid document (E-Invoicing Detailed Guidelines §10).
Amber is not a failure. The invoice is valid; ZATCA has noted something. Read the remarks anyway. ZATCA says warnings are accepted for now but may become rejections in future (E-Invoicing Detailed Guidelines §10).
Check warnings on a full screen
The mobile invoice card shows accepted and accepted-with-warnings the same way. Warnings are only distinguishable on the desktop list.
What to do, by badge¶
Find the invoice's badge and follow its branch.
- Not cleared or Not reported. ZATCA does not let you resubmit or cancel a rejected invoice. You fix the cause and issue a new invoice, with its own counter value and hash (E-Invoicing Detailed Guidelines, FAQ, p. 63). The steps are in Fixing it.
- Reported · warnings. No action is needed on this invoice. Correct the client, item or profile so the next invoice is clean (E-Invoicing Detailed Guidelines §10).
- Pending or Response not received. ZATCA expects the same invoice to be sent again until its servers answer, not a new one (E-Invoicing Detailed Guidelines §10). Clix retries on its own. Do not issue a second invoice for the same sale.
- An accepted invoice with a mistake. It cannot be edited or deleted. Issue a credit or debit note against it (Tax Invoicing guideline §7.1).
Where to find the detail¶
Open the invoice. The rejection detail lists each error with its category and message. Rejected Invoices in the sidebar gathers them all:
Invoices that ZATCA rejected — review and resubmit them once corrected.
An empty page is good news: "All invoices have been successfully processed by ZATCA."
How to read a rejection¶
The message names the field. Work from it directly:
| The message mentions | Look at |
|---|---|
| A VAT number | The client's VAT registration, or your own in Company Profile |
| An address field | Building number, district, city or postal code — on the client or the branch |
| A VAT category or rate | The category on each line; zero-rated and exempt lines need a reason code |
| A total or a calculation | Line quantities, prices, discounts and charges |
| A date | Issue date, and supply date on standard invoices |
| A device or certificate | The device's certificate state under ZATCA Connections |
Most rejections are one of three things: a wrong VAT number, an incomplete address, or a VAT category without its required reason.
Fixing it¶
- Expand the rejected invoice and read the errors under ZATCA Compliance Status.
- Correct the underlying record — the client, the item, or your company profile.
- In the invoice's ⋮ menu, click Duplicate Invoice.
- Correct the copy if needed, then issue it.
A rejected invoice cannot be resubmitted, in the app or through the API. The copy is a new invoice with its own number, and it counts toward your monthly allowance. This follows ZATCA's rule: invoices cannot be cancelled, and a corrected invoice goes to ZATCA as a new one (E-Invoicing Detailed Guidelines, FAQ).
A rejected invoice never became a valid tax document, so replacing it this way is right. This is different from correcting an invoice ZATCA accepted, which needs a credit or debit note:
Once issued to ZATCA, this invoice can't be edited or deleted — corrections need a credit or debit note.
Things that look like rejections but are not¶
| What you see | What it is |
|---|---|
| Status sitting at pending for a while | ZATCA was busy or briefly unavailable. Clix sends the invoice again every hour, on the hour, until ZATCA answers. It does the same for an invoice ZATCA answered with HTTP 404. |
| "Response not received" | Clix did not get a definitive answer. Check again before resubmitting. |
| No PDF on a rejected invoice | Expected — "PDFs are only generated for cleared invoices." |
| No credit note option | Expected — notes only apply to invoices ZATCA accepted |
| "Failed Request: invoice_schema_data: Value error, Missing required fields: issue_date, issue_time" when you click Review invoice or Save as Draft | Not a ZATCA rejection; the invoice was never sent. A defect in backend releases 0.108.6 and 0.108.7, which demanded an issue date and time that Clix itself fills in. The form has no field for either, so nothing you enter changes it, and the draft cannot be saved either. Fixed in 0.108.8. If your environment is older, issue through the API or write to support@goclix.ai with the message. Seen on the sandbox 2026-09-28. |
certificate-permissions: "User only allowed to use the vat number that exists in the authentication certificate", on the sandbox |
The sandbox signs every invoice with one shared test certificate, so any VAT number but the certificate's is refused. Your invoice is fine; issue it on app.goclix.ai. On production this code means the connection's certificate belongs to a different VAT registration than the organisation's: check the VAT number under Business and reconnect the device. |
Do not create a replacement invoice for a pending one
If a status has not settled, wait or ask support. Issuing a second invoice for the same sale because the first looked stuck gives you two invoices, and the accepted one cannot be deleted — only credited.
When to contact support¶
- The same invoice is rejected after you have corrected what the message named.
- The message names something you cannot find in the app.
- A status has been unresolved for hours.
Include the invoice number and the exact rejection text. Write to support@goclix.ai.