Skip to Content

ZATCA Integration

by
Odoo

$ 200.01

v 19.0 Third Party 5
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Invoicing (account)
• Discuss (mail)
Lines of code 246
Technical Name zatca_integration
LicenseLGPL-3
Websitehttps://www.taqnix.com
Versions 16.0 17.0 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Invoicing (account)
• Discuss (mail)
Lines of code 246
Technical Name zatca_integration
LicenseLGPL-3
Websitehttps://www.taqnix.com
Versions 16.0 17.0 18.0 19.0

KSA Phase-2 e-Invoicing (Fatoora) Integration

Integrate your e-Invoicing and stay 100% ZATCA compliant.

01. Seamless integration with existing systems
02. Supports structured XML invoice formats
03. Secure and reliable invoice transmission
04. Real-time validation and error reporting

Overview

Introduction

The KSA Phase-2 e-Invoicing Integration module is developed to ensure full compliance with the regulations mandated by ZATCA. This solution automates the end-to-end workflow, ensuring your business stays ahead of legal requirements.

Onboarding

Seamlessly onboard to ZATCA's e-invoicing platform with automated certificate management.

Validation

Validate invoices in real-time against ZATCA's APIs to prevent submission errors.

Automation

Maintain continuous compliance with minimal manual intervention from your team.

XML Signing

Generate and sign Phase-2 compliant electronic invoices automatically.

Traceability

Ensure auditability and full traceability of all your e-invoice data records.

Direct ZATCA Fatoora integration ensures regulatory safety and operational efficiency.

System Configuration

ZATCA E-Invoicing Settings

Configuration Path
Settings > Invoicing > Settings > ZATCA E-Invoicing Settings

API Modes Supported

Sandbox, Pre-Production, and Production

ZATCA Settings Interface

Interface rendering may vary based on your Odoo version and screen resolution.

Data Configuration

Company Master Data Configuration

Under Settings > Users & Companies, fill in your company's legal and ZATCA-specific identification details:

  • Country: Select Saudi Arabia
  • Building Number: Enter the official building number as recorded on your company's registration documents.
  • Plot Identification Number: Provide the cadastral plot number assigned to your registered premises.
  • Identification Scheme: Select the appropriate ID type (e.g., Commercial Registration).
  • Identification Number (SA): Your company's national ID in Saudi Arabia.
  • VAT Number: The 15-digit VAT registration for ZATCA reporting.
  • Company ID: Unique internal reference for your company.
  • Currency: Ensure it's set to SAR for compliance.
Company Settings

Fatoora Compliance Interface

On boarding

Journal Onboarding (ZATCA Tab)

Configure your Sales Journal to connect with ZATCA by following these steps:

Step 01: Enter Serial Number

In the ZATCA tab of Configuration > Journals, set a unique device serial number.

1234-ABCD-5678
Step 02: Onboard Journal

Click the Onboard Journal button to initiate the compliance setup and finalize the ZATCA connection.

ZATCA READY
ZATCA Onboarding Interface

Visual Configuration Guide

Easy customer setup

Customer Data Configuration

Under Settings > Users & Companies, fill in your company's legal and ZATCA-specific identification details.

 

Primary Identity & Location

1. Country: Select Saudi Arabia (Partner Country)
2. Building Number: Official number per registration.
3. Plot Identification: Cadastral plot for premises.
 
 

Legal & ZATCA Specifics

1. Identification Scheme: ID type (e.g., CR Number).
2. Identification Number (SA): Partner national ID.
3. VAT Number: 15-digit ZATCA registration.
4. Company ID: Unique internal reference.
Settings

Fatoora Compliance Interface

Compliance Workflow

Requesting CSID Certificate

01

Log into the ZATCA Fatoora Portal (fatoora.zatca.gov.sa) with your ERAD credentials.

02

Navigate to the Onboard New Solution Unit/Device tile and click Generate OTP code (you can request up to 100 codes at once).

03

Copy or download the OTP(s), valid for one hour.

04

Enter the OTP into the dialog below to validate and retrieve your CSID.

OTP Input

Secure CSID certificate credentials.

INSTANT ZATCA REPORTING

Submit an Invoice to ZATCA

On a Posted invoice form, click the Submit to ZATCA button to transmit your data immediately.

Submit to ZATCA Action

Instant Compliance Integration

BULK ZATCA SUBMISSION

Bulk Submission of Invoices

Optimize your administrative tasks. Simply select multiple invoices from the List View and trigger the Submit to ZATCA action to synchronize your records in bulk.

ZATCA Bulk Action Interface
Seamless Batch Processing

Track e-invoice compliance status

Invoice List: E-Invoice Status

Real-time visibility into your compliance workflow. Instantly track status tags directly from your list view:

NOT SENT SENT CLEARED REPORTED
ZATCA E-Invoice Status Dashboard

ZATCA Integration Column View

Audit Readiness

Submission Confirmation & Logs

After successful submission, view the confirmation note and audit trail in the chatter:

Chatter Message Confirming Invoice Submission to ZATCA

ZATCA Integration Column View

Configure ZATCA API settings

ZATCA API Integration and Submission Mode Settings

In the Accounting settings, configure how Odoo communicates with ZATCA's e-invoicing API. This setting is crucial for ensuring proper invoice submission.

Sandbox

This is ZATCA's test environment, ideal for trial runs and development. It simulates the submission process without legal consequences, so you can safely test the onboarding steps here.

Pre-Production

A staging environment for advanced testing, closer to the real ZATCA system and used before going live. It is still safe to test here without submitting real invoices.

Production

The live environment where invoices are legally submitted to ZATCA. Once set to Production, you cannot revert to Sandbox or Pre-Production. Be cautious: any invoice submitted in Production mode is legally binding and subject to audit, fines, and penalties if not compliant.

Odoo API Mode Configuration Screenshot

Manage API submission settings

Important Warning:
Once you change the submission mode to Production, you cannot change it anymore. Be very careful, as any invoice submitted to ZATCA in Production mode will be accounted for and might lead to fines & penalties.

This warning is to ensure you fully understand the responsibility of switching to Production mode. Any mistakes (such as sending test data or invalid invoices in Production) can have serious consequences.

Recommended Practice

1. Always start in Sandbox mode. Complete the onboarding and test the end-to-end invoice flow in this environment.
2. Only switch to Production mode once you are confident everything is working smoothly and fully compliant.
3. Before going live, triple-check all configurations (company information, invoice format, QR codes, ZATCA certificates, etc.).

Streamlined compliance automation workflow

How It Works

01. Onboarding

Upload your CSR to ZATCA to receive a Compliance CSID. Use this to automatically obtain your Production CSID for live transactions.

02. Invoice Generation

Create standard or simplified invoices in Odoo. Our system automatically attaches the compliant QR code and barcode while validating all data against ZATCA rules.

03. Submission to ZATCA

Send invoices manually or set them to automatic sync. Any submission errors are instantly logged, notifying you for immediate corrective action.

04. Reporting & Archival

Monitor real-time status updates for all invoices. Confirmation receipts and historical logs are securely archived, ensuring you are audit-ready at all times.

Invoice Submission Screenshot

Technical documents

API & Technical References

Portal Access
Fatoora Portal Login
https://login.gazt.gov.sa
Testing Environment
Sandbox Developer Portal
gw-fatoora.zatca.gov.sa/developer-portal
Pre-Production
Simulation API Endpoint
gw-fatoora.zatca.gov.sa/simulation
Live Environment
Production API Endpoint
gw-fatoora.zatca.gov.sa/core

Essential user documentation guides

Useful Resources

Fatoora Portal User Manual
Official English Guidelines (PDF Format) 		VIEW ->
Detailed Technical Guidelines
Implementation specs for Phase 2 (PDF) 		VIEW ->
Security Implementation Standards
Compliance and Security Standards (PDF) 		VIEW ->
E-Invoice Data Dictionary
Technical Data Mapping (Excel Download) 		OPEN ->

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.