ZATCA XML Schema: Complete Technical Reference 2026

ZATCA XML Schema: Complete Technical Reference 2026

The Kingdom of Saudi Arabia is rapidly transforming its tax compliance landscape with the implementation of e-invoicing, governed by the Zakat, Tax and Customs Authority (ZATCA). This initiative aims to streamline processes, enhance transparency, and ultimately improve tax collection. As we approach 2026, understanding the ZATCA XML schema is crucial for businesses operating in Saudi Arabia, especially with the upcoming waves of implementation. This comprehensive technical reference provides detailed insights into the ZATCA XML schema for 2026, focusing on key aspects relevant to businesses preparing for compliance.

Understanding ZATCA E-Invoicing Waves and Thresholds for 2026

ZATCA is rolling out e-invoicing in phases, referred to as waves. Each wave targets specific taxpayer groups based on their annual revenue. Understanding these waves and their corresponding thresholds is vital for businesses to determine their compliance deadlines. As we move into 2026, knowing the dates and specific requirements for Waves 23 and 24 will be critical.

Based on current patterns and projections, let's consider how potential future waves might operate:

Wave 23 (Projected March 2026): Details on this wave, including the exact revenue threshold and registration timelines, should be available by late 2025. Based on prior wave thresholds, we anticipate it to focus on businesses with revenue in a specific range, potentially smaller than those addressed in earlier waves. Keep a close eye on ZATCA announcements.

Wave 24 (Projected June 2026): Following Wave 23, Wave 24 will likely include another segment of taxpayers based on revenue. Again, keep an eye on ZATCA for the official details, but anticipate a similar revenue-based grouping strategy. This wave is anticipated to focus on smaller businesses than the previous waves.

Important Note on Thresholds: While the exact revenue thresholds for Waves 23 and 24 are not yet publicly available, it's crucial for businesses to closely monitor ZATCA announcements and consult with tax advisors to determine their eligibility and compliance deadlines. It is important to note that if your turnover exceeds SAR 375,000, it is almost certain you will be in a previous wave. If you turnover is below this it is likely you will be in wave 23 or 24.

What is the ZATCA XML Schema?

The ZATCA XML schema defines the structure and format of the electronic invoices (e-invoices) that businesses in Saudi Arabia must generate and submit to ZATCA. It specifies the data elements required, their data types, and the relationships between them. Adhering to the schema ensures data consistency and facilitates seamless integration between businesses and ZATCA's systems.

Key Components of the ZATCA XML Schema

The ZATCA XML schema comprises several key components, each responsible for capturing specific information related to the e-invoice. Understanding these components is crucial for generating valid and compliant XML documents.

Invoice Header

The invoice header contains essential information about the invoice itself, such as:

• Invoice Number: A unique identifier for the invoice.
• Invoice Date: The date the invoice was issued.
• Invoice Type Code: Specifies the type of invoice (e.g., standard invoice, credit note, debit note).
• Tax Scheme: Always "VAT" for Value Added Tax.
• Tax Scheme Version ID: The version of the VAT scheme being used.
• Profile ID: Indicates the application of the e-invoicing regulation (e.g., "reporting:1.0").
• Profile Execution ID: Indicates the phase of e-invoicing compliance (e.g., "Standard").

Seller Information

This section provides details about the seller (the business issuing the invoice), including:

• Seller Name: The legal name of the seller.
• VAT Registration Number: The seller's VAT registration number.
• Address: The seller's registered address.

Buyer Information

Similar to the seller information, this section contains details about the buyer (the recipient of the invoice), including:

• Buyer Name: The legal name of the buyer.
• VAT Registration Number: The buyer's VAT registration number (if applicable). This can be optional depending on the buyer type.
• Address: The buyer's address.

Invoice Lines

The invoice lines section details each individual item or service included in the invoice. Each line contains information such as:

• Item Name: A description of the item or service.
• Quantity: The quantity of the item or service.
• Unit Price: The price per unit of the item or service.
• Line Extension Amount: The total price for the line item (quantity * unit price).
• VAT Category Code: Specifies the VAT rate applicable to the item or service.
• VAT Amount: The VAT amount for the line item.

Invoice Totals

The invoice totals section summarizes the various amounts on the invoice, including:

• Tax Exclusive Amount: The total amount of the invoice before VAT.
• Tax Inclusive Amount: The total amount of the invoice including VAT.
• VAT Amount: The total VAT amount for the entire invoice.
• Rounding Amount: Adjustments due to rounding.
• Payable Amount: The final amount payable by the buyer.

Digital Signature

A crucial component, the digital signature ensures the authenticity and integrity of the e-invoice. It is generated using a qualified electronic signature certificate issued by a ZATCA-approved certification authority.

QR Code

The QR code is a machine-readable code that contains key information from the e-invoice, such as the seller's VAT registration number, invoice total, and VAT amount. It allows for easy verification of the invoice by ZATCA and the buyer.

Common ZATCA XML Schema Errors and How to Avoid Them

Generating valid ZATCA XML documents can be challenging, and businesses often encounter errors. Here are some common errors and tips on how to avoid them:

• Invalid Data Types: Ensure that all data elements conform to the specified data types in the schema (e.g., using a string for a numeric field).
• Missing Required Fields: Verify that all required fields are present in the XML document. The schema clearly defines which fields are mandatory.
• Incorrect Data Formats: Use the correct date, time, and number formats as specified in the schema.
• Digital Signature Issues: Ensure that the digital signature is valid and generated using a qualified certificate.
• VAT Calculation Errors: Double-check your VAT calculations to ensure accuracy.

Using validation tools and testing your XML documents thoroughly before submission can help identify and resolve these errors.

Tools and Resources for ZATCA XML Schema Compliance

Several tools and resources can assist businesses in achieving ZATCA XML schema compliance:

• ZATCA Website: The official ZATCA website provides the latest schema specifications, guidelines, and FAQs.
• XML Schema Validators: Online and offline XML schema validators can be used to check the validity of your XML documents against the ZATCA schema.
• E-Invoicing Software Solutions: Specialized e-invoicing software solutions automate the process of generating compliant XML documents. These often integrate with existing accounting and ERP systems.
• Consultants: Tax consultants and e-invoicing experts can provide guidance and support to businesses navigating the complexities of ZATCA compliance.

The Importance of Choosing the Right E-Invoicing Solution

Complying with ZATCA e-invoicing requirements can be complex and time-consuming, especially for businesses without prior experience in XML schema implementation. Choosing the right e-invoicing solution can significantly simplify the process and ensure ongoing compliance. A good solution will handle the intricacies of the ZATCA XML schema, digital signature generation, and QR code creation automatically.

FatooraPlus: Your Partner for ZATCA Compliance

We highly recommend considering FatooraPlus as your e-invoicing solution. FatooraPlus is specifically designed to meet the requirements of ZATCA e-invoicing regulations. It provides a user-friendly interface, automates XML generation, and handles all aspects of ZATCA compliance. This helps businesses comply with the ZATCA mandate while reducing operational costs and improving efficiency.

Key Benefits of Using FatooraPlus

• Simplified XML Generation: FatooraPlus automatically generates compliant ZATCA XML documents, eliminating the need for manual coding.
• Seamless Integration: Integrates with existing accounting and ERP systems.
• Digital Signature Management: Handles digital signature generation and management.
• QR Code Generation: Automatically creates QR codes for invoices.
• Real-time Validation: Provides real-time validation of XML documents to ensure compliance.
• Ongoing Updates: Automatically updated to reflect the latest ZATCA regulations and schema changes.

Preparing for ZATCA Wave 23 and Wave 24 in 2026: A Practical Guide

As 2026 approaches, here's a practical guide to help your business prepare for ZATCA Waves 23 and 24:

1. Determine Your Eligibility: Closely monitor ZATCA announcements to determine your eligibility for Wave 23 or Wave 24 based on your annual revenue.
2. Understand the Requirements: Thoroughly understand the ZATCA XML schema specifications and other relevant regulations.
3. Choose an E-Invoicing Solution: Select an e-invoicing solution that meets your business needs and ensures ZATCA compliance. Consider FatooraPlus for its comprehensive features and ease of use.
4. Implement and Test: Implement your chosen e-invoicing solution and thoroughly test it to ensure that it generates valid and compliant XML documents.
5. Train Your Staff: Train your staff on the new e-invoicing processes and procedures.
6. Stay Updated: Stay informed about any changes to the ZATCA regulations and schema specifications.

Conclusion

Compliance with the ZATCA XML schema is essential for businesses operating in Saudi Arabia. By understanding the key components of the schema, avoiding common errors, and choosing the right e-invoicing solution, businesses can ensure compliance and avoid penalties. With Waves 23 and 24 on the horizon in 2026, now is the time to take proactive steps to prepare for e-invoicing implementation.

Don't wait until the last minute to prepare for ZATCA compliance. Take control of your e-invoicing journey today!

Start your free trial of FatooraPlus now at fatooraplus.com and ensure seamless ZATCA compliance!