1 · Getting Started with Ventoo Address Validation

What does Ventoo Address Validation do?

Ventoo Address Validation matches addresses in Business Central against the official address data of Swiss Post. For every address checked you get a clear result:

Is the address correct and deliverable?
Does Swiss Post suggest a correction or completion (e.g. correct spelling, missing house number, correct post code/city combination)?
Is the address not found or not unique?

Validation runs at several points in the process – from master-data maintenance to the physical invoice dispatch. For each point you decide whether it only shows a notification (recommended) or blocks the action.

Core principle: Addresses are validated as early as possible – where they can still be corrected. A hard block belongs at the end (posting), not at the beginning (master-data entry).

Key features

Feature	Benefit
Manual validation	Validate Address action on all relevant cards, with a result fact box (traffic light).
Automatic validation on cards	Changing an address field automatically validates the address and shows a clickable, non-blocking notification.
Document check	Changing the bill-to/ship-to address on a sales document is validated – also catches one-time addresses.
Release, print and reminder gates	Validation on release, when printing unposted documents, and when issuing/sending reminders.
Posting gate	Validation before posting (ship/invoice) – the recommended place for a hard block.
Dispatch gate	Last safety net before the physical print/send of a posted invoice or credit memo.
Apply correction	The value suggested by Swiss Post can be written back into the address with one click.
Background queue	Validates the existing address base automatically and in batches (job queue).
Worklist	List of open, actionable addresses with a review status for the responsible person.
Role Center	Dedicated Address Data Steward role center with KPIs and activity cues.

Supported addresses

Validation is integrated at the following places:

Master data (cards)

Card	Validated address
Customer	Customer address
Ship-to Address	Ship-to address
Vendor	Vendor address
Order Address	Vendor order address
Contact	Contact address
Company Information	Company address
Responsibility Center	Responsibility center address

Documents

Document	Validated address
Sales quote, order, invoice, credit memo	Bill-to and ship-to address
Posted sales invoice / credit memo	Bill-to address (before print/send)
Reminder	Reminder address

Country gating: The Swiss Post interface is only called for the countries CH, LI or for an empty country. All other addresses get the status Foreign (Not Checked) – without an API call.

Note on purchase documents: On the purchase side the Vendor and Order Address cards are validated today. Checks on purchase documents themselves and finance charge memos are intentionally not included yet.

Ready in four steps

Install the app – from AppSource or as an .app file (see Setup and Configuration).
Set up the connection – choose the environment, enter the Swiss Post technical user and password and verify with Test Connection.
Apply recommended defaults – one click enables the sensible baseline configuration (validate everywhere, block only at posting).
Get going – open a customer card and click Validate Address, or change an address field and watch the automatic notification.