ZATCA E-Invoicing Connector (Saudi Arabia)

Key Features

Real-time ZATCA Phase 2 (Fatoora) integration — clearance for standard B2B tax invoices, reporting for simplified B2C invoices, triggered automatically on order payment via Shopify webhooks

Generates compliant UBL 2.1 XML invoices and applies the ECDSA cryptographic stamp using your ZATCA-issued CSID

TLV-encoded Base64 QR code on every invoice, carrying seller name, VAT number, timestamp, total, and VAT amount per ZATCA spec

Bilingual Arabic/English tax invoices with correct RTL layout, suitable for printing and PDF delivery

Full credit and debit note handling, wired to Shopify refund and order-edit webhooks so adjustments stay ZATCA-compliant

Automatic 15% Saudi VAT calculation, seller/buyer VAT number capture and validation, and B2B vs B2C invoice-type detection

Invoice counter (ICV) and previous-invoice-hash (PIH) chaining maintained exactly as ZATCA requires for an unbroken sequence

Cleared invoice XML, QR, and ZATCA response stored on each Shopify order via metafields for full audit traceability

Built against the Shopify Admin GraphQL API with OAuth-scoped access — no broad permissions, only what invoicing needs

Onboarding of your CSR/CSID through the Fatoora portal, including sandbox (simulation) validation before go-live

Resilient submission with retry and a dashboard for any orders that failed clearance, so nothing slips through uncompliant

Built, installed, configured, and supported by ECOSIRE — including post-launch updates when ZATCA revises the spec

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 Shopify.

Go live + support

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

About this Product

The ZATCA E-Invoicing Connector makes your Saudi Shopify store compliant with the ZATCA Phase 2 (Fatoora) Integration mandate without you touching a line of code. Every order triggers a real-time invoice that is cryptographically stamped, QR-coded, and cleared or reported against ZATCA's platform — exactly as the Integration Phase requires.

This is a build-to-order app: ECOSIRE engineers it to your store, your VAT registration, and your CSID, then installs and configures it for you. It is not an instant App Store download. After purchase, we onboard your ZATCA credentials (CSR/CSID via the Fatoora portal), map your product tax rates, and connect to your store through the Shopify Admin GraphQL API and order/refund webhooks.

When an order is paid, the app builds a UBL 2.1 XML invoice, applies the ECDSA cryptographic stamp, generates the TLV-encoded Base64 QR code, and submits it to ZATCA — clearance for standard B2B tax invoices and reporting for simplified B2C invoices. The cleared invoice (with QR) is stored against the Shopify order via metafields, so your team and your customers always see a compliant document.

Invoices are issued bilingually in Arabic and English, with full credit and debit note handling for refunds and adjustments — wired to Shopify's refund webhooks so corrections stay in sync. We handle the 15% VAT calculations, seller/buyer VAT number validation, and invoice counter/hash chaining ZATCA demands.

You get a system that is yours: hosted by you or by us, documented, and supported. Pricing is a one-time USD 499 build. No per-invoice tax on every sale, no opaque off-the-shelf black box — a connector engineered for your exact catalog, tax setup, and compliance obligations, with a human team behind it.

What you get

A custom Shopify app installed on your store, scoped via OAuth to the Admin GraphQL API and order/refund webhooks

ZATCA onboarding: CSR generation, CSID provisioning through the Fatoora portal, and sandbox simulation pass before production

Configured tax mapping (15% VAT), seller VAT/registration details, and B2B/B2C invoice-type rules for your catalog

Bilingual Arabic/English invoice template with cryptographic stamp and compliant QR code

Metafield schema storing cleared invoice XML, QR, ICV/PIH, and ZATCA responses on every order for audit

Admin documentation plus a handover walkthrough, and a defined support window for fixes and ZATCA spec updates

Who this is for

Saudi Shopify store owner facing the Fatoora deadline

A KSA merchant whose business has been notified by ZATCA of its Phase 2 integration wave and needs Shopify orders to clear/report compliantly before the deadline, without hiring an in-house developer.

Finance or VAT manager at a growing KSA retailer

Responsible for accurate 15% VAT, valid tax invoices, and clean audit trails. Needs cleared B2B invoices, simplified B2C invoices with QR, and correct credit/debit notes tied to every refund.

Agency or operations lead managing a Saudi client store

Handles Shopify for a Saudi brand and wants compliance handled by a specialist team — built, installed, and supported — rather than stitching together a generic app and praying it matches the latest ZATCA spec.

How ZATCA E-Invoicing Connector (Saudi Arabia) Compares

Criterion	ECOSIRE	Custom Build	Competitor
ZATCA Phase 2 clearance + reporting submission to Fatoora	Included	Partial support	Partial support
Cryptographic stamp (ECDSA/CSID) + compliant TLV QR code	Included	Partial support	Partial support
Built, installed, and configured to your store and VAT setup	Included	Included	Not included
Bilingual Arabic/English compliant tax invoices	Included	Partial support	Partial support
Credit/debit notes wired to Shopify refund webhooks	Included	Partial support	Partial support
Instant self-serve install from the Shopify App Store	Not included	Not included	Included
Ongoing maintenance as ZATCA revises the Fatoora spec	Included	Not included	Partial support
Predictable one-time cost (no per-invoice fees)	Included	Partial support	Not included

Frequently Asked Questions about ZATCA E-Invoicing Connector (Saudi Arabia)

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

After purchase, typical delivery is about 2 to 4 weeks depending on your ZATCA onboarding status and catalog complexity. Week 1 is discovery and CSR/CSID provisioning through the Fatoora portal, followed by build and sandbox (simulation) validation, then production go-live once ZATCA returns successful clearances. If your CSID is already issued, we can move faster. We confirm an exact timeline with you at kickoff — this is not an instant App Store install.

What ongoing support and updates are included?

A defined support window is included for bug fixes and configuration help after go-live. Because ZATCA periodically revises the Fatoora spec (schema changes, new validation rules), we offer continued maintenance so your connector stays compliant. We will tell you upfront what the included window covers and the terms for an extended support/maintenance plan — we do not leave you on an outdated integration.

Do I need to be onboarded with ZATCA before you build this?

Not necessarily — we guide you through it. We help generate the CSR, obtain your CSID via the Fatoora portal, and validate everything in ZATCA's sandbox before any live invoice is cleared. You will need an active Saudi VAT registration and access to your ZATCA taxpayer account; we handle the technical integration steps around it.

Does it handle both B2B and simplified B2C invoices?

Yes. Standard tax invoices (typically B2B, with buyer VAT details) go through ZATCA's clearance model — cleared before they are final. Simplified invoices (B2C retail) use the reporting model and carry the compliant QR code. The app detects the invoice type from the order and applies the correct flow automatically, including the required cryptographic stamp and ICV/PIH chaining.

What happens with refunds, returns, and corrections?

Refunds and order edits in Shopify fire webhooks that the connector listens to, generating ZATCA-compliant credit notes (for refunds) and debit notes (for upward adjustments). These reference the original invoice and are cleared or reported the same way, keeping your invoice sequence and VAT records correct and auditable.

Will this conflict with Shopify's built-in tax features?

No. Shopify natively calculates and displays VAT, but it does not generate ZATCA Phase 2 cleared e-invoices, cryptographic stamps, or compliant QR codes, and it does not submit anything to ZATCA. This connector adds that compliance layer on top of your existing tax setup, reading the order's tax data rather than replacing how you charge VAT.