أكواد أخطاء زاتكا بالعربي — معنى كل كود وطريقة حله

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

كيف تقرأ الكود قبل أن تبحث عنه

بنية الكود نفسها تخبرك بمكان المشكلة، وهذا يختصر نصف وقت البحث:

• BR-KSA-… قاعدة خاصة بالمملكة، غالباً حقل إلزامي أو صيغة محلية
• BR-KSA-F-… تنسيق حقل: طول، أو صيغة، أو محارف غير مسموحة
• BR-CO-… قاعدة حسابية مشتركة، عادةً تطابق مجاميع
• BR-S وBR-Z وBR-O وBR-E قواعد فئات الضريبة: أساسية، صفرية، خارج النطاق، معفاة
• BR-KSA-EN16931-… قاعدة من المواصفة الأوروبية التي تبني عليها المملكة
• KSA-… رقم حقل محلي، مثل KSA-14 لرمز QR وKSA-25 لوقت الإصدار

أكواد الهوية والترقيم

هذه المجموعة تخص «من أنت» و«رقم الفاتورة»، وهي أكثر ما يظهر عند بدء الربط:

• KSA-9 وBR-KSA-31: تكرار المعرّف الفريد UUID أو انقطاع تسلسل عدّاد الفواتير ICV
• BR-KSA-F-08: معرّف السجل التجاري CRN بصيغة غير صحيحة
• BR-KSA-F-10: معرّف الهوية الوطنية NAT للمشتري بصيغة غير صحيحة
• BR-KSA-F-12: معرّف البائع أو المشتري يحتوي على مسافات وهي غير مسموحة
• BR-KSA-42 وBR-KSA-71: اسم المشتري مطلوب على أنواع بعينها من الفواتير
• BR-KSA-63: رقم المبنى مطلوب إذا كان بلد المشتري السعودية

أكواد الحساب والضريبة

هذه أكثر ما يُربك المحاسبين لأن الأرقام تبدو صحيحة على الورق:

• BR-CO-17 وBR-S-09: قيمة الضريبة يجب أن تساوي الوعاء × النسبة مقرّباً لخانتين
• BR-25: الإجمالي قبل الضريبة يجب أن يساوي مجموع صافي البنود
• BR-S-05: نسبة الضريبة على البند يجب أن تطابق نسبة فئة الضريبة
• BR-KSA-84: النسب المسموحة للفئة الأساسية محصورة في ٥٪ و١٥٪
• BR-KSA-97: عند اختلاف العملة عن الريال، لمبلغ الضريبة بعملة المحاسبة قاعدة منفصلة

أكواد رمز QR والتوقيع

وتخص المرحلة الأولى والثانية معاً:

• BR-KSA-26 وBR-KSA-27: رمز QR يجب أن يكون بصيغة base64Binary
• BR-KSA-CL-14: الحد الأقصى لطول محتوى رمز QR رُفع إلى ألف حرف
• BR-KSA-29: معرّف التوقيع المرجعي يجب أن يطابق القيمة المحددة حرفياً
• BR-KSA-70: وقت إصدار الفاتورة KSA-25 أصبح إلزامياً

أكواد التوقيت والصيغة

• BR-KSA-98: إرسال فاتورة مبسطة بعد انتهاء مهلة الأربع والعشرين ساعة
• BR-KSA-F-01: التواريخ يجب أن تكون ميلادية بصيغة ISO 8601، والتاريخ الهجري يُرفض
• BR-CL-14: رموز الدول يجب أن تتبع قائمة ISO 3166-1
• BR-KSA-06: رمز نوع المعاملة يجب أن يكون سبع خانات بالضبط

انتبه: القواعد تتغيّر بين إصدارات SDK

بعض القواعد أُلغيت وبعضها أُعيد تفعيله. فمثلاً أُزيلت BR-KSA-50 لتفادي أخطاء التقريب على مستوى البند، وأُعيد تفعيل BR-KSA-15 وBR-KSA-35 وBR-KSA-36 في إصدار لاحق، وخُففت قواعد مثل BR-CO-16 وBR-CO-10 من «مرفوضة» إلى «مقبولة مع تحذير».

لهذا لا تعتمد على مقال قديم — بما في ذلك هذا المقال — كمرجع نهائي. تحقق من سجل إصدارات SDK الذي يستخدمه مزوّدك، ومن مواصفة XML المنشورة من الهيئة.

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

ما الفرق بين خطأ وتحذير في نتيجة الفحص؟

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

أين المرجع الرسمي الكامل للأكواد؟

لا توجد صفحة رسمية واحدة تجمعها. المرجع الملزم هو مواصفة XML للفوترة الإلكترونية وملفات schematron المرفقة بإصدار SDK، وكلاهما يُنزَّل من موقع الهيئة.