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¶
| 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 |
Amber is not a failure. The invoice is valid; ZATCA has noted something. Read the remarks anyway — they are usually advance warning of what will become a rejection.
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.
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 and resubmitting¶
- Open the rejected invoice and read the errors.
- Correct the underlying record — the client, the item, or your company profile.
- Use Fix & Resubmit to ZATCA on the invoice.
A rejected invoice never became a valid tax document, so correcting and resubmitting it 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 retries. |
| "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 |
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.