Reading a ZATCA status
The five statuses, what each means, and what to do about it.
Where the status appears
In three places:
- A colour-coded badge on the order row in the Orders screen, one for the invoice and one for the credit note.
- The ZATCA Invoice Error screen.
- The ZATCA Credit Note Error screen.
ACCEPTED
The authority accepted the document. Nothing to do. The badge is green.
WARNING
The document was accepted but with remarks from the authority. Not a failure and no resubmission is needed, but it is worth reading the remark and fixing its cause in your data so it stops recurring. The badge is orange.
NOT SUBMITTED
The document was never sent to the authority at all. Common causes:
- The automatic submission switch is off.
- The invoice is still a draft and has not been posted.
- The ZATCA setup in Odoo is incomplete — the certificate or the establishment details.
The badge is red.
REJECTED
The authority refused the document. The reason is in the error column and comes from the authority itself; it usually concerns missing or non-conforming data: the customer VAT number, the address, or the tax details.
Correct the data in Odoo, then resubmit from the error screen. The badge is red.
ERROR
The submission could not be completed — a connection problem with the authority, or a configuration error in Odoo. Retry first; if it persists, review the ZATCA settings in Odoo. The badge is red.
Statuses refresh hourly
Every hour the connector re-reads the status of documents not yet accepted. If you submitted something and it looks pending, wait an hour before worrying: the authority may have accepted it and the status simply has not been read yet.