Improved Customer Tax Address Handling

What’s new?

A smart, non-blocking alert has been added for establishments with Phase 2 e-invoicing enabled, triggered when creating or approving a commercial document in Saudi Arabia if the customer’s tax address is incomplete. Missing fields can be completed directly inside a popup window without interrupting the workflow.

Key highlights:

• Non-blocking alert:
  
  A warning appears on save or approval only if address data is incomplete, with the option to continue without being forced.
• Complete directly in the popup:
  
  Only the missing fields are shown for editing:
  • Street name
  • Building number
  • Postal code
  • City
  • District
  • Country
• Quick save and auto-sync:
  
  When you choose “Save and Continue”, the system will:
  • Validate the fields
  • Save them to the document
  • Update the customer record (per current behavior)
  • Complete the save/approval action
• Full flexibility:
  
  The alert can be dismissed and the workflow continued without entering the data (document issuance will not be blocked).

Validation rules:

• For customers inside Saudi Arabia (SA):
  
  Required fields:
  • Street name (BT-50)
  • Building number (KSA-18)
  • Postal code (BT-53)
  • City (BT-52)
  • District (KSA-4)
  • Country (BT-55)
• For customers outside Saudi Arabia:
  
  Required fields:
  • Street name (BT-50)
  • City (BT-52)
  • Country (BT-55)
• The alert appears only when:
  • The customer is taxable or has a B2B Tax Identification Number
  • Or the buyer is a government entity (B2G)
  • And there is a gap in the address

User experience improvements:

• Full support for both languages (Arabic and English)
• Clear messages aligned with ZATCA requirements
• Field validation handled in a lightweight, non-intrusive way

Goal of this update:

Reduce ZATCA (Zakat, Tax and Customs Authority) warnings and improve address data quality, while maintaining a flexible, non-disruptive user experience.