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
- The store needs its own account on ZATCA’s Fatoora portal. Ironloom has no access to it and holds no certificate for you.
- In Settings, Store: the legal name and the 15-digit VAT number.
Connect
- Open Settings and the tile Saudi Arabia: ZATCA e-invoicing. It is shown only when the store’s country is Saudi Arabia.
- 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.
- Choose the ZATCA platform: Simulation (ZATCA's test platform for real stores) first. Production (real invoices) only after the simulation succeeded.
- In the Fatoora portal, create a one-time code for a new device.
- Choose Save and connect this till to ZATCA (needs a one-time code) and type the One-time code (OTP) from the Fatoora portal.
- 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
- Each sale and return gets a counter, a hash linked to the one before, a signature and the QR code, and is reported in the background.
- Without internet, invoices wait and are sent later. Send the waiting invoices now sends them at once; Show the last answers of the platform shows what ZATCA replied.
- A buyer with a VAT number gets a business tax invoice, which ZATCA must clear before it is handed over. The till asks for the buyer’s address once and tells you whether ZATCA cleared or refused it.
- Make a debit note for a receipt (an amount added afterwards) reports an amount added to a receipt later.
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.
For: Owner Accountant SA since version 1.0.12
Did this help?
Thank you. Your answer helps us improve the help.