Seamless ZATCA API Integration

ZATCA Phase 2 Integration for POS Systems in Saudi Arabia

تكامل زاتكا المرحلة الثانية | متطلبات الفاتورة الإلكترونية زاتكا

Connect your point of sale system directly to the ZATCA Fatoora platform. Automate e-invoice generation, digital signing, clearance, and reporting. Full ZATCA integration in Saudi Arabia without writing a single line of code.

Start Free Trial Talk to an Expert
ZATCA Phase 2 Integration Dashboard

Real-time ZATCA integration and monitoring dashboard

Saudi Arabia's digital transformation is reshaping how every business handles invoicing. The Zakat, Tax and Customs Authority has made it clear: all VAT-registered businesses must integrate their systems with the ZATCA platform. This is not a recommendation. It is a regulation backed by penalties. For business owners who rely on POS systems for daily operations, understanding ZATCA integration in Saudi Arabia is now a top priority.

Whether you operate a small retail store in Riyadh, manage a chain of restaurants across Jeddah, or run a wholesale distribution centre in the Eastern Province, your POS system must be able to communicate with the ZATCA Fatoora platform. This page explains exactly what ZATCA Phase 2 integration involves, what your POS system needs to support it, and how LookPOS makes the entire process simple.

What Is ZATCA E-Invoicing?

ZATCA e-invoicing is the electronic invoicing framework mandated by the Zakat, Tax and Customs Authority of Saudi Arabia. Officially called Fatoora, it requires businesses to replace manually created invoices with structured, machine-readable electronic documents that follow a specific format and are transmitted to ZATCA for validation.

The programme was introduced as part of Saudi Vision 2030 to increase transparency in business transactions, reduce VAT tax evasion, and modernize the commercial infrastructure of the Kingdom. It affects every VAT-registered entity regardless of size, sector, or revenue.

The Two Phases of ZATCA E-Invoicing

ZATCA rolled out e-invoicing in two phases, each with distinct requirements:

  • Phase 1 (Generation Phase): Effective since December 4, 2021. Businesses were required to generate invoices electronically using a compliant system. Invoices needed a structured format, unique identifiers, and QR codes on B2C invoices. Manual and handwritten invoices were no longer accepted.
  • Phase 2 (Integration Phase): Being rolled out in waves since January 2023. Businesses must now integrate their invoicing systems with the ZATCA Fatoora platform via API. Invoices must be submitted electronically to ZATCA for clearance (B2B) or reporting (B2C). This phase demands XML formatting, cryptographic signatures, and real-time data transmission.

Key Distinction

Phase 1 only required you to generate electronic invoices. Phase 2 requires you to transmit them to ZATCA and receive validation before they become official. This is a fundamental shift that demands a technically capable POS system.

Why Businesses Need a ZATCA-Integrated POS System

Many businesses in Saudi Arabia purchased their POS software before ZATCA introduced e-invoicing. Those systems were built for billing, inventory, and basic reporting. They were never designed to generate XML documents, apply cryptographic signatures, or communicate with government APIs. When ZATCA Phase 2 came into effect, these systems became insufficient.

A POS system with built-in ZATCA integration solves this problem completely. Instead of building a separate integration layer, hiring developers, or purchasing middleware, you get a single system that handles both your daily operations and your tax compliance obligations.

The Risks of Operating Without ZATCA Integration

Financial Penalties

ZATCA can impose penalties ranging from 5,000 SAR to 50,000 SAR per violation for non-compliance with e-invoicing regulations. This includes failure to generate compliant invoices, failure to submit invoices to ZATCA, and issuing invoices without the required fields or QR codes.

  • Invoice rejections: Without proper XML formatting and digital signatures, your invoices will be rejected by the ZATCA platform, preventing you from legally completing B2B transactions.
  • Audit exposure: Non-compliant businesses become targets for ZATCA audits. A compliant system creates a verifiable digital trail that protects you during inspections.
  • Partner trust: Other VAT-registered businesses may refuse to accept your invoices if they are not ZATCA-cleared, disrupting your supply chain and partnerships.
  • Operational delays: Manual workarounds for e-invoicing are time-consuming and error-prone, slowing down your daily business operations.

Features That Make LookPOS ZATCA-Ready

LookPOS was engineered with ZATCA compliance at its core. Every feature works together to ensure your invoices meet all regulatory requirements while keeping your business operations efficient.

Built-In ZATCA Integration Features

Every technical requirement handled automatically within your POS

UBL 2.1 XML Generation

Every invoice is automatically formatted in the UBL 2.1 XML standard required by ZATCA, including all mandatory fields, namespaces, and element structures

Certificate Management

Automated CSR generation, compliance certificate acquisition, and production certificate lifecycle management through the Fatoora portal

Cryptographic Signing

X.509 certificate-based digital signatures applied to every invoice ensuring document integrity and non-repudiation

TLV QR Code Encoding

Generates ZATCA-compliant QR codes with Tag-Length-Value encoded seller name, VAT number, timestamp, totals, and tax amounts

B2B Clearance & B2C Reporting

Automatic detection and routing: standard invoices go through clearance workflow, simplified invoices through reporting workflow

Invoice Hash Chain

Each invoice cryptographically references the previous invoice hash, maintaining an unbreakable sequential chain as ZATCA requires

Real-Time Validation

Invoices are validated against ZATCA rules before submission. Errors are caught and displayed before they reach the government platform

Credit & Debit Notes

Issue ZATCA-compliant credit notes for returns and debit notes for adjustments, properly linked to the original invoice reference

Multi-Format Printing

Print ZATCA invoices on A4, A3, 80mm thermal, or 58mm thermal paper. Every format includes all required ZATCA fields and QR codes

ZATCA Phase 2 Integration System

How LookPOS Handles ZATCA Phase 2 Integration

The technical complexity of ZATCA Phase 2 is significant. It involves cryptography, API communication protocols, XML schema validation, and certificate lifecycle management. LookPOS abstracts all of this complexity so your business can focus on selling rather than technical implementation.

The Integration Architecture

When you complete a sale in LookPOS, the following happens automatically in the background:

  1. Invoice data is collected from the transaction including product details, quantities, prices, discount amounts, VAT calculations, and customer information.
  2. Invoice type is determined automatically. If the customer has a VAT registration number in the system, a standard tax invoice (B2B) is created. Otherwise, a simplified tax invoice (B2C) is generated.
  3. XML document is built following the UBL 2.1 schema with all mandatory ZATCA elements: supplier details, buyer details, line items, tax subtotals, legal monetary totals, and document references.
  4. Previous invoice hash (PIH) is retrieved and linked to maintain the hash chain integrity.
  5. Digital signature is applied using your production certificate obtained during the ZATCA onboarding process.
  6. QR code is generated with TLV-encoded data containing the seller name, VAT number, timestamp, invoice total, and VAT amount.
  7. Invoice is transmitted to the ZATCA Fatoora platform via secure API. B2B invoices go through the clearance endpoint. B2C invoices go through the reporting endpoint.
  8. Response is processed and the invoice status is updated. Successful submissions are marked and stored. Failed submissions display the exact error for correction.

Processing Speed

The entire process from sale completion to ZATCA submission takes just a few seconds. Your cashier does not need to wait or perform any additional steps. ZATCA integration operates silently in the background.

Developer Portal vs Production Portal

LookPOS supports both the ZATCA developer portal (for testing) and the production portal (for live operations). During the initial setup, you can test your integration using the developer portal to verify that everything works correctly. Once validated, switching to production mode is a single configuration change. This dual-mode support ensures you can onboard with confidence, knowing your invoices will be accepted before going live.

Benefits for Retailers and Restaurants Across Saudi Arabia

LookPOS ZATCA integration serves every business type in the Kingdom

Retail Stores
Restaurants
Supermarkets
Pharmacies
Electronics
Jewelry
Fashion
Cafes
Hardware
Wholesale

For Retailers

  • Barcode-driven billing with ZATCA compliance
  • Inventory tracking across branches
  • Quick B2C invoicing for walk-in customers
  • B2B clearance for wholesale buyers

For Restaurants

  • Table management with compliant billing
  • Kitchen order printing separate from invoices
  • Takeaway and delivery invoicing
  • Split bill with VAT calculation per item

Step-by-Step: Setting Up ZATCA Integration

From zero to fully integrated in six straightforward steps

1

Create Your LookPOS Account

Sign up at lookpos.com and enter your business information including business name (Arabic and English), VAT registration number, Commercial Registration (CR) number, and your business address with the four-digit building number required by ZATCA.

2

Generate Your ZATCA OTP

Log in to the ZATCA Fatoora portal at fatoora.zatca.gov.sa. Navigate to the onboarding section and generate a One-Time Password (OTP) for your e-invoicing solution unit. Copy this OTP for the next step.

3

Enter OTP in LookPOS

Go to the ZATCA Onboarding section in your LookPOS dashboard and enter the OTP. LookPOS will automatically generate a Certificate Signing Request (CSR), submit it to ZATCA, receive your compliance certificate, run validation tests, and obtain your production certificate.

4

Configure Your Products and VAT Rates

Add your product catalogue with the correct VAT rates. Saudi Arabia allows three rates: 0% (zero-rated), 5% (reduced), and 15% (standard). Assign the appropriate rate to each product or category. LookPOS validates that only ZATCA-accepted rates are used.

5

Process Your First Sale

Ring up a sale through the POS as you normally would. LookPOS will generate the invoice, apply the digital signature, create the QR code, and submit it to ZATCA automatically. You will see the ZATCA status update on your sales dashboard.

6

Monitor Your ZATCA Dashboard

Review your ZATCA submissions from the dedicated dashboard. See which invoices were successfully cleared or reported, identify any that need attention, and access your complete archive of ZATCA-validated documents for audit purposes.

ZATCA Onboarding and Dashboard Setup

Complete visibility into all ZATCA submissions and compliance status

Watch: ZATCA Integration Demo

Step-by-step ZATCA onboarding and invoice submission demonstration

Why Businesses Choose LookPOS for ZATCA Integration

Built for Saudi Arabia. Trusted by businesses across the Kingdom.

Native Integration

ZATCA is built into the POS core. No plugins, no middleware, no third-party tools needed. Everything works from one system.

30-Minute Setup

Complete your ZATCA onboarding in under half an hour. No developer needed. No coding required. Just enter your OTP and go.

Arabic & English

Full bilingual support for the interface, invoices, and reports. ZATCA requires Arabic on invoices, and LookPOS delivers it natively.

No Per-Invoice Fees

Flat monthly pricing with unlimited ZATCA submissions. No hidden charges per invoice, per API call, or per certificate renewal.

Automatic Updates

When ZATCA changes regulations or API specifications, LookPOS is updated automatically. Your compliance never falls behind.

Dedicated Support

ZATCA integration questions? Our team understands every aspect of Saudi e-invoicing and can guide you through any issue.

LookPOS vs Legacy POS Systems

Feature LookPOS Legacy POS
ZATCA Phase 2 Integration Built-in Not available
UBL 2.1 XML Generation Automatic Manual / None
Cryptographic Digital Signing Automatic Not supported
QR Code with TLV Encoding On every invoice Basic or none
Automatic B2B/B2C Detection Yes Manual selection
Fatoora API Connection Real-time Not available
Arabic Language Support Full support Varies
Setup Time for ZATCA Under 30 minutes Days/Weeks or N/A

ZATCA Phase 2 Compliance Checklist

Verify your business meets every ZATCA requirement. LookPOS handles all of these automatically.

Active VAT registration with ZATCA
ZATCA-compliant POS or invoicing system
Fatoora portal onboarding completed
Production certificate obtained
UBL 2.1 XML invoice format
Cryptographic digital signatures
TLV-encoded QR codes on invoices
Sequential Invoice Counter Value (ICV)
Hash chain linking consecutive invoices
B2B invoices cleared via API
B2C invoices reported within 24 hours
Arabic text on all tax invoices
Valid VAT rates only (0%, 5%, 15%)
Seller VAT number on every invoice
Buyer VAT number on B2B invoices
Credit note references to original invoice

Frequently Asked Questions About ZATCA Integration

Technical and practical answers for Saudi business owners

What does ZATCA Phase 2 integration mean for my POS system? +

ZATCA Phase 2 integration means your POS system must connect directly to the ZATCA Fatoora platform via API. Every invoice generated must be transmitted to ZATCA in near real time. B2B standard invoices require clearance before delivery to the buyer. B2C simplified invoices must be reported within 24 hours. The invoice must follow UBL 2.1 XML format, include cryptographic digital signatures, a sequential counter, a hash chain, and a TLV-encoded QR code.

ZATCA Invoice Pending Status
What happens if my business does not comply with ZATCA Phase 2? +

Non-compliance carries financial penalties starting from 5,000 SAR and reaching up to 50,000 SAR per violation. Specific penalties apply for different violations: failure to issue electronic invoices, missing mandatory fields, incorrect QR codes, or failure to submit invoices to ZATCA. Repeated violations can lead to escalated enforcement actions. Additionally, other businesses may reject your invoices if they are not properly cleared through ZATCA, disrupting your B2B relationships.

How long does it take to integrate ZATCA with LookPOS? +

The complete integration process takes under 30 minutes. You generate an OTP from the ZATCA Fatoora portal and enter it into LookPOS. The system then automatically handles the Certificate Signing Request, compliance certificate acquisition, validation testing, and production certificate issuance. There is no coding, no server configuration, and no technical expertise required on your part.

Does LookPOS support both B2B and B2C ZATCA invoicing? +

Yes. LookPOS automatically determines the invoice type based on the customer profile. When a customer has a VAT registration number stored in the system, LookPOS generates a standard (B2B) tax invoice and sends it to ZATCA for clearance. For walk-in customers or those without a VAT number, LookPOS generates a simplified (B2C) tax invoice and submits it through the reporting channel. You do not need to select the type manually.

What technical requirements does ZATCA Phase 2 demand? +

ZATCA Phase 2 demands several technical capabilities: UBL 2.1 XML invoice formatting, cryptographic digital signatures using X.509 certificates obtained from ZATCA, TLV-encoded QR codes containing seller and transaction data, a sequential Invoice Counter Value (ICV) that increments with every invoice, a hash chain where each invoice references the hash of the previous one, secure API connectivity to the Fatoora platform, and support for both clearance and reporting workflows. LookPOS implements all of these natively.

Can I switch from my current POS to LookPOS easily? +

Yes. LookPOS supports product import via Excel and CSV files, making it easy to migrate your catalogue from any existing system. Customer data, tax configurations, and business settings can all be configured during the initial setup. Our support team assists with migration to ensure a smooth transition. Most businesses complete their migration and ZATCA integration within the same day.

Does ZATCA integration work with thermal receipt printers? +

Absolutely. LookPOS generates ZATCA-compliant invoices in four print formats: A4 paper, A3 paper, 80mm thermal receipts, and 58mm thermal receipts. All formats include the mandatory ZATCA QR code, seller and buyer information, individual line item VAT breakdown, invoice identifiers, and total amounts. The QR code is sized appropriately for each paper format to ensure it remains scannable.

Integrate Your POS with ZATCA Today

Stop worrying about e-invoicing compliance. LookPOS handles ZATCA Phase 2 integration automatically so you can focus on growing your business in Saudi Arabia.

No credit card required. Setup in under 30 minutes. Cancel anytime.

تكامل نظام زاتكا المرحلة الثانية لنقاط البيع

يوفر LookPOS تكامل زاتكا المرحلة الثانية بشكل كامل عبر بوابة المطورين زاتكا. يتعامل النظام مع جميع متطلبات المرحلة الثانية زاتكا بما في ذلك إنشاء شهادات CSR، الحصول على شهادات الإنتاج، وإرسال الفواتير إلى منصة فاتورة.

يدعم النظام صيغة الفاتورة الإلكترونية XML والتوقيع الرقمي للفواتير زاتكا ومتطلبات رمز QR في الفاتورة الإلكترونية. يعمل التكامل تلقائياً مع كل عملية بيع دون الحاجة لتدخل يدوي.

تكامل زاتكا المرحلة الثانية بوابة المطورين زاتكا صيغة XML الفاتورة التوقيع الرقمي للفواتير متطلبات رمز QR
AM

About the Author

Atif Mehmood

Founder of LookPOS — With 8+ years of experience building POS solutions for businesses in Saudi Arabia and Pakistan, Atif leads the development of ZATCA-compliant e-invoicing systems that serve retail stores, restaurants, and enterprises across the Kingdom.

Related Pages

Explore more LookPOS solutions for your business

ZATCA POS System

Full ZATCA compliant POS

Grocery Store POS

For supermarkets & grocery

Restaurant POS

Dine-in, takeaway & delivery

All Features

Complete feature overview