POS integration · Accounting
Every sale a signed ZATCA e-invoice, reported or cleared
ZATCA e-invoicing POS integration in ArmPOS turns each sale into a signed tax invoice, sent to ZATCA’s Fatoora gateway. Simplified invoices are reported, and standard ones are cleared.
- Saudi Arabia
- Fatoora Phase 2
- Signed XML and QR code
- Built in
How a sale becomes a ZATCA e-invoice
- A sale is savedat the POS or in Sales
- UBL XML, signedwith your certificate and a QR code
- Sent to Fatoorareported, or cleared for a business
- Reported or Clearedon Documents sent to ZATCA
What ArmPOS does with ZATCA e-invoicing, step by step
- Onboarding makes a key and a signing request (CSR), then trades your Fatoora one-time code (OTP) for a compliance CSID
- ArmPOS sends ZATCA’s compliance checks with sample invoices, credit notes and debit notes, and once they pass gets your production CSID
- Each sale becomes a UBL 2.1 XML invoice with its own counter and the previous invoice’s hash, signed (XAdES) with a QR code
- A simplified invoice, such as every POS sale, is reported; a standard one, to a buyer with a VAT number, is cleared
- A cleared invoice comes back stamped by ZATCA with its own QR code, and XML downloads it
- A sale return goes as a credit note that names the sale it corrects
What goes to ZATCA, and what happens next
Once onboarding says Ready, with Send new invoices by themselves on, each new sale goes in the background.
- A POS sale is reportedA simplified tax invoice, sent to Fatoora once the sale is saved.
- A sale to a business is clearedA customer with a 15-digit VAT number, starting and ending with 3, gets a standard invoice, except at the POS.
- A sale return is a credit noteIt names the sale it corrects, and goes the same way.
- ZATCA refuses an invoiceMarked Failed with ZATCA’s messages, and your settings people are told. Try again rebuilds it with a new counter.
- ZATCA doesn’t answerMarked Failed. Try again sends the same signed invoice, unchanged.
- A sale edited or deleted laterNothing changes at ZATCA. Correct it with a sale return, which sends a credit note.
A sale made while the POS was offline is signed and sent once it reaches ArmPOS.
Where it works, and for whom
Countries
- Saudi Arabia
For
- Retail & grocery
- Fashion & beauty
- Health & pharmacy
- Phones & electronics
- Hardware & building materials
- Wholesale & distribution
- Hospitality
Set up in 3 steps
- In Settings › System Settings, tab ZATCA, add your VAT Number and Company Name (Arabic), and turn on Enable ZATCA QR on Sales Receipts.
- Open Integrations › Accounting › ZATCA, click Set up, turn on Send invoices to ZATCA, fill in your details, and click Save.
- Get a one-time code from the Fatoora portal’s Onboard New Solution Unit/Device. Type it in One-time code from Fatoora, and click Send.
Words you’ll see on the screens
- Send invoices to ZATCA
- Environment
- CRN
- Send new invoices by themselves
- One-time code from Fatoora
- Onboarding and documents
- Where it stands
- Start onboarding
- Compliance checks
- Documents sent to ZATCA
- Reported
- Cleared
What it doesn’t do
- Sales made before onboarding says Ready aren’t sent later: each sale goes when it’s saved.
- An edit or a deletion never reaches ZATCA: correct a sale with a sale return, which sends a credit note.
- A failed invoice isn’t sent again by itself: open Documents sent to ZATCA and click Try again.
Questions
How do I connect my POS to ZATCA’s Fatoora?
Fill in ZATCA’s details in Integrations › Accounting › ZATCA, then onboard with a one-time code (OTP) from the Fatoora portal.
Does ArmPOS do ZATCA Phase 2?
Yes. It signs each invoice and sends it to Fatoora: reporting for simplified invoices, clearance for standard ones.
Which sales become standard invoices?
A sale whose customer has a 15-digit VAT number starting and ending with 3. Every POS sale is a simplified invoice.
Does the receipt show ZATCA’s QR code?
Yes, with Enable ZATCA QR on Sales Receipts on. Once the invoice is signed, the receipt prints its QR code, and a cleared one prints ZATCA’s.
What happens when ZATCA rejects an invoice?
It’s marked Failed with ZATCA’s messages, the sale stays, and your settings people are told. Fix the cause, then click Try again.
Can I test before sending real invoices?
Yes. A first setup starts on Sandbox, where any 6 digits work as the code. Move to Simulation, then Production, and onboard again each time.
Does it work when the POS is offline?
The POS keeps selling. Each offline sale is signed and sent to ZATCA once it reaches ArmPOS.
Works well with
-
Salla
Each new Salla order arrives as a sale as soon as Salla sends it; products come in too.
-
WhatsApp
Sends invoice receipts and payment notes from your own WhatsApp Business number.
-
Stripe
Take cards at the POS and in your online store, paid into your own Stripe account.
Get Started
Run your shop on ArmPOS
Start free with point of sale and inventory management in one app. No card needed; upgrade when your business grows.
- 14-day free trial
- No card needed
- Android & iPhone
