Skip to content Skip to footer

أخطاء التحقق في ملف XML للفاتورة الإلكترونية: لماذا ترفض منصة فاتورة فواتيرك وكيف تعالجها

تُرحّل الفاتورة، ثم يظهر بجانبها: مرفوضة. ومعها رسالة تقنية بالإنجليزية لا يفهمها المحاسب ولا الكاشير. هذا المشهد يتكرر في منشآت كثيرة بعد دخولها مرحلة الربط والتكامل، وكلما اتسعت الموجات زاد عدد من يواجهه للمرة الأولى. في هذا المقال نشرح كيف تتحقق منصة فاتورة من ملف XML، وما الفرق بين الخطأ والتحذير، وما أكثر أسباب الرفض شيوعاً، وكيف تعالجها دون أن تكسر تسلسل فواتيرك.

كيف تتحقق الهيئة من الفاتورة؟

بحسب دليل بوابة المطورين الصادر عن هيئة الزكاة والضريبة والجمارك، يمر ملف الفاتورة بعدة طبقات من التحقق:

الطبقة ماذا تفحص
هيكل XML (XSD) مطابقة الملف لمخطط UBL 2.1 وترتيب العناصر وأنواع البيانات.
قواعد EN 16931 مجموعة من القواعد الأوروبية للفاتورة الإلكترونية مثل اتساق المبالغ والإجماليات.
القواعد السعودية (KSA) قواعد خاصة بالمملكة، وتتقدم على قواعد EN 16931 عند تعارضهما في نفس الحقل.
رمز QR بنية الرمز وحقوله: اسم البائع والرقم الضريبي والطابع الزمني والإجماليات، والتجزئة والتوقيع.
الختم التشفيري صحة التوقيع الرقمي وأن الملف لم يتغير بعد توقيعه.
سلسلة التجزئة (PIH) أن كل فاتورة تحمل تجزئة الفاتورة السابقة لها من نفس الجهاز.

خطأ أم تحذير؟ الفرق مهم

يفرّق الدليل بين نتيجتين: الخطأ يعني أن المستند غير صالح ويُرفض، والتحذير يعني أن المستند مقبول لكنه غير ممتثل بالكامل. وينبّه الدليل التفصيلي للفوترة الإلكترونية إلى أن التحذيرات قد تتحول إلى أخطاء رافضة مستقبلاً، فلا تتجاهلها لأن الفاتورة “مرّت”. وتظهر نتيجة الإبلاغ أو الاعتماد بإحدى الحالات: مقبولة، أو مقبولة مع تحذير، أو مرفوضة.

أشهر أسباب الرفض وعلاجها

1. بيانات البائع أو المشتري ناقصة أو بصيغة خاطئة

الرقم الضريبي، والسجل التجاري، وعناصر العنوان الوطني (رقم المبنى، الشارع، الحي، المدينة، الرمز البريدي). في الفاتورة الضريبية (B2B) تحتاج بيانات المشتري الكاملة، ومنها رقمه الضريبي وعنوانه. العلاج: نظّف بطاقات العملاء وبيانات المنشأة قبل الربط، لا بعد الرفض.

2. اختلاف الإجماليات

مجموع الأسطر لا يطابق إجمالي الفاتورة أو مبلغ الضريبة بسبب طريقة التقريب أو الخصومات. العلاج: اعتمد طريقة احتساب ثابتة في النظام، وتجنّب تعديل المبالغ يدوياً في الملف.

3. فئة الضريبة أو سبب الإعفاء

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

4. الإشعار الدائن أو المدين بدون مرجع

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

5. كسر سلسلة التجزئة أو العداد

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

6. التوقيع أو الشهادة

ملف تغيّر بعد توقيعه، أو شهادة تخص بيئة غير بيئة الإرسال (محاكاة مقابل إنتاج)، أو شهادة منتهية. العلاج: تحقق من حالة الربط والبيئة قبل الإرسال، وجدّد الشهادات في وقتها.

لماذا لا تتجاهل الفواتير المرفوضة؟

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

أدوات الهيئة للاختبار

توفر الهيئة عبر بوابة المطورين مجموعة أدوات الامتثال والتمكين: أداة SDK تعمل دون اتصال للتحقق من الملفات، ومدقق عبر البوابة يقبل حتى 5 ملفات XML في المرة ويتحقق من تسلسل التجزئة بينها، إلى جانب بيئة المحاكاة لتجربة التسجيل والإبلاغ والاعتماد. ويؤكد الدليل أن نجاح الملف في SDK لا يعني قبوله من الهيئة، فالمرجع النهائي هو رد المنصة.

كيف يتعامل RivDesktop مع أخطاء التحقق؟

  • قبل الربط: يتحقق من بيانات البائع: الرقم الضريبي (15 رقماً يبدأ وينتهي بالرقم 3)، والسجل التجاري، ورقم المبنى، والشارع، والحي، والمدينة، والرمز البريدي المكون من 5 أرقام.
  • عند التسجيل: يشغّل 6 فحوصات امتثال (فاتورة وإشعار دائن وإشعار مدين للمبسطة والضريبية)، ويظهر مؤشر الحالة بالأحمر إذا كانت البيئة المختارة لا تطابق الشهادة.
  • قبل الإرسال: تحقق محلي من الحقول الإلزامية، مثل اسم المشتري ورقمه الضريبي وعنوانه الوطني في الفاتورة الضريبية، ومرجع الفاتورة الأصلية في الإشعارات.
  • تحديد نوع الفاتورة تلقائياً: وجود رقم ضريبي سعودي صالح للعميل يجعلها ضريبية تمر بالاعتماد، وإلا فهي مبسطة تُرسل بالإبلاغ، والمرتجع يتحول إلى إشعار دائن مرتبط بالأصل.
  • التسلسل: يحافظ على ICV وPIH بشكل آمن حتى مع أكثر من جهاز كاشير.
  • بعد الرد: تقرير الربط يعرض حالة كل فاتورة، وسبب الرفض مترجماً بلغة مفهومة، مع خيار التحقق فقط دون إرسال، وإعادة إرسال المحدد أو كل المعلق، وجرس تنبيهات يعرض عدد المرفوض والمعلق.

وفي Riv-ERP السحابي شاشة مخصصة لمتابعة الفواتير غير المرفوعة والمرفوضة لدى الهيئة. التفاصيل في دليل RivDesktop ودليل Riv-ERP السحابي.

الأسئلة الشائعة

ما الفرق بين الفاتورة المرفوضة والمقبولة مع تحذير؟

المرفوضة تحتوي خطأً واحداً على الأقل يجعلها غير صالحة، أما المقبولة مع تحذير فصالحة لكنها غير ممتثلة بالكامل، وقد تتحول التحذيرات إلى أخطاء رافضة مستقبلاً.

هل أحذف الفاتورة المرفوضة وأصدر غيرها؟

لا تحذف الفواتير؛ الحذف أو التعديل بعد الإصدار مخالفة مستقلة. عالج سبب الرفض في البيانات، وصحّح بالمستند المناسب، واترك للنظام إدارة العداد وسلسلة التجزئة.

هل نجاح الفاتورة في أداة SDK يضمن قبولها؟

لا. يذكر دليل بوابة المطورين أن نجاح التحقق في SDK لا يعني قبول الهيئة، والمرجع النهائي هو رد منصة فاتورة.

هل يوضح RivDesktop سبب الرفض؟

نعم، يعرض تقرير الربط سبب الرفض مترجماً بلغة مفهومة، ويتيح التحقق دون إرسال، وإعادة الإرسال بعد التصحيح.

احجز عرضاً تجريبياً: 📲 0552007190 · ✉️ Info@riv-erp.com

شاهد Riv-ERP عملياً

نسختان: RivDesktop على خادمك، أو Riv-ERP السحابي على Oracle Cloud.

احجز عرضاً تجريبياً

اشترك في نشرة Riv-ERP

مقالات عملية عن الفوترة الإلكترونية والمحاسبة وإدارة المنشآت، تصلك على بريدك. وهدية: قائمة تجهيز الفوترة الإلكترونية – المرحلة الثانية.

★★★★★5.028 تقييماً على Google