What does validation error BR-KSA-20 mean in Saudi ZATCA Phase 2 (Fatoora)?

[BR-KSA-20] Saudi ZATCA Electronic Invoice XML Implementation Standard mandatory rule BR-KSA-20. ZATCA Fatoora portal / SDK rejected the UBL 2.1 XML under rule BR-KSA-20 during Phase 2 Clearance or Reporting.

How do I fix BR-KSA-20 (KSA Phase 2 Field Rule #20) automatically?

Apply ZATCA Phase 2 UBL 2.1 extensions (UUID, ICV counter, PIH hash, 15-digit VAT TIN, National Address, and 9-tag TLV QR) to clear BR-KSA-20. You can upload your rejected XML or PDF invoice in the workbench on this page and click "1-Click Auto-Fix All Errors" to repair BR-KSA-20 immediately.

Home › Official Error Catalog › BR-KSA-20

🇸🇦 Saudi ZATCA Phase 2 (Fatoora) • SEVERITY: FATAL • KSA Phase 2 Field Rule #20

How to Fix BR-KSA-20: KSA Phase 2 Field Rule #20

ZATCA Fatoora portal / SDK rejected the UBL 2.1 XML under rule BR-KSA-20 during Phase 2 Clearance or Reporting.

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

BR-KSA-20 — BLOCKING REJECTION

Official Specification Rule

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

XPath: /ubl:Invoice

Deterministic Remediation (How to Fix)

Apply ZATCA Phase 2 UBL 2.1 extensions (UUID, ICV counter, PIH hash, 15-digit VAT TIN, National Address, and 9-tag TLV QR) to clear BR-KSA-20.

❌ REJECTED XML STRUCTURE (TRIGGERS BR-KSA-20)

<!-- ZATCA Fatoora SDK Rejection: BR-KSA-20 -->

✅ COMPLIANT XML STRUCTURE (BR-KSA-20 FIXED)

<!-- ZATCA Phase 2 Compliant UBL 2.1 Node (BR-KSA-20 CLEARED) -->

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

Ziel-Standard & Rechtsnorm wählen:

📄 PDF-Rechnung, XRechnung XML oder ZUGFeRD hier ablegen

Keine Registrierung für den Sofort-Check • DSGVO-konforme Verarbeitung • Unterstützt DATEV, Lexoffice, sevDesk, Stripe & SAP

🛠️ Auto-Korrektur Editor

1. Document Header & Routing Identifiers XRECHNUNG 3.0.2

Invoice No BT-1

Issue Date BT-2

Due Date BT-9 / BR-DE-26

Buyer Ref / Leitweg-ID BT-10 / BR-DE-15

Currency & ZATCA UUID BT-5 / KSA-1

2. Seller Party & Mandatory Contact (BG-4 / BG-6 / BR-DE-2) BT-27 .. BT-43

Seller Legal Name BT-27

Seller VAT / 15-Digit ZATCA TIN BT-31 / BR-KSA-08

Contact Person BT-41 / BR-DE-5

Contact Phone BT-42 / BR-DE-6

Contact Email BT-43 / BR-DE-7

Seller EndpointID BT-34 / R020

Building # (ZATCA) KSA-17

SEPA Payee IBAN BT-84 / BR-DE-23

3. Buyer Party & Peppol Endpoint (BG-7 / R010) BT-44 .. BT-55

Buyer Legal Name BT-44

Buyer VAT ID BT-48

Buyer EndpointID BT-49 / R010

4. Line Items & EN 16931 Mathematical Reconciliation (BR-CO-10 .. 16) BG-25 / BG-22

Net Total BT-109 / BR-CO-13

VAT Total BT-110 / BR-S-09

Payable Gross BT-112 / BR-CO-15

🛡️ KoSIT / EN 16931 Prüfbericht

AUDITING...

UTF-8 • OASIS UBL 2.1 / EN 16931

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-27

KSA-14 (TLV Base64 Encoded QR Code)

[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.

Fix BR-KSA-27 →

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 →

INSTANT SELF-SERVE ACTIVATION • NO SALES CALLS

Keine Verkaufsgespräche. Sofortige E-Rechnungs-Freigabe.

Wenn Ihr Kunde eine PDF-Rechnung ablehnt, zählen Minuten. Einzel-Pass oder Flatrate für Buchhaltung & Steuerberater.

Single Emergency Fix

Notfall Einzel-Rechnungspass

$19 einmalig

1 abgelehnte Rechnung sofort in XRechnung 3.0 & ZUGFeRD 2.3 umwandeln & reparieren. Kein Abo.

✅ 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

Einzelrechnung freischalten ($19) →

Pro B2B & Export-Tarif

$79 / Monat

Bis zu 250 E-Rechnungen/Monat, Stapelverarbeitung, E-Mail-zu-XRechnung Postfach & Vorlagen.

✅ 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

Pro-Tarif starten ($79/Mo) →

For Tax Advisors & High Volume

Steuerberater & Multi-Mandanten Hub

$199 / Monat

Unbegrenzte USt-IdNr./Mandanten, Webhook-API und eigenes Lieferanten-Prüfportal.

✅ 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

Kanzlei-Hub starten ($199/Mo) →