LIVE 2026/2027 MANDATE ENGINE: Germany XRechnung 3.0.2 • ZUGFeRD 2.3 • Belgium/EU Peppol BIS 3.0 • Saudi ZATCA Phase 2 • UAE PINT
🇬🇧 EN🇩🇪 DE🇫🇷 FR🇧🇪 NL🇸🇦 AR🇮🇹 IT🇵🇱 PL🇪🇸 ES
85 EightyFive E-Invoice Hub
Home › Official Error Catalog › BR-KSA-27
🇸🇦 Saudi ZATCA Phase 2 (Fatoora) • SEVERITY: FATAL • KSA-14 (TLV Base64 Encoded QR Code)

How to Fix BR-KSA-27: KSA-14 (TLV Base64 Encoded QR Code)

The invoice is either missing the `AdditionalDocumentReference` with `ID="QR"`, or uses a plain URL/text QR code instead of ZATCA’s mandatory binary TLV Base64 payload (Seller Name, VAT Number, ISO Timestamp, Total with VAT, VAT Amount, XML SHA-256 Hash, ECDSA Signature, Public Key).

📐 Official Schematron Specification & XPath Diagnosis for BR-KSA-27

BR-KSA-27 — BLOCKING REJECTION
Official Specification Rule
[BR-KSA-27] The QR code (KSA-14) must be present and encoded in Base64 TLV (Tag-Length-Value) format containing Tags 1 to 9 for Phase 2.
XPath: /ubl:Invoice/cac:AdditionalDocumentReference[cbc:ID="QR"]/cac:Attachment/cbc:EmbeddedDocumentBinaryObject
Deterministic Remediation (How to Fix)
Compute the TLV byte array for Tags 1–9, encode as Base64, and embed inside cac:AdditionalDocumentReference[cbc:ID="QR"].
❌ REJECTED XML STRUCTURE (TRIGGERS BR-KSA-27)
<!-- Missing QR AdditionalDocumentReference or plain text QR -->
✅ COMPLIANT XML STRUCTURE (BR-KSA-27 FIXED)
<cac:AdditionalDocumentReference>
  <cbc:ID>QR</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject mimeCode="text/plain">AQxBbC1Ob29yIENvLnwCDzMxMDEyMjM5MzUwMDAwMwMUMjAyNi0xMS0wOFQxMjowMDowMFoEBjExNTAuMAUFMTUwLjA=</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>

⚡ Repair BR-KSA-27 in Your Invoice Right Now:

اختر النظام الضريبي والمعيار المطلوب:

📄 اسحب وأفلت ملف الفاتورة PDF أو XML أو CSV هنا

فحص فوري بدون تسجيل • خصوصية تامة • يدعم QuickBooks و Xero و Stripe و دفترة و قيود و SAP

🛠️ محرر الإصلاح التلقائي

1. Document Header & Routing Identifiers XRECHNUNG 3.0.2
2. Seller Party & Mandatory Contact (BG-4 / BG-6 / BR-DE-2) BT-27 .. BT-43
3. Buyer Party & Peppol Endpoint (BG-7 / R010) BT-44 .. BT-55
4. Line Items & EN 16931 Mathematical Reconciliation (BR-CO-10 .. 16) BG-25 / BG-22

🛡️ تقرير مطابقة قواعد ZATCA / EN 16931

AUDITING...
Checking Official Schematron Rules...
Validating EN 16931, KoSIT, Peppol BIS 3.0 & ZATCA Phase 2
--%

Related Saudi ZATCA Phase 2 (Fatoora) Validation Rules

BR-KSA-03

KSA-1 (UUID / Universally Unique Identifier)

[BR-KSA-03] The invoice must contain a unique identifier (UUID) (KSA-1) given by the machine that issued the document matching RFC 4122 format.

Fix BR-KSA-03 →
BR-KSA-06

KSA-2 (Invoice Sub-Type Code / NNPNESB)

[BR-KSA-06] The invoice transaction code (@name attribute on cbc:InvoiceTypeCode) must exist and respect the 7-character pattern NNPNESB (e.g., 0100000 for Standard Tax Invoice or 0200000 for Simplified Invoice).

Fix BR-KSA-06 →
BR-KSA-08

BT-31 (Seller 15-Digit Saudi VAT Number)

[BR-KSA-08] Seller VAT registration number (BT-31) must consist of 15 digits, starting with 3 and ending with 3.

Fix BR-KSA-08 →
BR-KSA-09

Seller National Address (BuildingNumber, PlotIdentification, District, PostalZone)

[BR-KSA-09] Seller address must contain Street Name (BT-35), Building Number (KSA-17), City (BT-37), Postal Code (5 digits, BT-38), District (KSA-3), and Country Code (SA).

Fix BR-KSA-09 →
BR-KSA-F-01

BT-2 (IssueDate ISO 8601 Format)

[BR-KSA-F-01] All dates MUST be formatted strictly as YYYY-MM-DD in the Gregorian calendar.

Fix BR-KSA-F-01 →
BR-KSA-01

KSA Phase 2 Field Rule #1

[BR-KSA-01] Saudi ZATCA Electronic Invoice XML Implementation Standard mandatory rule BR-KSA-01.

Fix BR-KSA-01 →
BR-KSA-02

KSA Phase 2 Field Rule #2

[BR-KSA-02] Saudi ZATCA Electronic Invoice XML Implementation Standard mandatory rule BR-KSA-02.

Fix BR-KSA-02 →
BR-KSA-04

KSA Phase 2 Field Rule #4

[BR-KSA-04] Saudi ZATCA Electronic Invoice XML Implementation Standard mandatory rule BR-KSA-04.

Fix BR-KSA-04 →
BR-KSA-05

KSA Phase 2 Field Rule #5

[BR-KSA-05] Saudi ZATCA Electronic Invoice XML Implementation Standard mandatory rule BR-KSA-05.

Fix BR-KSA-05 →
INSTANT SELF-SERVE ACTIVATION • NO SALES CALLS

بدون مكالمات مبيعات. تفعيل فوري وذاتي خلال ثوانٍ.

لا تدع فاتورة معلقة تؤخر تحصيل مستحقاتك المالية. اختر باقة الفاتورة الواحدة الطارئة أو الباقة الشهرية للشركات.

Single Emergency Fix

باقة الطوارئ لفاتورة واحدة

$19 دفعة واحدة فقط

تحويل وإصلاح فاتورة واحدة عاجلة فوراً مع رمز QR والختم القياسي. بدون اشتراك شهري.

  • ✅ Convert 1 PDF/CSV or Repair 1 Rejected XML
  • ✅ Full KoSIT, EN 16931, Peppol & ZATCA Validation
  • ✅ Download Certified UBL 2.1 XML + Hybrid ZUGFeRD PDF/A-3
  • ✅ Includes ZATCA Phase 2 TLV QR & Leitweg-ID Check
تحميل الفاتورة المعتمدة ($19) ←
MOST POPULAR FOR B2B SAVE 85% vs ERP

باقة الشركات والمصدرين (Pro)

$79 / شهرياً

حتى 250 فاتورة شهرياً، تحويل جماعي، بريد إلكتروني للتحويل التلقائي وربط مع QuickBooks/Stripe.

  • ✅ Up to 250 Certified E-Invoices / month
  • ✅ Batch ZIP Upload (Convert 50 PDFs at once)
  • ✅ Email-to-XML Auto-Inbox (Forward from Stripe/Xero/QuickBooks)
  • ✅ All 5 Mandates: XRechnung, ZUGFeRD, Peppol, ZATCA & UAE PINT
  • ✅ Saved Seller IBAN, VAT ID & Buyer Leitweg-ID Profiles
ابدأ باقة الشركات ($79/شهرياً) ←
For Tax Advisors & High Volume

باقة مكاتب المحاسبة والشركات المتعددة

$199 / شهرياً

أرقام ضريبية غير محدودة، واجهة برمجية Webhook API، وبوابة خاصة لفحص فواتير الموردين.

  • ✅ Unlimited Client VAT / Tax Registration IDs
  • ✅ Up to 2,500 Conversions & Validations / month
  • ✅ Full REST Webhook API (Stripe, Make, Zapier, n8n, SAP)
  • ✅ Branded Supplier Compliance Gate Portal for Vendors
تفعيل باقة مكاتب المحاسبة ($199/شهرياً) ←