BR-KSA-09 🏢 Seller Address & Identity error

BR-KSA-09: Seller Saudi National Address Mandatory Fields Missing

BR-KSA-09: نقص في الحقول الإلزامية للعنوان الوطني للبائع

Official ZATCA Specification:

Seller address must contain street name (BT-35), building number (KSA-17), postal code (BT-38), city (BT-37), District (KSA-3), and country code (BT-40 = 'SA').

XPath Context: /ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cac:PostalAddress

📌 Overview & Impact

Seller address must contain all 6 Saudi National Address elements: Street Name, Building Number, Postal Code, City, District, and Country Code ('SA').

الوصف بالعربية: يجب أن يحتوي عنوان البائع على العناصر الستة الكاملة للعنوان الوطني السعودي: اسم الشارع، رقم المبنى، الرمز البريدي، المدينة، الحي، ورمز الدولة (SA).

⚠️ Common Causes for Rejection

  • Omission of <cbc:BuildingNumber> or <cbc:CitySubdivisionName> (District)
  • Postal code <cbc:PostalZone> is missing or not 5 digits
  • Building number is not 4 digits
  • Country code is not 'SA'

How to Fix & Resolve

1

Lookup Official Saudi Post Address

Verify the seller's registered National Address at splonline.com.sa to obtain the exact 4-digit building number and 5-digit postal code.

2

Populate All 6 XML Address Elements

Include StreetName, BuildingNumber, CitySubdivisionName, CityName, PostalZone, and Country IdentificationCode.

💻 Code Comparison: Invalid vs Compliant UBL 2.1 XML

❌ Invalid XML (Rejected by ZATCA) Invalid Payload
<cac:PostalAddress>
  <cbc:StreetName>King Fahd Road</cbc:StreetName>
  <cbc:CityName>Riyadh</cbc:CityName>
  <cac:Country>
    <cbc:IdentificationCode>SA</cbc:IdentificationCode>
  </cac:Country>
</cac:PostalAddress>
✓ Valid XML (Compliant UBL 2.1) Valid Payload
<cac:PostalAddress>
  <cbc:StreetName>King Fahd Road</cbc:StreetName>
  <cbc:BuildingNumber>1234</cbc:BuildingNumber>
  <cbc:CitySubdivisionName>Al Olaya</cbc:CitySubdivisionName>
  <cbc:CityName>Riyadh</cbc:CityName>
  <cbc:PostalZone>12211</cbc:PostalZone>
  <cac:Country>
    <cbc:IdentificationCode>SA</cbc:IdentificationCode>
  </cac:Country>
</cac:PostalAddress>

Verify Your Invoice XML Online

Use Qeemah's free developer tools to inspect transforms, C14N digests, and Phase 2 QR codes.

Frequently Asked Questions

Does BR-KSA-09 apply to Simplified Invoices?

Yes, seller National Address requirements (BR-KSA-09) apply to all invoices (both Standard B2B and Simplified B2C).

Stop Fighting Cryptic ZATCA XML Errors

Qeemah handles Phase 2 e-invoicing, cryptographic signing, and real-time clearance automatically. Integrate in minutes.