Guide to Integrating Your Invoicing System with ZATCA

Introduction to ZATCA System Integration

Integrating your e-invoicing system with ZATCA's Fatoora platform is the cornerstone of Phase 2. This integration ensures that every invoice your business issues is automatically sent, verified, and approved by the authority in real-time.

The process may seem technically complex, but with proper understanding of requirements and the right tools, it can be completed smoothly. In this guide, we'll explain the entire process step by step.

Prerequisites Before Starting

Before beginning the integration process, ensure the following requirements are met:

1. Active Tax Registration

Your business must be registered for VAT with ZATCA. The Tax Identification Number (TIN) is required at all stages of integration.

2. Compliant E-Invoicing System

The system must support Phase 2 standards, including issuing invoices in UBL 2.1 XML format, digital signing, and QR code generation.

3. Suitable Technical Environment

Integration requires a stable internet connection and a secure server environment (or cloud system) capable of reliably processing API requests.

Integration Steps

Phase 1: Developer Portal Registration

The first step is registering your invoicing system with ZATCA's developer portal. This portal provides technical documentation and the testing environment (Sandbox) necessary for integration.

Upon registration, you'll receive:

• API keys for accessing the test environment
• Comprehensive technical documentation for all endpoints
• Examples of compliant invoices

Phase 2: Obtaining Digital Signing Certificate

The digital signing process requires a CSID (Compliance Solution Identifier) certificate. To obtain it:

1. The system creates a Certificate Signing Request (CSR) containing business data

2. The request is sent to the Fatoora platform via the designated API

3. The authority issues a preliminary Compliance CSID

4. After passing compliance tests, a Production CSID is issued

Phase 3: Building the Compliant Electronic Invoice

A compliant electronic invoice includes:

• Complete seller and buyer information
• Item details and pricing
• VAT calculations
• Digital signature using CSID
• QR code in TLV format
• Invoice hash for linking with previous invoices

Phase 4: Sending the Invoice and Receiving Approval

After building and signing the invoice:

1. The system sends the XML invoice to the Fatoora platform

2. The authority verifies data and signature validity

3. If accepted, a response with "Accepted" status is returned with a cryptographic stamp

4. If rejected, a response explaining rejection reasons is returned for correction

Simplifying the Process with FatooraPro

All these complex technical steps are handled automatically by FatooraPro. As a user, all you need to do is enter your business data once, and the system will handle:

• Creating and renewing digital signing certificates
• Automatically building XML-compliant invoices
• Sending invoices to the authority and receiving approvals
• Generating QR codes and invoice hashes
• Maintaining a complete record of all transactions

Save your time and effort — let FatooraPro handle the technical side while you focus on growing your business.