BR-KSA-06 📑 هيكلية ونوع الفاتورة error

BR-KSA-06: كود المعاملة الفرعية للفاتورة غير صحيح (NNPNESB / KSA-2)

BR-KSA-06: Invalid Invoice Transaction Subtype Code (NNPNESB / KSA-2)

المواصفة التقنية المعتمدة من زاتكا:

يجب أن يتطابق كود المعاملة في خاصية name مع نمط NNPNESB: خانتان 01 (ضريبية) أو 02 (مبسطة)، تليها 5 خانات ثنائية (0 أو 1) لطرف ثالث، توريد اعتباري، تصدير، مجمعة، وفوترة ذاتية.

XPath Context: /ubl:Invoice/cbc:InvoiceTypeCode/@name

📌 نبذة عن القاعدة وسبب التدقيق

كود المعاملة (KSA-2) في خاصية name يجب أن يتكون من 7 خانات وفق هيكلية NNPNESB المعتمدة من زاتكا.

English Description: The invoice transaction code (KSA-2) must exist in @name attribute of InvoiceTypeCode and respect the 7-digit NNPNESB structure.

⚠️ الأسباب الشائعة لظهور الخطأ ورفض الفاتورة

  • غياب خاصية @name في وسم <cbc:InvoiceTypeCode>
  • طول النص في خاصية name لا يساوي 7 خانات بالضبط
  • استخدام أحرف أو أرقام غير 0 و 1 في الخانات من 3 إلى 7
  • دمج غير مسموح به (مثل تعيين فاتورة تصدير مع فاتورة مبسطة)

خطوات الحل وتصحيح الفاتورة

1

بناء الكود السباعي

للفاتورة الضريبية B2B: '0100000'، وللفاتورة المبسطة B2C: '0200000'، ولفاتورة التصدير: '0100100'.

2

فحص قيود التصدير

لا تقم بتفعيل خانة التصدير (الخانة الخامسة) مع الفواتير المبسطة (02).

💻 نموذج برمجي لمقارنة ملف XML (قبل وبعد التصحيح)

❌ النموذج الخاطئ (مرفوض من زاتكا) Invalid XML
<cbc:InvoiceTypeCode name="01">388</cbc:InvoiceTypeCode>
✓ النموذج الصحيح (المعتمد رسمياً) Valid UBL 2.1
<cbc:InvoiceTypeCode name="0100000">388</cbc:InvoiceTypeCode>

تحقق من صحة ملف الفاتورة الآن مجاناً

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

الأسئلة الشائعة حول BR-KSA-06

ما هو كود المعاملة للفاتورة الضريبية القياسية B2B؟

كود المعاملة للفاتورة الضريبية القياسية المحلية هو '0100000'.

ودّع مشاكل الربط وأخطاء الفوترة مع برنامج قيمة

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