IRONLOOM POS

Saudi Arabia: how do I connect the till to ZATCA (phase 2, Fatoora)?

For version 1.0.46 ยท 11/2026

Open Settings, Saudi Arabia: ZATCA e-invoicing, fill in the store's registration details, choose ZATCA's simulation platform, and connect with a one-time code from the store's own account on the Fatoora portal. Once connected, the till signs every sale and return and reports it in the background. This connection has not yet been accepted by ZATCA on a real account: test it on the simulation platform first.

Before you start

Connect

  1. Open Settings and the tile Saudi Arabia: ZATCA e-invoicing. It is shown only when the store's country is Saudi Arabia.
  2. Fill in: Commercial registration number (CRN), Branch name, Building number (4 digits), Street, District, City, Postal code (5 digits), Business category, and for items at 0 % VAT the tax category and reason.
  3. Choose the ZATCA platform: Simulation (ZATCA's test platform for real stores) first. Production (real invoices) only after the simulation succeeded.
  4. In the Fatoora portal, create a one-time code for a new device.
  5. Choose Save and connect this till to ZATCA (needs a one-time code) and type the One-time code (OTP) from the Fatoora portal.
  6. The till makes its certificate request, sends sample invoices and shows ZATCA's answer. On success: This till is connected to ZATCA. Every sale and return is now signed and reported.

If ZATCA does not accept the samples, the till says it is not connected and shows the answer. Send that text to support@ironloomtechnologies.com.

Day to day

The window says it plainly: The one-time code comes from your own account on ZATCA's Fatoora portal. Connect on the simulation platform first; go to production only after ZATCA accepted the samples there. Written from ZATCA's published rules: not yet accepted by ZATCA on a real connection.