أخطاء منصة فاتورة تصلك برمز قاعدة مثل BR-KSA-40 ونص إنجليزي قصير، حين ترفض المنصة فاتورتك في السعودية أو تقبلها بتحذير. اكتب الرمز في خانة البحث أعلاه أو الصق الرد كاملاً، فتظهر لكل رسالة نصها الرسمي، وهل هي رفض أم تحذير، والحقل المعني في ملف XML، وأشهر أسبابها، وخطوات إصلاحها قائمةً تؤشّر عليها. وتنزّل لكل رسالة ورقة إصلاح بصيغة PDF تعطيها لمزوّد النظام أو للمبرمج.
كيف تستعمل مستكشف الأخطاء
البحث يقرأ ثلاثة أشكال: الرمز وحده بأي كتابة (BR-KSA-40 أو br ksa 40)، أو رد المنصة كاملاً بكل ما فيه من رموز، أو كلمة من الرسالة بالإنجليزية أو بالعربية. حين يجد رمزاً واحداً يفتح شرحه مباشرة، وحين يجد عدة رموز يرتّبها والرفض أولاً، لأن الرفض هو ما يمنع قبول الفاتورة الآن. وإن كان في النص رمز لم يُشرح هنا بعد، يذكره تحت عدد النتائج حتى لا يضيع.
مفتاح «تصفية متقدمة» يصفّي بالدرجة وبنوع الفاتورة، وزر «نسخ رابط الرسالة» داخل كل شرح يعطيك رابطاً يفتحها وحدها.
الفرق بين الرفض والتحذير في منصة فاتورة
الفاتورة الضريبية (القياسية) تمر بالاعتماد (Clearance): ترسلها إلى المنصة قبل أن تعطيها للمشتري، ولا تُعد صحيحة إن رجعت برفض. والفاتورة المبسطة تمر بالإبلاغ (Reporting): تعطيها للعميل فوراً، ثم تبلّغ المنصة بها خلال 24 ساعة من إصدارها. وفي الحالتين يعود الرد بإحدى نتيجتين: رسالة رفض واحدة على الأقل فلم تُقبل الفاتورة ويجب إصلاحها وإعادة إرسالها، أو تحذيرات بلا رفض فقُبلت الفاتورة معها.
الدرجة الظاهرة بجوار كل رمز هنا مأخوذة من ملفات قواعد التحقق في عدّة التطوير التي تنشرها الهيئة (SDK)، وهي الملفات نفسها التي تفحص بها المنصة. فإن جاء رد المنصة بدرجة مختلفة لرمز ما، فالمعتمد رد المنصة، لأن الهيئة تحدّث القواعد بين الإصدارات.
كيف تقرأ رسالة الرفض من منصة فاتورة
الرسالة الرسمية تذكر الحقل بمعرّفه في نموذج البيانات: BT للحقول الأوروبية الأصل (مثل BT-31 الرقم الضريبي للبائع) وKSA للحقول السعودية (مثل KSA-16 عدّاد الفاتورة). ولهذا يذكر كل شرح هنا مسار الحقل في ملف XML، فتبحث عنه في الملف مباشرة. والرموز ثلاث عائلات: BR وBR-CO من قواعد المعيار الأوروبي للفوترة الإلكترونية، وBR-KSA من قواعد الهيئة الخاصة بالسعودية. وبعض الرسائل بلا رمز BR لأنها من فحوص أخرى: بنية الملف، ورمز QR، والتوقيع، وسلسلة التجزئة.
ولقراءة رمز QR أو ملف XML نفسه وفحص صيغته ومبالغه، استعمل قارئ الفاتورة الإلكترونية، ثم ارجع إلى هنا برمز الرسالة.
أكثر رسائل الرفض شيوعاً في الربط مع فاتورة
| الرمز | ما الذي ينقص | أول ما تفحصه |
|---|---|---|
| BR-KSA-40 | الرقم الضريبي للبائع بشكل خاطئ | 15 رقماً أولها وآخرها 3 |
| BR-KSA-33 | عدّاد الفاتورة ICV | العدّاد بعد ترقية النظام أو نقله |
| BR-KSA-70 | وقت الإصدار بصيغته | أجزاء الثانية وفرق التوقيت |
| BR-CO-15 | الإجمالي شاملاً الضريبة | الخصم بعد الضريبة والتقريب |
| BR-KSA-84 | نسبة الفئة القياسية | صنف صفري مسجل بفئة S |
| BR-KSA-17 | سبب الإشعار الدائن | حقل InstructionNote |
| invoiceTotal | إجمالي QR لا يطابق الفاتورة | توليد الرمز قبل آخر تعديل |
وأكثر التحذيرات ظهوراً في الفواتير الضريبية نقص بيانات المشتري: الاسم (BR-KSA-42)، والعنوان الوطني الكامل (BR-KSA-63)، ومعرّف بديل حين لا يكون للمشتري رقم ضريبي (BR-KSA-81).
أخطاء شائعة عند إصلاح رسائل الرفض
- تعديل ملف XML بعد توقيعه. أي تعديل ولو مسافة يغيّر التجزئة، فتُرفض الفاتورة برسائل التوقيع ورمز QR. صحّح البيانات في النظام، ثم وقّع من جديد.
- إرسال الفاتورة المصحّحة بالعدّاد والتجزئة السابقة نفسيهما. كل محاولة إرسال مستند جديد في سلسلة الجهاز، فتأخذ العدّاد التالي وتجزئة آخر فاتورة قُبلت.
- تجاهل التحذيرات لأن الفاتورة قُبلت. تتكرر في كل فاتورة، وقد تصير رفضاً مع تحديث القواعد.
- إصلاح الرسالة الأولى وحدها. الرد قد يحمل عدة رسائل، والصق الرد كاملاً هنا لترى كل ما فيه.
- تغيير تاريخ الفاتورة لتجاوز تحذير التأخير في الإبلاغ. التاريخ يبقى تاريخ الإصدار الفعلي.
ماذا تفعل بعد إصلاح الرسالة
أعد إرسال الفاتورة نفسها بعد التصحيح إن كانت رُفضت، وتابع أن الرد خلا من الرفض. ثم ابحث عن سبب الرسالة في الإعدادات لا في الفاتورة وحدها: بيانات الفرع، وبطاقة العميل، وقالب الفاتورة، ومهمة الإرسال المجدولة، حتى لا تعود في الفاتورة التالية. وإن كانت الرسالة تخص برمجة الحل (التجزئة أو التوقيع أو ترتيب العناصر)، فأرسل ورقة الإصلاح بصيغة PDF إلى مزوّد النظام مع نص الرد كما وصلك. ولمعرفة موعد الربط الإلزامي لمنشأتك استعمل أداة موجة الربط.
حين تتكرر رسائل الرفض في فواتير كل يوم
نحن في ميكروتيك نبني برنامج محاسبة (ERP) تجتمع فيه المبيعات والمشتريات والمخزون والمالية والموارد البشرية، وحلولنا معتمدة من هيئة الزكاة والضريبة والجمارك. إن كانت الفواتير تُصدر من أكثر من نظام وكل نظام يُصلح وحده، فجرّب أن تكون الفاتورة وبيانات العميل والفرع في مكان واحد.