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

نعم. تتضمن الحزمة السعودية في أودو موديول Saudi Arabia - E-invoicing (l10n_sa_edi) الذي يتكامل مع منصة فاتورة التابعة لهيئة الزكاة والضريبة والجمارك عبر واجهتها البرمجية. والموديول ضمن الشفرة المفتوحة لأودو بترخيص LGPL-3، فهو متاح في النسخة المجتمعية كما في المؤسسية.

هل أحتاج إلى أودو إنتربرايز للربط مع الهيئة؟

لا. موديول الربط جزء من الشفرة المفتوحة، فتستطيع قواعد بيانات Community استخدامه. أما Enterprise فيضيف الاستضافة على أودو أونلاين وخدمة الترقية ودعم أودو الرسمي، وهذه أهم على المدى البعيد من الموديول نفسه.

متى يجب على منشأتي الربط مع الهيئة؟

تختار الهيئة المكلفين على موجات، وتبلغ كل موجة قبل موعد الربط بستة أشهر على الأقل. الموجة الخامسة والعشرون، المعلنة في 24 يوليو 2026، تشمل من تجاوزت إيراداتهم الخاضعة للضريبة 187,500 ريال خلال 2022 أو 2023 أو 2024 أو 2025، وآخر موعد لها 1 فبراير 2027.

ما الفرق بين الاعتماد (Clearance) والإبلاغ (Reporting)؟

الفاتورة الضريبية (غالباً بين المنشآت) يجب أن تعتمدها الهيئة قبل مشاركتها مع المشتري. أما الفاتورة الضريبية المبسطة (غالباً للأفراد) فتُسلَّم للعميل أولاً ثم يُبلَّغ عنها بصيغة XML خلال 24 ساعة من إصدارها.

لماذا ترفض الهيئة فواتير أودو؟

أغلب حالات الرفض سببها بيانات ناقصة: حقول عنوان المنشأة أو العميل، أو الرقم الضريبي أو رقم الهوية، أو بيانات الضريبة. يعرض أودو رمز الرد ورسالة الهيئة في سجل الفاتورة؛ صحّح البيانات في أودو ثم أعد الإرسال.

هل يمكن إرسال فواتير طلبات سلة وزد إلى الهيئة تلقائياً؟

نعم، عبر أودو. مع تطبيق تك فاي للربط على أودو 19.3 أو أحدث وتفعيل الإرسال التلقائي، تُرسل كل فاتورة وإشعار دائن يُنشئه التطبيق في أودو إلى الهيئة باستخدام إعدادات الربط في أودو نفسه.

ربط أودو مع الفوترة الإلكترونية المرحلة الثانية (زاتكا)

المرحلة الثانية من الفوترة الإلكترونية — مرحلة الربط والتكامل — تعني أن نظام الفوترة لديك يجب أن يتصل مباشرة بمنصة «فاتورة» التابعة لهيئة الزكاة والضريبة والجمارك: تصدر الفاتورة بصيغة XML منظمة، وتُختم بختم تشفيري، ثم تعتمدها الهيئة قبل إرسالها للعميل أو يُبلَّغ عنها خلال 24 ساعة. وأودو يفعل ذلك من داخله. يشرح هذا الدليل طريقة ربط أودو مع هيئة الزكاة: ما تشترطه الهيئة، والموديول والإعدادات المطلوبة، وخطوات التسجيل، وكيف تقرأ رسائل الرفض. المعلومات الخاصة بالهيئة محدّثة حتى سبتمبر 2026.

الإجابة المختصرة: ثبّت الحزمة السعودية في أودو مع موديول Saudi Arabia - E-invoicing، وأكمل كل حقول الهيئة في سجل المنشأة (العنوان بالحي ورقم المبنى، والرقم الضريبي، والسجل التجاري)، ثم سجّل كل يومية مبيعات برمز OTP من ستة أرقام من بوابة فاتورة — في بيئة Sandbox أولاً، ثم Simulation، ثم Production. أكّد فاتورة واضغط Process now، وتأكد أن الرد 200 – Action Successful.

هل منشأتي ملزمة؟ ومتى؟

المرحلة الأولى (إصدار الفواتير وحفظها إلكترونياً) مطبقة منذ 4 ديسمبر 2021. أما المرحلة الثانية فبدأت في 1 يناير 2023 وتُطبَّق على موجات، وتقول الهيئة إنها تبلغ كل موجة قبل موعد الربط بستة أشهر على الأقل (مراحل التطبيق).

الموجة	من تشمل	آخر موعد للربط
الموجة 24	إيرادات خاضعة للضريبة تجاوزت 375,000 ريال في 2022 أو 2023 أو 2024	30 يونيو 2026
الموجة 25	إيرادات خاضعة للضريبة تجاوزت 187,500 ريال في 2022 أو 2023 أو 2024 أو 2025	1 فبراير 2027

أُعلنت الموجة 25 في 24 يوليو 2026 (إعلان الهيئة). وموجتك الفعلية مذكورة في الإشعار الذي تصلك من الهيئة، فاعتمد عليه قبل الحدود الرقمية.

ماذا تشترط المرحلة الثانية فعلاً؟

يحدد الدليل التفصيلي للفوترة الإلكترونية مسارين:

	الفاتورة الضريبية	الفاتورة الضريبية المبسطة
الاستخدام المعتاد	بين المنشآت — المشتري مسجل في الضريبة	للأفراد — التجزئة والعملاء المباشرون
نموذج الهيئة	اعتماد (Clearance): تعتمدها الهيئة قبل مشاركتها	إبلاغ (Reporting): تُسلَّم فوراً ويُبلَّغ عنها خلال 24 ساعة
الصيغة	XML، أو PDF/A-3 مضمّن فيه ملف XML	XML يُرسل إلى فاتورة، مع رمز QR على الفاتورة المطبوعة
الإشعارات الدائنة والمدينة	تتبع مسار الفاتورة التي تعدّلها	كذلك

ويحتاج نظامك أيضاً إلى معرّف ختم تشفيري (CSID) يصدر عبر بوابة فاتورة، وخطوة تسجيل اليومية في أودو هي التي تحصل عليه نيابةً عنك.

أي موديول في أودو مسؤول عن الربط؟

تسرد وثائق الحزمة السعودية في أودو الموديولات التالية:

الموديول	الاسم التقني	الوظيفة
Saudi Arabia - Accounting	`l10n_sa`	دليل الحسابات، وضريبة 15%، ورمز QR للمرحلة الأولى
Saudi Arabia - E-invoicing	`l10n_sa_edi`	الربط مع الهيئة في المرحلة الثانية
Saudi Arabia - E-invoicing (Simplified)	`l10n_sa_edi_pos`	الفوترة الإلكترونية من نقاط البيع
Saudi Arabia - Point of Sale	`l10n_sa_pos`	حقول الامتثال في فواتير نقاط البيع

موديول الفوترة الإلكترونية موجود في المستودع المفتوح لأودو بترخيص LGPL-3 (في الفروع 16.0 و17.0 و19.0)، فالربط مع الهيئة ليس ميزة حصرية للنسخة المؤسسية.

الخطوة الأولى: أكمل بيانات المنشأة

ترفض الهيئة التسجيل والفواتير إذا كانت بيانات المنشأة ناقصة. أكمل في سجل الشركة:

اسم المنشأة — 63 حرفاً كحد أقصى.
العنوان كاملاً بما فيه الحي ورقم المبنى ورقم القطعة.
نوع المعرّف ورقمه (مثل رقم السجل التجاري).
الرقم الضريبي، والعملة ريال سعودي.

الفروع تستخدم الرقم الضريبي للمنشأة الأم مع رقم السجل التجاري للفرع في حقل نوع المعرّف. وبيانات العملاء تحتاج العناية نفسها: فاتورة لمنشأة بلا رقم ضريبي أو عنوان من أكثر أسباب الرفض شيوعاً.

وقاعدتان إضافيتان من وثائق أودو: الفاتورة يجب أن تكون بالعربية (ويجوز أن تكون ثنائية اللغة — فعّل خيار Gulf Cooperation Council Format في إعدادات المحاسبة)، والسطر الذي يحمل خصماً إجمالياً يجب أن تُطبَّق عليه ضريبة 15%.

الخطوة الثانية: سجّل كل يومية مبيعات

يتم التسجيل لكل يومية على حدة، وعبر ثلاث بيئات بالترتيب:

البيئة	الغرض	مصدر رمز OTP
Sandbox	بيئة اختبار مشتركة؛ استخدم الرقم الضريبي 399999999900003	يعبّئه أودو تلقائياً
Simulation (Pre-Production)	اختبارك الخاص على نسخة مكررة من قاعدة بياناتك؛ فواتيرها غير نافذة نظاماً	بوابة فاتورة — بيئة المحاكاة
Production	الفوترة الفعلية	بوابة فاتورة — بيئة الإنتاج

في كل بيئة: اضبط ZATCA API mode من المحاسبة ← الإعدادات، وافتح يومية المبيعات، ثم تبويب ZATCA، واضغط Onboard وأدخل الرمز.

صلاحية رمز OTP 60 دقيقة فقط. وبمجرد التحويل إلى Production وإرسال فاتورة، لا يمكن العودة إلى Sandbox أو Simulation — لذلك اختبر على نسخة مكررة أولاً. وكل يومية مبيعات تُسجَّل منفصلة، واليومية التي تتوقف عن استخدامها ألغِ معرّفها (CSID) من بوابة فاتورة.

الخطوة الثالثة: أرسل واقرأ رد الهيئة

أكّد الفاتورة، واضغط Process now في الشريط الأزرق، ثم اقرأ الرد في سجل الفاتورة:

الرمز	المعنى	ما العمل
200	مقبولة	لا شيء
202	مقبولة مع تحذيرات	عالج السبب الآن — قد تتحول التحذيرات إلى رفض لاحقاً
400	مرفوضة	اقرأ القاعدة في الرسالة، وصحّح البيانات، وأعد الإرسال
401	غير مصرّح	راجع الشهادة وبيانات الاعتماد (وأعد التسجيل عند الحاجة)
429، 500، 503، 504	لم تُستلم	أعد الإرسال

مثال رفض شائع: BR-KSA-F-13 … Please recheck Other Seller/Buyer ID — أي أن رقم المعرّف في سجل العميل أو المنشأة خاطئ أو ناقص.

جهّز أودو مع الربط بالهيئة عبر تك فاي

طلبات المتجر الإلكتروني: سلة وزد

إذا كنت تبيع على سلة أو زد، ففواتير طلبات المتجر يجب أن تصل إلى الهيئة أيضاً. مع تطبيق تك فاي لربط سلة بأودو أو لربط زد بأودو يكون التقسيم واضحاً: أودو يوقّع ويرسل، والتطبيق يطلب من أودو إرسال كل فاتورة يرحّلها وكل إشعار دائن يُنشئه عند الإلغاء أو الإرجاع. ويتطلب الإرسال التلقائي أودو 19.3 أو أحدث وتفعيل خيار Automatically Send Invoices to ZATCA (طريقة العمل). ويعيد التطبيق قراءة الحالات المعلّقة كل ساعة، ويعرض ما لم يُقبل في شاشات أخطاء مخصصة.

وسببان من جهة التطبيق يستحقان الانتباه: يُرفض الإشعار الدائن إذا لم يُضبط سبب الإرجاع المطلوب من الهيئة، ولا تقبل الهيئة إشعاراً دائناً على فاتورة لم تقبلها أصلاً (أخطاء الإشعارات الدائنة).

قائمة التحقق قبل التشغيل الفعلي

تأكيد موجتك وموعدها من إشعار الهيئة.
تثبيت الحزمة السعودية وموديول l10n_sa_edi، وموديول نقاط البيع إن كنت تبيع في متجر فعلي.
اكتمال بيانات المنشأة والفروع والعملاء.
تفعيل قالب الفاتورة العربي.
تسجيل كل يوميات المبيعات في Sandbox، ثم في Simulation على نسخة مكررة.
دفعة اختبار تشمل فاتورة ضريبية وفاتورة مبسطة وإشعاراً دائناً — وكلها ترجع 200.
التسجيل في Production في وقت هادئ، مع متابعة ردود اليوم الأول.

كيف تنجز ذلك

تك فاي شريك فضي معتمد من أودو. باقة تطبيق أودو لدينا بسعر 3,999 ريال، وتشمل إعداد دليل الحسابات والمخازن حسب احتياجك، وثلاث جلسات تدريبية، ودعماً فنياً لمدة عام. وإذا كان أودو يعمل لديك بالفعل، يستطيع فريق دعم أودو تولّي إعدادات الربط مع الهيئة ومعالجة حالات الرفض. تك فاي شركة برمجيات وليست مكتباً محاسبياً، وتبقى قرارات المعالجة الضريبية مسؤولية محاسبك.

تخطط لميزانية المشروع كاملاً؟ اقرأ أسعار تطبيق نظام أودو في السعودية والفرق بين أودو أونلاين وOdoo.sh والاستضافة الخاصة.