Adressprüfung
Einleitung
Diese Aktion ermöglicht es, bei jeder Änderung einer Adresse eine externe Adressvalidierung durchzuführen und dem Benutzer ggf. eine Korrektur vorzuschlagen. Das ist bei der Adresse oder der abweichenden Postanschrift in den Stammdaten der Kontakte sowie bei der Adresse oder der abweichenden Lieferadresse in Angeboten oder in Bestellungen möglich.
Folgende Angaben müssen Sie – abweichend von den allgemeinen Angaben – vornehmen:
Wählen Sie bitte den Aktionstyp „Adressprüfung“ aus.
Auslöser
In der Karte „Ausführung bei“ können Sie festlegen, wann die Adressprüfung ausgelöst wird. Hierbei steht Ihnen nur die Option „Adressänderung“ zur Verfügung.
Wenn Sie „Adressänderung“ (TriggeredBy = „addressChange“) aktivieren, wird die Aktion immer ausgeführt, wenn der Benutzer
- den Fokus auf einem der Adressfelder („Straße“, „PLZ“, „Ort“, „Land“) hatte und
- der Inhalt eines der Adressfelder geändert wurde und
- alle Adressfelder einen Inhalt haben und
- der Fokus nicht mehr auf einem der Adressfelder ist.
Die Aktion wird zudem für Adressen in Deutschland nicht angestoßen, wenn die Leitcodierung für Deutschland in Salesware aktiviert ist.
Die Aktion kann in diesen Entitäten ausgelöst werden:
- Angebot (offer)
- Bestellung (order)
- Kontakt(customer)
- Warenkorb (shoppingCart)
Eingabeparameter
Neben den allgemeinen werden zusätzlich diese Paramater übergeben.
| Key | Datentyp | Value |
|---|---|---|
| StreetAndHouseNumber | string | Straße und Hausnummer |
| ZipCode | string | Postleitzahl |
| City | string | Stadt/Ort |
| CountryCode | string | Ländercode, z.B. DE |
Es werden keine Positionsdaten übergeben.
Ausgabeparameter
| Key | Datentyp | Value |
|---|---|---|
| StreetAndHouseNumber | string | Straße und Hausnummer |
| ZipCode | string | Postleitzahl |
| City | string | Stadt/Ort |
| CountryCode | string | Ländercode, z.B. DE |
WICHTIG
Die Rückgabe von Dateien wird nicht unterstützt.
Hinweis
Unvollständig zurückgegebene Adressen werden für die Anzeige um die Eingabeparameter ergänzt, so dass sicher gestellt ist, dass vollständige Adressen verglichen werden.
Tritt ein Fehler auf, weil beispielsweise die API nicht erreichbar ist, dann sollten keine Adressdaten zurück gegeben werden. Message und MessageType werden dann analog den anderen Aktionen verarbeitet / dargestellt.