أسباب رفض الفاتورة الإلكترونية من ZATCA وطريقة معالجة الأخطاء
ترفض هيئة الزكاة والضريبة والجمارك (ZATCA) الفاتورة الإلكترونية عندما لا تستوفي أحد متطلبات التحقق الإلزامية. وتشمل الأسباب التي ينبغي فحصها الرقم الضريبي للبائع، وحقول العنوان، وحسابات الفاتورة، وبصمات المستندات، وشهادات التوقيع الرقمي. وتوضح الاستجابة الواردة من منصة فاتورة نتائج التحقق التي أخفقت، حتى تتمكن من تحديد سبب المشكلة وتصحيحه.
فهم رسائل رفض الفواتير من ZATCA
عندما يرسل متجرك فاتورة إلى منصة فاتورة، تتحقق ZATCA من ملف XML وفقًا لمتطلباتها المنشورة. ويمكن أن تكون نتيجة التحقق إحدى الحالات التالية.
| الحالة | معناها | الإجراء المطلوب |
|---|---|---|
| مقبولة | اجتاز المستند التحقق دون تحذيرات. | احتفظ بالفاتورة واستجابة ZATCA. |
| مقبولة مع تحذيرات | قُبل المستند، لكن بعض عمليات التحقق أظهرت تحذيرات. | افحص التحذيرات وصحح أسبابها في الفواتير التالية. |
| مرفوضة | منع خطأ واحد على الأقل قبول المستند. | صحح السبب واتبع الإجراء المناسب لإعادة التقديم. |
لا ينبغي إعادة إرسال فاتورة قُبلت مع تحذيرات. وتوضح الإرشادات الفنية للهيئة ضرورة معالجة التحذيرات في أقرب وقت، لأن استمرار المخالفات قد يؤدي إلى إجراءات إضافية.
أما الفاتورة المرفوضة فتحتاج إلى معالجة مختلفة. وتنص إرشادات ZATCA على إنشاء مستند مصحح بعداد فواتير مستقل وبصمة مناسبة للفاتورة السابقة. ويجب إبقاء العداد والبصمة الأصليين للمستند المرفوض دون تغيير.
المصدر: الإرشادات الفنية التفصيلية من ZATCA، القسم 4.3 والقسم 7 (الأسئلة الشائعة للأعمال)
الأسباب التالية موثقة في قواعد التحقق المنشورة. وقد جرى ترتيبها بحسب الجزء الذي تحتاج إلى فحصه في الفاتورة، وليس بحسب معدل تكرار كل خطأ.
أخطاء بيانات البائع
الرقم الضريبي للبائع مفقود أو غير صحيح
القواعد: BR-KSA-39 وBR-KSA-40.
تشترط القاعدة BR-KSA-39 وجود الرقم الضريبي للبائع أو الرقم الضريبي للمجموعة التي ينتمي إليها البائع. أما القاعدة BR-KSA-40 فتتحقق من صيغة الرقم.
يجب أن يستوفي الرقم الضريبي الشروط التالية:
- يتكون من 15 رقمًا بالضبط.
- يبدأ بالرقم 3.
- ينتهي بالرقم 3.
قد تظهر رسالة تحقق إذا كان الرقم مفقودًا، أو كان عدد خاناته غير صحيح، أو لم يبدأ أو ينتهِ بالرقم المطلوب.
قارن الرقم الضريبي المسجل في إعدادات الفوترة ببياناتك الضريبية المسجلة. وصحح أي خطأ في إدخاله قبل إنشاء مستند آخر.
في رصيدو، افتح WooCommerce > الفوترة الإلكترونية (ZATCA) > بيانات البائع لمراجعة الرقم. المصدر: معيار تطبيق الفواتير الإلكترونية بصيغة XML من ZATCA، القاعدتان BR-KSA-39 وBR-KSA-40 كما أوضح موظفو ZATCA القاعدة BR-KSA-39 في مجتمع مطوري فاتورة.
عنوان البائع غير مكتمل
القواعد: BR-KSA-09 وBR-KSA-37 وBR-KSA-66. تشترط القاعدة BR-KSA-09 أن يتضمن عنوان البائع اسم الشارع، ورقم المبنى، والرمز البريدي، والمدينة، والحي، ورمز الدولة.
وتتحقق القواعد الأخرى من صيغ محددة:
- BR-KSA-37: يجب أن يتكون رقم المبنى من 4 أرقام.
- BR-KSA-66: يجب أن يتكون الرمز البريدي للبائع من 5 أرقام.
على سبيل المثال، إذا احتوى عنوان البائع على المدينة دون الحي، فلن يستوفي متطلبات القاعدة BR-KSA-09.
قارن بيانات البائع المحفوظة في المتجر ببيانات العنوان الوطني المسجل. وتحقق من وجود جميع الحقول المطلوبة في العنوان الذي يُدرج داخل ملف XML.
المصدر: معيار تطبيق XML من ZATCA، قواعد عنوان البائع
بيانات السجل التجاري غير صحيحة
القاعدة: BR-KSA-08.
تشترط ZATCA استخدام رمز تعريف مسموح به في حقل تعريف البائع. وعند استخدام السجل التجاري، يكون رمز نوع التعريف هو CRN.
وتشترط القاعدة أيضًا أن تتكون قيمة التعريف من أحرف وأرقام فقط، وألا يتكرر تعريف البائع أكثر من مرة.
تحقق من رقم السجل التجاري ورمز نوع التعريف في ملف XML الذي أُنشئ. وإذا كان للمنشأة أكثر من سجل تجاري، فإن معيار ZATCA ينص على استخدام سجل الفرع الذي يصدر الفاتورة الضريبية.
المصدر: معيار تطبيق XML من ZATCA، القاعدة BR-KSA-08
أخطاء محتوى الفاتورة وحساب ضريبة القيمة المضافة
إجماليات الفاتورة غير متطابقة
القواعد: BR-CO-10 وBR-CO-14 وBR-CO-15 وBR-CO-17.
تتحقق ZATCA من توافق إجماليات الفاتورة مع المبالغ التي استُخدمت في حسابها. وتشمل هذه القواعد عمليات حسابية مختلفة.
| القاعدة | ما تتحقق منه ZATCA |
|---|---|
| BR-CO-10 | تطابق مجموع صافي مبالغ بنود الفاتورة مع إجمالي صافي البنود في المستند. |
| BR-CO-14 | تطابق إجمالي ضريبة القيمة المضافة في الفاتورة مع مجموع مبالغ الضريبة حسب الفئات الضريبية. |
| BR-CO-15 | مساواة الإجمالي شامل الضريبة لمجموع الإجمالي غير شامل الضريبة ومبلغ الضريبة. |
| BR-CO-17 | تطابق مبلغ الضريبة لكل فئة مع ناتج ضرب المبلغ الخاضع للضريبة في النسبة المطبقة، بعد التقريب إلى منزلتين عشريتين. |
قد ينتج عدم التطابق عن طريقة حساب الخصومات أو الرسوم أو مبالغ الضريبة داخل ملف XML.
قارن بنود الفاتورة التي ظهر فيها الخطأ بالإجماليات المسجلة في المستند. وراجع طريقة احتساب الخصومات ومبالغ الضريبة في برنامج الفوترة.
بالنسبة إلى طلب WooCommerce، قارن المبالغ المحفوظة في الطلب بالمبالغ الواردة في ملف XML. وإذا وجدت اختلافًا، فافحص عملية إنشاء الفاتورة قبل إصدار مستند بديل.
المصدر: معيار تطبيق XML من ZATCA، قواعد BR-CO
فئة ضريبة القيمة المضافة مفقودة أو غير صحيحة
القواعد: BR-CO-04 وBR-KSA-18 وBR-KSA-23 وBR-KSA-24 وBR-KSA-69.
يجب تحديد فئة ضريبية لكل بند في الفاتورة. وتحدد ZATCA رموز الفئات التالية.
| الرمز | الفئة الضريبية |
|---|---|
| S | خاضعة للنسبة الأساسية |
| Z | خاضعة لنسبة الصفر |
| E | معفاة من ضريبة القيمة المضافة |
| O | خارج نطاق ضريبة القيمة المضافة |
تحصر القاعدة BR-KSA-18 قيم الفئات الضريبية في هذه الرموز.
وتفرض قواعد أخرى متطلبات تتعلق بسبب المعاملة الضريبية:
- BR-KSA-23: تتطلب رمز سبب الإعفاء في تفاصيل الضريبة الخاصة بالفئة المعفاة.
- BR-KSA-24: تتطلب رمز سبب الاستثناء في تفاصيل الضريبة الخاصة بالفئة الخارجة عن النطاق.
- BR-KSA-69: تتطلب رمز سبب الاستثناء في تفاصيل الضريبة الخاصة بالفئة الخاضعة لنسبة الصفر.
راجع التصنيف الضريبي للمنتج أو الخدمة التي ظهر بشأنها الخطأ. ثم صحح الفئة أو رمز السبب المطلوب وفقًا للمعاملة الضريبية الصحيحة للبيع.
لا تغير الفئة الضريبية بهدف التخلص من رسالة التحقق فقط. يجب أن تعكس الفاتورة المعاملة الصحيحة لضريبة القيمة المضافة على العملية.
المصدر: معيار تطبيق XML من ZATCA، قواعد الفئات الضريبية
مبالغ الضريبة تحتوي على منازل عشرية زائدة
القواعد: BR-DEC-13 وBR-DEC-14 وBR-KSA-DEC-03.
تضع ZATCA حدًا لعدد المنازل العشرية المسموح بها في عدد من حقول المبالغ. وتسمح الحقول المشمولة بالقواعد التالية بمنزلتين عشريتين كحد أقصى.
تغطي القاعدة BR-DEC-13 إجمالي ضريبة القيمة المضافة في الفاتورة. وتغطي BR-DEC-14 الإجمالي شامل الضريبة، بينما تتعلق BR-KSA-DEC-03 بمبلغ الضريبة على مستوى بند الفاتورة.
تحقق مما إذا كان نظام إنشاء الفواتير يكتب نتائج الحسابات غير المقربة مباشرة في ملف XML.
يجب معالجة المشكلة في طريقة الحساب أو إنشاء ملف XML. مع المحافظة على اتساق مبالغ المعاملة الأساسية مع قواعد حساب ضريبة القيمة المضافة المطبقة.
المصدر: معيار تطبيق XML من ZATCA، قواعد المنازل العشرية
الإشعار الدائن لا يحتوي على مرجع أو سبب
القواعد: BR-KSA-17 وBR-KSA-56.
يجب أن يتضمن الإشعار الدائن سبب إصداره، وأن يشير إلى الفاتورة السابقة المرتبطة به. وتغطي القاعدة BR-KSA-17 سبب إصدار الإشعار، بينما تشترط BR-KSA-56 وجود معرف مرجع الفاتورة في الإشعارات الدائنة والإشعارات المدينة.
إذا نتج عن استرداد مبلغ إشعار دائن لا يتضمن مرجع الفاتورة الأصلية، فراجع البيانات التي استُخدمت في إنشاء المستند.
ينشئ رصيدو إشعارات دائنة عند معالجة المبالغ المستردة في WooCommerce. ويرتبط كل إشعار دائن بالفاتورة الأصلية ويتضمن سبب الاسترداد.
المصدر: معيار تطبيق XML من ZATCA، قواعد الإشعارات الدائنة
أخطاء تسلسل الفواتير والتوقيع الرقمي
بصمة الفاتورة السابقة مفقودة أو مرمزة بطريقة غير صحيحة
القواعد: BR-KSA-26 وBR-KSA-61.
تشترط القاعدة BR-KSA-61 وجود بصمة الفاتورة السابقة، المعروفة بالاختصار PIH. وتحدد القاعدة BR-KSA-26 طريقة حساب هذه البصمة وترميزها، باستخدام SHA-256 وترميز Base64، مع استبعاد عناصر محددة من ملف XML أثناء حساب البصمة.
تشير كل فاتورة إلى المستند الذي سبق إنشاؤه. وينتج عن ذلك تسلسل يمكن التحقق منه لاكتشاف التغييرات.
إذا ظهرت هذه الرسالة، فافحص طريقة حساب البصمات في نظام إنشاء الفواتير ومرجع المستند السابق. وتستخدم الفاتورة الأولى البصمة الابتدائية المحددة في معيار ZATCA.
لا تستبدل البصمة يدويًا بقيمة عشوائية.
ينشئ رصيدو المستندات واحدًا تلو الآخر ويسجل بصمة الفاتورة السابقة. ويمنع ذلك عمليات الدفع المتزامنة في WooCommerce من تغيير ترتيب التسلسل.
المصدر: معيار تطبيق XML من ZATCA، القاعدتان BR-KSA-26 وBR-KSA-61
عداد الفواتير مفقود أو بصيغة غير صحيحة
القواعد: BR-KSA-33 وBR-KSA-34.
يجب أن تحتوي كل فاتورة على قيمة عداد الفواتير، المعروف بالاختصار ICV. وتشترط القاعدة BR-KSA-34 أن تتكون هذه القيمة من أرقام فقط.
تحقق من وجود العداد في حقل XML المخصص له.
وتنص الإرشادات الفنية للهيئة على عدم إعادة استخدام عداد الفاتورة. ويجب تخصيص عداد مستقل للمستند البديل، حتى عندما يكون المستند السابق قد رُفض.
يحدد رصيدو العداد عند إنشاء كل مستند ويحافظ على تسلسل الفواتير.
المصادر:
شهادة التوقيع غير صالحة أو التوقيع مفقود
القاعدة: BR-KSA-60. وتتناول الإرشادات الفنية للهيئة أيضًا التحقق من صلاحية الشهادات.
تشترط القاعدة BR-KSA-60 وجود ختم تشفيري على الفواتير الضريبية المبسطة والإشعارات المرتبطة بها. وتوضح ZATCA أن المستندات الموقعة باستخدام شهادات غير صالحة تُرفض.
تحقق من اكتمال ربط المتجر ووجود شهادة إنتاج صالحة مرتبطة بالرقم الضريبي للمنشأة.
يحصل رصيدو على الشهادة أثناء ربط المتجر. وإذا تغيرت قيمتا AUTH_KEY أو SECURE_AUTH_KEY في موقع WordPress، فيجب ربط المتجر مرة أخرى، لأن مفاتيح التشفير الجديدة لن تتمكن من فك تشفير الشهادة والمفتاح المخزنين. ولا تتأثر الفواتير التي سبق إصدارها.
المصادر:
مشكلات مواعيد الإبلاغ وتواريخ الفواتير
تأخر الإبلاغ عن فاتورة ضريبية مبسطة
يجب الإبلاغ عن الفواتير الضريبية المبسطة إلى ZATCA خلال 24 ساعة من وقت المعاملة.
هذه مهلة للإبلاغ عن الفاتورة. ولا يعني تجاوزها تلقائيًا أن المستند يحتوي على خطأ تحقق مماثل للأخطاء الموجودة في ملف XML.
تحقق من وقت إصدار المستند وحالة إرساله. وإذا ظل المستند في الانتظار، فافحص ما إذا كان السبب انقطاع الاتصال بالشبكة أو مشكلة في خدمات ZATCA.
يرسل رصيدو الفواتير الضريبية المبسطة في الخلفية باستخدام Action Scheduler. ويعيد محاولة الإرسال لعدة ساعات ضمن مهلة الإبلاغ عند حدوث مشكلات في الشبكة أو انقطاع خدمات ZATCA.
المصدر: الإرشادات الفنية التفصيلية من ZATCA، القسم 4.3.1
تاريخ إصدار الفاتورة يقع في المستقبل
القاعدة: BR-KSA-04.
تشترط ZATCA ألا يكون تاريخ إصدار المستند بعد التاريخ الحالي. وإذا ظهرت هذه القاعدة ضمن نتائج التحقق، فراجع التاريخ المسجل في ملف XML.
افحص إعدادات التاريخ والوقت في المتجر وطريقة إنشاء الفاتورة. ويجب أن يعكس تاريخ الإصدار التاريخ الصحيح للمستند، مع معالجة سبب المشكلة قبل إنشاء مستند جديد.
المصدر: معيار تطبيق XML من ZATCA، القاعدة BR-KSA-04
مراجعة الفواتير المرفوضة في رصيدو
يحتفظ رصيدو بملف XML الموقع واستجابة ZATCA داخل موقع WordPress الخاص بك. ويمكنك استخدام هذه البيانات لمعرفة سبب رفض المستند.
لمراجعة المشكلة:
- افتح WooCommerce > الفوترة الإلكترونية (ZATCA).
- اختر تبويب الفواتير الإلكترونية.
- ابحث عن المستند المتأثر وراجع حالته.
- اقرأ أسباب الرفض التي أعادتها ZATCA.
- حدد ما إذا كانت المشكلة في بيانات البائع أو حسابات الفاتورة أو أحد المتطلبات الفنية.
- صحح السبب الأساسي قبل اتباع الإجراء المناسب للمستند المرفوض.
يضيف رصيدو أيضًا ملاحظة إلى طلب WooCommerce عندما ترفض ZATCA الفاتورة. ويعيد محاولة الإرسال تلقائيًا عند حدوث مشكلات في الشبكة أو انقطاع الخدمة، مع إبقاء أسباب الرفض متاحة للمراجعة.
إذا اقترب موعد انتهاء صلاحية الشهادة، تعرض صحة الموقع (Site Health) تحذيرًا قبل 30 يومًا. ويمكنك تجديد الشهادة من خلال ربط المتجر مرة أخرى باستخدام رمز تحقق (OTP) جديد.
للاطلاع على تعليمات الإعداد والمزيد من التفاصيل، راجع توثيق رصيدو.
المصادر
أسئلة
هل يمكن إعادة إرسال فاتورة رفضتها ZATCA؟
نعم، بعد تصحيح سبب الرفض. وتشترط الإرشادات الفنية للهيئة إنشاء المستند البديل كمستند جديد له عداد فواتير مستقل وبصمة مناسبة للفاتورة السابقة. ويجب الاحتفاظ بالمستند المرفوض دون تغيير. أما الفاتورة التي قُبلت مع تحذيرات، فلا ينبغي إعادة إرسالها لمجرد وجود تلك التحذيرات.
هل يعني تحذير ZATCA أن الفاتورة مرفوضة؟
لا. تميز ZATCA بين المستندات المقبولة مع تحذيرات والمستندات المرفوضة. فالتحذير يعني أن المستند قُبل رغم وجود ملاحظة في أحد اختبارات التحقق، بينما يعني الرفض أن خطأ واحدًا على الأقل منع القبول. ويجب مراجعة التحذيرات ومعالجة أسبابها في الفواتير التالية. وتوضح حالة الاستجابة النتيجة التي تنطبق على المستند.
أين أجد أسباب رفض الفاتورة من ZATCA داخل WooCommerce؟
عند استخدام رصيدو، افتح WooCommerce > الفوترة الإلكترونية (ZATCA) > الفواتير الإلكترونية. يعرض التبويب أسباب الرفض التي أعادتها ZATCA، ويضيف رصيدو ملاحظة إلى طلب WooCommerce المرتبط بالفاتورة. كما يحتفظ بملف XML الموقع واستجابة الهيئة داخل موقعك، حتى تتمكن من مراجعة المستند والمشكلة المسجلة.