ZATCA E-Invoicing (Fatoora) for WooCommerce — KSA — Multichannel & PIM Tools Module for WooCommerce

主な機能

**ZATCA Phase-1 and Phase-2 compliant** invoice generation triggered automatically on WooCommerce order completion via `woocommerce_order_status_completed` and related hooks

**UBL 2.1 XML** invoice generation conforming to ZATCA's e-invoicing XML implementation standard, including standard (B2B) and simplified (B2C) invoice types

**PDF/A-3** human-readable invoice with the signed UBL XML embedded as an attachment, archival-grade and ZATCA-acceptable

**Cryptographic stamp** — XML digital signature plus the invoice hash chain (PIH/previous-invoice-hash) ZATCA requires for Phase 2

**TLV-encoded QR code** (Base64) carrying seller name, VAT number, timestamp, invoice total, VAT amount and the cryptographic stamp, rendered on PDF and order screens

**Fatoora portal API integration** — clearance of standard tax invoices and reporting of simplified invoices, with ZATCA's returned status (cleared/reported/warning/error) saved to the order

**CSID onboarding & EGS device registration** — compliance CSID then production CSID generation handled with you during installation

**HPOS-aware** — works with WooCommerce High-Performance Order Storage (custom order tables) as well as legacy post-based orders

**WP-Cron retry queue** for transient Fatoora API failures, so a portal timeout never silently drops a required invoice

**wp-admin settings panel** for VAT registration number, seller identity, certificate management, environment (sandbox/simulation/production) and per-order-status triggers

**WPML / multisite** compatible bilingual (Arabic / English) invoice layouts with correct RTL rendering

Compliance **audit log** of every submission, response and hash, exportable for ZATCA inspection

Reusable **WordPress hooks/filters** so your developers can extend field mapping (e.g. custom buyer VAT capture at checkout) without forking the plugin

受注生産、すべておまかせ

自分での設定は不要 — ECOSIRE が構築・インストール・サポートする実働アプリです。

ご注文

一回限りの構築料金から始めます。キックオフで一緒に範囲を決めます。

構築とインストール

ECOSIRE がお客様の WooCommerce 上で構築・設定・インストールします。

本番稼働 + サポート

約2〜4週間で稼働し、リリース後のサポート期間が付きます。

この製品について

This is not a one-click download. It is a custom WooCommerce plugin that ECOSIRE builds, installs and configures on your own WordPress site, tailored to your tax setup, theme and hosting — then supports after go-live.

Saudi merchants on WooCommerce are legally required to comply with ZATCA (Fatoora) e-invoicing. WooCommerce core has no concept of a ZATCA-compliant UBL 2.1 XML invoice, a cryptographic stamp, a TLV-encoded QR code, or CSID onboarding — so most stores end up exporting orders and re-keying them into a separate portal. This plugin closes that gap inside WordPress.

We hook into WooCommerce order lifecycle events (woocommerce_order_status_completed, woocommerce_new_order) so that when an order is finalised the plugin generates a ZATCA Phase-1 and Phase-2 compliant invoice: a signed UBL 2.1 XML document and a human-readable PDF/A-3 with the XML embedded, stamped with your cryptographic signature and a Base64 TLV QR code (seller name, VAT number, timestamp, totals, VAT amount, hash). For Phase 2 (Integration), the plugin calls the Fatoora portal APIs to perform clearance of standard tax invoices and reporting of simplified invoices, stores ZATCA's returned status against the order, and retries failures via WP-Cron.

The build is HPOS-aware (custom order tables), reads VAT registration and seller identity from wp-admin settings, supports WPML/multisite Arabic-English layouts, and stores credentials and certificates securely. CSID onboarding (compliance CSID then production CSID) and device/EGS registration are handled during installation with you.

You get a working compliance pipeline on your store, source code you own, and a named engineer for onboarding and post-launch support. Honest lead time applies — see FAQ.

得られるもの

Custom-built ZATCA e-invoicing plugin **installed and activated on your WordPress/WooCommerce site** by an ECOSIRE engineer

Full **CSID onboarding** (compliance + production) and EGS device/unit registration completed with you against the Fatoora portal

Configured **wp-admin settings** — VAT number, seller details, certificates, environment and order-status triggers wired to your tax setup

**Sandbox/simulation validation** run plus a verified live clearance/reporting submission before sign-off

**Source code you own**, plus a short technical handover document covering hooks, filters and the settings panel

**Post-launch support and compatibility updates** for the agreed support window (WooCommerce/WordPress version bumps and ZATCA spec revisions)

これは誰のためのものですか

Saudi WooCommerce store owner facing a ZATCA deadline

Runs a B2C/B2B store on WooCommerce and has received notice that their VAT bracket must integrate with Fatoora. Needs compliant invoices generated and cleared automatically, without migrating off WooCommerce or hiring a full-time developer.

Finance / tax manager at a KSA retailer

Owns VAT filing and audit readiness. Wants every order to produce a correct UBL 2.1 invoice with the right TLV QR and stamp, an audit trail of clearances and reports, and confidence that simplified vs standard invoices are handled correctly.

Agency or WordPress developer serving Saudi clients

Manages client WooCommerce sites and needs a maintainable, HPOS-compatible ZATCA solution with clean hooks and filters they can extend, rather than gluing together a brittle export-and-reupload workaround.

ZATCA E-Invoicing (Fatoora) for WooCommerce — KSA の比較方法

基準	エコシエール	カスタムビルド	競合他社
ZATCA Phase-2 compliant UBL 2.1 XML generated inside WooCommerce	付属	部分的なサポート	部分的なサポート
Cryptographic stamp + TLV-encoded QR code on the invoice	付属	部分的なサポート	部分的なサポート
Live Fatoora portal clearance & reporting API integration	付属	部分的なサポート	部分的なサポート
CSID onboarding & EGS device registration done for you	付属	部分的なサポート	含まれていない
HPOS (custom order tables) compatibility	付属	部分的なサポート	部分的なサポート
Installed, validated and supported on your own site after purchase	付属	部分的なサポート	含まれていない
You own the source code and can extend it via hooks/filters	付属	付属	含まれていない
Instant self-serve marketplace download	含まれていない	含まれていない	付属

ZATCA E-Invoicing (Fatoora) for WooCommerce — KSA に関するよくある質問

How long until it's live on my store? (delivery / lead time)

This is a build-to-order engagement, not an instant download. Typical lead time is around 2 to 4 weeks from kickoff, depending on your hosting access, whether your ZATCA/Fatoora onboarding (taxpayer portal access, OTP for CSID) is ready, and any custom invoice fields you need. We confirm a firm timeline after a short scoping call, then build, install and validate on your site before go-live.

What support and updates do I get after launch?

Every build includes a post-launch support window covering bug fixes, WooCommerce/WordPress version-compatibility updates and adjustments for ZATCA spec or Fatoora API changes during that period. You own the source code, so you are never locked in. Extended or ongoing support and a maintenance retainer are available if you want us to keep the integration current beyond the included window.

Do I need ZATCA / Fatoora onboarding before you start?

You need to be VAT-registered and have access to the ZATCA taxpayer (Fatoora) portal. We handle the technical CSID onboarding — generating the compliance CSID, validating against the simulation environment, then issuing the production CSID and registering your EGS unit. If you have not started portal onboarding yet, we guide you through it as part of the build.

Does this work with WooCommerce HPOS and my existing theme/plugins?

Yes. The plugin is built to be HPOS-aware (it reads and writes against WooCommerce's High-Performance Order Storage custom order tables as well as legacy post-based orders) and integrates via standard WooCommerce hooks, so it coexists with your theme, payment gateways and checkout customisations. We test against your actual stack during the build. WPML/multisite Arabic-English setups are supported.

How are simplified (B2C) versus standard (B2B) invoices handled?

ZATCA treats them differently: standard tax invoices must be cleared by Fatoora before issuance, while simplified invoices are reported within 24 hours. The plugin detects the invoice type from the order (e.g. whether a buyer VAT number is present), generates the correct UBL 2.1 structure, applies clearance or reporting accordingly, and stores ZATCA's response and the hash chain on the order for audit.

ZATCA E-Invoicing (Fatoora) for WooCommerce — KSA

A build-to-order WooCommerce plugin that makes your store generate ZATCA Phase-2 compliant e-invoices — UBL 2.1 XML, PDF/A-3, cryptographic stamp and TLV QR — and clears them through the Fatoora portal. Built, installed and supported by ECOSIRE on your own WordPress site.