Skip to Content

ZATCA Backend Processing Only

by
Odoo

$ 199.31

In-App Purchases
v 19.0 Third Party
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Point of Sale (point_of_sale)
• Invoicing (account)
• Discuss (mail)
• Inventory (stock)
Lines of code 607
Technical Name saqer_zatca_backend_only
LicenseLGPL-3
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Point of Sale (point_of_sale)
• Invoicing (account)
• Discuss (mail)
• Inventory (stock)
Lines of code 607
Technical Name saqer_zatca_backend_only
LicenseLGPL-3

ZATCA Backend Processing

معالجة فواتير الزكاة والضريبة من الخلفية

تسريع نقطة البيع بنسبة تصل إلى 90% عبر تأجيل إرسال فواتير ZATCA إلى مهام الخلفية
Speed up your POS by deferring ZATCA EDI submission to scheduled backend jobs

Odoo 19.0 Point of Sale ZATCA Phase 2 Saudi Arabia

المشكلة / The Problem

عند إصدار الفواتير من نقطة البيع في المملكة العربية السعودية، يقوم Odoo بإرسال الفاتورة فوراً إلى هيئة الزكاة والضريبة (ZATCA) مما يسبب تأخيراً من 3 إلى 8 ثوانٍ في كل عملية دفع، وأحياناً تجميد الشاشة أو فشل العمليات في أوقات الذروة.

In standard Odoo, every POS payment waits for a synchronous ZATCA submission (3–8 seconds), freezing the cashier screen and causing chain-lock issues during peak hours.

الحل / The Solution

تقوم هذه الوحدة بتأجيل إرسال فواتير ZATCA إلى مهام الخلفية (Cron) المجدولة، بحيث يُغلق الكاشير الطلب فوراً دون أي انتظار، وتتم معالجة الفاتورة مع هيئة الزكاة في الخلفية تلقائياً.

3-8s

قبل / Before

الكاشير ينتظر رد ZATCA بعد كل دفعة
Cashier waits for ZATCA response

<0.5s

بعد / After

إغلاق فوري للطلب، الإرسال في الخلفية
Instant checkout, background submission

100%

التوافق / Compliance

توافق كامل مع متطلبات ZATCA Phase 2
Full ZATCA Phase 2 compliance

المميزات الرئيسية

Key Features

⚡

أداء فائق السرعة / Ultra-fast POS

إغلاق فوري للطلب دون انتظار رد ZATCA. تعطيل توليد ملف PDF أثناء البيع لتوفير ثوانٍ إضافية.

🔄

معالجة آلية بالخلفية / Automatic Backend Processing

مهام Cron المدمجة في Odoo تقوم بإرسال الفواتير إلى ZATCA كل 5 دقائق تلقائياً دون أي تدخل.

📱

QR على الإيصال فوراً / Instant QR on Receipt

يظهر رمز QR للمرحلة الأولى على إيصال نقطة البيع مباشرة (توليد من JavaScript)، ويُستبدل بـ QR المرحلة الثانية من الخلفية.

🔗

حماية سلسلة الفواتير / Chain Integrity Protection

الحفاظ الكامل على تسلسل chain_index المطلوب من ZATCA، مع آلية استرداد ذكية للفواتير المعطّلة في السلسلة.

🛠️

أزرار إعادة المحاولة / Retry & Reset Buttons

أزرار يدوية على الفاتورة لإعادة إرسال ZATCA أو تصفير الحالة، مع بنر تحذيري يُظهر الفاتورة المعطِّلة للسلسلة.

🔍

فلاتر متابعة جاهزة / Smart Tracking Filters

فلاتر جديدة في شاشة الفواتير: "ZATCA معلّقة" و"ZATCA محجوبة" لمتابعة حالة الإرسال بسهولة.

⚙️

تحكم لكل نقطة بيع / Per-POS Configuration

تفعيل/تعطيل المعالجة بالخلفية من إعدادات كل نقطة بيع على حدة، مع التفعيل التلقائي للشركات السعودية.

🛡️

معالجة أخطاء قوية / Robust Error Handling

لا تتوقف نقطة البيع بسبب أخطاء ZATCA، مع سجل كامل (Logs) لكل محاولة إرسال وإمكانية إعادة المعالجة بسهولة.

🌍

متعدد الشركات / Multi-Company Ready

يؤثر فقط على الشركات السعودية (country_code = 'SA')، دون أي تغيير على سلوك نقاط البيع في الدول الأخرى.

كيف تعمل الوحدة

How It Works

1

دفع في POS

الكاشير يستلم المبلغ ويضغط "Validate" - الطلب يُغلق فوراً.

2

إنشاء الفاتورة

تُنشأ الفاتورة بحالة "To Send" مع تجاوز إرسال ZATCA الفوري.

3

QR على الإيصال

يُطبع QR المرحلة الأولى على الإيصال الحراري للعميل.

4

إرسال بالخلفية

مهمة Cron تقوم بإرسال الفاتورة إلى ZATCA وتحديث حالتها إلى "Sent".

التثبيت والإعداد

Installation & Configuration

خطوات التثبيت

  1. انسخ الوحدة إلى مجلد addons الخاص بـ Odoo.
  2. أعد تشغيل خادم Odoo.
  3. من التطبيقات اضغط تحديث قائمة التطبيقات.
  4. ابحث عن "ZATCA Backend" ثم اضغط تثبيت.

خطوات الإعداد

  1. اذهب إلى نقطة البيع > الإعدادات > نقطة البيع.
  2. افتح إعدادات نقطة البيع لديك.
  3. في تبويب المحاسبة، فعّل خيار "Defer ZATCA Processing to Backend".
  4. احفظ وأعد فتح الجلسة - الوحدة جاهزة للعمل!

ملاحظة: الخيار مُفعّل تلقائياً لأي شركة دولتها هي المملكة العربية السعودية (SA).

المواصفات التقنية / Technical Specifications

إصدار Odoo / Odoo Version 19.0 Community & Enterprise
الرخصة / License LGPL-3
الاعتمادات / Dependencies point_of_sale, l10n_sa_edi, l10n_sa_edi_pos, account_edi
الفئة / Category Point of Sale / Accounting
الدولة المستهدفة / Target Country Saudi Arabia (KSA) - ZATCA compliant
متعدد الشركات / Multi-Company Yes - SA companies only

لمن هذه الوحدة؟ / Who Is This For?

🍔 المطاعم والمقاهي

ذات أوقات ذروة عالية، حيث كل ثانية في نقطة البيع تعني رضا أكبر للعملاء.

🛒 المتاجر والسوبر ماركت

عدد كبير من عمليات البيع اليومية وصفوف انتظار طويلة.

⛽ محطات الوقود

حجم معاملات ضخم يحتاج استجابة فورية من نقطة البيع.

🏪 سلاسل الفروع

فروع متعددة تصدر فواتير متزامنة، مع ضرورة الحفاظ على تسلسل ZATCA.

الأسئلة الشائعة / Frequently Asked Questions

هل ستبقى الفواتير متوافقة مع ZATCA؟

نعم. الوحدة لا تغيّر أي منطق في التوقيع أو الإرسال، بل تؤجّله فقط لمهمة Odoo المدمجة EDI: Perform web services operations، لذا تبقى الفواتير متوافقة 100% مع ZATCA Phase 2.

ماذا يحدث لو فشل الإرسال لـ ZATCA؟

لا تتوقف نقطة البيع إطلاقاً. الفاتورة تبقى بحالة "To Send" ويمكن للمحاسب استخدام زر Retry ZATCA أو الفلاتر الجديدة لمتابعة الفواتير المعلقة وإعادة معالجتها.

هل QR Code سيظهر على إيصال العميل؟

نعم. يتم توليد QR المرحلة الأولى مباشرة من JavaScript في نقطة البيع، ويُطبع على الإيصال الحراري فوراً، أما QR المرحلة الثانية (مع التوقيع) فيُضاف لاحقاً بواسطة مهمة الخلفية على ملف PDF.

هل تؤثر الوحدة على الشركات خارج السعودية؟

لا. المنطق مقيد بالشركات التي دولتها هي المملكة العربية السعودية country_code = 'SA'، والشركات الأخرى تعمل بسلوك Odoo القياسي دون أي تغيير.

كم تستغرق مهمة الخلفية لإرسال الفواتير؟

مهمة Odoo المدمجة EDI: Perform web services operations تعمل افتراضياً كل بضع دقائق، ويمكن تعديل التكرار حسب حجم العمليات من إعدادات المهام المجدولة (Scheduled Actions).

جاهز لتسريع نقطة البيع لديك؟

انضم للمتاجر التي تُصدر فواتير ZATCA دون أي انتظار في الكاشير.

Developed by Saqer
For support, customization, or technical questions, contact the developer team.

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 or have a question related to your purchase, please use the support page.