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
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.