حل مشاكل منصة فاتورة
دليل فني وتشغيلي يوضح أسباب رفض الفواتير الإلكترونية في منصة فاتورة التابعة لهيئة الزكاة والضريبة والجمارك زاتكا وخطوات معالجتها عمليا داخل نظام أودو
لا يحدث رفض الفواتير في منصة فاتورة ZATCA بشكل عشوائي، بل يرتبط في الغالب بأخطاء في بنية ملف XML أو حسابات ضريبة القيمة المضافة أو التوقيع الرقمي والهاش أو نقص الحقول الإلزامية في رمز الاستجابة السريعة QR Code. يساعد هذا الدليل مسؤولي المالية والمحاسبين في المنشآت السعودية على تشخيص رسائل الخطأ ومعالجتها خطوة بخطوة داخل نظام أودو لضمان اعتماد الفواتير من أول محاولة وتفادي الغرامات النظامية.
وفي هذا الدليل نستعرض الأخطاء الخمسة الأكثر تكرارا وكيفية ضبط إعدادات أودو لمنع تكرارها نهائيا.
1. بيانات فاتورة ناقصة أو غير مطابقة لمتطلبات ZATCA
يعد غياب بعض الحقول الإلزامية أو تسجيلها بصيغ غير مقبولة من أبرز أسباب الرفض الفوري للفواتير في منصة فاتورة:
- عدم تسجيل الرقم الضريبي للمورد أو كتابته بطريقة خاطئة تخالف صيغة الـ 15 رقما المعتمدة.
- عدم التمييز بين نوع الفاتورة الضريبية B2B والفاتورة المبسطة B2C بما يناسب صفة المشتري والعملية التجارية.
- كتابة تواريخ وأوقات الإصدار بصيغ غير قياسية أو فقدان حقل التوقيت الزمني من ملف XML.
- نقص بيانات العنوان الوطني للشركة أو العميل مثل المدينة والرمز البريدي والشارع.
كيف تصلح ذلك في أودو؟
تأكد من ضبط بطاقة الشركة وإدخال رقم السجل التجاري والرقم الضريبي والعنوان الوطني بدقة , مع تدقيق بطاقات العملاء وتضمين الرقم الضريبي للمنشآت الخاضعة للضريبة.
وتبرز أهمية الالتزام بـ متطلبات الامتثال للمرحلة الثانية من الفوترة الإلكترونية لتفادي استخدام فواتير ضريبية B2B دون استيفاء بيانات المشتري أو إصدار فواتير مبسطة B2C بعمليات تجارية كبرى , بحيث لا تخرج أي فاتورة من النظام قبل التحقق من اكتمال الحقول الإلزامية في قواعد البيانات.
2. تنسيقات غير صحيحة في ملف الفاتورة الإلكتروني (XML)
منصة فاتورة لا تنظر فقط إلى شكل الفاتورة الـ PDF، بل تعتمد على ملف XML داخلي يجب أن يلتزم ببنية (Structure) ونوع بيانات محدد. أي اختلاف بسيط في هذه البنية يؤدي مباشرة إلى رفض الفاتورة.
أمثلة على أخطاء في التنسيق:
- صيغة التاريخ/الوقت غير متوافقة مع الشكل القياسي المطلوب.
- استخدام نص في حقل رقمي (مثل مبلغ أو نسبة).
- استخدام كود ضريبة أو وحدة قياس غير معتمدة في معايير ZATCA.
- حقول مطلوبة في الـ XML غير موجودة أو فارغة، رغم أنها تظهر في الـ PDF.
كيف تصلح ذلك في أودو؟
- اعتمد على موديولات توطين للفوترة الإلكترونية مصمّمة خصيصًا للسعودية، ولا تستخدم حلولًا يدوية أو توليد XML خارج أودو.
- تأكد من أن إصدار أودو والموديول الخاص بالفوترة الإلكترونية محدث لآخر نسخة وتوافق مع الأدلة الفنية الحديثة.
- اختبر إرسال الفواتير في بيئة تجريبية (Sandbox/Testing) قبل التشغيل الكامل، واقرأ رسائل الخطأ بعناية لتعرف بالضبط أي حقل أو تنسيق يسبب المشكلة.
- تجنّب تعديل ملفات XML من خارج النظام؛ أي تعديل يجب أن يتم من خلال إعدادات أودو أو من خلال الشريك التقني.
الهدف أن يكون توليد XML عملية آلية ومستقرة، لا تعتمد على تدخل يدوي أو سكربتات غير موثوقة.
3. فروق في ضريبة القيمة المضافة والمبالغ الإجمالية
تعتبر فروق التقريب واختلاف ناتج جمع السطور مع إجمالي الفاتورة سببا متكررا لرفض المعاملات:
- وجود فارق بين قيمة الضريبة المحسوبة في النظام والناتج المتوقع وفق خوارزميات التدقيق في منصة فاتورة.
- تطبيق نسبة 15% مع اختيار كود تصنيف ضريبي معفى أو خاضع لنسبة الصفر مما يسبب تضاربا حسابيا.
- عدم تطابق مجموع ضرائب السطور الفردية Line Taxes مع حقل الضريبة الإجمالي Total Tax في الفاتورة.
كيف تصلح ذلك في أودو؟
- ضبط إعدادات ضريبة القيمة المضافة بنسبة 15% وربطها بالحسابات الدائنة والمدينة في شجرة الحسابات العامة.
- أتمتة احتساب الضريبة ومنع التعديل اليدوي على مبالغ الضريبة داخل أسطر الفواتير إلا في الحالات الاستثنائية الموثقة.
- تدقيق سياسة التسعير في بطاقات المنتجات وتحديد ما إذا كانت الأسعار تشمل الضريبة Tax Included أو غير شاملة Tax Excluded لمنع تضارب المجاميع.
- مطابقة التقارير الضريبية الدورية في أودو مع بيانات الفواتير المرسلة لمنصة زاتكا لضمان التوافق التام.
4. مشاكل في التوقيع الرقمي وهاش الفاتورة (Invoice Hash / Digital Signature)
في المرحلة الثانية لا يقبل النظام الفاتورة بمجرد صحة أرقامها , بل يشترط سلامة السلسلة التشفيرية والتوقيع الرقمي المعتمد:
- استخدام طرق حساب غير صحيحة لتوليد الهاش الحالي بناء على هاش الفاتورة السابقة Previous Invoice Hash.
- تعديل أي بيان في الفاتورة بعد توليد التوقيع الرقمي دون إعادة بناء ملف التشفير.
- انتهاء صلاحية الشهادة الرقمية CSID أو استخدام مفتاح سري غير مطابق للجهاز المسجل.
- التلاعب في العداد التسلسلي للفواتير Sequential Counter ومحاولة إعادة استخدام أرقام سابقة.
كيف تصلح ذلك في أودو؟
تأكد من مطابقة موديول الفوترة الإلكترونية لآليات التشفير الرسمية المعتمدة لدى الهيئة لحساب الهاش والتوقيع الرقمي دون أي تلاعب في عداد الفواتير أو السلسلة المشفرة.
وتوضح شروحات توليد الختم التشفيري والهاش في نقاط البيع والفواتير المبسطة ضرورة حظر أي تعديل يدوي على بيانات الفاتورة بعد اعتمادها , والاعتماد الحصري على دورة الإشعارات الدائنة والمدينة الرسمية لإلغاء وتعديل المعاملات مع مراقبة صلاحية شهادات CSID الرقمية وتجديدها قبل انتهائها.
5. رمز QR غير صحيح أو بيانات مشفرة ناقصة
يمثل رمز الاستجابة السريعة في الفواتير المبسطة B2C ركيزة الامتثال الأولى , ويؤدي أي خطأ في تشفيره إلى رفض الفاتورة عند التفتيش والتدقيق:
- إنشاء رمز QR بصيغة بصرية عادية أو كرابط ويب دون استخدام ترميز TLV Base64 المشفر.
- نقص بعض الحقول الإلزامية التسعة الخاصة بالمرحلة الثانية مثل الختم التشفيري وهاش الفاتورة والتوقيع الرقمي.
- تضارب البيانات المقروءة عند مسح الرمز مع الأرقام والنصوص المطبوعة في متن الفاتورة.
كيف تصلح ذلك في أودو؟
اعتمد على مولد رمز الاستجابة السريعة المدمج في موديول الفوترة المعتمد لأودو ولا تستخدم مولدات خارجية عامة قد تخل بترتيب حقول TLV Base64 الإلزامية.
كما تساهم خطط تنقية بيانات العملاء وتدقيق الأرقام الضريبية في أودو في منع تضارب الأسماء والأرقام الضريبية المسجلة داخل الرمز مع نص الفاتورة , مع اختبار قراءة الـ QR عبر أدوات الفحص المعتمدة للتأكد من ربط توليد الرمز بخطوة الترحيل النهائي للفاتورة.
ماذا تفعل إذا رفضت فاتورة بالفعل؟
- قراءة رمز الخطأ ووصف المشكلة الوارد في الاستجابة الفنية لمنصة فاتورة بدقة لتحديد مكمن الخلل.
- تصحيح السبب الجذري في أودو سواء كان في بيانات العميل أو كود الضريبة أو إعدادات التكامل.
- إصدار إشعار دائن Credit Note لإلغاء أثر الفاتورة المرفوضة محاسبيا وفق اللوائح المعتمدة وتجنب الحذف المباشر للسجلات.
- إنشاء فاتورة جديدة مصححة وإعادة إرسالها لمنصة فاتورة واعتمادها في السلسلة التشفيرية.
كيف تتخلص من أخطاء منصة فاتورة نهائيا مع ترميز؟
إن وجود نظام أودو وحده لا يكفي لتفادي رفض الفواتير ما لم يرافقه ضبط دقيق لإعدادات الضرائب وشجرة الحسابات والشهادات التشفيرية وتهيئة فريق المحاسبة للتعامل مع رموز الأخطاء.
يقدم لك فريق ترميز خدمات معالجة أخطاء الفوترة والدعم الفني لأودو لنراجع معك إعدادات النظام الحالية ونصلح مسببات الرفض ونضمن قبول فواتيرك من أول محاولة وامتثالك التام لاشتراطات زاتكا دون أي تعطل تشغيلي.