مرجعك التقني الشامل لتشخيص وتصحيح جميع أخطاء التحقق والرفض الصادرة من منصة فاتورة (ZATCA Fatoora Portal)، مع حلول خطوة بخطوة ونماذج XML مقارنة قبل وبعد التصحيح.
BR-KSA-03 • BR-KSA-03: Invalid Universally Unique Identifier (UUID / KSA-1)
يجب أن تحتوي الفاتورة على معرّف فريد عالمياً (UUID) وفق معيار RFC 4122 يحتوي على أحرف وأرقام وشرطات فقط.
BR-KSA-04 • BR-KSA-04: Invoice Issue Date Cannot Be in Future
تاريخ إصدار الفاتورة (BT-2) يجب أن يكون أقل من أو مساوياً للتاريخ الحالي بتوقيت المملكة العربية السعودية (UTC+3).
BR-KSA-05 • BR-KSA-05: Invalid Invoice Type Code (BT-3)
رمز نوع الفاتورة يجب أن يكون أحد رموز UN/CEFACT 1001 المعتمدة: 388 (فاتورة ضريبية)، 381 (إشعار دائن)، 383 (إشعار مدين)، 386 (دفعة مقدمة).
BR-KSA-06 • BR-KSA-06: Invalid Invoice Transaction Subtype Code (NNPNESB / KSA-2)
كود المعاملة (KSA-2) في خاصية name يجب أن يتكون من 7 خانات وفق هيكلية NNPNESB المعتمدة من زاتكا.
BR-KSA-08 • BR-KSA-08: Invalid Seller Identification Scheme (BT-29)
يجب أن يتوفر معرف البائع مرة واحدة مع أحد مخططات الهوية المعتمدة: CRN (السجل التجاري)، MOM، MLS، 700، SAG، أو OTH.
BR-KSA-09 • BR-KSA-09: Seller Saudi National Address Mandatory Fields Missing
يجب أن يحتوي عنوان البائع على العناصر الستة الكاملة للعنوان الوطني السعودي: اسم الشارع، رقم المبنى، الرمز البريدي، المدينة، الحي، ورمز الدولة (SA).
BR-KSA-15 • BR-KSA-15: Supply Date Mandatory for Standard Tax Invoices
الفواتير الضريبية القياسية (B2B) يجب أن تتضمن تاريخ التوريد الفعلي (KSA-5) داخل عقدة التسليم cac:Delivery.
BR-KSA-26 • BR-KSA-26: Invalid Previous Invoice Hash Calculation (PIH / KSA-13)
يجب أن يكون هاش الفاتورة السابقة (KSA-13) مشفراً بـ Base64 لترميز SHA-256 للفاتورة السابقة، أو الهاش المبدئي الصفري للفاتورة الأولى.
BR-KSA-27 • BR-KSA-27: Mandatory QR Code (KSA-14) Missing or Malformed
يجب أن تحتوي الفاتورة على رمز QR مشفر بنظام Base64 ومبني بترميز TLV وفق متطلبات المرحلة الثانية من هيئة الزكاة.
BR-KSA-31 • BR-KSA-31: Unsupported Subtype on Simplified Tax Invoice
بالنسبة للفواتير المبسطة (02)، يسمح فقط بمعاملات الطرف الثالث والتوريد الاعتباري والفواتير المجمعة، ويحظر التصدير والفوترة الذاتية.
BR-KSA-37 • BR-KSA-37: Seller Building Number Must Be Exactly 4 Digits
رقم مبنى البائع (KSA-17) يجب أن يتكون من 4 خانات رقمية مطابقة لبيانات العنوان الوطني السعودي.
BR-KSA-40 • BR-KSA-40: Seller VAT Number Must Be 15 Digits Starting & Ending with 3
رقم التسجيل الضريبي للبائع (BT-31) يجب أن يتكون من 15 رقماً بالضبط، يبدأ بالرقم 3 وينتهي بالرقم 3.
BR-KSA-51 • BR-KSA-51: Line Total Amount with VAT Mismatch (KSA-12)
مبلغ البند شامل الضريبة (KSA-12) يجب أن يساوي تماماً صافي مبلغ البند (BT-131) + مبلغ ضريبة البند (KSA-11).
BR-KSA-56 • BR-KSA-56: Billing Reference ID Mandatory for Credit & Debit Notes
للإشعارات الدائنة (381) والمدينة (383)، يجب تضمين رقم الفاتورة المرجعية الأصلية (BT-25) في عقدة BillingReference.
BR-KSA-63 • BR-KSA-63: Buyer Saudi National Address Mandatory When Country is 'SA'
إذا كان رمز دولة المشتري 'SA' في الفاتورة الضريبية القياسية، فإن جميع عناصر العنوان الوطني السعودي للمشتري تصبح إلزامية.
BR-KSA-68 • BR-KSA-68: Tax Currency Code Must Exist and Be 'SAR'
رمز العملة الضريبية (BT-6) إلزامي في كل فاتورة ويجب أن يكون 'SAR' (الريال السعودي) بغض النظر عن عملة الفاتورة.
BR-KSA-70 • BR-KSA-70: Invalid Invoice Issue Time Format (KSA-25)
يجب أن يتضمن وقت إصدار الفاتورة (KSA-25) صيغة 'hh:mm:ss' بالتوقيت المحلي أو 'hh:mm:ssZ' بتوقيت UTC.
BR-KSA-DEC-01 • BR-KSA-DEC-01: Allowance / Discount Percentage Must Have Maximum 2 Decimals
نسبة الخصم يجب أن تكون قيمة رقمية من 0.00 إلى 100.00 بحد أقصى خانتين عشريتين، ويحظر إدخال رمز النسبة المئوية (%).
ZATCA-API-429 • ZATCA API 429: Too Many Requests / Rate Limit Exceeded
تفرض منصة فاتورة حداً أقصى لمعدل إرسال الفواتير في الثانية، ويؤدي إرسال طلبات متزامنة بكثافة إلى إرجاع خطأ HTTP 429.
INVALID-INVOICE-HASH • INVALID-INVOICE-HASH: Cryptographic Invoice Hash Mismatch
بصمة SHA-256 المحتسبة لملف XML لا تطابق البصمة المستخرجة بواسطة مدقق زاتكا نتيجة أخطاء في التحويل المعياري C14N.
جرب البحث بكلمات أخرى أو تصفح القواعد بحسب التصنيف أعلاه.
نظام قيمة مصمم ليتولى التحقق التلقائي من معايير BR-KSA، والتوقيع الرقمي ECDSA، والتحويل المعياري C14N، وتوليد رمز الاستجابة السريعة TLV في أجزاء من الثانية دون أي تدخل يدوي.