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

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

How do I fix BR-KSA-24 (KSA Phase 2 Field Rule #24) 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-24. 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-24 immediately.

Home › Official Error Catalog › BR-KSA-24

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

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

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

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

BR-KSA-24 — BLOCKING REJECTION

Official Specification Rule

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

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

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

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

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

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

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

Wybierz docelowy standard prawny:

📄 Upuść tutaj fakturę PDF, XML lub CSV

Bez rejestracji • Pełna poufność • Obsługuje inFakt, Fakturownia, wFirma, Comarch, Stripe i Xero

🛠️ Edytor Auto-Fix

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

🛡️ Raport Walidacji

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

Zero rozmów handlowych. Natychmiastowy dostęp.

Gdy niemiecki lub unijny kontrahent odrzuca fakturę PDF, odblokuj płatność w 30 sekund.

Single Emergency Fix

Pakiet Awaryjny — 1 Faktura

$19 jednorazowo

Napraw i przekonwertuj 1 pilną fakturę natychmiast. Bez subskrypcji.

✅ 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

Odblokuj fakturę ($19) →

Plan Pro Eksporter & B2B

$79 / miesiąc

Do 250 faktur/mies., paczki ZIP, skrzynka Email-do-XML oraz szablony kontrahentów.

✅ 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

Uruchom Plan Pro ($79/mies.) →

For Tax Advisors & High Volume

Hub dla Biur Rachunkowych

$199 / miesiąc

Nielimitowane numery NIP/VAT, API Webhook oraz Portal Weryfikacji Dostawców.

✅ 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

Aktywuj Hub Biura ($199/mies.) →