ربط أودو مع منصة فاتورة (المرحلة الثانية): دليل عملي خطوة بخطوة
إذا وصلتك رسالة من هيئة الزكاة والضريبة والجمارك بأن منشأتك ضمن موجة الربط القادمة، وأنت تعمل على أودو، فالخبر الجيد أن أودو يدعم المرحلة الثانية من الفوترة الإلكترونية بشكل رسمي. لكن الربط لا ينجح بضغطة زر: أغلب المشاكل التي رأيتها في المشاريع سببها بيانات ناقصة في الشركة أو العملاء، لا الربط نفسه. هذا الدليل يختصر لك الطريق.
من يشمله الربط الآن؟
تُطبَّق المرحلة الثانية (مرحلة الربط والتكامل) منذ 1 يناير 2023 على شكل موجات، وكل موجة تنزل بحد الإيرادات أكثر من سابقتها. آخر موجة أعلنتها الهيئة هي الموجة 25، وتشمل كل منشأة تجاوزت إيراداتها الخاضعة لضريبة القيمة المضافة 187,500 ريال في أي سنة من 2022 أو 2023 أو 2024 أو 2025، مع الاستعداد للربط ابتداءً من 1 فبراير 2027.
ماذا يتغيّر فعلياً في المرحلة الثانية؟
في المرحلة الأولى كان يكفي أن يُصدر النظام فاتورة إلكترونية فيها رمز QR. في المرحلة الثانية يصبح نظامك متصلاً بمنصة «فاتورة» ويرسل لها كل فاتورة بصيغة XML موقّعة رقمياً:
- الفاتورة الضريبية (B2B): تُرسل إلى المنصة لـالاعتماد (Clearance) قبل أن تُسلَّم للعميل.
- الفاتورة المبسّطة (B2C): تُسلَّم للعميل مباشرة، ثم يجب الإبلاغ عنها (Reporting) للمنصة خلال 24 ساعة.
- الإشعارات الدائنة والمدينة تتبع نفس القواعد، ويجب أن تشير إلى الفاتورة الأصلية وسبب الإصدار.
هل أودو جاهز؟
نعم. أودو يوفّر الربط مع منصة فاتورة ضمن الحزمة السعودية الرسمية، من خلال هذه الموديولات:
| الموديول | الاسم التقني | الوظيفة |
|---|---|---|
| المحاسبة السعودية | l10n_sa | شجرة الحسابات والضرائب السعودية |
| الفوترة الإلكترونية | l10n_sa_edi | الربط مع منصة فاتورة |
| نقاط البيع | l10n_sa_pos | متطلبات الفواتير المبسّطة في نقاط البيع |
إذا كنت على إصدار قديم من أودو (مثل 12 أو 13)، فالربط الرسمي غير متوفر فيه، وخياراتك هي الترقية إلى إصدار حديث أو موديول طرف ثالث. الترقية خيار أنظف على المدى الطويل، وقد نقلت بنفسي نظاماً كاملاً من Odoo 12 إلى 18 لهذا السبب تحديداً.
قبل أن تبدأ: جهّز البيانات
هذه النقطة توفّر عليك أكثر وقت. افتح الإعدادات ← الإعدادات العامة ← الشركات وتأكد من الآتي:
- اسم الشركة لا يتجاوز 63 حرفاً.
- العنوان مكتمل، بما فيه رقم المبنى والرقم الإضافي (أربعة أرقام لكل منهما) والحي والمدينة والرمز البريدي.
- نوع الهوية: يُفضَّل السجل التجاري (CR)، مع إدخال رقمه.
- الرقم الضريبي صحيح (15 رقماً).
- العملة ريال سعودي.
ونفس الشيء لـالعملاء من الشركات: الرقم الضريبي والعنوان الكامل برقم المبنى. فاتورة لعميل بدون رقم مبنى سترفضها المنصة، وهذا من أكثر الأخطاء تكراراً. نصيحتي: صدّر قائمة العملاء إلى Excel، وفلتر الحقول الفارغة، وأكملها قبل الربط.
خطوات الربط في أودو
1. ابدأ ببيئة المحاكاة
ادخل بوابة فاتورة ببيانات المنشأة، واختر بوابة المحاكاة (Fatoora Simulation Portal). في أودو افتح المحاسبة ← الإعدادات ← الإعدادات، وفي قسم ZATCA API Integration اختر Simulation (Pre-Production) واحفظ.
2. اربط دفاتر المبيعات (Onboarding)
- افتح المحاسبة ← الإعدادات ← دفاتر اليومية، ثم دفتر المبيعات، ثم تبويب ZATCA.
- أدخل الرقم التسلسلي (Serial Number)، ويمكن استخدام نفس الرقم لكل دفاتر المبيعات.
- اضغط Onboard Journal.
- في بوابة فاتورة اضغط Onboard New Solution Unit/Device، واختر عدد رموز OTP (رمز لكل دفتر)، ثم Generate OTP Code.
- انسخ الرمز إلى أودو واضغط Request.
3. اختبر كل أنواع الفواتير
عند تأكيد الفاتورة يعرض أودو خيار إرسالها، ويُظهر رد المنصة مباشرة. لا تكتفِ بفاتورة واحدة؛ اختبر كل حالة تستخدمها فعلاً:
- فاتورة ضريبية لشركة، وفاتورة مبسّطة لفرد.
- إشعار دائن (مرتجع) على فاتورة سابقة.
- فاتورة فيها ضريبة صفرية أو معفاة، مع اختيار رمز سبب الإعفاء من إعدادات الضريبة (الخيارات المتقدمة).
- فاتورة فيها خصم، وأخرى بعملة غير الريال إن كنت تستخدمها.
بعدها قارن عدد الفواتير في صفحة الإحصائيات في بوابة المحاكاة مع قائمة الفواتير في أودو.
4. الانتقال إلى الإنتاج
بعد نجاح الاختبارات، غيّر وضع الربط إلى Production واحفظ، ثم أعد ربط كل دفتر مبيعات من جديد، لكن هذه المرة من بوابة فاتورة الرئيسية.
أشهر أسباب الرفض وكيف تتجنبها
| المشكلة | الحل |
|---|---|
| بيانات العميل ناقصة (رقم المبنى، الرقم الضريبي، الحي) | أكمل بيانات العملاء قبل الربط، واجعل الحقول إلزامية للعملاء من الشركات. |
| اسم الشركة أطول من 63 حرفاً | اختصر الاسم في إعدادات الشركة. |
| انتهاء رمز OTP | أنشئ رمزاً جديداً واستخدمه خلال ساعة. |
| ضريبة صفرية بدون سبب إعفاء | حدّد رمز سبب الإعفاء في إعدادات الضريبة. |
| إشعار دائن بدون مرجع | أنشئ الإشعار الدائن من الفاتورة الأصلية نفسها، واكتب سبب الإصدار. |
بعد التشغيل
- الفواتير التي لم تُرسل يرسلها أودو تلقائياً في نهاية كل يوم، لكن تابع قائمة الفواتير يومياً في الأسابيع الأولى.
- الفواتير المرفوضة فقط يمكن إرجاعها إلى مسودة وتعديلها. الفاتورة المعتمدة لا تُعدَّل؛ صحّحها بإشعار دائن.
- درّب فريق المبيعات على إكمال بيانات العميل عند إنشائه، فهذا يمنع معظم المشاكل من الأساس.
تحتاج مساعدة في الربط؟
اشتغلت على الامتثال لمنصة فاتورة والربط مع منصة فسح وترقية أودو من الإصدار 12 إلى 18 في بيئة إنتاج فعلية. إذا أردت فحص جاهزية نظامك أو تنفيذ الربط كاملاً، تواصل معي.
تواصل معي واتساب