Fatoora portal
Fatoora is ZATCA's e-invoicing platform: taxpayers generate OTPs there to onboard and renew devices, and it receives invoices through the API.
FATOORA is ZATCA's e-invoicing platform, at fatoora.zatca.gov.sa. ZATCA defines it as the portal that receives tax invoice, simplified invoice and note data from taxpayers' solutions, and where a taxpayer onboards units by generating, renewing or revoking a CSID and sees the list of onboarded solutions and devices.
The everyday developer use: the business owner logs in, chooses to onboard a new solution unit, and copies an OTP. The portal can generate up to 100 OTPs at once, each valid for one hour. The invoices themselves go to the API gateway at gw-fatoora.zatca.gov.sa, not to the website.
What goes wrong: a developer has no access to the customer's account and has to ask for the OTP, the step that most often delays an integration. Also, "Fatoora" names the portal, the platform and the API at once, so always ask which environment. The developer portal needs no taxpayer account.
On Matheel, a business owner without a developer opens an activation link on their phone, types their details and one OTP per device, and the devices are onboarded.
Example
https://gw-fatoora.zatca.gov.sa/e-invoicing/developer-portal
https://gw-fatoora.zatca.gov.sa/e-invoicing/simulation
https://gw-fatoora.zatca.gov.sa/e-invoicing/core
FAQ
What do I do in the Fatoora portal to connect my software?
Log in with the business account, generate an OTP per device under Onboard new solution unit, and give it to the software or developer to onboard the device.
Do I upload invoices to the Fatoora portal by hand?
No. In Phase 2 your system sends every invoice through the API: clearance for standard, reporting for simplified.
Related terms
- OTP (Fatoora portal one-time password)
- ZATCA environments (developer portal, simulation, production)
- CSID (Cryptographic Stamp Identifier)
- EGS (E-invoice Generation Solution unit)
Let Matheel handle this for you
Matheel signs the invoice, files it with ZATCA and keeps the counter and hash in one request, and returns the PDF with the QR.
Try Matheel, no signup Matheel API docs