Skip to content

Connect your store to ZATCA

Connect e-invoicing with a Fatoora code, fix errors, renew.


Connecting makes every sale file its own invoice with ZATCA. You do it in Settings, then Taxes, on the "E-invoicing (ZATCA)" card under "Tax registration". You connect once, with a one-time code from the Fatoora portal. Only orders charged VAT at the Saudi rate of 15% are filed, and orders placed before you connected are not.

Before you start

  • Only the store owner can connect, continue setup or renew. Anyone else who presses the button sees "That did not go through. Try again."
  • Your VAT number is saved under "Tax registration".
  • Your store's national address is saved on the same card.
  • You have your company account for the Fatoora portal.

Connect your store

  1. Press "Connect" on the "E-invoicing (ZATCA)" card.
  2. Open the Fatoora portal and sign in with your company account.
  3. Choose Onboard new solution and copy the one-time code. It lasts one hour.
  4. Come back to the studio and paste it into "One-time code from Fatoora".
  5. Press "Submit code".

The card then shows "Talking to ZATCA…". We create the signing keys, send ZATCA a set of test documents and collect your store's certificate, all from that one press. When it finishes, the badge reads "Connected" with "Certificate valid until" and the date.

Connection statuses

  • "Waiting for a code" and "Keys ready": setup has started and needs a code from Fatoora.
  • "Checks in progress": ZATCA are checking the test documents.
  • "Checks passed": the test documents passed. If "Continue setup" shows, press it to collect the certificate.
  • "Connected": done, and invoices for orders charged 15% VAT file by themselves.
  • "Didn't connect": setup stopped. Read the message under the card. If "Continue setup" shows, press it (no new code needed); otherwise start again with a new code.
  • "Certificate revoked": the certificate no longer works. Connect again with a new code.

There is one connection for your whole account. With several stores under the same VAT number you connect once, and each store's invoices carry that store's own name and address, so every store needs its national address.

Renew the certificate

30 days before the certificate expires, the card shows "This certificate expires soon." and a "Renew certificate" button. Invoicing keeps running on the current certificate until the new one takes over.

  1. Press "Renew certificate".
  2. In the Fatoora portal, choose Renew existing solution and copy the new code.
  3. Paste it into "One-time code from Fatoora" and press "Submit code".

If it does not connect

  • "Add your VAT number above first." or "Add your store address above first: ZATCA require it.": complete "Tax registration" and come back.
  • "ZATCA did not accept that code...": the code expired, or your VAT number does not match your Fatoora account. Fetch a fresh code and check the number.
  • "Your earlier code already worked. Continue setup instead of fetching a new one.": press "Continue setup", no code needed.
  • "ZATCA rejected one of the test documents..." or "ZATCA refused the request...": check your VAT number and address, then press "Continue setup" or try again.
  • "ZATCA is not answering right now..." or "Something went wrong on our side...": nothing is lost. Press "Continue setup" in a few minutes.
  • "Setup is already running. Give it a minute.": wait, then reload the page.

More in Taxes