Saudi Arabia - POS Direct ZATCA Integration
by EasyERPS https://easyerps.com , AMR Hawsawi https://easyerps.com| 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 | Show |
| Lines of code | 5133 |
| Technical Name |
l10n_sa_edi_pos_direct |
| License | LGPL-3 |
| Website | https://easyerps.com |
| 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 | Show |
| Lines of code | 5133 |
| Technical Name |
l10n_sa_edi_pos_direct |
| License | LGPL-3 |
| Website | https://easyerps.com |
🇸🇦 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
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.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.
Please log in to comment on this module