E-Invoicing Compliance: KSA ZATCA

Temel Özellikler

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

Bilingual Arabic/English tax invoices with correct RTL layout, your VAT registration number, and seller/buyer fields

Automated 15% VAT reconciliation against Shopify order tax lines and payouts, with mismatch flagging

XML and PDF/A-3 export (source XML embedded in the PDF) for archival and audit retention

Credit note and debit note handling linked back to the original cleared/reported invoice

Clearance/reporting status, QR, and stamp written back to Shopify order metafields, visible in Admin

EGS unit onboarding: Compliance CSID and Production CSID generation and renewal handled for you

Triggered via Shopify Admin GraphQL API and orders/paid + refunds/create webhooks through an OAuth embedded app

Retry and dead-letter queue so a Fatoora timeout never silently drops an invoice

Sandbox dry-run against ZATCA's compliance simulation environment before going live on production CSID

Configurable invoice numbering and counter that satisfies ZATCA's sequential, non-resettable requirement

Siparişe özel, sizin için baştan sona

Kendiniz kurmanıza gerek yok — ECOSIRE tarafından geliştirilen, kurulan ve desteklenen çalışır bir uygulama.

Sipariş verirsiniz

Tek seferlik geliştirme fiyatıyla başlayın. Kapsamı başlangıçta sizinle birlikte belirleriz.

Geliştirir ve kurarız

ECOSIRE, Shopify ortamınızda geliştirir, yapılandırır ve kurar.

Yayına alma + destek

Yaklaşık 2–4 haftada yayına alırsınız; lansman sonrası bir destek süresi de dahildir.

Bu Ürün Hakkında

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.

Ne elde edeceksin

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

Bu kimin için

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.

E-Invoicing Compliance: KSA ZATCA Nasıl Karşılaştırılır

Kriter	ECOSIRE	Özel Yapı	Rakip
ZATCA Phase 2 clearance (B2B) + reporting (B2C) via Fatoora APIs	Dahil	Kısmi destek	Kısmi destek
Cryptographic stamp, UUID, and previous-invoice-hash (PIH) chaining	Dahil	Kısmi destek	Kısmi destek
Bilingual Arabic/English ZATCA-compliant tax invoice with TLV QR	Dahil	Kısmi destek	Dahil
Tailored to your VAT structure, B2B/B2C mix, and theme	Dahil	Dahil	Dahil değil
Automated VAT reconciliation against Shopify payouts	Dahil	Kısmi destek	Kısmi destek
XML + PDF/A-3 archival export with embedded source XML	Dahil	Kısmi destek	Kısmi destek
Instant self-serve install with no engineer involved	Dahil değil	Dahil değil	Dahil
CSID onboarding/renewal and spec-update maintenance handled for you	Dahil	Dahil değil	Kısmi destek

E-Invoicing Compliance: KSA ZATCA hakkında Sıkça Sorulan Sorular

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 2 to 4 weeks 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.