Integrating ZATCA with SAP Business One

Looking to integrate ZATCA with SAP Business One? This guide will walk you through the process step by step, ensuring a smooth and successful integration.

Ajith Kumar M
July 30, 2023
4 min

Sign up for E-Invoicing Newsletter

The latest industry news, technologies and resources.
We care about your data in our privacy policy.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.


In the Kingdom of Saudi Arabia (KSA), the transition to electronic invoicing (e-invoicing) is a significant step towards digital transformation in financial processes. A key component in this shift is the role of middleware in integrating with the Zakat, Tax, and Customs Authority (ZATCA) system. This blog post explores how middleware functions in this context and how offers a streamlined solution for SAP B1 integration with ZATCA.

The SAP B1 E-Invoice Generation Workflow:

The e-invoice generation process in SAP B1 is designed for efficiency and ease of use. From generating invoices to converting them into e-invoices, creating PDF A/3 files, and emailing these documents, SAP B1 handles it all within its integrated platform. This not only saves time but also enhances accuracy and compliance.

There are two ways to trigger e-invoice generation in SAP B1. The first involves a manual selection of pending invoices, followed by the “Generate E-Invoice” command. The second method is more automated, where e-invoices are generated upon the creation or approval of an invoice in the ERP system. This flexibility ensures that the process aligns with various business operations, making it a versatile tool for all users.

One of the key strengths of SAP B1’s e-invoicing solution lies in its customizable integration. Recognizing that each business has unique needs, the integration process begins with a thorough analysis of the existing ERP system. This involves examining the ERP’s capabilities and exploring the database, like MySQL, to identify the specific invoice data tables required. This tailored approach ensures that the integration aligns perfectly with the business's operational needs, making the transition to e-invoicing smooth and efficient.

The Integration Workflow:

  1. Database Extraction:
  2. The process begins with extracting data from the SAP B1 database.
  3. This data is typically in SQL format, allowing for seamless extraction and manipulation.
  4. Bill Details Retrieval:
  5. The next step involves retrieving detailed information from the bills, including items, quantities, prices, and more.
  6. API Field Mapping:
  7. Essential fields required for e-invoicing are identified and mapped through an API.
  8. This step ensures that all necessary data for VAT compliance and e-invoicing is captured accurately.
  9. VAT Calculations:
  10. VAT details, such as tax rates and total tax amounts, are calculated.
  11. These calculations are crucial for compliance with KSA’s tax regulations.
  12. Data Transfer from SAP B1 to
  13. The processed data is then transferred from the SAP B1 database to the database.
  14. This transfer involves secure data transmission protocols to ensure data integrity and security.
  15. Validation and Data Storage in Database:
  16. Upon receiving the data, performs a series of validations to check for accuracy and compliance.
  17. Validated data is then stored in the database, ready for the next steps in the e-invoicing process.
  18. Communication with ZATCA:
  19. The validated invoice data is sent to ZATCA for compliance verification and approval.
  20. This step is crucial for ensuring that the e-invoices meet all regulatory requirements set by ZATCA.
  21. Receiving QR Code and XML from ZATCA:
  22. Once the invoice is approved, ZATCA returns a QR code and XML data.
  23. This data is crucial for finalizing the e-invoice and ensuring it meets all the legal requirements.
  24. Updating Databases with QR and XML Data:
  25. The received QR code and XML data are updated in both the client’s SAP B1 database and the database.
  26. This ensures that both systems reflect the latest, compliant invoice data.

The Role of Middleware in E-Invoicing and ZATCA Compliance:

Middleware is an essential component in this integration, serving as the connective tissue between SAP B1 and ZATCA’s system. It not only facilitates seamless data flow but also ensures that all e-invoicing activities comply with the stringent regulations set by ZATCA. emerges as a robust middleware solution, offering APIs that connect ERP/POS systems with ZATCA. This ensures full compliance with e-invoicing regulations, making the middleware an indispensable part of the e-invoicing ecosystem.

  • Key Features of E-Invoicing Middleware:
  • Utilizes RESTful APIs for easy integration with any ERP/POS system.
  • Requires minimal changes to existing ERP/POS setups.
  • Supports a wide range of document types through a single API.
  • Maintains a constant, uninterrupted connection with ZATCA.
  • Enables the smooth generation of e-invoices.
  • Supports the creation of invoices in PDF/A3 format, complete with embedded XML.

How Facilitates SAP B1 and ZATCA Integration:

  • Seamless Connection:’s APIs act as an efficient middleware, linking ERP/POS systems with ZATCA, ensuring full e-invoicing compliance.
  • Simplified Registration: The system can register multiple ERP/POS systems with ZATCA in a single action.
  • Security and Compliance: Each device is registered with a unique cryptographic stamp, enhancing security and compliance.

Advanced Features of for E-Invoicing:

  • Data Validation: Over 150 smart data checks confirm that invoice data aligns with ZATCA regulations, ensuring accuracy and minimizing errors.
  • Mandatory Fields Generation: The system automatically generates essential fields such as invoice hash, previous invoice hash, UUID, invoice counter value, and QR code.
  • Invoice Data Conversion: Invoice data is converted into the UBL 2.1 schema in XML format, as specified by ZATCA.
  • Automated Data Processing: Invoice data is sent to the cloud platform for conversion into ZATCA-compliant e-invoices.
  • Enhanced Invoice Format: adds a Phase II QR code and certified XML to existing invoices, resulting in the final PDF A/3 invoice.
  • Data Archival: E-invoice data is stored for up to six years on SLA-based cloud servers, ensuring long-term accessibility and compliance.


The integration of SAP B1 with ZATCA through middleware like is a game-changer for businesses in KSA. By simplifying and automating e-invoicing processes, ensures that businesses not only comply with the latest regulations but also streamline their financial operations. With these advanced features, businesses can confidently navigate the digital landscape of e-invoicing, ensuring accuracy, security, and efficiency.