ZATCA Business Settings

Before creating invoices, users need to configure the business settings for each company on the instance. The ZATCA business settings include the following tabs:

Seller Details:

• Select the Company for Integration with ZATCA:

  • Choose the company that will be integrated with ZATCA for invoicing purposes.

• Address (with Required Fields):

  • Select the company’s address and ensure all necessary address details are filled in.

• Company Unit (Fetched from Address Title):

  • The company unit information will be automatically fetched from the address title provided.

• Company Unit Serial (Format: 1-Solution Provider Name|2-Model or Version|3-Serial):

  • Specify the company unit serial using the format: 1-Solution Provider Name|2-Model or Version|3-Serial.
  • Example: 1-ERPNext|2-15|3-1.
  • The unit serial is like the identifier of the unit you are onboarding to ZATCA platform

• Company Category (Business Category):

  • Define the business category for the company.

• Country (Auto-Fetch from the Company):

  • The country will be automatically fetched from the company details.

• Country Code (Auto-Fetch from the Country):

  • The country code will also be automatically fetched.
  • Make sure the code is "SA"

• Enabled ZATCA Integration (Enable/Disable):

  • Set this field to true to enable the ZATCA integration.

• Sync with ZATCA (Synchronization Mode):

  • Choose between two synchronization modes:
  • Live: Send transactions immediately to ZATCA, primarily for B2B transactions.
  • Batches: Send batches of transactions every 2 hours, mainly for B2C transactions.

Seller ID

• Seller Name (Name in the Registration License):

  • Enter the seller’s name as it appears in the registration license.

• VAT Registration Number (Registration Number in the VAT License):

  • Provide the VAT registration number associated with the company.

• Additional IDs (At Least One Required):

  • You must provide at least one additional ID, such as:
  • CRN (Commercial Registration Number)

VAT Account Configuration

This tab is to automatically Creates tax account under Duties and Taxes.
Creates Tax Category, Sales Taxes and Charges Template and Item Tax Template.

The user enters

• The name of the account
• The account number
• The tax rate
• The tax category

This feature can only be used on the creating of ZATCA business settings after that it will be read-only to prevent manipulating.

CLI

CLI Setup:

The ZATCA CLI is an open-source tool used to generate CSRs, validate, and sign XML sales invoices sent to ZATCA. It offers two setup options:

• Automatic:

  • One-click setup downloads the CLI and Java 11 runtime from GitHub by default (configurable). It will display a button to download and set up ZATCA CLI.
  • Override CLI Download URL: If left empty, the CLI will be downloaded from here.
  • Override JRE Download URL: If left empty, JRE 11 will be downloaded from here.

• Manual:

  • Manually deploy the CLI on the server as well as a Java 11 runtime and configure the path to the deployed CLI.

Integration:

• Validate Generated XML:

  • If enabled, validates the generated ZATCA XML when creating Sales Invoice Additional Fields. This has a performance impact, so it is recommended to enable this only for testing or troubleshooting problems.

    • Block Invoice on Invalid XML

      • If enabled, submission of sales invoices that produce invalid XML will be blocked.
        Requires ZATCA CLI 2.1.0 or later (In case of Rejection or Accepted with warnings)

• Fatoorah Server URL (ZATCA Server URL for Production):

  • The user selects which environment he uses

    • Sandbox: ZATCA test environment
    • Simulation: Test environment requires OTP from Fatoorah platform
    • Production: ZATCA production environment requires OTP from Fatoorah platform

By following these settings and configurations, the system will be properly integrated with ZATCA, ensuring compliance with regulatory requirements for invoicing.