Skip to Content

Saudi Arabia - POS Direct ZATCA Integration

by ,
Odoo
v 18.0 Third Party 213
Download for v 18.0 Deploy on Odoo.sh
Versions 17.0 18.0
You bought this module and need support? Click here!
Versions 17.0 18.0
✨ 70% Faster 🚀 Phase 2 Compliant ⚡ Async Processing 🔒 Secure

🇸🇦 ZATCA Direct POS Integration

Enhanced Saudi Arabia E-Invoicing Phase 2 for Point of Sale

Overview

An optimized replacement for the standard l10n_sa_edi_pos module, providing direct ZATCA integration with significant performance improvements and enhanced functionality designed specifically for high-volume retail environments in Saudi Arabia.

This module eliminates the need for customer data entry in cash transactions, removes unnecessary PDF generation, and provides true Phase 2 QR code compliance with digital signatures and async reporting.

نظرة عامة

موديول محسن بديل عن l10n_sa_edi_pos الافتراضي، يوفر تكامل مباشر مع هيئة الزكاة والضريبة مع تحسينات كبيرة في الأداء ووظائف محسنة مصممة خصيصاً لبيئات التجزئة عالية الحجم في المملكة العربية السعودية.

70%

Faster Processing

100%

Phase 2 Compliant

24h

Async Reporting

0

PDF Generation

Module Comparison

Feature l10n_sa_edi_pos (Standard) l10n_sa_edi_pos_direct (Enhanced)
Customer Data Requirement ❌ Requires full customer data for every POS transaction
يتطلب بيانات العميل كاملة مع كل عملية 		✅ Cash customer support (no customer data needed)
دعم العميل النقدي (لا يتطلب بيانات العميل)
PDF Generation ❌ Creates A4 PDF invoice for every POS order
ينشئ فاتورة PDF مع كل طلب 		✅ No PDF generation - POS receipts only
لا ينشئ PDF - إيصالات نقاط البيع فقط
Database Load ❌ Heavy database connection with every transaction
يتطلب الاتصال بقاعدة البيانات مع كل عملية 		✅ Minimal database impact - frontend processing
تأثير قليل على قاعدة البيانات - معالجة على واجهة نقاط البيع فقط
QR Code Compliance ⚠️ Basic Phase 1 (only 5 fields)
رمز QR بالمرحلة الأولى الأساسية (5 حقول فقط) 		✅ Full Phase 2 (9 fields + digital signatures)
رمز QR بالمرحلة الثانية كاملة (9 حقول + توقيعات رقمية)
ZATCA Synchronization ❌ Immediate sync required (not required for simplified)
مزامنة فورية مطلوبة (غير مطلوبة للمبسطة) 		✅ Compliant 24-hour async reporting
تقارير غير متزامنة خلال 24 ساعة حسب اللوائح
Record Duplication ❌ POS Order + Account Invoice (double records)
طلب نقاط البيع + فاتورة محاسبية (سجلات مضاعفة) 		✅ Single POS record - no duplication
سجل نقاط البيع واحد - لا تكرار

Key Features

Cash Customer Support

No customer data required for cash transactions, streamlining the POS workflow.

Full Phase 2 QR Codes

Complete ZATCA Phase 2 compliance with 9-field QR codes and digital signatures.

Async Processing

24-hour compliant async reporting without blocking POS operations.

Minimal Database Load

Frontend processing reduces database connections and improves performance.

Installation & Configuration

Important: This module replaces the standard l10n_sa_edi_pos module. Uninstall the standard module before installing this enhanced version.

Step 1: Remove Standard Module

Uninstall the existing l10n_sa_edi_pos module from your system to avoid conflicts.

Step 2: Install Enhanced Module

Install l10n_sa_edi_pos_direct through the Apps menu or via command line.

Step 3: Verify Configuration

Ensure your ZATCA certificate is properly configured in the invoice journal settings.

Step 4: Enable Direct Mode

Navigate to POS Configuration and enable "ZATCA Direct Mode" for your point of sale.

Step 5: Test Transactions

Perform test transactions to verify QR code generation and ZATCA submission workflow.

Changelog

  • 18.0.1.3.2 04-06-2026
    • 🐛 Fixed Cron Search Error: ZATCA cron jobs now filter companies via the stored partner_id.country_id path, removing the "Non-stored field res.company.country_id cannot be searched" error
  • 18.0.1.3.0 29-08-2025
    • 🔧 Enhanced QR Code Integration: Improved override of compute_sa_qr_code method to properly use l10n_sa_pos functions
    • 🚀 Code Optimization: Removed redundant QR generation methods and streamlined date formatting
  • 18.0.1.2.0 22-08-2025
    • 🔧 Fixed Arabic Character Encoding: Resolved btoa() InvalidCharacterError when using Arabic language interface
    • 🛡️ Improved Unicode Support: Enhanced base64 encoding for ZATCA compliance with Arabic text
  • 18.0.1.1.0 20-08-2025
    • ✅ Added ZATCA Refund Features: Interactive refund reason popup with 6 predefined codes and full ZATCA compliance (BR-KSA-17, BR-KSA-F-04)

GitHub Repository

This module is open source and available on GitHub. Contributions and feedback are welcome.

هذا الموديول مفتوح المصدر ومتاح على GitHub. المساهمات والملاحظات مرحب بها.

https://github.com/amr-devops/l10n_sa_edi_pos_direct/tree/18.0

Support & Contact

Author Information

  • Author: EasyERPS, AMR Hawsawi
  • License: LGPL-3
  • Website: https://easyerps.com

Target Market

This module is designed for Saudi Arabian businesses requiring high-performance ZATCA compliance in retail environments.

Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Point of Sale (point_of_sale)
• Discuss (mail)
• Inventory (stock)
• Invoicing (account)
Community Apps Dependencies
Lines of code 5324
Technical Name l10n_sa_edi_pos_direct
LicenseLGPL-3
Websitehttps://easyerps.com

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.