BR-KSA-63 👤 Buyer Identification & Address error

BR-KSA-63: Buyer Saudi National Address Mandatory When Country is 'SA'

BR-KSA-63: العنوان الوطني للمشتري إلزامي عندما تكون الدولة السعودية (SA)

Official ZATCA Specification:

If the buyer country code (BT-55) is 'SA', then these fields are mandatory: street name (BT-50), building number (KSA-18), postal code (BT-53), city (BT-52), District (KSA-4), country code (BT-55).

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

📌 Overview & Impact

If buyer country code is 'SA' on a Standard Tax Invoice, street name, building number, postal code (5 digits), city, district, and country code are all mandatory.

الوصف بالعربية: إذا كان رمز دولة المشتري 'SA' في الفاتورة الضريبية القياسية، فإن جميع عناصر العنوان الوطني السعودي للمشتري تصبح إلزامية.

⚠️ Common Causes for Rejection

  • ✕ Providing partial address for a Saudi B2B customer (e.g. only CityName and Country)
  • ✕ Missing <cbc:BuildingNumber> or <cbc:CitySubdivisionName> for buyer
  • ✕ Buyer postal code is not exactly 5 digits (BR-KSA-67)

✅ How to Fix & Resolve

1

Capture Full National Address on Customer Profile

Collect the 6-part Saudi National Address (Street, 4-digit Building No, District, City, 5-digit Postal Code, SA) during B2B client onboarding.

2

Populate All Buyer PostalAddress Child Elements

Ensure all 6 nodes exist in the customer Party/PostalAddress structure.

💻 Code Comparison: Invalid vs Compliant UBL 2.1 XML

❌ Invalid XML (Rejected by ZATCA) Invalid Payload 
<cac:AccountingCustomerParty>
  <cac:Party>
    <cac:PostalAddress>
      <cbc:CityName>Jeddah</cbc:CityName>
      <cac:Country><cbc:IdentificationCode>SA</cbc:IdentificationCode></cac:Country>
    </cac:PostalAddress>
  </cac:Party>
</cac:AccountingCustomerParty>
✓ Valid XML (Compliant UBL 2.1) Valid Payload 
<cac:AccountingCustomerParty>
  <cac:Party>
    <cac:PostalAddress>
      <cbc:StreetName>Al Andalus Road</cbc:StreetName>
      <cbc:BuildingNumber>4567</cbc:BuildingNumber>
      <cbc:CitySubdivisionName>Al Rawdah</cbc:CitySubdivisionName>
      <cbc:CityName>Jeddah</cbc:CityName>
      <cbc:PostalZone>23432</cbc:PostalZone>
      <cac:Country><cbc:IdentificationCode>SA</cbc:IdentificationCode></cac:Country>
    </cac:PostalAddress>
  </cac:Party>
</cac:AccountingCustomerParty>

Verify Your Invoice XML Online

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

Inspect XML & Hash → Decode QR Code →

❓ Frequently Asked Questions

Does BR-KSA-63 apply if the buyer is located outside Saudi Arabia?

No, if buyer country code is not 'SA' (e.g. 'AE', 'US'), only StreetName (BT-50), CityName (BT-52), and Country IdentificationCode (BT-55) are required under BR-KSA-10.

🔗 Related ZATCA Rules

BR-KSA-09

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

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

Stop Fighting Cryptic ZATCA XML Errors

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

Start Free Trial Now → Browse All ZATCA Error Codes