Sign in Get started
Questions

ZATCA Phase 2 e‑invoicing questions, answered

Registration, the API, the portal and what happens when ZATCA says no. Search, or pick a topic.

Getting started with ZATCA e‑invoicing

What does this service do?

It connects you to ZATCA for Phase 2 e-invoicing. We register your device with ZATCA, sign each invoice, submit it and give you ZATCA's response. You can do this through our API from your own software, or by creating invoices in our portal.

Should I use the API or the portal?

Use the API if you already have billing software, a POS or an ERP that creates invoices. Use the portal if you have no invoicing system and want to create invoices in the browser. You can use both under one account.

Who needs ZATCA Phase 2?

ZATCA brings VAT-registered businesses in Saudi Arabia into Phase 2 in waves and notifies each group in advance. If ZATCA has told you that your integration date is coming, you need a system that can clear and report invoices.

Can I try it before going live?

Yes. Every account can register a sandbox device and send sample invoices at no charge. Nothing sent from the sandbox counts as a real tax document.

ZATCA device registration and OTP

What do I need to register a device?

Your VAT registration number, your company details as they appear on the commercial registration, and an OTP generated from your account on ZATCA's Fatoora portal. We do the rest.

Where do I get the OTP?

Sign in to ZATCA's Fatoora portal with your business account and choose to onboard a new solution or device. The portal shows a one-time code. It expires quickly, so generate it just before you register.

What is a device, and how many do I need?

ZATCA calls each system that issues invoices an EGS unit. Many businesses need one. If you have several branches or tills that issue invoices separately, register one for each.

Do I have to handle certificates or keys?

No. We create the key pair and the signing request, obtain the certificate (CSID) from ZATCA and store it for that device.

Can one account cover several companies or branches?

Yes. Each company and each device has its own registration and keys, managed under a single account. This suits software vendors serving many clients.

ZATCA e‑invoicing API

My software already creates invoices. What changes?

Very little. After your system saves an invoice, it sends the same details to our API and stores the response. Your invoice numbering, customers and reports stay where they are.

What format do I send?

Plain JSON. You do not build XML, compute hashes or generate the QR code. See the examples on the API page.

What do I get back?

The ZATCA status, the QR code data and the invoice hash. The signed XML is available from a separate call. Any warnings or errors from ZATCA are included exactly as issued.

How do I move from sandbox to production?

Register your real device with a fresh OTP and switch to your production API key. The requests and responses keep the same shape, so your code does not change.

ZATCA invoicing portal

Can I use the portal without any technical knowledge?

Yes. The portal is a complete invoicing screen. You register a device, fill in the invoice form and press Submit to ZATCA.

Can an individual or freelancer register?

Yes, as long as you have a VAT registration number with ZATCA. You register under that number and issue invoices from the portal.

How do I give the invoice to my customer?

The portal gives you the signed XML and the QR code data for each accepted invoice. Print the QR code on the invoice document you give your customer. The portal does not produce a PDF.

Invoices, clearance and reporting

What is the difference between clearance and reporting?

Standard tax invoices, issued to other businesses, are cleared: ZATCA approves them in real time before the buyer receives them. Simplified invoices, issued to consumers, are reported: you give the invoice to the customer first and it is sent to ZATCA within 24 hours.

You tell us the invoice type and we use the right process.

What happens if ZATCA rejects an invoice?

You get ZATCA's error codes and messages in the API response and in the portal. Correct the invoice and submit it again. Nothing is hidden or reworded.

What is a warning, and do I need to act on it?

A warning means ZATCA accepted the invoice but found something that should be corrected in future invoices. The invoice is valid. Fix the cause so later invoices are clean.

Can I issue credit and debit notes?

Yes. A note references the original invoice and is submitted the same way, through the API or the portal.

Can I edit or delete an invoice after it is cleared?

No. Once ZATCA has cleared or received an invoice it cannot be changed. To correct it, issue a credit or debit note against it.

Send your first invoice to the sandbox today.

Create an account, register a test device and watch ZATCA's response come back. Move to production when you are ready.