Integrating your system with ZATCA e-invoicing: the complete 2026 guide
E-invoicing integration is Phase 2 of the e-invoicing regime enforced by the Zakat, Tax and Customs Authority (ZATCA): your system sends every invoice as a signed XML file to the Fatoora platform, to be cleared before it reaches the customer or reported within 24 hours. Wave 25 covers businesses whose taxable revenue exceeds SAR 187,500, with a deadline of 1 February 2027. You have three routes: an off-the-shelf cloud accounting package from about SAR 119 a month, integrating your current system at a market cost from roughly SAR 9,500, or an ERP system with the integration built in. The figures are market ranges, not a quote.
On this page
- Phase 1 and Phase 2: what is the difference?
- Who must integrate and when: Waves 23, 24 and 25
- What integration means technically
- The test environment before going live
- Three routes to compliance: which fits you?
- How we handle e-invoicing in the systems we build
- Readiness checklist before your wave deadline
- Common mistakes that cost time and money
- How to compare two e-invoicing integration quotes
- E-invoicing integration cost by route (Saudi market ranges, 2026)
- Our commitments
- How we work with you
- Frequently asked questions
Phase 1 and Phase 2: what is the difference?
Phase 1, the generation phase, began on 4 December 2021. It required every VAT-registered business to issue invoices from a compliant electronic system instead of handwritten invoices or Word and Excel files, with a QR code on simplified invoices. In this phase your system does not connect to ZATCA; it only has to issue an electronic invoice with the required fields and store it.
Phase 2, the integration phase, began on 1 January 2023 and is rolled out in waves by revenue size. Your system connects to ZATCA’s Fatoora platform and sends every invoice as a digitally signed XML file. The practical difference is large: a system that prints a correctly formatted invoice is enough for Phase 1, but not for Phase 2 unless it can sign, submit and receive ZATCA’s response.
- Phase 1 (generation): an electronic invoice from a compliant system, with no connection to ZATCA
- Phase 2 (integration): a signed XML file, sent to the Fatoora platform and cleared or reported
- Every VAT-registered business must comply with Phase 1, and with Phase 2 when its wave arrives
Who must integrate and when: Waves 23, 24 and 25
ZATCA defines the waves by a threshold of VAT-taxable revenue in reference years named in each wave’s announcement, and notifies the businesses in scope at least six months before their deadline. With every wave the threshold drops, bringing smaller businesses into scope.
Wave 25 is the widest yet: announced on 24 July 2026, it covers businesses whose revenue exceeds SAR 187,500, which must complete integration by 1 February 2027. That threshold is close to the voluntary VAT registration threshold, so a very large share of small registered businesses now face a near deadline.
- Wave 23: revenue above SAR 750,000, deadline 31 March 2026
- Wave 24: revenue above SAR 375,000, applying from April 2026
- Wave 25: revenue above SAR 187,500, deadline 1 February 2027
- Confirm your wave in ZATCA’s notification or your account on its portal; the notification is the reference, not an estimate
What integration means technically
Integration is not a button added to your software but a set of requirements the invoicing system must meet. Understanding them helps you assess any quote you receive, and tells you whether your current system can be integrated at all.
- XML following the UBL 2.1 standard with the fields and rules ZATCA specifies; the invoice can be shared with the customer as a PDF/A-3 with the XML embedded
- A cryptographic stamp (digital signature) on every invoice, and an invoice hash chained to the previous invoice’s hash so the sequence cannot be tampered with
- A unique UUID and a sequential invoice counter for each generation unit
- A QR code with the Phase 2 fields, including the signature data and public key
- Registering each e-invoice generation solution (EGS) on Fatoora: an OTP from the portal, a certificate request, a compliance certificate, compliance checks, then the production CSID, with renewals tracked
- Clearance for B2B tax invoices: sent to ZATCA and cleared before delivery to the buyer
- Reporting for B2C simplified invoices: given to the customer immediately and reported to ZATCA within 24 hours
- Credit and debit notes under the same rules, plus handling rejections, errors and resubmission when the connection drops
The test environment before going live
ZATCA provides a developer portal and a simulation environment where the system is tested before connecting to production. Good testing is not one successful invoice; it covers every case that happens in your real business: a B2B invoice and a B2C one, a discount, a credit note for a return, an exempt or zero-rated item, a foreign-currency invoice, and an internet outage mid-submission.
Most post-launch problems come from untested cases: customers without a valid VAT number, rounding that differs between the total and the line items, or a POS that works offline and submits its invoices late. So budget time for testing in your plan, and do not make the wave deadline your first day live.
Three routes to compliance: which fits you?
The first route is an off-the-shelf cloud accounting and invoicing package that includes Phase 2. It is the fastest and cheapest for a small business with no other system, and Phase 2 is usually in the mid-tier plans rather than the cheapest. Its drawback is that it imposes its own way of working, so if your sales and stock live in another system you will enter data twice.
The second route is integrating your current system, whether a POS, a custom system or an ERP, directly with Fatoora or through an approved provider’s API. This keeps your team’s way of working, but requires a system that can still be developed and whose code someone owns. The third route is a new ERP or quotation and invoicing system with the integration built in, best when integration is a chance to move off Excel or legacy software anyway.
- A small business with no other system: an off-the-shelf cloud package is usually enough
- An existing system that works well and whose code you own: integrate the current system
- A legacy system that cannot integrate, or data spread across spreadsheets: a new system with integration built in
How we handle e-invoicing in the systems we build
At FortuneCode we do not treat e-invoicing as an afterthought but as part of every system that issues invoices: ERP systems, quotation and invoicing systems, and sales and booking systems. The invoice logic is designed from the start around Phase 2 requirements and tested in the simulation environment before go-live, so you never discover after launch that your system needs rebuilding.
When you have an existing system we are working on or connecting to your other systems, we assess whether it can be integrated as part of the project scope, and the written quote states what the integration covers and how long it takes. The scope and contract are written before we start, the code and accounts belong to your company, and the delivery date is written into the contract with on-time delivery guaranteed and fast technical support after go-live.
Readiness checklist before your wave deadline
Start early. The deadline is the date for full operation, not the date to start thinking. This list sums up what you need to do, in order:
- Confirm your wave and deadline from ZATCA’s notification or your portal account
- List every place that issues invoices: branches, POS terminals, the online store, the accounting system, manual invoices
- Ask your system provider in writing: does it support Phase 2? When? At what cost?
- Clean up customer data: VAT numbers and national addresses for the businesses you sell to
- Choose your route: off-the-shelf software, integrating the current system, or a new system
- Run tests in the simulation environment on every type of invoice you issue
- Register your generation units and obtain production certificates
- Go live with one branch or POS first, then roll out once confirmed
- Train sales and accounting staff to handle rejected invoices and resubmit them
Common mistakes that cost time and money
The first mistake is leaving it to the last month, when providers are swamped, prices rise and testing time shrinks. The second is assuming a system is “compliant” because it prints a QR code; that is a Phase 1 requirement, while Phase 2 needs signing, submission and receiving ZATCA’s response.
The third is forgetting side sources of invoices: an online store, a POS in one branch, or manual invoices for a major client. Every source that issues tax invoices must go through integration. The fourth is integrating a system whose code you do not own and whose developer no longer supports it, so the integration breaks at ZATCA’s first update and nobody can fix it.
How to compare two e-invoicing integration quotes
The cheapest quote is not always the best value. Ask every provider to answer the same questions in writing; they reveal the difference between real integration and cosmetic integration:
- How many generation units or POS terminals does the price cover, and what does each extra one cost?
- Does it cover both clearance and reporting, plus credit and debit notes?
- Does it include testing in the simulation environment on my business cases, or a single test invoice?
- Are there monthly fees or per-invoice fees after go-live?
- Who handles certificate renewals and ZATCA requirement updates after go-live?
- What happens when the connection drops or an invoice is rejected, and how is the employee alerted?
E-invoicing integration cost by route (Saudi market ranges, 2026)
Indicative Saudi market ranges in SAR, not a quote.
| Scope | Typical cost | What drives the price |
|---|---|---|
| Cloud accounting and invoicing software including Phase 2 | About SAR 119–380 per month | Phase 2 is often not in the cheapest plan; extra users and branches cost more |
| Cloud software onboarding services | SAR 795–1,395 one-off | Importing customers, items and chart of accounts within a set number of hours |
| Integrating an existing system for a small or mid-sized business | SAR 9,500–18,000 | One main system or device, 7 to 10 working days |
| Integrating a company with several branches and POS terminals | SAR 22,000–45,000 | Up to about 10 devices and POS terminals, 2 to 3 weeks |
| Groups and holding companies on global systems | SAR 55,000–110,000+ | SAP, NetSuite or Oracle, 3 to 5 weeks |
| Custom or configured ERP system with the integration built in | SAR 30,000–150,000 | Accounting, inventory, sales, purchasing and reports, with e-invoicing as part of the system |
We send you a written quote in SAR within 24 hours of the discovery session.
Our commitments
You own the code
Source code, accounts and domain are in your organisation’s name from day one.
Written scope and contract
Scope, milestones and price are agreed in writing before the first line of code.
On-time delivery, guaranteed
The delivery date is written into the contract, and we keep it at every milestone.
Fast technical support
A team that responds quickly after launch and fixes any issue in production.
How we work with you
- 1
Free discovery session
30 minutes with an engineer to understand your needs and how you work.
- 2
Written proposal within 24 hours
Clear scope, milestones, timeline and a price in SAR, with no obligation.
- 3
Contract and staged payments
You pay in stages tied to deliveries, not everything upfront.
- 4
Delivery with weekly reports
Follow progress in the client portal and review every milestone before sign-off.
- 5
Launch, training and support
We launch on schedule, train your team and stay with you with fast support.
Frequently asked questions
How do I know whether my business must integrate, and by when?
ZATCA notifies the businesses in each wave at least six months before the deadline, and you can check your account on the ZATCA portal. As a rule, a VAT-registered business whose taxable revenue exceeded SAR 187,500 in the reference years falls within Wave 25 or an earlier wave, with a final deadline of 1 February 2027.
What is the difference between Phase 1 and Phase 2 of e-invoicing?
Phase 1 requires you to issue invoices from a compliant electronic system, with a QR code on simplified invoices, without connecting to ZATCA. Phase 2 requires your system to create each invoice as a signed XML file and send it to the Fatoora platform, to be cleared before delivery for B2B invoices or reported within 24 hours for B2C invoices.
How much does e-invoicing integration cost?
Published market offers put integrating an existing system for a small or mid-sized business at SAR 9,500–18,000, a multi-branch company at SAR 22,000–45,000, and groups on global systems from SAR 55,000 upwards. Off-the-shelf cloud packages offer Phase 2 plans from about SAR 119 a month. The price depends on the type of system and the number of generation units.
Can my current system be integrated, or do I have to replace it?
If your system is still developed and someone owns its code or its provider supports it, integration is usually possible directly with Fatoora or through an approved provider’s API. If it is legacy software that is no longer supported, or Excel files, patching it can cost nearly as much as a new system with integration built in. A short technical assessment settles this before you pay.
What is the difference between clearance and reporting?
Clearance applies to B2B tax invoices: your system sends the invoice to ZATCA, which validates and stamps it, and it is then delivered to the buyer. Reporting applies to B2C simplified invoices: they go to the customer immediately and the system sends them to ZATCA within 24 hours. Most businesses need both flows, so make sure the integration covers them.
What is a CSID certificate and why do I need it?
It is the cryptographic certificate ZATCA issues for each invoice generation unit, which the system uses to sign its invoices. You obtain it by registering the unit on Fatoora: an OTP from the portal, a compliance certificate, compliance checks, then the production certificate. Each branch or separate POS has its own unit and certificate, and certificates expire, so renewals need tracking.
How long does integration take?
Integrating one system for a small business takes 7 to 10 working days in market offers, multi-branch companies 2 to 3 weeks, and groups 3 to 5 weeks. Add time for cleaning customer data, testing and training the team. So start at least two months before your wave deadline, not in the final weeks.
What happens if the internet drops while issuing an invoice?
For B2C simplified invoices, the invoice can be given to the customer and sent to ZATCA when the connection returns, within the 24-hour window, so the system must store pending invoices and resubmit them automatically. B2B tax invoices need clearance before delivery. A good system alerts staff to any pending or rejected invoice instead of letting it disappear silently.
Do you offer integration as a standalone service?
We build e-invoicing into the systems we deliver or connect for our clients: ERP systems, quotation and invoicing systems, and sales systems. If your current system is part of a project we are working on, we assess its integration within the scope and state it in the quote. The scope is written before we start, and we send a written quote within 24 hours.
Do I need to integrate my online store and POS terminals too?
Yes. Every source that issues tax invoices in your business’s name must go through integration: the online store, branch POS terminals, the accounting system and ordering apps. Each source can be integrated as a separate generation unit, or invoicing can be unified in one system that receives orders from every channel, which is usually easier to track and report on.
You may also need
Ready to start?
Send us your idea on WhatsApp and get a written proposal with scope, timeline and price within 24 hours.
Talk to us on WhatsAppLast updated: