الفاتورة الإلكترونية في Odoo: دليل التكامل الكامل مع ZATCA 2026
كل ما تحتاج معرفته عن دعم Odoo للفاتورة الإلكترونية السعودية: المرحلتان، الموجات، الغرامات، وخطوات الربط الفعلية مع منصة فاتورة.
الفاتورة الإلكترونية في Odoo: التكامل مع ZATCA
إجابة سريعة: يدعم Odoo Enterprise التكامل الرسمي الكامل مع نظام الفاتورة الإلكترونية السعودية "فاتورة" التابع لهيئة الزكاة والضريبة والجمارك (ZATCA)، بمرحلتيه: الإصدار (Phase 1) والربط والتكامل (Phase 2). هذا يشمل توليد الفواتير بصيغة XML المعتمدة، الختم الرقمي المشفَّر، رمز الاستجابة السريع (QR)، والاتصال المباشر بواجهة برمجة تطبيقات فاتورة للحصول على تصديق فوري على الفواتير. تنبيه توقيت مهم: المواعيد النهائية لأغلب الموجات الكبرى (الموجة 23 والموجة 24) انقضت بالفعل بحلول منتصف 2026، وانتهت معها فترة السماح من الغرامات — ما يعني أن الامتثال الآن أصبح إلزامياً وفورياً لأي شركة تجاوزت عتبة الإيرادات المحدَّدة دون أي استثناء.
ما هي منظومة "فاتورة"؟ ومرحلتاها الأساسيتان
"فاتورة" هو النظام الوطني السعودي للفوترة الإلكترونية الذي تشرف عليه هيئة الزكاة والضريبة والجمارك، ويهدف لاستبدال الفواتير الورقية أو المُصدرة ببرامج تحرير النصوص بفواتير إلكترونية موثوقة وقابلة للتتبّع بالكامل. ينقسم النظام إلى مرحلتين مختلفتين تقنياً:
المرحلة الأولى: الإصدار (سارية منذ ديسمبر 2021)
تُلزم كل شركة خاضعة لضريبة القيمة المضافة بإصدار فواتيرها إلكترونياً (بدلاً من الفواتير اليدوية) بصيغة تحتوي كل الحقول الإلزامية، مع رمز QR على الفواتير المبسّطة، دون أي اتصال مباشر مع أنظمة الهيئة بعد. هذه المرحلة إلزامية لكل شركة سعودية بلا استثناء تقريباً منذ سنوات، ومن المتوقَّع أن تكون كل شركة ممتثلة لها فعلياً بحلول الآن.
المرحلة الثانية: الربط والتكامل (تُطبَّق تدريجياً بموجات)
هنا يصبح الأمر أكثر تعقيداً تقنياً: يجب أن يتصل نظامك مباشرة بمنصة فاتورة عبر واجهة برمجة تطبيقات معتمدة، بحيث تُرسَل كل فاتورة فور إصدارها للتصديق أو الإبلاغ عنها في الوقت الفعلي تقريباً. كل فاتورة متوافقة مع هذه المرحلة يجب أن تحتوي:
معرّف فريد عالمي (UUID) لكل فاتورة على حدة.
ختم تشفير (Cryptographic Stamp) موقَّع عبر شهادة معرّف الختم التشفيري (CSID).
توقيع رقمي باستخدام شهادة X.509 صادرة عبر بوابة اعتماد ZATCA.
رمز QR مُشفَّر بصيغة TLV يحمل تسع بيانات إلزامية محدَّدة.
سلسلة تجزئة (Hash Chain) بمعيار SHA-256 تربط كل فاتورة بالفاتورة السابقة لها، بحيث يصعب حذف أو تعديل أي فاتورة دون كسر هذه السلسلة بشكل قابل للاكتشاف فوراً من الهيئة.
الفرق بين نمط الربط (B2B) ونمط التقرير (B2C)
نقطة تقنية غالباً ما تسبب لبساً: تُعامَل الفواتير بشكل مختلف حسب طبيعة العميل:
الفواتير الضريبية القياسية (B2B وB2G): تخضع لنمط الربط المسبق (Clearance) — يجب إرسال الفاتورة لمنصة فاتورة والحصول على تصديقها قبل تسليمها للعميل فعلياً، وعادة في أقل من ثوانٍ معدودة.
الفواتير الضريبية المبسّطة (B2C، كنقاط البيع والتجزئة): تخضع لنمط التقرير (Reporting) — تُصدَر الفاتورة للعميل فوراً، لكن يجب الإبلاغ عنها لمنصة فاتورة خلال مهلة أقصاها 24 ساعة من إصدارها.
تحديث توقيتي مهم: الموجات وانتهاء فترة السماح
يُطبَّق تكامل المرحلة الثانية تدريجياً عبر "موجات" تستهدف الشركات حسب حجم إيراداتها الخاضعة للضريبة، بإشعار مسبق من الهيئة لا يقل عن ستة أشهر قبل كل موعد نهائي. آخر موجتين كبيرتين معلَنتين:
الموجة 23: استهدفت الشركات التي تجاوزت إيراداتها 750,000 ريال في أي من أعوام 2022 أو 2023 أو 2024، بموعد نهائي في 31 مارس 2026.
الموجة 24: خفّضت العتبة إلى 375,000 ريال فقط، بموعد نهائي في 30 يونيو 2026 — وهو نفس الموعد الذي انتهت فيه أيضاً مبادرة الهيئة لإلغاء الغرامات وإعفاء دافعي الضرائب منها.
بمعنى آخر: إذا كانت إيرادات شركتك الخاضعة للضريبة تجاوزت 375,000 ريال في أي من الأعوام المذكورة، فأنت على الأرجح مشمول بالفعل بالتزام الربط الكامل، ودخلت الهيئة اعتباراً من يوليو 2026 مرحلة "إنفاذ كامل دون استثناءات". إن لم تكن قد أكملت الربط بعد وشركتك ضمن هذا النطاق، فالخطوة العاجلة هي التحقق فوراً من حالة شركتك عبر بوابة ZATCA الرسمية دون تأجيل.
الغرامات: ما الذي يخاطر به عدم الامتثال؟
نشرت الهيئة هيكلاً واضحاً للغرامات، من أبرزها:
عدم إصدار الفاتورة الإلكترونية أو عدم أرشفتها: غرامة تبدأ من 5,000 ريال.
حذف أو تعديل فاتورة إلكترونية بعد إصدارها: غرامة تبدأ من 10,000 ريال.
عدم وجود رمز QR متوافق: غرامة قد تصل إلى 10,000 ريال لكل فاتورة.
الغرامات تتصاعد مع تكرار المخالفة خلال فترة اثني عشر شهراً، وقد تصل لحالات أكثر خطورة إلى تعليق مؤقت للتسجيل الضريبي.
كيف يدعم Odoo هذا التكامل عملياً؟
ضمن نسخة Enterprise، يوفر Odoo تكاملاً رسمياً جاهزاً يغطي كل المتطلبات التقنية السابقة دون الحاجة لبناء حل من الصفر. خطوات الإعداد الأساسية:
التحقق من بيانات الشركة: التأكد من اكتمال اسم الشركة (بحد أقصى 63 حرفاً وفق متطلبات ZATCA)، العنوان الكامل (بما في ذلك رقم المبنى والرقم الإضافي)، الرقم الضريبي، والعملة المضبوطة على الريال السعودي.
إنشاء طلب توقيع الشهادة (CSR) والحصول على CSID الامتثال (Compliance CSID) — شهادة مؤقتة تُستخدَم لاختبار التكامل قبل الإنتاج الفعلي.
اختبار كامل عبر بيئة المحاكاة (Fatoora Simulation Portal): تسجيل الدخول ببيانات اعتماد الشركة، والتبديل لبيئة المحاكاة المخصصة للاختبار، حيث تُختبر كل سيناريوهات الفوترة (فواتير قياسية، مبسّطة، إشعارات دائن ومدين) دون أي أثر رسمي فعلي.
ضبط دفاتر اليومية (Journals): كل دفتر يومية مبيعات يحتاج رقماً تسلسلياً مخصصاً، وربطه عبر رمز تحقق لمرة واحدة (OTP) يُولَّد من بوابة فاتورة نفسها.
الانتقال لبيئة الإنتاج والحصول على CSID الإنتاج: بعد اجتياز كل الاختبارات بنجاح، يمكن تفعيل وضع "الإنتاج" (Production) والحصول على شهادة الإنتاج النهائية.
⚠️ تحذير لا يمكن التكرار عليه كفاية: الانتقال من وضع المحاكاة إلى وضع الإنتاج إجراء لا يمكن التراجع عنه إطلاقاً. أي فاتورة تُرسَل بالخطأ في وضع الإنتاج تُعتبر رسمياً وقد تُحاسَب عليها الشركة فعلياً. لهذا، يجب اختبار كل سيناريوهات الفوترة الممكنة (بما فيها الحالات الاستثنائية كالخصومات والإشعارات الدائنة) في بيئة المحاكاة أولاً، والتأكد التام من صحة الإعداد قبل أي تفعيل نهائي.
نقطة حاسمة: هذا التكامل حصري لنسخة Enterprise
كما ذكرنا في مقالات سابقة ضمن هذه السلسلة، فإن حزمة التوطين السعودي الكاملة — شجرة الحسابات المتوافقة، ضرائب القيمة المضافة الجاهزة، والتكامل الرسمي مع فاتورة تحديداً — متوفرة حصرياً ضمن نسخة Odoo Enterprise. نسخة Community لا تتضمن هذا التكامل افتراضياً، وأي شركة تعتمد عليها تحتاج إما بناء حل تكامل مخصص من الصفر، أو الاعتماد على إضافة من طرف ثالث غير مدعومة رسمياً من Odoo — وهو خيار أقل أماناً بكثير نظراً لحساسية هذا النوع من الامتثال النظامي وسرعة تغيّر متطلباته.
خطوات عملية للتحقق من جاهزية شركتك الآن
تحقق من حالتك في بوابة ZATCA لمعرفة إن كانت شركتك مشمولة فعلياً بأي موجة سارية، بناءً على إيراداتك الخاضعة للضريبة في الأعوام الأخيرة.
راجع نسخة Odoo التي تستخدمها حالياً — إن كانت Community، فأنت بحاجة لخطة انتقال عاجلة إلى Enterprise أو حل بديل موثوق.
لا تعتمد فقط على التوافق مع المرحلة الأولى — نظام يصدر فواتير إلكترونية بشكل صحيح لا يعني بالضرورة جاهزيته الكاملة لمتطلبات الربط الفعلي في المرحلة الثانية.
اختبر كل سيناريوهات فوترتك الفعلية (بما فيها الاستثناءات والحالات الخاصة) على بيئة المحاكاة قبل أي انتقال للإنتاج.
استعن بشريك Odoo لديه خبرة موثّقة تحديداً في تكامل ZATCA، وليس فقط خبرة عامة بـOdoo — فارق الخبرة هنا حاسم نظراً لحساسية الموضوع.
الخلاصة
الفاتورة الإلكترونية السعودية لم تعد مجرد "إضافة تقنية اختيارية" بل التزام قانوني كامل يخضع لإنفاذ صارم اعتباراً من منتصف 2026 لكل شركة تتجاوز عتبات إيرادات منخفضة نسبياً. يوفر Odoo Enterprise تكاملاً رسمياً جاهزاً يغطي كل المتطلبات التقنية المعقدة لهذا الالتزام، لكن نجاح التطبيق الفعلي يعتمد بشدة على دقة الإعداد والاختبار قبل أي انتقال نهائي للإنتاج — وهي خطوة تستحق الاستعانة بخبرة متخصصة بدل المخاطرة بغرامات فعلية قابلة للتجنب بالكامل.
الأسئلة الشائعة
هل كل شركة سعودية ملزمة بالمرحلة الثانية من الفاتورة الإلكترونية؟ الالتزام يعتمد على تجاوز عتبة إيرادات محدَّدة أعلنتها الهيئة لكل موجة. بحلول منتصف 2026، انخفضت هذه العتبة لتشمل الشركات التي تجاوزت 375,000 ريال في إيراداتها الخاضعة للضريبة خلال الأعوام الأخيرة، ما يعني شمول شريحة واسعة جداً من الشركات الصغيرة والمتوسطة.
ما الفرق بين نمط الربط ونمط التقرير؟ نمط الربط (Clearance) يُطبَّق على فواتير الشركات (B2B) ويتطلب تصديق الفاتورة من الهيئة قبل تسليمها للعميل. نمط التقرير (Reporting) يُطبَّق على فواتير المستهلكين (B2C) وتُصدَر الفاتورة فوراً مع إبلاغ الهيئة خلال 24 ساعة.
هل يمكن التراجع بعد تفعيل وضع الإنتاج في Odoo؟ لا، هذا الانتقال نهائي وغير قابل للتراجع. لهذا يُنصح دوماً باختبار كل السيناريوهات الممكنة على بيئة المحاكاة أولاً قبل أي تفعيل فعلي.
هل يمكن الاعتماد على Odoo Community لتحقيق الامتثال؟ لا يُنصح بذلك؛ التكامل الرسمي مع فاتورة حصري لنسخة Enterprise. الاعتماد على حلول بديلة غير رسمية مع Community يحمل مخاطرة أعلى بكثير نظراً لحساسية هذا النوع من الامتثال.
ماذا يحدث إن لم تلتزم شركتي بالموعد النهائي لموجتها؟ تتعرض الشركة لغرامات فعلية تتراوح غالباً بين 5,000 و50,000 ريال حسب نوع المخالفة، مع تصاعد الغرامة عند تكرارها، وقد تصل الحالات الأكثر خطورة إلى تعليق مؤقت للتسجيل الضريبي.