> ## Documentation Index
> Fetch the complete documentation index at: https://www.spacebring.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# ZATCA Fatoorah in Saudi Arabia
> Enable ZATCA Fatoorah eInvoicing for Saudi Arabia to automatically generate compliant eInvoices and submit them for real-time clearance
Spacebring supports ZATCA Fatoorah eInvoicing for Saudi Arabia and helps you stay compliant by:
* Automatically generating eInvoices and credit notes in the format required by the Zakat, Tax and Customs Authority (ZATCA)
* Submitting them for real-time clearance via ZATCA's FATOORA platform
* Adding ZATCA QR codes to the PDF invoices sent to customers, allowing them to verify invoices with the ZATCA app
* Tracking sync status for every invoice.
This feature is currently in beta. Its functionality and appearance are subject to change, and it may not be fully stable. We welcome your feedback at [support@spacebring.com](mailto:support@spacebring.com).
## Prerequisites
To enable eInvoicing, ensure the following requirements are completed.
### Complete location billing details
Your location billing details, tax, and currency must be complete and accurate.
1. Go to **Location settings** > **General** page > **Billing details** tab.
2. Fill in your location's billing details.
* **Legal business name**
* **Address** — Country (Saudi Arabia), Address line 1, Address line 2 (building number, max 4 digits), City, State/Province, and Postal code (5 digits).
* **Tax ID** (VAT) — must be exactly 15 digits, starting and ending with `3`.
* **Contact details** — Email is mandatory.
3. **Commercial registration number** — enter your CRN issued by the Ministry of Commerce. This is required for ZATCA Fatoorah eInvoicing alongside your VAT number.
4. Go to **Location settings** > **Billing** page > [**Taxes**](/docs/billing/taxes) tab.
* Set the **Tax type** to **VAT** and enter **15%** in the **Tax rate** field (required by ZATCA).
5. Go to **Location settings** > **Billing** page > **Currencies** tab.
* Make sure your main location currency is set to SAR, Saudi Riyal.
* If your primary location currency is different, [add SAR Saudi Riyal as an alternative currency](/docs/billing/currencies) and apply it to all customer profiles for whom you want to generate eInvoices.
Only invoices issued in SAR can be synced to ZATCA's FATOORA platform.
### Complete customer billing details
Each customer must also have accurate billing details.
1. Go to **Location settings > Customers** and manage the [**Require billing details**](/docs/customer-management/billing-details) setting depending on your needs:
* Enable this requirement for both individual users and companies
* Or only for companies, if you need to generate eInvoices only for companies.
If **Require billing details** is enabled for a customer type:
* New customers will be prompted to fill out their billing details at the first payment.
* Existing customers missing billing details will be prompted to update their details during their next payment.
2. To review or update customer details manually:
* Go to the **Customers** page > open each customer profile > locate the [**Billing details**](/docs/customer-management/billing-details) section on the right side panel. Fill in any missing billing details as an administrator.
* Alternatively, ask customers to update billing details on their own under [**Membership > Billing**.](/docs/customer-management/billing-details)
#### Requirements for companies
For companies, complete billing details are required for eInvoices to be generated and submitted.
If a company's billing details are incomplete or invalid, invoices for that company will remain in [**Draft**](/docs/billing/invoices/statuses) status with a warning and cannot be issued.
#### Requirements for individual users
For individual members, only fill in billing details if you want their invoices generated as eInvoices and submitted to ZATCA's FATOORA platform.
* If you do not want to generate eInvoices for individual members, leave their billing details, especially the **Legal business name** and **Tax ID**, empty.
* If at least one of these fields is filled for an individual member, Spacebring will attempt to sync their invoices as eInvoices to ZATCA's FATOORA platform.
## Enable eInvoicing
1. Go to **Location settings > Billing > Invoices** tab.
2. Enable the **eInvoicing** switch.
3. In the **ZATCA registration** section, click **Start verification process**.
4. Follow the instructions in the registration form to configure your ZATCA Fatoorah eInvoicing credentials.
* For **Invoice type**, select **Standard only** or **Standard + Simplified**. Spacebring syncs only standard invoices.
5. Your registration will be submitted to ZATCA for verification.
* You can monitor the status using the **Track verification status** button, which opens the ZATCA FATOORA portal where you can follow the process.
* Verification may take some time. Once approved, your registration status will update to verified.
* If verification fails, click **Restart verification** to retry.
## How eInvoicing works
After eInvoicing is enabled:
* All invoices for customers with valid billing details are automatically generated in the ZATCA-compliant eInvoice format.
* During issuance, invoices are also submitted to ZATCA's FATOORA platform for real-time clearance.
* After clearance is confirmed, customers receive the standard PDF invoice, which includes a ZATCA QR code they can scan with the ZATCA app or compatible scanners to verify the invoice.
* Credit notes are also submitted to ZATCA if their original invoice was successfully cleared.
* When eInvoicing is enabled, voiding invoices and credit notes is not supported, because this is not allowed under ZATCA. Instead, you can:
* [Issue a credit note](/docs/billing/invoices/credit-notes) to correct the invoice.
* If necessary, issue a credit note for the full invoice amount to cancel it.
### Track eInvoice syncing
Each invoice has the eInvoice sync status indicated.
If an eInvoice fails to sync (for example, due to invalid or missing customer billing details):
* The invoice will not be issued.
* The system will display:
* "eInvoice sync failed" status
* A red warning triangle next to the affected invoice
* A red warning triangle next to the customer's name on the **Customers** page.
If prompted, update the customer's billing details or complete any required actions, and click **Issue** again.
You can also see the eInvoice sync status for all invoices in the [**Invoices** report](/docs/analytics/reports).