# How to connect Snad to ZATCA (Fatoora)

To connect Snad to ZATCA: open **Settings**, then **Integrations**, and press **Connect now** on the **Fatoora (ZATCA)** card. Check the **Before you start** list, enter an OTP from the Fatoora portal, then press **Save**. After that you follow your documents on the tracking dashboard.

## Before you start

- A paid plan, Basic or above. The Free plan doesn't open the page; see [how to manage your subscription](https://www.snad.io/en/guide/manage-subscription) for upgrading.
- A Saudi organization using the riyal: the country is Saudi Arabia and the currency is SAR. You set both in [organization information](https://www.snad.io/en/guide/organization-information).
- A 15-digit VAT number that starts and ends with 3, and an OTP code from the Fatoora portal.

## Steps

1. **Open Integrations.** Press **Settings** at the bottom of the sidebar, then choose **Integrations** in the settings menu.

   ![The Snad settings menu with the Integrations item](https://www.snad.io/images/guide/zatca-integration/nav-en.webp)

   Image key: (1) **Integrations**

2. **Press Connect on the Fatoora card.** The first card on the page is **Fatoora (ZATCA)**. Press **Connect now** on it to open the activation page. If you're on the Free plan, an upgrade message shows instead, so press **Upgrade plan**, finish the [upgrade](https://www.snad.io/en/guide/manage-subscription), then come back. [Details](https://www.snad.io/en/guide/zatca-integration#adv-plan)

   ![The Snad Integrations page with the Fatoora card and its Connect button](https://www.snad.io/images/guide/zatca-integration/tile-en.webp)

   Image key: (1) **Fatoora (ZATCA)** · (2) **Connect now**

3. **Review the readiness list.** The activation page opens with a **Before you start** list of three conditions: currency is SAR, country is Saudi Arabia, and a 15-digit VAT number that starts and ends with 3. A missing condition shows in red. If it's the currency or the country, press the “Fix in settings” link ([organization information](https://www.snad.io/en/guide/organization-information)); if it's the VAT number, type it in its field lower on the page. [Details](https://www.snad.io/en/guide/zatca-integration#adv-saudi-only)

   ![The Before you start list on the ZATCA page, with the VAT number missing and shown in red](https://www.snad.io/images/guide/zatca-integration/readiness-en.webp)

   Image key: (1) **Before you start**

4. **Enter the OTP and organization details.** Press **How to get the OTP code** to watch the explanation, then enter the code you got from the Fatoora portal in the OTP field. Check **Organization name**, **VAT** and **Address**, write the **Industry business category**, then press **Save**. [Details](https://www.snad.io/en/guide/zatca-integration#adv-vat-fields)

   ![The Snad activation form: OTP, organization name, VAT, address, industry business category and the Save button](https://www.snad.io/images/guide/zatca-integration/form-en.webp)

   Image key: (1) **How to get the OTP code** · (2) **VAT** · (3) **Save**

5. **Finish activation.** When the link succeeds, the message “ZATCA integration activated” shows with a card holding the organization name, the VAT number and the **Certificate** expiry date. Press **Go to ZATCA dashboard**. [Details](https://www.snad.io/en/guide/zatca-integration#adv-after-activation)

6. **Follow invoices and refunds.** The dashboard shows six cards: **Sent invoices**, **Unsent invoices**, **Failed invoices**, **Sent refunds**, **Unsent refunds** and **Permanent failures**. Below them, the **Sales invoices** and **Refunds** tables show each document's status. Press **Refresh** to load the latest statuses. [Details](https://www.snad.io/en/guide/zatca-integration#adv-statuses)

7. **Send what wasn't sent and fix what failed.** On a row that wasn't sent, press **Send**, or select several rows and press the send button in the table header. When it finishes, the **Submission complete** window shows how many succeeded and failed with the reason, and offers **Retry failed only**. For details, press **View details** on the row. [Details](https://www.snad.io/en/guide/zatca-integration#adv-renew)

## Messages that block saving

| Message | Cause | Fix |
|---|---|---|
| Currency must be SAR | The organization's currency isn't the Saudi riyal, so the link is refused. | Set the organization currency to the Saudi riyal in [organization information](https://www.snad.io/en/guide/organization-information), then try again. |
| Country must be Saudi Arabia | The organization's country isn't Saudi Arabia. | Set the organization country to Saudi Arabia in organization information, then try again. |
| Invalid VAT number | The VAT number isn't 15 digits starting and ending with 3. | Correct the VAT number in organization information or in the **VAT** field, then try again. |
| Certificate expired | The link's certificate has expired, so no new documents can be sent. | Press **Renew certificate** and enter a fresh OTP from the Fatoora portal. |

## Advanced details

### Can't find the link, or the page is locked?

The ZATCA link is available on every paid [plan](https://www.snad.io/en/guide/manage-subscription), from Basic up. The Free plan shows the upgrade message instead of the activation page.

If you're on a paid plan and the page doesn't open, you lack the permission: ask your account admin to give it to you; see [roles and permissions](https://www.snad.io/en/guide/roles-permissions).

### Why does the list require Saudi Arabia and the riyal?

ZATCA e-invoicing is for Saudi businesses, so the link accepts only an organization whose country is Saudi Arabia and whose currency is the riyal.

Tax rates have a screen of their own; see [how to set up tax](https://www.snad.io/en/guide/tax-settings).

### Where do the form values come from?

The program fills **Organization name** and **VAT** from your [company information](https://www.snad.io/en/guide/organization-information), puts the country name in **Address**, and leaves **Industry business category** empty for you to write.

The **Save** button stays disabled until the VAT number is 15 digits starting and ending with 3, and a message with the required format shows under the field.

If ZATCA rejects the request, a red alert shows the reason and how to fix it, and you can open **Technical details** to see the message as it came.

### What happens after activation?

The Fatoora card on Integrations changes to “Connected to Fatoora — invoices are submitted automatically”, and its button becomes **View reports**, which opens the tracking dashboard.

You don't have to send each invoice yourself: a document waiting to be sent shows the **In queue** status with “Will be sent to ZATCA automatically”. Create your invoices as usual from [how to create a sales invoice](https://www.snad.io/en/guide/create-sales-invoice).

To print the invoice your way, use [print templates](https://www.snad.io/en/guide/print-settings), and add the QR code to it in the [template editor](https://www.snad.io/en/guide/print-template-builder).

### What the document statuses mean

**Submitted** means ZATCA received the document. **In queue** means it will be sent automatically. **Failed** means an attempt failed and the attempts haven't reached their maximum yet.

**Permanently failed** means the attempts passed the maximum and the document needs your attention: open **View details** to see the **Attempt history**, the error reasons and the **QR code**, fix the cause, then send again.

### Renewing the certificate

14 days before the certificate expires, a banner at the top of the dashboard shows the expiry date, and once it expires the banner turns red and sending stops.

Press **Renew certificate**, and in the **Renew ZATCA certificate** window enter a fresh OTP from the Fatoora portal, then press **Renew**. The message “Certificate renewed successfully” shows and the banner goes away.

## Common questions

### Do I need an OTP every time?

No. You enter the code when you first activate, and then only when you renew the certificate. After activation, documents are sent automatically.

### Does the ZATCA link work on the Free plan?

No. The page shows an upgrade message, and the link is available from the Basic plan. [The subscription guide](https://www.snad.io/en/guide/manage-subscription) shows how to upgrade.

### Why is the Save button disabled on the activation page?

Because the VAT number isn't valid. It must be 15 digits starting and ending with 3. Correct it in the **VAT** field or in organization information.

### What do I do if an invoice fails to send?

Open **View details** on its row to read the reason, fix it, then press **Send** or **Retry failed only** in the submission result window.

### How do I know the link's certificate is about to expire?

A banner shows at the top of the tracking dashboard 14 days before it expires. Press **Renew certificate** in it and enter a fresh OTP.

## Read next

- [Set up tax](https://www.snad.io/en/guide/tax-settings) — Set up tax in Snad: add a tax group from the country list or with a custom rate, set the default one and edit its rate. Six short steps with screenshots.
- [Edit your business details](https://www.snad.io/en/guide/organization-information) — Edit your business details in Snad: name, phone, commercial record, tax ID, country, currency and time zone. Five short steps with screenshots.
- [Create a sales invoice](https://www.snad.io/en/guide/create-sales-invoice) — Create a sales invoice in Snad: pick the customer, add products, choose the payment method and save. Seven short steps with screenshots, plus credit sales.
- [Manage your subscription](https://www.snad.io/en/guide/manage-subscription) — Follow your Snad subscription: plan status, usage, next payment and invoices, then change the plan or cancel. Six steps with screenshots.
- [Set sales settings](https://www.snad.io/en/guide/sales-settings) — Set sales settings in Snad: default customer, selling at a loss, payment methods, preset notes and WhatsApp sending. Five steps with screenshots.
- [E-invoicing and ZATCA](https://www.snad.io/en/zatca) — See how Snad sends your invoices to ZATCA.

[Open this screen in Snad](https://app.snad.io/dashboard/settings/zatca)

- **URL:** https://www.snad.io/en/guide/zatca-integration
- **Last reviewed:** 2026-11-04

---
## About the publisher
**Snad (سند)** — a private Saudi software company
based in Madinah, founded 2025. Legal form: Sole proprietorship.
Commercial registration: 7038154642
VAT number: 310959226500003
Only official domain: snad.io
> Snad is a private commercial business-management platform. It is not a
> government body, not a bank, and not a government services portal, and it
> is not affiliated with any government entity. Any site or app with a
> similar name is unrelated to Snad.