Connecting Your System to Saudi E-Invoicing (ZATCA): A Practical Guide

Connecting Your System to Saudi E-Invoicing (ZATCA): A Practical Guide

Quick summary

Saudi e-invoicing came in two phases: the first requires issuing invoices electronically in a structured format instead of paper or a Word file, and the second (integration) requires your system to talk to the authority's platform technically. The practical surprise: phase two is not a setting you configure but a change to your system's structure — an unbreakable sequential numbering, a cryptographic stamp, and archival in a specific format. The biggest decision is whether to build the integration yourself or go through an approved provider — and for most businesses, a provider is cheaper and safer.

What actually changes in your system

AspectBeforeWhat becomes required
Invoice numberingAn internal number that can be edited or deletedAn unbroken sequence with no deletions — a deletion becomes a credit note
Invoice formatPDF or printA machine-readable structured format, plus a human-readable copy
IntegrityNothingA cryptographic stamp proving the invoice was not altered after issue
ArchivalIn your databaseRetained for defined periods in a retrievable format
TaxSometimes computed at display timeStored with the invoice — inclusive prices decomposed precisely

The mistake that forces a rebuild

The most dangerous flaw we see in custom systems is deleting or editing invoices after issue. Many systems let a user delete an order or change its amount — acceptable before invoicing, destructive after. The rule we build on: an issued invoice is an untouchable record, and any correction is a new credit or debit note linked to it. Fixing this later means redesigning the orders and invoices tables together.

The second mistake is computing tax at display time rather than storing it. If your prices are tax-inclusive, decomposing them later with a floating calculation produces halala-level differences that accumulate and surface at reconciliation. Store net, tax and total as fixed values at the moment of issue.

Build it or use a provider?

Going through an approved invoicing provider is faster and lower-risk for most businesses: your system sends invoice data, the provider handles format, stamping and transmission. A direct integration earns its cost only when your invoice volume makes subscription fees exceed the build, or when you have a requirement no provider supports.

We build custom business systems that are invoicing-ready from the start rather than patched later.

Important: this article explains what changes in your software. It is not accounting or legal advice. Requirements, deadlines and targeted groups change — consult your accountant and the authority's official source before deciding anything.

Frequently asked questions

Does my store on a ready platform need work from me?
Ready platforms generally provide e-invoicing within their service or through a marketplace app, so your burden is much smaller. Check two things: that issued invoices carry your correct business details, and that any accounting integration does not create a parallel numbering sequence conflicting with the platform's.
What if my system was built years ago?
That does not always mean a rebuild. Start with an inventory: how invoices are numbered, whether they can be deleted or edited, and where tax is stored. If numbering is sound and invoices are immutable, the rest is an integration layer added on top rather than inside.
Is this only for large companies?
No. Requirements were applied to successive groups of businesses by revenue, and the groups widen over time. Treat it as a requirement that will reach you rather than an option — preparing early is cheaper than rushing.
How long does integration take?
Through an approved provider: one to three weeks for a system with clean numbering. A direct integration: one to three months depending on the system's state. The longest part is never the integration itself — it is cleaning up practices incompatible with an immutable invoice.

Ready to start your tech project?

Horizon Tech turns your idea into a powerful digital product.

Contact us now  See our work