Resources

How to choose a ZATCA integration provider

ZATCA complianceBy the alFatora team9 min read

When a business issues thousands of invoices a day, the real question is not whether an invoice can be sent to the Authority. It is what happens when one is rejected, when an external service goes down, when validation rules change, or when one legal entity's configuration differs from another's. Choosing a ZATCA integration provider is an operational, financial and technical decision at once, because the integration directly affects your ability to issue correct documents, prove compliance, and keep collecting without disrupting the ERP or the points of sale.

Phase 2 integration should not be treated as a transport channel. The invoice goes through a full cycle: data preparation, validation, signing and stamping, QR generation, submission for clearance or reporting, then an audit trail you can return to months or years later. The right provider takes clear ownership of that cycle instead of leaving your team chasing error messages across several systems.

What should a ZATCA integration provider offer?

The first criterion is the ability to turn regulatory complexity into an intelligible operational interface. A business does not need to rebuild its invoicing system in a technical format specific to each regulator. What it needs is to pass invoice data from its current system in one stable, clear data shape, then receive a result the finance system and the operations teams can act on.

In an enterprise environment, the provider should support integration with ERPs, e-commerce platforms, points of sale, and subscription or internal billing systems. Ideally it offers a unified API on one JSON data shape rather than forcing development teams to handle UBL detail directly. That does not remove the regulatory requirements in the background, but it isolates them from your core systems and makes future change cheaper.

The provider should also distinguish what requires prior clearance from what requires reporting, and return a precise state per document: under processing, accepted, rejected, or needs correction. A phrase like "submitted" is not a sufficient operational state. The useful state is the one that says whether the Authority accepted the document, what prevented acceptance if it did not, and what the next action is.

Start from the invoice's path, not a feature list

Before comparing proposals, map the invoice's real path inside your organisation. Identify where it originates, which fields each system fills, who approves it, and when the result has to appear to the user or the customer. Questions more important than price then emerge: is the invoice submitted synchronously or through a processing queue? Can a retry be made safely? Does the document get duplicated when connectivity drops? And can support teams find the cause without manually reading raw logs?

For the point of sale, speed and processing continuity are decisive. In business-to-business invoicing, the accuracy of buyer data, the VAT number and the handling of credit notes may matter more than millisecond response times. No single design suits everyone; but a good provider makes those trade-offs explicit from the start and turns them into measurable settings and policies.

Stress scenarios deserve testing too, not just one successful demo invoice. Ask to see the platform's behaviour under a large document flow, when the regulator's response is delayed, or when an already-accepted invoice is resubmitted. Continuity here means queues, retries, duplicate prevention and event ordering are part of the design, not manual steps a team remembers during a crisis — and that is what actually shows during an outage.

Validating before submission reduces costly rejection

Every rejected invoice consumes time from finance, tax and technology, and may delay collection or confuse the customer's experience. So it is not enough for the provider to discover the error after submission. The practical value appears when it validates the data, the format and the rules before the document reaches the Authority.

Validation messages have to be actionable. The difference between "error in the invoice" and "the buyer's national address field is incomplete for this scenario" is the difference between a long support ticket and a direct correction. Ask whether the provider exposes the error code, its cause, the affected field and a suggested fix, and whether that information returns to your system by webhook.

Validation does not shift responsibility for commercial data. Your source system remains responsible for product prices, discounts and customers. But the integration provider should identify early where that data conflicts with the invoicing rules, and stop unqualified documents entering a costly or confusing production path.

Security and key custody are not a technical detail

Electronic signing and stamping are among the most sensitive parts of the integration. The business should understand where certificates are stored, who may use them, how they are rotated or renewed, and what happens when a responsible person or a legal entity changes. Keeping signing keys in an ungoverned environment, or distributing them across servers and staff, widens the risk surface for no reason — and the certificate lifecycle is the first thing worth asking about.

Look for organised certificate management, key protection through dedicated security modules, and clear logs of every signing, submission or configuration change. It is not enough for the platform to be secure in theory; it must be able to give an audit team practical proof: who performed the action, when, on which document, and with what result.

That matters more in groups running several legal entities. Each entity's data, certificates, configuration and user permissions must be isolated, while unified administrative visibility stays available to those authorised. That isolation protects compliance and stops one configuration error affecting a whole group's operations.

Ask for auditability, not just archiving

Keeping a PDF copy of the invoice is not the same as having an operational audit record. When a specific document is queried, finance and tax teams need to trace its journey: when the platform received it, which data was validated, when it was signed or stamped, what response came back, and whether it was reprocessed later. The requirements for invoice storage and the audit trail set the statutory period and form.

Those records should be tamper-proof, and searchable by invoice number, customer, entity, state or period. The platform should also retain the events tied to amendments, credit notes and resubmission, rather than showing only the final state. In reviews, the chain of events is often more important than the document copy alone.

Check data-residency requirements and retention policies as well. Businesses operating in Saudi Arabia and the region may face internal or contractual policies that require a specific location for data. A general answer about hosting is not enough; what is needed is an explicit commitment on where data is processed and stored, how it is accessed, and the disaster-recovery plan.

How to assess pricing and operational responsibility

A low price per document can hide a higher cost elsewhere: fees for submission attempts, for rejected invoices, for sandbox environments, or for support at escalation. Compare the pricing model against the outcome that actually creates value for the business, which is the authority accepting the document.

The clearest model is paying for accepted documents, with no charge for rejections, failed validation or sandbox use. That aligns the incentive between business and provider to improve data quality and watch performance, and makes the budget more predictable. But the precise definition of an accepted document, when it is counted, and how credit notes and reprocessing are treated all deserve review.

No less important than pricing are the limits of responsibility. Ask about the service-level agreement, incident response times, the plan for an outage in the Authority's services, and who holds the escalation decision. "Support is available" is not an operational commitment. What a business needs is a defined incident path, states it can follow, and performance reports based on numbers rather than reassurance.

AI needs production controls

AI assistants can save considerable time searching audit records, interpreting validation errors, checking document states and following invoicing resources. But granting an agent authority to change production configuration or submit documents without limits creates a risk no smaller than the regulatory one.

A mature design lets intelligent tools read, search and diagnose within scoped permissions, with mandatory human approval for any write in production. And the platform should log the agent's requests, the identity of the user who approved them, the action taken and the result.

A question list before signing

  • What happens to the request when the Authority's service stops, and how are documents held in the queue?
  • How is the creation of two documents for one transaction prevented on retry?
  • Where is data processed and stored, for how long, and who can reach it?
  • How are certificates and keys managed, and who may request their use?
  • Can legal entities be isolated under one account with central visibility?
  • Is the audit record searchable and exportable, and does it keep the chain of events rather than only the result?
  • What exactly is the customer charged for: submission, or the accepted document?
  • What are the sandbox's limits, and is using it free?

How this looks in alFatora - الفاتورة

alFatora Connect answers these questions by design rather than by promise: one integration managing the invoice's journey from validation and signing through to submission and the audit trail; keys generated inside security modules in the Kingdom and non-exportable; legal entities isolated under one account; scoped access keys separating writes from reads; and a free, unlimited sandbox. Credits burn on documents the Authority actually accepts in production — not on attempts, rejections or experiments.

A good choice is not measured by a demo in which one invoice goes through, but by the provider's ability to manage the exceptions that happen in real operations. Ask for a trial built on your documents, your paths and your legal entities, then judge how it handles rejection, outage and audit before comparing interfaces or marketing promises. Then the integration becomes a compliance architecture you can rely on, rather than a new fragile point in the revenue cycle.

Frequently asked questions

What is the most important question to ask a ZATCA integration provider?

What happens at failure: when the Authority’s service stops, when a document is rejected, and on retry. Behaviour at the exception reveals more than any successful single-invoice demo.

Is the lowest price per document the cheapest?

Not always. Compare what is actually charged for: submission attempts, rejected documents and sandbox use. The clearest model is paying for documents the authority accepted.

Do I have to replace my current invoicing system?

No. The right provider accepts your invoice data from the system you already run, in one stable shape, and carries the regulatory requirements in a layer isolated from your systems.

Was this useful? Review alFatora on Google.

Zakat, Tax and Customs AuthorityFatooraCompatible with ZATCA Phase 2
e-invoicing requirements
Create your account