Skip to main content

National Address

The Saudi national address is a standardized address format developed by Saudi Post. Shaari uses this format for customer addresses because ZATCA Phase 2 requires structured address data on tax invoices -- free-text addresses are not accepted.

Saudi National Address Format​

A complete Saudi national address consists of the following fields:

FieldArabic LabelDescriptionExample
Building Numberرقم المبنىA four-digit number assigned to the building.8228
Street Nameاسم الشارعThe name of the street the building faces.King Fahd Road
DistrictالحيThe neighborhood or district within the city.Al Olaya
CityالمدينةThe city name.Riyadh
Postal Codeالرمز البريديA five-digit postal code.12345
Additional Numberالرقم الإضافيA four-digit number that further identifies the location within the postal code area.6789
CountryالدولةThe country code. Defaults to SA (Saudi Arabia).SA
info

The building number and additional number together form a unique identifier for any address in Saudi Arabia. The building number identifies the structure, and the additional number narrows it down within the postal code zone.

Why National Address Matters for ZATCA​

ZATCA Phase 2 mandates that both the seller's and the buyer's addresses appear in the structured UBL 2.1 XML format on every tax invoice. Specifically:

  • Seller address is configured in your company settings and appears on all outgoing invoices.
  • Buyer address is pulled from the customer record and included on invoices sent to that customer.

For B2B clearance, ZATCA validates that the address fields are present and properly formatted. Missing or incomplete addresses will cause the invoice to be rejected.

For B2C reporting, the address requirements are less strict, but including a complete address is still recommended for your own records.

caution

If a customer's national address is incomplete and you try to submit a B2B invoice to ZATCA, the submission will fail with a validation error. Make sure to collect complete address details from your B2B customers before invoicing them.

Setting Customer Addresses​

To enter or update a customer's national address:

  1. Navigate to Sales > Customers.
  2. Open the customer record.
  3. Click Edit.
  4. Scroll to the Address section.
  5. Fill in each field of the national address:
    • Building Number (4 digits)
    • Street Name
    • District
    • City
    • Postal Code (5 digits)
    • Additional Number (4 digits)
  6. Click Save.

The address fields are validated as you type:

  • Building number must be exactly 4 digits.
  • Postal code must be exactly 5 digits.
  • Additional number must be exactly 4 digits.
  • Street, district, and city are required text fields.

Company Address​

Your own company's national address is configured separately in Settings > Company Profile. This address appears as the seller's address on every invoice, quotation, and contract your organization issues. Make sure it is complete and accurate, especially if you have ZATCA Phase 2 enabled.

tip

You can look up any Saudi national address on the Saudi Post website (splonline.com.sa). Use the address locator to find the correct building number and additional number for any location.

Address Display​

On invoices, quotations, and contracts, the national address is displayed in a structured format:

English format:

Building 8228, King Fahd Road
Al Olaya District
Riyadh 12345-6789
Saudi Arabia

Arabic format:

مبنى 8228، طريق الملك فهد
حي العليا
الرياض 12345-6789
المملكة العربية السعودية

The language of the address display matches the document language setting.