ElliboHelp Centre

ZATCA e-invoicing (Saudi Arabia)

Connect Ellibo to ZATCA (Fatoora) with your own certificate. Tax invoices are cleared and simplified invoices reported as you save them, with their QR code.

Businesses in Saudi Arabia must send each invoice to ZATCA (Phase 2 of e-invoicing). Ellibo does this straight from Accounting and Inventory, with your own device certificate. There is no middleman and nothing to pay on top of your plan (e-invoicing is part of the Standard plan and above).

What happens to each document

  • To a VAT-registered customer (the customer has a 15-digit VAT number): a tax invoice. It is sent to ZATCA to be cleared before you share it. ZATCA's cleared copy and its QR code are kept with the invoice.
  • To anyone else (a walk-in customer, a person): a simplified invoice, signed with its QR code and reported to ZATCA.
  • Credit notes go the same way, with the invoice they correct.
  • Each document is signed, numbered by the device's counter and chained to the previous one by its hash.

Once cleared or reported, a document can't be edited or cancelled: make a credit note to correct it.

Step 1: Your details

Open Settings › ZATCA e-invoicing (in Accounting or Inventory) and fill in:

  • your VAT number (15 digits, starting and ending with 3);
  • your business ID (usually the commercial registration number);
  • your short address: street, building number (4 digits), district, city and postal code (5 digits).

Click Save details.

Step 2: Try it out

Leave Where to send on Try it out (ZATCA developer portal) and click Connect to ZATCA. No code is needed. Ellibo makes your device key, runs ZATCA's six compliance checks (invoice, credit note and debit note, tax and simplified) and shows each result. Make a few invoices: nothing reaches your real ZATCA account.

Step 3: Go live

  1. Sign in to the Fatoora portal and choose Onboard new solution unit / device.
  2. Generate a one-time code (OTP). It works for one hour.
  3. In Ellibo, set Where to send to Live (Fatoora portal), Save details, type the code and click Connect to ZATCA.

From now on, Send each invoice and credit note as soon as it is saved sends them for you. The invoice shows Cleared or Reported, and its PDF prints the QR code.

A document says "Not sent" or "Rejected"

Open it: ZATCA's reason is shown on the ZATCA card. Fix it (often the customer's address: a tax invoice needs the street, building number, city and postal code), then click Send again.

Good to know

  • Simulation: to test against ZATCA's simulation portal, choose Simulation and use a code from that portal.
  • Certificates expire: the end date is on the settings page. Connect again before then (a new code from Fatoora).
  • Branches with their own VAT number need their own device; their documents aren't sent from this connection.
  • POS receipts aren't sent by this connection.
Still need help?Write to us and we'll walk you through it.
Contact support