BR-KSA-37 🏢 Seller Address & Identity error

BR-KSA-37: Seller Building Number Must Be Exactly 4 Digits

BR-KSA-37: رقم مبنى البائع يجب أن يتكون من 4 أرقام بالضبط

Official ZATCA Specification:

The seller address building number must contain exactly 4 digits.

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

📌 Overview & Impact

The seller address building number (KSA-17) must contain exactly 4 numeric digits matching the Saudi National Address.

الوصف بالعربية: رقم مبنى البائع (KSA-17) يجب أن يتكون من 4 خانات رقمية مطابقة لبيانات العنوان الوطني السعودي.

⚠️ Common Causes for Rejection

  • Providing a 3-digit, 5-digit, or alphanumeric building number (e.g. '123' or 'Bldg 4')
  • Adding extra characters, spaces, or letters
  • Leaving the building number empty

How to Fix & Resolve

1

Verify SPL National Address

Check the registered 4-digit Building Number on SPL (Saudi Post) National Address certificate.

2

Pad or Correct Value

Ensure the XML value is exactly 4 digits (e.g. <cbc:BuildingNumber>3142</cbc:BuildingNumber>).

💻 Code Comparison: Invalid vs Compliant UBL 2.1 XML

❌ Invalid XML (Rejected by ZATCA) Invalid Payload
<cbc:BuildingNumber>42B</cbc:BuildingNumber>
✓ Valid XML (Compliant UBL 2.1) Valid Payload
<cbc:BuildingNumber>3142</cbc:BuildingNumber>

Verify Your Invoice XML Online

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

Frequently Asked Questions

What if my company's building number has an additional number (e.g. 1234-5678)?

Use the primary 4-digit Building Number in <cbc:BuildingNumber>. The 4-digit additional number is optional.

Stop Fighting Cryptic ZATCA XML Errors

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