Skip to main content
Product details are displayed in English. Translations coming soon.
ZATCA Phase 2 E-Invoicing (KSA) — A build-to-order Magento 2 / Adobe Commerce extension that makes your store ZATCA Phase 2 ( — 1/1مثالی پیش منظر

A build-to-order Magento 2 / Adobe Commerce extension that makes your store ZATCA Phase 2 (Fatoora) compliant

— cryptographically signed, QR-coded UBL e-invoices, cleared and reported in real time. Built, installed, and supported by

ECOSIRE on your Magento install.

ZATCA Phase 2 E-Invoicing (KSA) کیا ہے؟

A build-to-order Magento 2 / Adobe Commerce extension that makes your store ZATCA Phase 2 (Fatoora) compliant — cryptographically signed, QR-coded UBL e-invoices, cleared and reported in real time. Built, installed, and supported by ECOSIRE on your Magento install. Built to order by ECOSIRE for Magento 2 / Adobe Commerce (build-to-order) — indicative price from $999.00 USD; request a quote for a scoped proposal.

اہم خصوصیات

UBL 2.1 XML generation for every Magento invoice, conformant to the ZATCA e-invoicing data dictionary and XSD (seller/buyer VAT, line items, tax subtotals, totals)
Standard (B2B) tax invoices submitted for clearance and Simplified (B2C) invoices submitted for reporting, with the correct invoice type code per transaction
ECDSA digital signature and cryptographic stamp using the production CSID, plus invoice hash (PIH) chaining and the incremental counter (ICV) maintained per Magento store/branch
ZATCA-compliant QR code (TLV, Base64) embedded on the invoice PDF and exposed via the order/invoice view
Fatoora platform integration: CSR generation, compliance CSID, production CSID onboarding, and live clearance/reporting API calls with response and warning capture
Credit note and debit note support mapped from Magento credit memos, with reason codes and reference to the original cleared invoice
Per-invoice compliance status tracking (cleared / reported / failed / pending) on a custom invoice attribute, surfaced in an admin grid
Cron-driven retry queue and Bulk/async-API support so clearance failures and ZATCA downtime do not block order workflow
Service contracts (Api interfaces) and REST/GraphQL endpoints for invoice status, so ERPs or headless storefronts can read compliance state
Admin ACL-gated Compliance dashboard with re-submit, re-print QR, view XML/signed document, and audit logging
Observers on sales_order_invoice_save_after and credit-memo events that auto-trigger document generation without manual steps
Multi-store-view aware: per-website seller identity, VAT number, branch (location) ID, and Arabic/English bilingual invoice fields
di.xml-based plugins/interceptors that decorate the native invoice PDF and sales emails with QR and signed-invoice metadata — no core file edits
Signed-document archival and configurable retention to meet ZATCA record-keeping obligations

آرڈر پر تیار، مکمل طور پر آپ کے لیے

خود سیٹ اپ کی ضرورت نہیں — ایک کام کرنے والی ایپ جو ECOSIRE بناتا، انسٹال اور سپورٹ کرتا ہے۔

  1. 1

    آپ آرڈر دیتے ہیں

    ایک بار کی تعمیر کی قیمت سے آغاز کریں۔ آغاز پر ہم آپ کے ساتھ مل کر دائرہ کار طے کرتے ہیں۔

  2. 2

    ہم بناتے اور انسٹال کرتے ہیں

    ECOSIRE اسے آپ کے Magento 2 پر بناتا، ترتیب دیتا اور انسٹال کرتا ہے۔

  3. 3

    لائیو + معاونت

    آپ تقریباً ایک کاروباری ہفتے میں لائیو ہو جاتے ہیں، گو لائیو کے بعد دو ہفتوں کی معاونت کے ساتھ۔ ہمارے فراہم کردہ کوڈ کی خرابیاں مفت درست کی جاتی ہیں۔

اس مصنوع کے بارے میں

ZATCA Phase 2 (the Integration Phase) is a hard mandate for VAT-registered Saudi merchants — and Magento 2 ships with nothing to satisfy it. The native invoice (Magento\Sales\Model\Order\Invoice) is a PDF and a database row; it has no UBL 2.1 XML, no cryptographic stamp, no compliant QR, and no connection to ZATCA's Fatoora platform. This extension closes that gap.

ECOSIRE builds and installs a dedicated module (Ecosire_ZatcaEInvoicing under app/code) directly on your Magento Open Source or Adobe Commerce instance. It generates a ZATCA-spec UBL 2.1 XML document for every invoice, applies the ECDSA digital signature and cryptographic stamp (CSID), embeds the TLV Base64 QR code, and submits the document to Fatoora — clearance for Standard (B2B) tax invoices and reporting for Simplified (B2C) invoices — handling the returned clearance/reporting status and warnings.

Implementation is real Magento engineering, not a theme tweak. An observer on sales_order_invoice_save_after queues each invoice; a cron job and a Bulk/async-aware service push it to Fatoora and persist the response on a custom EAV/flat extension of the invoice entity. Service contracts (Api/ interfaces) expose generation and status; plugins (interceptors) decorate the invoice PDF and order view; admin ACL gates a Compliance grid where staff see per-invoice status, ICV/PIH chain, QR, and credit-note (debit/credit) handling. Onboarding (CSR generation, compliance + production CSID via the Fatoora APIs) is done with you.

Because it is build-to-order, the module is tuned to your VAT registration, tax classes, store views, and seller details — then handed over with source, documentation, and a support window. This is not a one-click Adobe Commerce Marketplace download — it is delivered and stood up by our engineers with a stated lead time below.

What you get

  • A production-ready Magento 2 module (Ecosire_ZatcaEInvoicing) installed under app/code on your Magento Open Source or Adobe Commerce instance, with full source
  • Fatoora onboarding executed with you: CSR creation, compliance CSID, and production CSID generation against the live ZATCA platform
  • di.xml, events.xml, acl.xml, crontab.xml, db_schema.xml and config wiring documented for your team
  • Admin configuration of seller VAT registration, branch/location IDs, tax-class mapping, and store-view identities
  • End-to-end validation: sample Standard and Simplified invoices cleared/reported successfully in the ZATCA sandbox then production
  • Technical handover document plus a short admin runbook (re-submission, status meanings, credit-note flow)
  • A defined post-delivery support window for bug fixes and ZATCA spec-change patches

Who this is for

VAT-registered Saudi Magento merchant

An online retailer in KSA already past the ZATCA Phase 2 enforcement wave for its revenue band, needing Magento invoices to clear/report through Fatoora to avoid penalties and keep selling.

Finance / tax compliance lead

The person accountable for VAT filings who needs every B2B invoice cleared before issue and every B2C invoice reported within the window, with an auditable status trail and proper credit-note handling.

Magento agency or in-house developer

A technical owner who wants a clean module under app/code (no core hacks, proper service contracts, di.xml plugins, ACL) that they can maintain, rather than a fragile DIY signing/clearance script.

How ZATCA Phase 2 E-Invoicing (KSA) Compares

CriterionECOSIRECustom BuildCompetitorMagento 2 نیٹو
ZATCA-spec UBL 2.1 XML generated for every invoiceIncludedPartial supportIncludedNot included
Digital signature, cryptographic stamp (CSID) and PIH/ICV chainingIncludedPartial supportIncludedNot included
Live Fatoora clearance (B2B) and reporting (B2C) integrationIncludedPartial supportIncludedNot included
Compliant TLV/Base64 QR on invoiceIncludedPartial supportIncludedNot included
Credit/debit note handling mapped from Magento credit memosIncludedPartial supportPartial supportNot included
Built, installed and Fatoora-onboarded for you on your instanceIncludedPartial supportNot includedNot included
Tailored to your VAT setup, tax classes and multi-store identitiesIncludedIncludedPartial supportNot included
Instant self-service download with no engagementNot includedNot includedIncludedNot included
Direct support and ZATCA spec-change patches from the builderIncludedPartial supportPartial supportNot included

Frequently Asked Questions about ZATCA Phase 2 E-Invoicing

How long until my store is ZATCA Phase 2 compliant after I order?

Because this is build-to-order, typical delivery is around one working week from kickoff, depending on your Magento version (Open Source vs Adobe Commerce), customizations, tax configuration, and how quickly we can complete Fatoora onboarding with your ZATCA credentials. We confirm a firm timeline after a short scoping call. There is no instant Marketplace download — our engineers build, install, and validate the module on your instance.

What ongoing support and updates do I get?

Every build includes a post-delivery support window for bug fixes. ZATCA periodically revises the e-invoicing specification, XSD, and APIs; we ship spec-change patches and offer an ongoing maintenance arrangement so your clearance and reporting keep working as the platform evolves. Support is handled directly by ECOSIRE — the same team that built your module.

Does this work on both Magento Open Source and Adobe Commerce?

Yes. The module is standard Magento 2 architecture (module under app/code, di.xml, service contracts, observers, ACL) and runs on Magento Open Source and Adobe Commerce 2.4.x. On Adobe Commerce we can additionally leverage the Bulk/async (message queue) APIs for high-volume clearance. We confirm compatibility with your exact 2.4.x patch level during scoping.

What is the difference between clearance and reporting, and does this handle both?

Standard (B2B) tax invoices must be cleared by ZATCA before they are issued to the buyer — the module submits the signed UBL XML and receives the cleared document. Simplified (B2C) invoices are reported to Fatoora within 24 hours after issuance. This extension routes each Magento invoice to the correct flow automatically based on the invoice type and buyer details.

Do I need to give you my ZATCA production credentials, and is onboarding included?

Fatoora onboarding (CSR generation, compliance CSID, then production CSID) is part of the engagement and done together with you — you keep control of the credentials and the OTP from the ZATCA portal. We never invent or store credentials outside your environment. The cryptographic keys and signed-document archive live on your Magento server.

Can other systems read the compliance status of an invoice?

Yes. The module exposes service contracts plus REST and (optionally) GraphQL endpoints returning per-invoice status, QR, and the signed document reference, so your ERP, accounting system, or headless storefront can consume ZATCA compliance state programmatically.

آرڈر پر تیار
3PL & Fulfillment Connector for Magento 2
قیمت کا تخمینہ طلب کریں

ZATCA Phase 2 E-Invoicing

A build-to-order Magento 2 / Adobe Commerce extension that makes your store ZATCA Phase 2 (Fatoora) compliant — cryptographically signed, QR-coded UBL e-invoices, cleared and reported in real time. Built, installed, and supported by ECOSIRE on your Magento install.

  • UBL 2.1 XML generation for every Magento invoice, conformant to the ZATCA e-invoicing data dictionary and XSD (seller/buyer VAT, line items, tax subtotals, totals)
  • Standard (B2B) tax invoices submitted for clearance and Simplified (B2C) invoices submitted for reporting, with the correct invoice type code per transaction
  • ECDSA digital signature and cryptographic stamp using the production CSID, plus invoice hash (PIH) chaining and the incremental counter (ICV) maintained per Magento store/branch
  • ZATCA-compliant QR code (TLV, Base64) embedded on the invoice PDF and exposed via the order/invoice view

قیمت کا تخمینہ طلب کریں

ہمیں ZATCA Phase 2 E-Invoicing کے لیے اپنی ضروریات بتائیں اور ہم آپ کو قیمتیں، لائسنس کے اختیارات اور ایک مخصوص تجویز بھیجیں گے — عام طور پر ایک کاروباری دن میں۔

ابھی کوئی ادائیگی نہیں۔ یہ ہماری ٹیم کو قیمت کی درخواست بھیجتا ہے — ہم قیمت اور اگلے اقدامات کے ساتھ ای میل کے ذریعے رابطہ کریں گے۔