Connecting your business to ZATCA, step by step
Updated 16 November 2026
Before your system can clear or report invoices, ZATCA has to recognise it. That is onboarding: you prove who you are with a one-time code from the Fatoora portal, and your system receives a cryptographic stamp identifier (CSID) it signs every invoice with.
Before you start
- Your VAT registration and CR details, exactly as registered.
- Your full national address: building number, street, district, city, postal code and additional number.
- Access to the Fatoora portal with your ZATCA e-services login.
The steps
- Log in to the Fatoora portal and generate an OTP for onboarding a new solution or device. It is short-lived, so have your system open first.
- Enter the OTP in your invoicing system. It creates a key pair and certificate request and receives a compliance CSID from ZATCA.
- The system runs ZATCA's compliance checks with sample standard and simplified invoices and notes.
- On passing, it receives the production CSID. From then on every invoice is stamped with it and cleared or reported.
Common problems
- The OTP expired — generate a new one and enter it straight away.
- Rejected invoices citing the seller address or identifiers — complete the national address and check the CR number matches.
- A customer's invoice will not clear — their VAT number or national address is missing or wrong.
Onboarding in Muhasabiya
Open ZATCA in the app, paste the OTP and Muhasabiya does the rest: the key, the request, the compliance checks and the production CSID. The screen shows each invoice's ZATCA status, so a rejection is visible the moment it happens, with the reason ZATCA gave.
Questions
Do I onboard again every year?
The certificate has a validity period and is renewed; you do not repeat the full setup to keep issuing invoices.
Can my accountant do the onboarding?
Anyone with access to your Fatoora portal account can generate the OTP; it is then entered in the invoicing system.