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

[BR-KSA-08] Seller VAT registration number (BT-31) must consist of 15 digits, starting with 3 and ending with 3. The seller VAT number in ` ` includes spaces, country prefixes (`SA`), or is not a valid 15-digit Saudi TIN starting and ending with `3` (e.g., `300000000000003`).

How do I fix BR-KSA-08 (BT-31 (Seller 15-Digit Saudi VAT Number)) automatically?

Format Seller CompanyID as a strict 15-digit numeric string starting with 3 and ending with 3. 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-08 immediately.

Home › Official Error Catalog › BR-KSA-08

🇸🇦 Saudi ZATCA Phase 2 (Fatoora) • SEVERITY: FATAL • BT-31 (Seller 15-Digit Saudi VAT Number)

How to Fix BR-KSA-08: BT-31 (Seller 15-Digit Saudi VAT Number)

The seller VAT number in `<cbc:CompanyID>` includes spaces, country prefixes (`SA`), or is not a valid 15-digit Saudi TIN starting and ending with `3` (e.g., `300000000000003`).

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

BR-KSA-08 — BLOCKING REJECTION

Official Specification Rule

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

XPath: /ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID

Deterministic Remediation (How to Fix)

Format Seller CompanyID as a strict 15-digit numeric string starting with 3 and ending with 3.

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

<cbc:CompanyID>SA 310122393500003</cbc:CompanyID>

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

<cbc:CompanyID>310122393500003</cbc:CompanyID>

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

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

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

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

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

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

🛡️ تقرير مطابقة قواعد ZATCA / 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-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 →

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) ←

باقة الشركات والمصدرين (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/شهرياً) ←