ZATCA E-Invoicing (Phase 2) for Magento 2 — Saudi Arabia — Multichannel & PIM Tools Module for Magento

Key Features

ZATCA-compliant standard tax invoices (B2B, clearance model) and simplified tax invoices (B2C, reporting model) generated as signed UBL 2.1 XML

ECDSA cryptographic stamp and digital signature applied using your CSID, with CSR generation and onboarding against the ZATCA compliance and production APIs

TLV-encoded, Base64 ZATCA QR code embedded on every invoice PDF and exposed for the B2C buyer

Real-time Fatoora clearance (standard invoices, pre-issue) and reporting (simplified invoices, within the 24h window) via the ZATCA Integration API

PIH (Previous Invoice Hash) chaining and ICV counter maintained per invoice so the cryptographic invoice chain is unbroken

Module delivered under app/code/Ecosire/ZatcaPhase2 with di.xml wiring, an observer on sales_order_invoice_save_after, and clean service contracts (no core hacks)

Admin grid with dedicated ACL resources showing per-invoice clearance/reporting status, ZATCA UUID, validation warnings, and one-click retry

Cron job that requeues failed or pending submissions and surfaces ZATCA API errors instead of silently dropping invoices

GraphQL and REST endpoints exposing e-invoice status for headless storefronts, ERP sync, and POS integrations

Sandbox-first rollout: full compliance simulation in the ZATCA developer portal before production CSID issuance and go-live

Multi-store / multi-website and multiple VAT-registration support, with correct seller details, branch info, and Arabic/English field handling

Works on both Magento Open Source and Adobe Commerce, B2B-aware, with credentials stored encrypted and configurable per store scope

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

You order

Start with a one-time build price. We scope it with you at kickoff.

We build & install

ECOSIRE builds, configures and installs it on your Magento 2.

Go live + support

You go live in about 2–4 weeks, with a post-launch support window.

About this Product

If you sell from Saudi Arabia on Magento 2 or Adobe Commerce, ZATCA's Phase 2 (Integration Phase) is not optional — once your business is in a notified wave, every standard (B2B) and simplified (B2C) tax invoice must be generated as a signed UBL 2.1 XML document, carry a cryptographic stamp, expose a TLV-encoded Base64 QR code, and be either cleared (standard invoices, pre-issue) or reported (simplified invoices, within 24h) through the Fatoora platform. Magento core has no concept of any of this.

This is a build-to-order engagement, not an instant Marketplace download. ECOSIRE builds a dedicated module under app/code/Ecosire/ZatcaPhase2, wires it into your invoicing flow via an observer on sales_order_invoice_save_after (plus service-contract APIs so it works for POS, ERP and headless flows), generates the compliant XML, applies the ECDSA cryptographic stamp against your CSID obtained from the ZATCA onboarding/compliance API, builds the QR, and calls the clearance/reporting endpoints — then stores the cleared/reported status, ZATCA UUID, and PIH (previous invoice hash) chain against each order.

We handle the full lifecycle on your server: CSR generation, sandbox compliance checks, production onboarding, an admin grid (with ACL) showing per-invoice clearance status and retry, cron-based requeue of failed submissions, and GraphQL/REST exposure of invoice status. It runs on Magento Open Source and Adobe Commerce (B2B, multi-store, multi-VAT-registration aware).

You get a tested, code-reviewed module, deployed to staging then production, with documentation and a support window. Because regulation and the Fatoora spec change, we offer ongoing maintenance so you stay compliant as ZATCA publishes new schema versions and validation rules.

What you get

Custom Magento 2 module (Ecosire_ZatcaPhase2) source code installed under app/code on your instance, with composer-compatible packaging

ZATCA onboarding completed: CSR generation, CSID issuance, and validated connection to the Fatoora sandbox and production environments

Deployment to your staging environment, end-to-end compliance testing, then promotion to production with go-live support

Admin configuration, ACL roles, and an operations runbook for monitoring clearance/reporting status and handling retries

Technical documentation covering architecture, configuration, the XML/QR/signing pipeline, and troubleshooting

A post-launch support window plus an optional maintenance plan for ZATCA spec and schema updates

Who this is for

Saudi Magento merchant in a notified ZATCA wave

A KSA-based store owner who has received (or expects) a ZATCA notification with an Integration-Phase go-live date and needs Magento producing compliant signed invoices before the deadline, without re-platforming.

Head of finance / tax compliance

Owns VAT correctness and audit risk. Needs every B2B invoice cleared before issuance and every B2C invoice reported within 24h, with a clear audit trail of ZATCA UUIDs, hashes, and validation results visible in the admin.

Magento technical lead or agency

Responsible for the codebase and uptime. Wants a clean app/code module with service contracts, observers, cron and ACL — not a core hack — that they can maintain, extend to their POS/ERP, and that survives Magento and Adobe Commerce upgrades.

How ZATCA E-Invoicing (Phase 2) for Magento 2 — Saudi Arabia Compares

Criterion	ECOSIRE	Custom Build	Competitor
ZATCA Phase-2 signed UBL 2.1 XML invoices (standard + simplified)	Included	Partial support	Included
Cryptographic stamp + CSID onboarding done for you on your server	Included	Partial support	Not included
Live Fatoora clearance & reporting wired into Magento invoicing flow	Included	Partial support	Partial support
Built, installed and supported on your own Magento instance	Included	Included	Not included
Tailored to your VAT registrations, multi-store and B2B setup	Included	Included	Partial support
Clean app/code module: DI, service contracts, observers, ACL, cron (no core hacks)	Included	Partial support	Partial support
Ongoing updates as ZATCA spec / schema changes	Included	Not included	Partial support
Instant self-service download / zero-cost to start	Not included	Not included	Included

Frequently Asked Questions about ZATCA E-Invoicing (Phase 2) for Magento 2 — Saudi Arabia

How long does delivery take, since this is built to order?

Typical delivery is about 3 to 5 weeks from kickoff, depending on your Magento version, customizations, and how many VAT registrations and store views are involved. We scope precisely up front: phase one is module build plus ZATCA sandbox compliance testing, phase two is production onboarding (CSID issuance) and go-live on your server. If you have an imminent notified deadline, tell us and we will prioritize and confirm a realistic date before you commit.

What ongoing support and updates do I get after go-live?

The build includes a post-launch support window for bug fixes and onboarding help. ZATCA periodically updates the Fatoora specification, XML schema, and validation rules, so we also offer a maintenance plan that keeps the module aligned with new ZATCA releases, covers Magento and Adobe Commerce version upgrades, and provides a support channel for clearance/reporting errors. You are never left running an outdated, non-compliant build.

Is this an instant download from the Adobe Commerce Marketplace?

No. This is a custom engagement: ECOSIRE builds the module specifically for your Magento instance and installs it under app/code on your server. There is no instant Marketplace purchase here — that approach can't perform your unique CSID onboarding, store configuration, and production go-live. We deliver the code, complete the ZATCA onboarding, deploy to staging then production, and support it.

Does it handle both B2B (standard) and B2C (simplified) invoices correctly?

Yes. Standard tax invoices (typically B2B) follow the clearance model — they are sent to Fatoora and cleared before being issued to the buyer. Simplified tax invoices (typically B2C, retail) follow the reporting model — issued immediately with the QR code, then reported to ZATCA within 24 hours. The module detects the invoice type, builds the correct UBL XML, applies the right flow, and maintains the PIH hash chain across both.

Will it work on my Adobe Commerce / Magento Open Source version and my existing customizations?

It runs on both Adobe Commerce and Magento Open Source. We build with dependency injection, service contracts, observers and plugins rather than core edits, so it coexists with your theme, B2B, multi-store setup and other extensions. During scoping we review your version and key customizations (custom invoice logic, ERP/POS integrations, headless storefront) and adapt the integration points accordingly.

ZATCA E-Invoicing (Phase 2) for Magento 2 — Saudi Arabia

A build-to-order Magento 2 / Adobe Commerce module that makes your store ZATCA Phase-2 (Integration Phase) compliant — signed XML e-invoices, cryptographic stamp, QR codes and live Fatoora clearance/reporting — built, installed and supported on your own Magento instance by ECOSIRE.