Illustrative previewA custom-built Shopify integration that makes Saudi stores ZATCA-compliant for both Phase 1 (Generation) and
Phase 2 (Integration), with QR-coded bilingual tax invoices, cryptographic stamps, and Fatoora clearance. Built, installed, and supported by ECOSIRE.
What is E-Invoicing Compliance: KSA ZATCA?
A custom-built Shopify integration for Saudi stores covering ZATCA Phase 1 (Generation) and Phase 2 (Integration): bilingual tax invoices with the ZATCA QR code, cryptographic stamps, and FATOORA clearance and reporting. Built to order by ECOSIRE for Shopify (build-to-order) — indicative price from $999.00 USD; request a quote for a scoped proposal.
Key Features
Built to order, done for you
No DIY setup — a working app, built, installed and supported by ECOSIRE.
- 1
You order
Start with a one-time build price. We scope it with you at kickoff.
- 2
We build & install
ECOSIRE builds, configures and installs it on your Shopify.
- 3
Go live + support
You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.
About this Product
E-Invoicing Compliance: KSA ZATCA makes your Saudi Shopify store compliant with the Zakat, Tax and Customs Authority (ZATCA) e-invoicing mandate — both Phase 1 (Generation) and Phase 2 (Integration). This is not an instant App Store install. ECOSIRE builds the integration to your store's tax setup, VAT registration, and theme, then installs and supports it for you.
We connect to your store through the Shopify Admin GraphQL API and an OAuth-authenticated embedded app. An orders/create and orders/paid webhook fires the invoicing pipeline: each order is converted into a ZATCA-compliant XML invoice (UBL 2.1), assigned a UUID, chained via previous-invoice hash (PIH), cryptographically stamped, and rendered as a bilingual Arabic/English tax invoice carrying the TLV Base64 QR code.
For Phase 2, we register your EGS unit with Fatoora, manage the Compliance & CSID onboarding, and route simplified invoices (B2C) through the reporting API and standard invoices (B2B) through the clearance API in near real time. Clearance status, QR, and stamp are written back to Shopify order metafields so your team sees compliance state inside Admin.
We also build automated VAT reconciliation against your Shopify payouts and tax lines, plus XML and PDF/A-3 archival export (PDF/A-3 embeds the source XML) for your record-keeping obligations.
Because every store differs — VAT group structure, B2B vs B2C mix, multi-location, credit/debit notes — we scope and configure this per merchant. You get a clear lead time, a working compliant pipeline, and a real engineer on the other end. Honest, build-to-order delivery — no fake App Store link.
What you get
- A custom-built, OAuth-installed Shopify embedded app connected to your store and your ZATCA EGS unit
- Completed Phase 2 onboarding: Compliance CSID and Production CSID registered with Fatoora for your business
- Live clearance (B2B) and reporting (B2C) pipeline validated against ZATCA's compliance simulation environment before cutover
- Bilingual Arabic/English invoice template configured with your VAT number, branding, and required ZATCA fields
- Order metafield write-back so clearance status, QR, and UUID appear inside Shopify Admin
- VAT reconciliation report plus XML and PDF/A-3 archival export configured for your retention needs
- A short admin runbook covering CSID renewal, reprocessing a failed invoice, and reading the compliance status
- A handover walkthrough call and an agreed support window for issues and ZATCA spec updates
Who this is for
Saudi D2C / retail merchant on Shopify
A KSA-based store owner who is VAT-registered and now falls inside a ZATCA Phase 2 integration wave. They need compliant cleared/reported invoices without leaving Shopify or hiring an in-house compliance engineer.
Finance / accounting lead
The person responsible for VAT filing and audit readiness. They care about correct 15% VAT, sequential numbering, PDF/A-3 archival, and reconciliation against Shopify payouts — and want compliance status visible without exporting CSVs.
B2B wholesale seller in KSA
A merchant issuing standard tax invoices to registered businesses who must obtain ZATCA clearance before the invoice is legally valid, including correct buyer VAT details and credit/debit note linkage.
How E-Invoicing Compliance: KSA ZATCA Compares
| Criterion | ECOSIRE | Custom Build | Competitor | Shopify Native |
|---|---|---|---|---|
| ZATCA Phase 2 clearance (B2B) + reporting (B2C) via Fatoora APIs | Included | Partial support | Partial support | Not included |
| Cryptographic stamp, UUID, and previous-invoice-hash (PIH) chaining | Included | Partial support | Partial support | Not included |
| Bilingual Arabic/English ZATCA-compliant tax invoice with TLV QR | Included | Partial support | Included | Not included |
| Tailored to your VAT structure, B2B/B2C mix, and theme | Included | Included | Not included | Not included |
| Automated VAT reconciliation against Shopify payouts | Included | Partial support | Partial support | Not included |
| XML + PDF/A-3 archival export with embedded source XML | Included | Partial support | Partial support | Not included |
| Instant self-serve install with no engineer involved | Not included | Not included | Included | Included |
| CSID onboarding/renewal and spec-update maintenance handled for you | Included | Not included | Partial support | Not included |
Frequently Asked Questions about E-Invoicing Compliance: KSA ZATCA
Is this an instant Shopify App Store download?
No. This is build-to-order. ECOSIRE builds the integration around your specific VAT setup, B2B/B2C mix, and theme, then installs it on your store via an OAuth embedded app and onboards your ZATCA EGS unit. There is no public App Store listing to click-install — a real engineer configures and ships it for you.
How long does delivery take?
Typical delivery is about one working week from kickoff. Phase 1 (QR + bilingual invoice generation) is usually live first, then Phase 2 clearance/reporting once your Compliance and Production CSIDs are issued by Fatoora and validated against ZATCA's simulation environment. Timeline depends on how quickly we receive your VAT registration details and EGS access, and on the complexity of your B2B/credit-note flows.
What ongoing support and updates do I get?
Every build includes a handover walkthrough and an agreed support window. ZATCA periodically updates its specification and renews CSIDs; we handle CSID renewal and spec-conformance updates during your support window. Extended maintenance and SLA options are available so your clearance pipeline keeps passing validation after go-live.
Does it handle both B2B clearance and B2C reporting?
Yes. Standard tax invoices (B2B) are routed through ZATCA's clearance API and must be cleared before issue; simplified invoices (B2C) are stamped, QR-coded, and reported to ZATCA within the required window. We also link credit and debit notes back to the original invoice.
Will the compliance status show inside Shopify?
Yes. We write clearance/reporting status, the invoice UUID, the cryptographic stamp, and the QR back into Shopify order metafields, so your team can see whether each order's invoice was cleared or reported directly from the Admin order page. Failed submissions are queued and retried, and surfaced for reprocessing.
Related Modules
Easypaisa Payment Gateway (Pakistan)
A build-to-order Shopify integration that adds Easypaisa mobile-wallet, card, and over-the-counter (OTC) payments to your checkout, with PKR pricing and automatic order confirmation. Designed, installed, and supported by ECOSIRE.
Egypt ETA E-Invoicing Connector
A build-to-order Shopify app that submits Egyptian Tax Authority (ETA) compliant e-invoices and e-receipts from your store in real time, with full UUID, signature, and rejection handling.
E-Invoicing Compliance: UAE FTA
A custom-built Shopify app that generates UAE PINT-AE / FTA-aligned e-invoices and VAT-compliant bilingual tax invoices, with TRN validation, reverse-charge, designated-zone and zero-rate handling, and VAT return data export. Built, installed and supported by ECOSIRE.
Email Marketing & Automation Platform
Ecommerce-grade email automation built into your Shopify store — pre-built welcome, cart, post-purchase and win-back flows with behavioral segmentation and product-data personalization. Built, installed and supported by ECOSIRE for a flat one-time fee.
E-Invoicing Compliance: KSA ZATCA
A custom-built Shopify integration that makes Saudi stores ZATCA-compliant for both Phase 1 (Generation) and Phase 2 (Integration), with QR-coded bilingual tax invoices, cryptographic stamps, and Fatoora clearance. Built, installed, and supported by ECOSIRE.
- ZATCA Phase 1 (Generation): compliant simplified and standard tax invoices with the mandatory TLV Base64 QR code, generated automatically on order paid
- ZATCA Phase 2 (Integration): Fatoora clearance for B2B standard invoices and reporting for B2C simplified invoices via the official APIs
- Cryptographic stamp, invoice UUID, and previous-invoice-hash (PIH) chaining for tamper-evident, sequentially linked invoices
- UBL 2.1 XML invoice generation conformant to the ZATCA e-invoice data dictionary and XSD validation
ZATCA e-invoicing for a Shopify store: scope the integration
This is a custom-built integration scoped to your store: Shopify orders become ZATCA-compliant tax invoices for a VAT-registered Saudi seller. Decide first which orders need Standard (B2B) invoices and which need Simplified (B2C) ones, because ZATCA treats the two differently.
What it covers
- An embedded Shopify app connected through the Admin GraphQL API, where paid and created orders start the invoicing pipeline.
- UBL 2.1 XML for each order with a UUID, the previous-invoice hash chain and the cryptographic stamp, rendered as a bilingual Arabic and English tax invoice with the TLV QR code.
- EGS registration and CSID onboarding with FATOORA, reporting of Simplified (B2C) invoices and clearance of Standard (B2B) invoices, with the status written back to order metafields.
- VAT reconciliation against Shopify payouts and tax lines, and XML and PDF/A-3 archive export.
What it does not cover
- A Shopify App Store install: the integration is built and configured per merchant.
- Shopify POS receipts: a separate scope, linked below.
- Your ZATCA registration and wave: you onboard with your own FATOORA portal account, and ZATCA assigns your wave.
Key facts, with sources
- Phase 1 (Generation) has applied since 4 December 2021 to all taxpayers except non-resident taxpayers: tax invoices and notes must be generated and stored with a compliant electronic solution. ZATCA: E-invoicing roll-out phases
- Phase 2 (Integration) has been enforced since 1 January 2023, in waves by taxpayer group. ZATCA notifies each group of its integration date at least six months in advance, so your own notification sets your date. ZATCA: E-invoicing roll-out phases
- Standard tax invoices (B2B) follow the clearance model: the seller submits them for clearance before providing them to the buyer, and they are valid only once ZATCA has cleared them. Simplified tax invoices (B2C) follow the reporting model: the seller submits them within 24 hours of the transaction being completed. ZATCA: E-invoicing Detailed Technical Guidelines (v2), sections 1.1, 4.3.1 and 4.3.2
Sources checked on .
Bring these details to the scope review
- Share your Shopify plan, markets and currencies, locations, and whether you sell to VAT-registered businesses, since those orders need Standard invoices and the buyer’s VAT number.
- Confirm the seller data for your VAT registration or VAT group: VAT number, Commercial Registration number, registered address and Arabic legal name. Never send store or portal credentials in an inquiry.
- Prepare order volumes, refund and return patterns, and representative orders with discounts, shipping and mixed tax rates, so credit notes and edge cases are scoped.
Agree what acceptance will prove
Agree simulation-environment tests before production: a reported Simplified order, a cleared Standard order, a refund that issues a credit note, an order webhook delivered twice without a duplicate invoice, and reconciliation of invoices against Shopify payouts and tax lines.
Is this an app we install from the Shopify App Store?
No. This listing is a build-to-order integration. A scoped proposal confirms the store setup, document types and acceptance tests before work begins.
Does it cover both Phase 1 and Phase 2?
The listing covers both: Phase 1 generation of compliant QR-coded tax invoices and Phase 2 integration with FATOORA for clearance and reporting. The proposal confirms which document types your store needs.
What affects the price?
The listed amount is an indicative starting point. VAT group structure, B2B and B2C mix, locations, credit and debit notes, archive needs and support requirements change the scope, and the proposal itemises them.