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

A build-to-order Magento 2 / Adobe Commerce extension that connects your Saudi store to the ZATCA Fatoora

platform for real-time B2B clearance, B2C reporting, UBL 2.1 e-invoices, cryptographic stamping and compliant QR codes. Built, installed and supported by ECOSIRE.

ZATCA Phase 2 E-Invoicing (Fatoora) for Magento 2 کیا ہے؟

A build-to-order Magento 2 / Adobe Commerce extension that connects your Saudi store to the ZATCA Fatoora platform for real-time B2B clearance, B2C reporting, UBL 2.1 e-invoices, cryptographic stamping and compliant QR codes. Built, installed and supported by ECOSIRE. 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.

اہم خصوصیات

ZATCA Fatoora onboarding handled for you: CSR generation, compliance CSID then production PCSID, with credentials stored securely per environment
Real-time B2B invoice clearance and B2C reporting submitted to the Fatoora APIs at invoice creation, with status, UUID and clearance/reporting response persisted to the order
UBL 2.1 XML generation with ECDSA cryptographic stamp, invoice hash and previous-invoice-hash (PIH) chaining built in a dedicated service-contract layer
TLV-encoded Base64 QR code (seller name, VAT number, timestamp, totals, XML hash, signature) rendered on the PDF invoice and the transactional email
Bilingual Arabic / English tax invoice and simplified-invoice PDF templates that meet ZATCA layout requirements
Implemented as a clean Magento 2 module under app/code with di.xml wiring, an observer on sales_order_invoice_save_after, and plugins/interceptors rather than core overrides
Admin ACL-gated configuration and a clearance/reporting status grid so finance staff can see, filter and re-submit invoices from the Magento admin
Cron-based automatic retry and a queue for invoices that hit transient Fatoora API timeouts or 5xx responses, so no invoice is silently lost
Credit-memo / refund e-invoice support (debit and credit notes) reported back to ZATCA with the correct invoice type codes
Multi-store / multi-store-view aware: separate VAT registrations and CSIDs can be scoped per website or store view
Service contracts and a REST/GraphQL surface so an external ERP or headless frontend can read clearance status programmatically
Works on both Magento Open Source and Adobe Commerce, and is tested against the ZATCA sandbox before any production submission

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

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

  1. 1

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

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

  2. 2

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

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

  3. 3

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

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

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

ZATCA Phase 2 (Fatoora) is not an optional plugin you toggle on — it is a cryptographic integration with Saudi Arabia's tax authority that has to work correctly on the very first invoice. This extension makes a Saudi Magento 2 / Adobe Commerce store fully compliant with the ZATCA e-invoicing mandate, handling real-time B2B clearance and B2C reporting directly from the order and invoice lifecycle.

ECOSIRE builds this as a proper Magento 2 module under app/code/Ecosire/ZatcaPhase2, wired into the platform the right way: an observer on sales_order_invoice_save_after triggers generation, service contracts expose a clean ZatcaInvoiceManagementInterface, and a di.xml binds the Fatoora API client, CSR/onboarding service and UBL builder. We generate UBL 2.1 XML with the required cryptographic stamp, invoice hash and previous-hash chaining (PIH), submit to the Fatoora compliance and core APIs over your CSID/PCSID, and persist the cleared/reported status, UUID, and QR payload back to the invoice.

The TLV-encoded, Base64 QR code is rendered on both the PDF invoice (via a sales_pdf plugin) and the transactional email, and invoices print as bilingual Arabic/English tax documents. Onboarding — CSR generation, compliance CSID, then production PCSID — is handled during delivery so you are not left decoding ZATCA's sandbox by yourself.

This is build-to-order, not an instant Marketplace download. ECOSIRE configures it to your VAT registration, Magento Open Source or Adobe Commerce edition, store-view scopes and PDF/email templates, installs it on your environment, and runs end-to-end tests against the ZATCA sandbox before go-live. You get a maintained module, admin ACL-gated controls, cron-based retry for transient API failures, and a real engineer on the other end when the regulation shifts.

What you get

  • A custom Magento 2 module (Ecosire_ZatcaPhase2) installed under app/code on your environment, composer-installable and version-pinned
  • Completed ZATCA Fatoora onboarding: CSR generated, compliance CSID obtained, production PCSID activated against your VAT registration
  • Bilingual Arabic/English PDF invoice and simplified-invoice templates with compliant TLV QR code, applied to your store's print and email flows
  • End-to-end test run against the ZATCA sandbox plus a go-live verification of the first real cleared B2B and reported B2C invoice
  • Admin configuration, ACL roles and a clearance-status grid configured for your finance team, with cron retry enabled
  • Technical handover document covering module structure, di.xml wiring, configuration paths, retry behaviour and a runbook for credential renewal

Who this is for

Saudi Magento store owner under the ZATCA mandate

A KSA-based ecommerce merchant whose VAT registration now requires Phase 2 integration. They need invoices cleared and reported correctly without becoming a tax-protocol expert, and they want one accountable party to own onboarding, install and go-live.

ERP / Magento integrator delivering for a client

An agency or systems integrator building a Saudi store who needs a reliable Phase 2 component that plugs into the order/invoice lifecycle via proper service contracts and observers, with a documented module they can support after handover.

Finance / tax manager responsible for compliance

The person who answers to ZATCA. They need visibility into every invoice's clearance/reporting status from the admin, automatic retry for failed submissions, and credit-note handling, so a missed submission never turns into a penalty.

How ZATCA Phase 2 E-Invoicing (Fatoora) for Magento 2 Compares

CriterionECOSIRECustom BuildCompetitorMagento 2 نیٹو
Real-time B2B clearance and B2C reporting to Fatoora APIsIncludedPartial supportIncludedNot included
ZATCA onboarding done for you (CSR, compliance CSID, production PCSID)IncludedNot includedPartial supportNot included
UBL 2.1 XML with cryptographic stamp and previous-hash (PIH) chainingIncludedPartial supportIncludedNot included
Built, installed and gone-live on your specific environment by the vendorIncludedIncludedNot includedNot included
Bilingual Arabic/English templates tailored to your store's PDF and emailIncludedPartial supportPartial supportNot included
Cron retry queue and admin status grid for failed submissionsIncludedPartial supportPartial supportNot included
Direct engineer support when the ZATCA spec changesIncludedNot includedPartial supportNot included
Instant self-serve download with no engagement neededNot includedNot includedIncludedNot included

Frequently Asked Questions about ZATCA Phase 2 E-Invoicing (Fatoora)

How long until it's live on my store, and what's the delivery process?

Typical delivery is about one working week depending on your edition (Open Source vs Adobe Commerce), customizations to invoice templates and how quickly ZATCA onboarding credentials are obtained. The flow is: kickoff and access, module build and configuration to your VAT data, sandbox onboarding (CSR, compliance CSID, production PCSID), end-to-end testing against the ZATCA sandbox, then a supervised go-live where we verify the first real cleared B2B and reported B2C invoice. This is build-to-order — it is built and installed on your environment, not a one-click Marketplace download.

What ongoing support and updates are included after go-live?

ZATCA periodically updates the Fatoora specification, invoice type codes and certificate requirements. We provide a support window after launch and offer a maintenance arrangement that covers spec changes, certificate/CSID renewal, Magento version-compatibility updates and bug fixes. Because you receive the actual module source under app/code plus a handover runbook, your own team or integrator can also maintain it — you are not locked to a black box.

Does this work on Magento Open Source as well as Adobe Commerce?

Yes. The module is implemented with standard Magento 2 mechanisms — di.xml dependency injection, observers, plugins/interceptors and service contracts — that exist in both editions, so it runs on Magento Open Source and Adobe Commerce. We confirm your exact version during kickoff and pin the module to it. Adobe Commerce specifics like B2B company accounts or additional store-view scopes are accommodated during the build.

How does it handle the cryptographic stamp, hashing and the QR code?

Each invoice is rendered as UBL 2.1 XML, hashed, signed with your ZATCA certificate (ECDSA), and chained to the previous invoice via the previous-invoice-hash (PIH). The signed payload and totals are encoded into a TLV/Base64 QR code that is printed on the bilingual PDF invoice and embedded in the transactional email. For B2B the invoice is cleared in real time before issuance; for B2C it is reported within ZATCA's window. All responses, UUIDs and statuses are stored against the Magento invoice.

What happens if a submission to ZATCA fails or times out?

Submissions are wrapped so a transient Fatoora API timeout or 5xx never silently drops an invoice. Failed submissions are queued and retried automatically by a Magento cron job, and the clearance/reporting status grid in the admin lets finance staff see exactly which invoices are pending, failed or succeeded and re-submit manually if needed. Persistent failures are surfaced rather than hidden, so compliance gaps are caught quickly.

آرڈر پر تیار
Xero Accounting Connector for Magento 2
Magento 2

Xero Accounting Connector for Magento 2

A custom-built Magento 2 module that pushes your sales orders, invoices, credit memos, customers and products into Xero automatically, so your books stay current without manual re-keying.

From $999.00ابتدائی قیمت — آپ کے دائرۂ کار کے مطابق مقرر کی جائے گی
آرڈر پر تیار
3PL & Fulfillment Connector for Magento 2
قیمت کا تخمینہ طلب کریں

ZATCA Phase 2 E-Invoicing (Fatoora)

A build-to-order Magento 2 / Adobe Commerce extension that connects your Saudi store to the ZATCA Fatoora platform for real-time B2B clearance, B2C reporting, UBL 2.1 e-invoices, cryptographic stamping and compliant QR codes. Built, installed and supported by ECOSIRE.

  • ZATCA Fatoora onboarding handled for you: CSR generation, compliance CSID then production PCSID, with credentials stored securely per environment
  • Real-time B2B invoice clearance and B2C reporting submitted to the Fatoora APIs at invoice creation, with status, UUID and clearance/reporting response persisted to the order
  • UBL 2.1 XML generation with ECDSA cryptographic stamp, invoice hash and previous-invoice-hash (PIH) chaining built in a dedicated service-contract layer
  • TLV-encoded Base64 QR code (seller name, VAT number, timestamp, totals, XML hash, signature) rendered on the PDF invoice and the transactional email

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

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

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