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

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

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

Home › Official Error Catalog › BR-KSA-02

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

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

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

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

BR-KSA-02 — BLOCKING REJECTION

Official Specification Rule

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

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

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

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

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

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

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

Normativa y estándar de destino:

📄 Arrastra aquí tu factura PDF, XML o CSV

Sin registro previo • Procesamiento privado • Compatible con Holded, Quipu, Stripe, QuickBooks, SAP y Xero

🛠️ Editor 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

🛡️ Informe de Conformidad

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