Fatoora portal

By Matheel, from ZATCA's specifications and SDK 3.4.8 · Updated

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

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