Shumoul E-Invoicing Framework — Developer Guide
The Shumoul E-Invoicing Framework provides ZATCA-compliant electronic invoicing for Saudi Arabia — UBL 2.1 invoice generation, digital signing, QR code encoding, and submission to ZATCA's Fatoora platform — for the Shumoul Cloud ERP platform.
Who it's for: Backend Developers · QA Engineers · Technical Partners
| Field | Value |
|---|---|
| Status | Production Ready |
| Version | Latest |
| Last Updated | 2026-07-06 |
| Maintained By | Shumoul Engineering |
| Documentation | Official Developer Guide |
| Source of Truth | Shumoul Platform Source Code |
See Chapter 1 — Overview for how this module is scoped and how it relates to the platform's other frameworks.
Chapters
- Overview
- Architecture
- Package Structure
- Runtime Flow
- Controllers & Endpoints
- Configuration
- Security
- Certificates
- Onboarding
- Invoice Lifecycle
- Technical Debt
- Known Limitations
- FAQ
- Troubleshooting
- References
- Tenant Setup Wizard — Frontend Integration Guide
Source of Truth
This guide is written directly against the platform's shipped source code and kept in sync with it. Engineers looking for the full audit trail behind it — discovery notes, verification passes, and fix history — can find it in Chapter 15 — References; open items are tracked openly in Chapter 11 — Technical Debt and Chapter 12 — Known Limitations rather than being silently resolved here.