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

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

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

Home › Official Error Catalog › BR-KSA-40

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

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

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

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

BR-KSA-40 — BLOCKING REJECTION

Official Specification Rule

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

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

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

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

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

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

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

Standard Normativo di Destinazione:

📄 Trascina qui la tua fattura PDF, XML o CSV

Nessuna registrazione per l’analisi • Elaborazione sicura • Compatibile con Stripe, Fatture in Cloud, TeamSystem, SAP & 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

🛡️ Report Validazione EN 16931

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 chiamate commerciali. Attivazione immediata.

Sblocca subito i pagamenti fermi per fatture rifiutate da clienti esteri o PA.

Single Emergency Fix

Pass Emergenza Singola Fattura

$19 una tantum

Converti e ripara subito 1 fattura bloccata. Nessun abbonamento.

✅ 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

Sblocca Fattura ($19) →

Piano Pro Esportatori & PMI

$79 / mese

Fino a 250 fatture/mese, caricamento multiplo ZIP e conversione automatica via Email.

✅ 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

Attiva Piano Pro ($79/mese) →

For Tax Advisors & High Volume

Hub Commercialisti & Multi-Azienda

$199 / mese

Partite IVA illimitate, API Webhook e Portale Verifica Fornitori personalizzato.

✅ 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

Attiva Hub Studio ($199/mese) →