Back

National Address / Short Address (E-Invoicing Requirements)

The system checks the client address details before sending any invoice to the Zakat, Tax and Customs Authority (ZATCA), and some address requirements have changed — this guide explains what is required now and what is no longer mandatory.

Mandatory Fields for Clients Inside Saudi Arabia

To send an invoice successfully for a client residing in Saudi Arabia, the following address fields are required:

  • Street address (Mandatory)
  • City (Mandatory)
  • State/Province (Mandatory)
  • Country (Mandatory)

Fields No Longer Mandatory

  • Building No.: no longer mandatory — its absence is skipped without blocking the submission.
  • Postal/Zip Code: no longer mandatory — its absence is skipped without blocking the submission.

If the building number or postal code is entered, the system validates their format. If the format is wrong, the submission may be blocked — so make sure the format is correct when entering them, or leave them empty if you are not sure.

Foreign Clients (Outside Saudi Arabia)

Saudi national address requirements do not apply to clients residing outside Saudi Arabia — only the Street address, City, and Country are needed, without a building number, postal code, or state.

Automatic Address Processing

The system automatically processes the client address details before every submission by removing hidden characters, invisible formatting characters, and unusual spaces. This prevents ZATCA from rejecting valid addresses because of minor technical issues caused by how the data was copied or imported.

What Happens If the Address Details Are Incomplete?

If the system detects missing required address details when trying to submit:

  • In POS invoices: the invoice is always saved even with missing data, and it shows a direct shortcut that opens the client edit page to complete the address and resubmit.
  • In non-POS invoices: the user is directed to the client details panel embedded in the invoice to complete the missing data.

Note About Approved Invoices

After ZATCA accepts and validates the invoice, the system protects its linked address details from any edit that may conflict with the document approved by the authority.

The client national address appears on the printed invoice within the client address, provided it is entered in the client details. The placeholder {%client_full_address%} shows the full address: building number and street name, then the secondary number, then the district, city, and postal code, then the short address.

To show any national address field separately, or to show your business national address, add its placeholder to the print template:

  1. From the main menu, click Templates.
  2. Click Printable Templates, then the Invoice/Estimate Layouts card.
  3. Click the … button next to the template, then click Edit.
  4. Click the section you want to add the address to in the template preview, such as the client details section.
  5. Click the required placeholder from the Placeholders list. The placeholder appears in the template at the cursor position.
  6. Click Save.

National Address Placeholders

Field Client Placeholder Business Placeholder
Building No. {%client_building_no%} {%site_building_no%}
Street Name {%client_street_name%} {%site_street_name%}
Secondary No. {%client_secondary_number%} {%site_secondary_number%}
District {%client_district%} {%site_district%}
City {%client_city%} {%site_city%}
Postal Code {%client_postcode%} {%site_postal_code%}
Short Address {%client_short_address%} {%site_short_address%}
🛈 The building number, street name, secondary number, district, and short address placeholders appear in the Placeholders list only for accounts whose country is Saudi Arabia. The placeholder appears empty on the invoice if the field is not entered in the client details or in Account Settings.