Skip to Content

The Comprehensive Technical Guide: How Does Odoo Meet the Integration Phase (Phase 2) Requirements with ZATCA?

تعرف على كيفية إعداد وربط نظام Odoo مع منصة فاتورة التابعة لهيئة الزكاة والضريبة والجمارك (ZATCA) للامتثال لمتطلبات المرحلة الثانية من الفوترة الإلكترونية، بدءًا من التكامل عبر واجهات API، وإنشاء فواتير XML وPDF/A-3، وحتى إدارة فواتير B2B وB2C والأرشفة الإلكترونية وفق الأنظمة السعودية.
September 27, 2026 by
The Comprehensive Technical Guide: How Does Odoo Meet the Integration Phase (Phase 2) Requirements with ZATCA?
Mohamed Hamdeen (MOHA)

ما هي المرحلة الثانية من الفوترة الإلكترونية؟

هيئة الزكاة والضريبة والجمارك (ZATCA) قسمت مشروع الفوترة الإلكترونية في السعودية إلى مرحلتين رئيسيتين: مرحلة التوليد (Phase 1) ومرحلة الربط والتكامل (Phase 2). في المرحلة الأولى كان المطلوب فقط إصدار فاتورة إلكترونية تحتوي على عناصر إلزامية مثل رقم الضريبة وQR Code وعدم قبول الفواتير المكتوبة يدويا أو في ملفات Word/Excel فقط.


المرحلة الثانية هي مرحلة الربط والتكامل (Integration / Clearance & Reporting)، وفيها يصبح نظام الفوترة في شركتك متصلاً مباشرة بمنصة فاتورة التابعة لـ ZATCA، بحيث يتم إرسال الفواتير إليها آليًا للموافقة (B2B) أو التبليغ (B2C) وفقًا لمتطلبات الهيئة. هذه المرحلة تفرض متطلبات تقنية إضافية على الأنظمة مثل أودو لضمان الامتثال الكامل وتفادي الغرامات أو رفض الفواتير.

أولا: ما الذي تفرضه ZATCA بالضبط في المرحلة الثانية؟



تفرض هيئة الزكاة والضريبة والجمارك معايير تقنية مشددة على كافة المنظومات المحاسبية:

  • اتصال مباشر ومشفر مع منصة فاتورة عبر واجهات API باستخدام شهادات الاعتماد الرقمي CSID
  • إنشاء ملفات الفواتير بصيغة XML مطابقة لمعايير UBL 2.1 وملفات PDF/A-3 المدمج بها ملف XML
  • توليد معرف فريد عالمي UUID لكل فاتورة مع طابع زمني دقيق وختم تشفيري Cryptographic Stamp وسلسلة تشفير تمنع التلاعب بالترتيب Hash Chain
  • حفظ سجل تدقيق آمن Audit Trail يمنع تعديل أو حذف الفواتير بعد ترحيلها مع أرشفة الاستجابة الرسمية من الهيئة

ثانيا: كيف يدعم أودو هذه المتطلبات فعليا؟


1. حزم التوطين السعودية (Saudi Localization Modules)

أودو لا يعمل مع الفوترة الإلكترونية السعودية بشكل تلقائي خارج الصندوق. يحتاج تثبيت وتهيئة حزم توطين محددة: l10n_sa و l10n_sa_edi وموديولات نقاط البيع المرتبطة.

هذه الحزم هي التي تضيف الحقول الإلزامية كالرقم الضريبي والسجل التجاري والعنوان الوطني , وتضبط منطق احتساب ضريبة القيمة المضافة , وتولد ملفات XML المعتمدة تلقائيا فور ترحيل القيد المحاسبي.

ولأن الهيئة تحدث متطلباتها بشكل دوري , يصبح الاعتماد على حزم الفوترة الإلكترونية في أودو إنتربرايز مقارنة بالإصدار المجاني فارقا حاسما , حيث تضمن النسخة المدفوعة استمرار تحديث التوافق مع اشتراطات زاتكا بينما تبقى النسخة المجتمعية في مكانها.

2. خطوات ربط أودو بمنصة فاتورة عبر API

الربط يمر بثلاث خطوات لا يمكن تجاوز أي منها:

الخطوة الأولى: تسجيل الحل التقني عبر بوابة فاتورة واستخراج رمز المصادقة OTP ثم شهادة الاعتماد الرقمية CSID ومفاتيح التشفير المقابلة لها.

الخطوة الثانية: إدخال بيانات الربط كاملة داخل إعدادات المحاسبة في أودو: عناوين خوادم الهيئة Endpoints وشهادات الأمان والمعرفات الرقمية للجهاز المعتمد.

الخطوة الثالثة: ربط دفاتر فواتير المبيعات ونقاط البيع بالأجهزة المعتمدة وبدء الإرسال الفعلي مع المزامنة اللحظية مع المنصة.

3. آلية توليد الفاتورة المشفرة داخل أودو

فور ترحيل الفاتورة , يقوم النظام بعدة عمليات في الخلفية لا تراها على الشاشة لكنها الجوهر التقني للامتثال: توليد ملف XML مطابق للمواصفات , إضافة التوقيع الرقمي والهاش المتسلسل بين الفواتير لمنع التلاعب , إنشاء ملف PDF/A-3 المضمن , وتوليد رمز QR المشفر بكل العناصر الإلزامية.

الفاتورة التي تخرج في النهاية ليست مجرد PDF بل وثيقة رقمية متعددة الطبقات قابلة للتدقيق.

ثالثا: تدفق العمل في المرحلة الثانية داخل أودو (B2B و B2C).

1. فواتير B2B الضريبية (Tax Invoices)

  • ينشئ المحاسب الفاتورة الضريبية للشركات داخل أودو ويدقق بيانات المشتري ورقم ضريبته.
  • عند ترحيل الفاتورة يقوم النظام بتوليد ملف XML وإرساله فورا عبر API لمنصة فاتورة.
  • تدقق المنصة الفاتورة وترد بالموافقة Cleared مع ختم تشفيري رسمي أو بالرفض مع بيان سبب الخطأ.
  • يحفظ أودو حالة الاعتماد ورمز UUID واستجابة الهيئة داخل بطاقة الفاتورة , وتصبح الفاتورة معتمدة قانونيا وتطبع مع رمز QR المحدث لتسليمها للعميل.

2. فواتير B2C المبسطة (Simplified Tax Invoices)

في حالة الفواتير المبسطة الموجهة للأفراد ومبيعات التجزئة , تصدر الفاتورة مباشرة من أودو أو عبر شاشات الكاشير مع طباعة رمز الاستجابة السريعة المشفر وتسليم الإيصال للمشتري فورا.

وتتوافق هذه الدورة مع آليات إصدار الفواتير المبسطة وتوليد الـ QR المشفر في نقاط البيع التي تتيح إرسال بيانات المبيعات لمنصة فاتورة بهدف التبليغ Reporting في الوقت الفعلي أو خلال مدة أقصاها 24 ساعة وفق الاشتراطات التنظيمية , مما يضمن استمرارية البيع دون أي تعطيل لتجربة العميل.

رابعا: متطلبات تقنية يجب الانتباه لها عند ربط أودو بـ ZATCA


  • تحديث إصدار النظام: التأكد من تشغيل إصدارات أودو الحديثة المدعومة بحزم الفوترة الإلكترونية السعودية Saudi EDI.
  • تدقيق البيانات الأساسية: تسجيل السجل التجاري والرقم الضريبي والعنوان الوطني للمنشأة بصيغ دقيقة مطابقة للوثائق الرسمية.
  • تجربة النظام في بيئة المحاكاة Sandbox: يعد اختبار دورة الفوترة داخل بيئة المحاكاة التجريبية Sandbox Mode لدى زاتكا خطوة جوهرية قبل تفعيل الربط على قاعدة البيانات الحية. ويساعد هذا الإجراء في فحص أخطاء رفض الفواتير وتوليد الهاش في بيئة الاختبار والتأكد من مطابقة بنية ملفات XML وقبول الشهادات الرقمية CSID وتوليد الأختام التشفيرية دون أي تعارضات فنية قد تعرض المنشأة للمخالفات عند بدء التشغيل الفعلي.
  • ضبط صلاحيات المستخدمين وسجل الأنشطة Audit Log: توثيق عمليات الإنشاء والاعتماد ومنع التعديل المباشر على القيود بعد ترحيلها وإلزام الموظفين بمسار الإشعارات الدائنة والمدينة.
  • استقرار البنية التحتية والاتصال: توفير اتصال إنترنت مستقر واستضافة سحابية موثوقة مثل Odoo.sh لضمان استمرارية الربط وسرعة إرسال الفواتير.

خامسا: لماذا ERP متكامل أفضل من حل فوترة منفصل؟



السؤال الذي يطرحه بعض المديرين الماليين: لماذا لا نستخدم برنامج فوترة منفصل بدلا من تطوير ERP كامل؟

الجواب في التشغيل اليومي. برنامج الفوترة المنفصل يتطلب إعادة إدخال البيانات من نظام المبيعات مرة أخرى , وهذا مصدر للأخطاء ولهدر الوقت. داخل أودو الفاتورة تنشأ من نفس العرض أو أمر المبيعات , المخزون يتحدث تلقائيا , والقيد المحاسبي ينشأ في نفس اللحظة.

كذلك تقارير VAT يمكن توليدها مباشرة من أودو بدون تجميع البيانات من منصات مختلفة. وتتبع حالة كل فاتورة (مرسلة / مقبولة / مرفوضة) من داخل النظام بدون الانتقال بين تطبيقات متعددة.

كل ما يتعلق بالفاتورة في مكان واحد: ملف PDF , ملف XML , رمز QR , استجابة الهيئة , وملاحظات الفريق الداخلي. هذا يختصر وقت أي تدقيق ضريبي من أسابيع إلى ساعات.

كيف تبني مسار ربط آمن ومعتمد مع منصة فاتورة؟

إن الامتثال للمرحلة الثانية من الفوترة الإلكترونية يتجاوز مجرد إضافة رمز استجابة سريعة إلى الفاتورة , بل يمثل تحولا بنيويا يربط دورة مبيعاتك وحساباتك مباشرة بمنظومة هيئة الزكاة والضريبة والجمارك.

وإذا كنت تخطط لربط نظام أودو الحالي لديك أو ترغب في فحص جاهزية إعداداتك ومطابقة دفاتر اليومية قبل موعد إلزام منشأتك , يقدم لك فريق ترميز خدمات الربط والتكامل المعتمدة مع هيئة الزكاة والضريبة والجمارك لوضع خطة تنفيذ فنية متكاملة تشمل استخراج الشهادات الرقمية واختبار الفواتير وتدريب محاسبيك على الاعتماد الفوري بأعلى درجات الأمان.