توثّق Odoo توطينًا للسعودية فيه ضرائب القيمة المضافة ودعم الفواتير بالعربية ووحدات الفوترة الإلكترونية لدى ZATCA. تعرّف على وظيفة كل جزء، وما تضبطه في بيانات الشركة، وأين تُستضاف البيانات، وما تسأل عنه الشريك.
يأتي دعم Odoo (أودو) للسعودية في ثلاثة أجزاء: حزمة دولة فيها دليل حسابات سعودي وضرائب قيمة مضافة بنسبة 15%، واللغة العربية مع الواجهات من اليمين إلى اليسار، ووحدات الفوترة الإلكترونية لدى هيئة الزكاة والضريبة والجمارك (ZATCA) للمرحلتين: الأولى (الإصدار والحفظ) والثانية (الربط والتكامل). ويصف هذا الدليل التوطين السعودي (KSA localization) في Odoo كما تعرضه وثائق الإصدار 19.0، كما هي في أكتوبر 2026، ويبيّن ما تضبطه وما تسأل عنه شريك Odoo. وهو معلومات عامة وليس نصيحة قانونية أو ضريبية. وتبقى منشأتك مسؤولة عن الامتثال، فتأكد من المتطلبات الحالية لدى ZATCA ولدى محاسبك.
باختصار
rtlcss لعرض الشاشات من اليمين إلى اليسار.l10n_sa، والمرحلة الثانية مع l10n_sa_edi. ولا تذكر الوثائق نسخة لهما، فاسأل شريكًا للتأكد.تُعدّ Odoo للسعودية على طبقات بالترتيب المبيّن أدناه، وتسرد صفحتها عن السعودية الوحدات:
| الوحدة | الاسم التقني | ما تقوله الوثائق |
|---|---|---|
| Saudi Arabia - Accounting | l10n_sa | الحزمة الافتراضية، مع دعم رمز QR للمرحلة الأولى |
| Saudi Arabia - Accounting Reports | l10n_sa_reports | تقارير المحاسبة |
| Saudi Arabia - E-invoicing | l10n_sa_edi | تكامل واجهة API مع المرحلة الثانية من ZATCA |
| Saudi Arabia - E-invoicing (Simplified) | l10n_sa_edi_pos | الفوترة الإلكترونية عبر Point of Sale |
| Saudi Arabia - Point of Sale | l10n_sa_pos | حقول الامتثال لفواتير PoS |
| Saudi Arabia - Withholding Tax | l10n_sa_withholding_tax | يثبّت Withholding Tax on Payment |
تُثبَّت الوحدات الأساسية مع التوطين، وتضيف الباقي من Apps. وتوفّر الحزمة دليل حسابات سعوديًا، وضرائب مهيأة مسبقًا (ضريبة قيمة مضافة قياسية 15%، وبنسبة صفر، ومعفاة)، ومواقف ضريبية بحسب حالة التسجيل، وضرائب استقطاع، وإقرار VAT and Withholding Return الذي يُصدَّر إلى Excel أو PDF.
أي نسخة؟ لا تقول الصفحة ذلك. وفي مصدر Odoo العام لنسخة Community على GitHub (فرع 19.0، راجعناه في 21 أكتوبر 2026) وجدنا l10n_sa وl10n_sa_edi وl10n_sa_pos وl10n_sa_edi_pos وl10n_sa_withholding_tax بترخيص LGPL-3، ولم نجد l10n_sa_reports. وتدرج صفحة نسخ Odoo التوطينات والتقارير في صف Accounting الحصري لنسخة Enterprise، فلا تتطابق المصادر تمامًا: اسأل شريكًا عمّا تشمله خطتك. ويعرض دليل Community مقابل Enterprise لدينا الصورة الأوسع للنسخ.
قد ترفض ZATCA التهيئة (onboarding) إذا كانت بيانات الشركة ناقصة. وتسرد Odoo الحقول التالية لسجل الشركة، وينطبق الأمر نفسه على نماذج جهات الاتصال ذات الصلة، فراجع عملاءك أيضًا:
وبالنسبة إلى الفرع، أدخل VAT Number للمنشأة الأم في جهة اتصال الفرع، وأدخل Commercial Registration Number الخاص بالفرع في Identification Scheme. وأصدر الفواتير عبر دفتر مبيعات المنشأة الأم، أو هيّئ دفتر مبيعات لكل فرع.
إلى حد كبير نعم، لكن تحقق من النتيجة بنفسك. وتغطي وثائق Odoo ثلاث نقاط:
rtlcss. ويبيّن دليلنا لتثبيت Odoo على Ubuntu موضعها.ولا تعد الوثائق بأن كل شاشة أو تقرير أو وحدة من أطراف ثالثة تظهر سليمة بالعربية، لذا اطبع فاتورة حقيقية وإشعارًا دائنًا وإيصال نقطة بيع، وتحقق من الاتجاه والأرقام والخطوط ورمز QR. وتساعدك قائمة التحقق للمواقع من اليمين إلى اليسار.
تأتي المرحلة الأولى (مرحلة الإصدار والحفظ)، أي فواتير مطابقة للمتطلبات تحمل رمز QR، مع l10n_sa. وتأتي المرحلة الثانية (مرحلة الربط والتكامل)، أي الربط مع منصة ZATCA، مع l10n_sa_edi، وتغطي l10n_sa_edi_pos نقطة البيع (Point of Sale). وتحدد ZATCA المواعيد والموجات، كما يشرح دليلنا للمرحلة الثانية. ووفق وصف Odoo، ينتج البيع بين الشركات (B2B) فاتورة ضريبية (Tax Invoice) تعتمدها ZATCA، وينتج البيع إلى المستهلك (B2C) فاتورة ضريبية مبسطة (Simplified Tax Invoice) مع رمز QR، يُبلَّغ عنها إلى نقطة الاتصال الخاصة بمنصة «فاتورة» (Fatoora) لدى ZATCA.
تُجري Odoo التهيئة بثلاثة أوضاع، تُضبط في Accounting > Configuration > Settings (Saudi Arabia Electronic Invoicing, ZATCA API mode):
| الوضع | الغرض | صالح قانونيًا |
|---|---|---|
| Sandbox | بيئة اختبار مشتركة مهيأة مسبقًا | لا |
| Simulation (Pre-Production) | اختبارك الخاص، على نسخة مكررة من قاعدة البيانات الفعلية | لا |
| Production | البيئة الفعلية | نعم |
هيّئ كل دفتر مبيعات على حدة: Accounting > Configuration > Journals، ثم دفتر المبيعات، ثم تبويب ZATCA، ثم Onboard، ثم أدخل كلمة المرور لمرة واحدة (OTP) المكوّنة من 6 أرقام من بوابة «فاتورة» (Fatoora) لدى ZATCA (تنتهي صلاحيتها بعد 60 دقيقة؛ وتملؤها بيئة Sandbox تلقائيًا). وبعد تأكيد الفاتورة، اضغط Process now وتحقق من ظهور Action Successful. وفي سجل الرسائل (chatter)، يعني الأخضر أن الفاتورة مقبولة، والأصفر مقبولة مع تحذيرات (عالجها، فقد تتحول التحذيرات إلى رفض)، والأحمر مرفوضة، وهي غير صالحة قانونيًا حتى تصحح السبب وتضغط Retry. وما إن ترسل قاعدة بيانات Production فاتورة واحدة حتى لا يمكنها العودة إلى Sandbox أو Simulation. وبالنسبة إلى نقطة البيع، ثبّت l10n_sa_edi_pos، وهيّئ دفتر الفواتير الافتراضي لنقطة البيع (PoS)، وعيّن عميلًا لكل طلب.
الوحدة ليست امتثالًا. ولا تستطيع الوثائق أن تخبرك بموجتك ولا بما إذا كان إعدادك يستوفي قواعد ZATCA الحالية. اختبر تدفقات فواتيرك الحقيقية، واطلب من محاسبك أن يؤكد وضعك بالرجوع إلى صفحة الفوترة الإلكترونية لدى ZATCA.
| الطريقة | ما تقوله Odoo | ملاحظات |
|---|---|---|
| Odoo Online | قواعد بيانات خاصة تستضيفها Odoo وتديرها | تسرد صفحة اتفاقية مستوى الخدمة (SLA) خمس مناطق، منها منطقة في الشرق الأوسط. لا وحدات مخصصة ولا وحدات من Apps Store |
| Odoo.sh | منصة Odoo السحابية، مع Hosting location تختاره عند إنشاء المشروع | يحتاج إلى اشتراك Enterprise يتضمن Odoo.sh |
| خادمك الخاص | تثبّت Odoo وتشغّله بنفسك | أي موقع تختاره. وأنت تتولى الأمن والنسخ الاحتياطي والتحديثات |
تقول سياسة الخصوصية لدى Odoo إن قاعدة البيانات تُستضاف في منطقة السحابة الأقرب إلى العميل، ويمكن نقلها عند الطلب، رهنًا بالتوافر. وتسرد الهند والسعودية موقعي إنتاج لمنطقتها Middle East & Southern Asia، مع نسخ احتياطية في أوروبا وكندا لا يمكنك اختيارها ولا تقييدها. وقد تتغير هذه المعلومات، فتأكد منها لدى Odoo. وهل يناسب ذلك بياناتك، وهل تحدد ZATCA أو قواعد أخرى مكان حفظ سجلات الفواتير، فهذان سؤالان تطرحهما على محاميك ومحاسبك.
تسرد Odoo شركاء التنفيذ بحسب الدولة في صفحة الشركاء. اسأل كل شريك، واحصل على الإجابات كتابةً:
l10n_sa_edi، ثم اختبر في Sandbox وفي Simulation على قاعدة بيانات مكررة.تصف وثائق Odoo وحدة تكامل للمرحلة الثانية هي l10n_sa_edi، بأوضاع Sandbox وSimulation وProduction. ويعتمد الامتثال أيضًا على موجتك وبياناتك وإعدادك وقواعد ZATCA الحالية، فاختبر وتأكد لدى ZATCA ولدى محاسبك.
بحسب صفحة Odoo، يجب أن تكون الفواتير الضريبية بالعربية، مع السماح بالفواتير ثنائية اللغة. استخدم حقل Language في بيانات العميل وخيار Gulf Cooperation Council Format، ثم اطبع فاتورة حقيقية وتحقق منها.
يسرد جدول إصدارات Odoo الإصدار 20.0 بأنه صدر في سبتمبر 2026، والإصدار 19.0 في الدعم القياسي حتى سبتمبر 2028 (مخطط له). وفي 21 أكتوبر 2026 كانت صفحة السعودية متطابقة في وثائق الإصدار 20.0. اطلب من شريكك تأكيد دعم ZATCA لإصدارك.
تعرض Odoo رد ZATCA في سجل الرسائل (chatter) الخاص بالفاتورة. والفاتورة المرفوضة غير صالحة قانونيًا، فصحّح السبب واضغط Retry.
ابدأ مع محاسبك: حالة ضريبة القيمة المضافة والموجة وأنواع الفواتير. ثم اقرأ الفوترة الإلكترونية المرحلة الثانية في السعودية للمتاجر الإلكترونية وضريبة القيمة المضافة والفواتير للمتاجر الإلكترونية في السعودية. وإن كنت ما زلت تبني المتجر، فاقرأ كيف أبدأ متجرًا إلكترونيًا في السعودية. لا تقدّم DevMarket خدمة الربط مع ZATCA ولا تنفيذها، وإدراج وحدة في أي سوق، ومنها سوقنا، ليس دليلًا على أنها تستوفي متطلبات المرحلة الثانية. ويمكنك تصفّح وحدات Odoo لاحتياجات أخرى.
قارن بين خيارات استضافة Odoo الثلاثة بحسب وثائق Odoo: ما يتيحه كل خيار، ومن يدير ماذا، وأي النسخ يناسب، وأين تُخزَّن البيانات، وما التكاليف المتوقعة، وكيف تنتقل بين الخيارات.
9 دقائق قراءة
تطبيق Odoo في الشركة مشروع وليس مجرد تثبيت. اتبع المراحل من تحديد النطاق إلى الإطلاق، وتعرّف على دور كل طرف، وقرّر بين الاستعانة بشريك والتنفيذ بنفسك، واستعن بقائمة تحقق للإطلاق.
9 دقائق قراءة
Odoo Studio يغيّر Odoo دون كود، والوحدات المخصصة تضيف كودًا. تعرّف على ما يستطيعه كل منهما، وأي نسخة واستضافة تسمحان به، وما تعنيه الترقيات لكليهما، وكيف تقرر بحسب الحاجة.
8 دقائق قراءة
لكل منتج على DevMarket إصدار يراجعه فريقنا، ومفتاح ترخيص فوري، وشروط واضحة للتحديث والدعم.