4 · Administration Reference

Status values

Every validation returns a normalized status, derived from the Swiss Post quality code (PSTAT) and the transport-level query status. The status drives the traffic light and the gate behaviour.

Status (display)	PSTAT	Light	Meaning
Not Checked	–	⚪ grey	No validation has been performed yet.
Correct	1	🟢 green	Address is valid and deliverable as entered.
Suggestion (spelling)	2	🟡 yellow	Swiss Post proposes a standardized spelling.
Suggestion (correction)	3 / 5	🟡 yellow	Swiss Post proposes a corrected address.
Suggestion (completion)	4	🟡 yellow	Swiss Post proposes a completed address (e.g. missing house number).
Partly Confirmed	6	🔴 red	Only part (street, post code or house number) could be confirmed.
Not Found	7	🔴 red	The address was not found.
Not Unique	8	🔴 red	Several possible matches.
Foreign (Not Checked)	9 / country gating	⚪ grey	No call – address outside CH/LI.
Error	10 / transport	🔴 red	Validation could not be completed.

Suggestion ≠ applied: A Suggestion status means Swiss Post offers a better address – nothing was changed on the record automatically. Applying it is a deliberate click.

"Address Validation Setup" field reference

Connection

Field	Meaning
Environment	Test or production endpoint of Swiss Post.
Base URL (Production / Test)	REST base URL incl. port and trailing `/` (pre-filled).
User Name	Bare technical user (e.g. `TU_1234567_0001`) without `@service.post.ch`.
Password	Stored encrypted in Isolated Storage (not on the setup record).
Timeout (ms)	HTTP timeout for calls to Swiss Post (default 10,000).

Triggers and modes

Field	Meaning	Default
Enable Manual Button / Button Mode	Validate Address action on the cards.	on / Suggest
Auto-Validate on Cards	Auto-validation + notification on address field change.	on
Check Addresses on Documents	Validation + notification on document address change.	on
Enable Release Gate / Mode	Validation on release.	on / Suggest
Enable Document Print Gate / Mode	Validation before printing unposted documents.	on / Suggest
Enable Reminder Gate / Mode	Validation on issue and before print/send of reminders.	on / Suggest
Enable Posting Gate / Mode	Validation before posting.	on / Block
Enable Print Gate / Mode	Validation before print of posted invoice.	on / Suggest
Enable Send Gate / Mode	Validation before send of posted invoice.	on / Suggest
Also Check on E-Mail	Validation on e-mail dispatch too.	off

Block behaviour (Block mode only)

Field	Default
Block: Partly Confirmed (PSTAT 6)	off
Block: Address Not Found (PSTAT 7)	on
Block: Ambiguous Address (PSTAT 8)	off
Block When Swiss Post Unreachable	off
Block: Correction Available	off

Background queue

Field	Default
Queue: Customers / Ship-to Addresses / Contacts / Vendors / Order Addresses	all on
Batch Size Per Run	50
Run Interval (Minutes)	30
Re-Sweep Interval (Days)	90
List House Numbers on Wrong/Missing No.	on
Keep Log History (Days)	0 (forever)
Re-open When Result Worsens	on
Re-open Deferred After (Days)	30
Re-open Done After (Days)	0 (off)

Data protection and data storage

No extra fields on master tables. All validation data lives in the app's own tables, keyed on Source Table No. + Source System Id: a validation log (full history) and a result table (the latest result per source).
Password encrypted in Isolated Storage (company scope) – never in clear text on the setup record. Authentication is carried as SecretText end to end.
Frugal API usage – a normalized address hash (SHA256) prevents identical repeat calls; foreign addresses are skipped without a call.
Data classification of the setup record: CustomerContent.
Transmitted data: For validation, the address components (street/house no., post code, city, country) are transmitted to the Swiss Post address web service. The Swiss Post privacy statement for the address web service applies.

Permissions

The app ships two permission sets:

Permission set	Object name	For whom
Ventoo Address Validation	`AddressValidUserVTO`	Everyday use: work the worklist, manage keywords, run validations, read the setup.
Ventoo Address Validation - Setup	`AddressValidAdminVTO`	Configuration: includes the user set and editing the setup (endpoints, credentials, gates) plus install/upgrade.

Usable without a permission set: The automatic flows (fact boxes, gates, role-center cues, background queue) run for every user via the objects' inherent permissions – nobody gets a permission error during normal work. The setup record is defined as Read + Insert, so the first access creates the record automatically.

Assign the people who actively work the worklist Ventoo Address Validation; assign the person who configures the service Ventoo Address Validation - Setup. Assign the person responsible for address maintenance the Address Data Steward profile in addition.

Technical facts

Property	Value
Platform	Business Central (SaaS), BC 28 / runtime 17.0
Object ID range	70679775 – 70679799
Object name affix	`VTO` (suffix on every object and control name)
Swiss Post service	Address web service, Address Assistant tier (`BuildingVerification4`)
Languages	Development language `en-US`; translations `de-CH`, `fr-CH`, `it-CH`
Publisher	Ventoo · https://www.ventoo.ch

Troubleshooting

Symptom	Possible cause / fix
Test Connection fails	User name entered with the `@service.post.ch` suffix (use only the bare `TU_…` name); wrong password; wrong environment (Test/Production).
All addresses are Foreign (Not Checked)	Country/Region Code is not CH/LI and not empty – this is by design (country gating).
Validation seems to "hang" during a mass run	Swiss Post per-minute limit reached (error 106); the queue continues on the next run. Lower the batch size if needed.
Gate blocks unexpectedly	Posting Gate Mode is set to Block and a block criterion (e.g. PSTAT 7) applies – correct the address or adjust the mode/criterion.
Gate keeps warning/blocking an address I already checked	Set the address to Done or Deferred in the worklist; the gates then trust that exact address and stop warning/blocking it. If it still reappears, the address changed or was recalled to the worklist (worsened result / recall interval).
Correction suggestion not shown	The address is already Correct (PSTAT 1) or Foreign; only a Suggestion status carries a value to apply.