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 $799.00 USD; request a quote for a scoped proposal.
商品詳細は英語で表示されます。翻訳は近日公開予定です。
イメージプレビュー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
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
ご注文
一回限りの構築料金から始めます。キックオフで一緒に範囲を決めます。
- 2
構築とインストール
ECOSIRE がお客様の Magento 2 上で構築・設定・インストールします。
- 3
本番稼働 + サポート
約2〜4週間で稼働し、リリース後のサポート期間が付きます。
この製品について
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.
得られるもの
- 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
これは誰のためのものですか
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.
ZATCA Phase 2 E-Invoicing (Fatoora) for Magento 2 の比較方法
| 基準 | エコシエール | カスタムビルド | 競合他社 | Magento 2 標準機能 |
|---|---|---|---|---|
| Real-time B2B clearance and B2C reporting to Fatoora APIs | 付属 | 部分的なサポート | 付属 | 含まれていない |
| ZATCA onboarding done for you (CSR, compliance CSID, production PCSID) | 付属 | 含まれていない | 部分的なサポート | 含まれていない |
| UBL 2.1 XML with cryptographic stamp and previous-hash (PIH) chaining | 付属 | 部分的なサポート | 付属 | 含まれていない |
| Built, installed and gone-live on your specific environment by the vendor | 付属 | 付属 | 含まれていない | 含まれていない |
| Bilingual Arabic/English templates tailored to your store's PDF and email | 付属 | 部分的なサポート | 部分的なサポート | 含まれていない |
| Cron retry queue and admin status grid for failed submissions | 付属 | 部分的なサポート | 部分的なサポート | 含まれていない |
| Direct engineer support when the ZATCA spec changes | 付属 | 含まれていない | 部分的なサポート | 含まれていない |
| Instant self-serve download with no engagement needed | 含まれていない | 含まれていない | 付属 | 含まれていない |
ZATCA Phase 2 E-Invoicing (Fatoora) for Magento 2 に関するよくある質問
How long until it's live on my store, and what's the delivery process?
Typical delivery is about 2 to 4 weeks 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.
関連モジュール
見積もりを依頼
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.
- 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