AddressDirectory

Beschreibung

Der AddressDirectory-Provider bindet elego an ausgewählte digitale Services der Schweizerischen Post an.

Folgende Anwendungsfälle werden unterstützt:

• Adressprüfung

  ---

  Mit der Adressprüfung wird die postalische Korrektheit einer Anschrift (Strasse, Hausnummer, PLZ und Ort) überprüft.

  Für die Adressprüfung wird die Meldung buildingverification des Address Web Services REST der Post verwendet.

• Personenprüfung

  ---

  ValidatePersonData prüft, ob die Post eine Person mit den übergebenen Daten Name, FirstName, Street, HouseNumber, Postcode und LocationName kennt und ob die Person an der übergebenen Adresse wohnt.

  Für die Prüfung wird der AddressVerification-Request mit der Ressource runquery2 des Address Web Services REST der Post verwendet.

Bausteine

Folgende Bausteine stehen zur Verfügung:

Entities

• IAddressReference

Activities

• ValidateAddress
• ValidateAddressData
• ValidatePersonData

Queries

Keine passenden Einträge gefunden.

ValueLists

Keine passenden Einträge gefunden.

Expression Functions

• GetAddressReferenceOrNullByHouseKey

Datenmodell

folgt

Configs

Parameter	Beschreibung	Beispiel
PostAddressService.Url	Postservice-URL	Siehe Info
PostAddressService.User	Postservice-User	Service-User (von Post vorgegeben)
PostAddressService.Pwd	Postservice-Passwort	Passwort kann verschlüsselt abgelegt werden.

Post-Service URLs

• Test: https://webservices-int.post.ch:17029/IN_SYNSYN_EXT_TEST/REST/v1
• Integration: https://webservices-int.post.ch:17023/IN_SYNSYN_EXT_INT/REST/v1
• Produktion: https://webservices.post.ch:17023/IN_SYNSYN_EXT/REST/v1/

Voraussetzungen

Für den Zugriff auf den REST-Service der Post ist ein Konto bei der Post erforderlich.

Kosten (Stand Ende 2020):

• Die einmalige Einrichtung des Services ist kostenpflichtig (Kosten: ~ CHF 2'000.--).
• BuildingVerification-Requests für die reine Adressprüfung (ohne Name/Vorname) mit Resource buildingverification sind gratis.
• AddressVerification-Requests für die Personenprüfung mit Ressource runquery2 sind kostenpflichtig.

Kontaktdaten Post: Tel. +41 58 386 67 67 | address-maintenance@swisspost.ch

Service-Dokumentation: Address web services REST

Beispiele

Sample-Ressourcen

Typ	PublidId	Beschreibung
DynamicGui	ZS_Addressreference	Beispiel-GUI für die Anzeige eines IAddressReferenceItems

Validierung einer Adresse

Die Validierung einer Adresse kann als Toolbar-Command in einem Entity-Gui (z.B. IPerson) wie folgt eingebaut werden:

<ActivityCommand Activity="ValidateAddress" 
   Label="[Activity.IPerson.ValidateAddress]" 
   Dock="Right" IconCls="SYS_Ico_entity_IAddressReference" 
   ShowConfirmationDialog="false" 
   ShowExecutionInfo="true" 
   RefreshAfterExecution="true"
/>