ZATCA Integration module for ERPNext - by ERPGulf

ZATCA integration app for ERPNext — from ERPGulf

In Saudi Arabia, compliance is not optional. It is the foundation of trust between businesses, customers, and the government. With the launch of the ZATCA (Zakat, Tax, and Customs Authority) e-invoicing mandate, companies of all sizes must issue invoices electronically, validate them against ZATCA standards, and ensure accurate submission in real time.

This is where ERPGulf’s ZATCA Integration App for ERPNext makes the difference. Built specifically for Saudi businesses, the app bridges ERPNext’s flexibility with ZATCA’s strict e-invoicing rules, giving companies a simple, automated, and fully compliant solution.

Why ZATCA compliance matters

ZATCA’s program has two key phases:

• Phase 1 — Generation. Businesses must issue e-invoices in XML/UBL 2.1, include QR codes, and stop using handwritten invoices.

• Phase 2 — Integration. Invoices must be validated against ZATCA before being shared with customers. This involves cryptographic signatures, secure APIs, and real-time submission.

Non-compliance means penalties, disrupted operations, and reputational risk.

ERPNext in Saudi Arabia

ERPNext is a global open-source ERP trusted for accounting, sales, inventory, HR, and more. But by default it is not tailored for Saudi e-invoicing rules. Invoices from ERPNext alone cannot be sent to ZATCA.

That gap is exactly what ERPGulf’s ZATCA app closes — making ERPNext a Saudi-ready system without changing how users already work.

What the app does

The integration app extends ERPNext’s invoice flow with everything ZATCA requires:

• automatic UBL 2.1 XML generation

• secure QR codes on every invoice

• digital signatures with ZATCA-approved certificates

• background submission to ZATCA’s servers

• full status tracking and error handling in ERPNext

Users continue to issue invoices as usual. Compliance happens silently in the background.

Built for Phase 2

The app was engineered for ZATCA’s second phase, where real-time integration is mandatory.

• direct connectivity with ZATCA sandbox and production environments

• digital fingerprints stamped on every invoice

• ongoing updates as ZATCA requirements evolve

This makes the app future-proof.

Designed for Saudi businesses

ERPGulf developed the app locally, with the Saudi market in mind.

• bilingual invoice templates in Arabic and English

• support for both retail POS invoices and B2B transactions

• works on Frappe Cloud or self-hosted servers

• proven across retail, wholesale, trading, manufacturing, and services

How it works

1. User creates an invoice in ERPNext

2. The app validates and formats it

3. Cryptographic signatures and QR codes are applied

4. The invoice is submitted automatically to ZATCA

5. ERPNext records ZATCA’s approval or rejection

All of this takes seconds.

Benefits

• always compliant with ZATCA

• no manual uploads or double entry

• fewer errors, fewer rejections

• seamless inside ERPNext’s normal workflow

• scales from one store to hundreds of outlets

• already trusted by hundreds of Saudi companies

Real-world example

A retailer in Riyadh runs 20 cashier counters. Each sale generates an invoice. With ERPGulf’s ZATCA app, every invoice is signed, submitted, and approved in the background.

Customers receive QR-compliant receipts instantly. The retailer avoids fines, keeps checkout queues moving, and stays fully compliant without slowing operations.

Why ERPGulf

• open-source roots. Transparent and community-driven code

• local expertise. Built in Saudi, for Saudi businesses

• constant updates. Aligned with ZATCA’s evolving standards

• dedicated support. Onboarding, training, and troubleshooting from the ERPGulf team

Looking ahead

ZATCA continues to refine its systems. ERPGulf is committed to evolving the app in step with every change, ensuring clients never fall behind.

Full documentation here https://docs.claudion.com/Claudion-Docs/selfbilled

Training video here https://youtu.be/V3m8Px_lbSQ