دليل معالجة أخطاء رفض الفواتير في المرحلة الثانية من 'فاتورة' (ZATCA)

مقدمة حول أخطاء الرفض في المرحلة الثانية (مرحلة الربط والتكامل)

تمثل المرحلة الثانية من الفاتورة الإلكترونية في السعودية تحولاً جذرياً للمنشآت الصغيرة والمتوسطة. فبخلاف المرحلة الأولى التي كانت تكتفي بإصدار وحفظ الفواتير، تتطلب المرحلة الثانية ربطاً مباشراً مع أنظمة هيئة الزكاة والضريبة والجمارك (ZATCA) عبر منصة “فاتورة”.

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

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

---

أنواع الفواتير وعمليات التحقق في المرحلة الثانية

لفهم أسباب الرفض، يجب التمييز بين مسارين:

1. الاعتماد (Clearance): خاص بالفواتير الضريبية (B2B). يجب إرسالها للهيئة في الوقت الفعلي واعتمادها قبل تسليمها للعميل. إذا رُفضت، تعتبر الفاتورة كأن لم تكن قانونياً.
2. الإبلاغ (Reporting): خاص بالفواتير الضريبية المبسطة (B2C). يتم إصدارها للعميل أولاً ثم إبلاغ الهيئة بها خلال 24 ساعة. الرفض هنا يعني فشل عملية الإبلاغ الإلزامي.

💡 نصيحة: يمكنك استخدام أداة فحص الجاهزية للمرحلة الثانية للتأكد من توافق نظامك الحالي.

---

تصنيفات أخطاء الرفض الشائعة

تتوزع أخطاء الرفض عادةً تحت أربعة تصنيفات رئيسية:

1. أخطاء التشفير والأمن (Security Errors)

تحدث عند وجود مشكلة في الربط الأمني بين نظامك ومنصة فاتورة، مثل:

• انتهاء صلاحية شهادة التشفير (CSID).
• خطأ في التوقيع الرقمي للفاتورة.

2. أخطاء تسلسل وتواصل الفواتير (Sequence Errors)

تعتمد الهيئة نظام “السلسلة” لضمان عدم التلاعب:

• عداد الفواتير (ICV): رقم تسلسلي لا يقبل التكرار أو القفز.
• بصمة الفاتورة السابقة (PIH): يجب أن تحتوي كل فاتورة على الهاش (Hash) الخاص بالفاتورة التي سبقتها مباشرة.

3. أخطاء قواعد العمل (Business Rules)

تتعلق بمدى مطابقة الفاتورة للأنظمة الضريبية في المملكة، مثل:

• عدم تطابق فئة الضريبة مع النسبة المستخدمة (مثلاً استخدام كود الإعفاء مع نسبة 15%).
• أخطاء في العمليات الحسابية للمجموع الكلي.

4. أخطاء هيكلية الـ XML

إذا كان ملف الفاتورة لا يتبع معايير (UBL 2.1) المعتمدة من الهيئة، سيتم رفضه فوراً.

---

جدول رموز الخطأ الأكثر شيوعاً وكيفية حلها

رمز الخطأ	المعنى	الحل المقترح
KSA-REJECT-01	خطأ في هيكل XML	تأكد من أن النظام يصدر ملفات UBL 2.1 صحيحة. استخدم مستعرض XML للتحقق.
KSA-9	عدم تطابق بصمة الفاتورة السابقة	الهاش (PIH) الموجود لا يطابق آخر فاتورة قبلتها الهيئة. يجب إعادة مزامنة التسلسل.
BR-KSA-31	خطأ في فئة الضريبة	تأكد من أن كود الفئة (مثل ‘S’ للأساسي) يطابق النسبة (15%).
BR-KSA-01	رمز الاستجابة السريعة (QR) غير صالح	الرمز يفتقد لبيانات إلزامية مثل التوقيع الرقمي أو بصمة الهاش.
KSA-3	فاتورة مكررة	تحاول إرسال فاتورة برقم موجود مسبقاً في قاعدة بيانات الهيئة.
BR-KSA-09	خطأ في حساب المجموع	المجموع شامل الضريبة لا يساوي (المجموع غير شامل الضريبة + مبلغ الضريبة). راجع قواعد التقريب.
401 Unauthorized	فشل المصادقة	شهادة التشفير (CSID) انتهت أو غير صالحة. يجب تجديد الربط عبر منصة فاتورة.

---

خطوات عملية لمعالجة الفاتورة المرفوضة

1. تحليل رسالة الاستجابة (API Response): ابحث في ملف الاستجابة عن حقل errors لفهم الرمز (Code) والرسالة (Message).
2. التحقق من صحة الحسابات: استخدم حاسبة ضريبة القيمة المضافة للتأكد من أن المبالغ والكسور العشرية تتوافق مع اشتراطات الهيئة.
3. إعادة بناء السلسلة: في حال وجود خطأ في الهاش (KSA-9)، يجب على النظام التقني استرجاع بصمة آخر فاتورة مقبولة وتصحيح التسلسل.
4. تحديث بيانات العميل: في فواتير B2B، تأكد من وجود الرقم الضريبي للعميل وعنوانه بشكل صحيح، حيث أن نقص هذه البيانات يؤدي للرفض.

---

كيف تتجنب أخطاء الرفض مع “قيمة”؟

تطوير نظام داخلي للتعامل مع تعقيدات المرحلة الثانية أمر مكلف ومرهق. برنامج قيمة صُمم ليتولى هذه المهمة بدلاً عنك:

• ربط آلي ومباشر: نقوم بالربط مع منصة فاتورة وتجديد الشهادات الأمنية تلقائياً.
• تحقق مسبق: يقوم نظام قيمة بفحص الفاتورة برمجياً قبل إرسالها للهيئة، مما يمنع 99% من أخطاء الرفض.
• إدارة السلسلة (Hash Chain): نضمن لك تسلسلاً دقيقاً لبصمات الفواتير (PIH) وعداد الفواتير (ICV) دون أي تدخل يدوي.
• دعم فني متخصص: فريقنا خبير في أنظمة الزكاة والضريبة وجاهز لمساعدتك في حل أي إشكال تقني.

اجعل منشأتك ممتثلة تقنياً دون عناء.

تعرف على مميزات الربط مع الهيئة في قيمة | اطلع على باقات الأسعار