Skip to content

Certificate and device problems

What each connection status means

What it is. The Status column on ZATCA Connections shows where each connection is in its registration with ZATCA. Registration is the one-time step that lets a connection issue invoices; see What a ZATCA connection is.

Why ZATCA requires it. Only a unit that ZATCA has onboarded may issue invoices in the integration phase (E-Invoicing Detailed Guidelines §4.1.2(a), p. 15; §4.2.2(a), p. 18). After you enter the one-time code, ZATCA confirms whether the unit was onboarded, and you start issuing invoices once it has been (FAQ, p. 59).

What to do in Clix. Find the connection's status below and follow the last column.

Status Meaning What to do
Active Connected to ZATCA and ready to issue compliant invoices Nothing
Pending Activation Waiting for ZATCA approval to start issuing invoices Wait — "Usually takes 1–2 hours — check back shortly."
Setup in Progress Completing security setup with ZATCA Wait — "Automatic process, usually completes within minutes."
Action Required The connection setup hit a problem Generate a fresh Fatoora code and connect again. More Details shows the connection's certificate dates and Serial number, not the error; if it fails again, contact support
Unknown Status Unknown connection status Reload the page first. Right after Connect, the page can stop watching the certificate chain too early and show "Connection failed" with this status although the connection completed; after a reload it reads Active (seen on the sandbox 2026-09-27). If it is still Unknown after a reload, contact support

Pending Activation and Setup in Progress are normal parts of registration. Do not connect again because it has not gone Active in a minute. You would need a fresh Fatoora code and be no further forward.

Connecting with a Fatoora code starts Setup in Progress, then Pending Activation, then Active. A problem during setup gives Action Required; a fresh code and connecting again returns to Setup in Progress. If the page stops watching, the status shows Unknown Status; reloading the page shows Active. Connecting with a Fatoora code starts Setup in Progress, then Pending Activation, then Active. A problem during setup gives Action Required; a fresh code and connecting again returns to Setup in Progress. If the page stops watching, the status shows Unknown Status; reloading the page shows Active.

The Compliance tab on ZATCA Connections counts certificates as Active, Expiring Soon, Expired or Unknown.

the Compliance tab with the Certificate Overview counts

To check a connection from ZATCA's side, sign in to the Fatoora portal. It lists all your onboarded solutions under View List of Solutions and Devices (Detailed Guidelines, FAQ, p. 59).

Where next. Fatoora code problems · Certificate expiry · When to contact support

Fatoora code problems

The Fatoora code is six digits and expires one hour after you generate it.

Problem Cause Fix
Rejected immediately Fewer or more than six digits "The code must be exactly 6 digits" — re-copy it
"The code is invalid or has expired" Expired: codes last one hour Generate a fresh code in Fatoora and use it straight away
Rejected but looks right Already used, or from a different taxpayer account Generate a new one from the correct account

If connecting fails for any reason, generate a new code rather than reusing the one you have.

Get the code immediately before you need it

The common failure is generating a batch of codes in Fatoora, then registering devices over the following hours. Open Fatoora, generate, paste, submit.

Certificate expiry

Certificates expire. Clix checks every day and emails your Admins when a certificate is within 30 days of expiry or has expired. One email lists every connection affected.

What an expired certificate breaks: that connection can no longer sign, so no new invoices through it. Invoices already issued stay cleared or reported.

To renew, open ZATCA Connections, click the connection's ⋯ button, then Renew certificate. The item appears only within 30 days of expiry. If reminder emails keep arriving after you have renewed, check that you renewed every connection the email lists.

"I cannot issue an invoice"

Work down this list:

  1. Is there a connection at all? No connection means nothing can be signed.
  2. Is it Active? Pending Activation or Setup in Progress means wait.
  3. Is its certificate current? An expired certificate stops invoicing. Check the Compliance tab.
  4. Is it set to the right invoice type? A connection set to Consumers (B2C) cannot issue a standard invoice. Add a connection set to Businesses or Both.
  5. Is it on the right branch? A branch connection puts the branch's address on the invoice; a business-level connection puts the Company Profile address.

When to contact support

  • A device has been in Setup in Progress for more than a few hours.
  • Action Required again after connecting with a fresh code.
  • Connecting fails repeatedly with fresh codes from the correct account.

Include the Connection name and its Serial number from More Details. Write to support@goclix.ai.

ZATCA sources

ZATCA publishes each text in Arabic and English; where they differ, the Arabic prevails.