Integration with ZATCA Fatoora Platform

Objectives

• Enable the Integration:
  • Testing
  • Production
• ZATCA Restrictions

Steps

To comply with the latest e-invoicing requirements and ensure regional compliance, you can now enable integration with the Fatoora platform from Lexzur. This allows any new invoice created in Lexzur to be directly added to the ZATCA Fatoora platform. 

Steps to Enable Integration: 

• Navigate to the Billing Module in Lexzur.

• Open the Settings under Configuration, then navigate to Setup Entities.

• Choose the entity for which you want to activate the integration.

• Click Activate Integration  

• Generate OTP Code: You will first need to test the environment. The OTP code is generated from the ZATCA Fatoora platform:
  • • Open your ZATCA account.
  •  
  •  
    • Click on Fatoora Portal. 

• •  
  •  
    • Choose Onboard New Solution Unit/Device.
  •  
  •  
    • Enter the number of OTP codes to be generated (e.g., 1) and generate the code.
  •  
    • Copy the generated OTP code.

• Go back to Lexzur to Complete the Integration: In Lexzur, fill out the following fields:

• • • OTP Code: Enter the code you obtained from the ZATCA Fatoora platform.
    • Integration Type: Choose either Fatoora Production or Fatoora Simulation (select Simulation for testing).
      • Production: Creates invoices directly in Fatoora.
      • Simulation: Used for testing purposes.
    • Client Name

 Once the integration is successfully set up, open any invoice. From the options icon in the top right corner, select Fatoora Simulation. A success message will confirm that the integration is functioning correctly.

Moving to Production:

Revoke Previous Integration:

• Return to  Billing Settings → Setup Entities and revoke the prior integration

• Repeat the setup process, this time selecting Fatoora Production as the integration type. (Repeat the activate integration steps)

After completing the setup, open an invoice again, and from the action wheel, choose Fatoora Production. 

The invoice will successfully reflect in ZATCA, and the Fatoora production status will be visible under the invoice status.

The integration status can also be monitored from the invoice grid.

Open the invoice grid, search for the integration type under columns, and add it to the grid. 

This will show which invoices have been sent to the Fatoora platform and which have not.

ZATCA Restrictions:

Once the integration is successfully completed, additional restrictions from ZATCA will apply, including:

• Client Details: All required information, such as addresses and tax numbers, must be provided for each invoice prior to creation. 

• The tax number should be 15 digits, starting and ending with 3.
• Updates at the level of Invoice QR Code.
• Invoice Types: Certain types, such as the simplified tax invoice, may no longer be compliant with export transaction types.

For more information about LEXZUR, kindly reach out to us at help@lexzur.com.

Thank you!