Zum Inhalt springen Zur Hauptnavigation springen Zur Fußzeile springen

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 Daten übergeben.

KeyDatentypValue
StreetAndHouseNumberstringStraße und Hausnummer
ZipCodestringPostleitzahl
CitystringStadt/Ort
CountryCodestringLändercode, z.B. DE

Es werden keine Positionsdaten übergeben.

Ausgabeparameter

Die Aktion erwartet entweder keine Rückmeldung (bei korrekter Adresse), eine Meldung mit Hinweis, Warnung oder Fehler (durch Fehler bei Adressvalidierung) oder die korrigierte Adresse.

Wichtig

Die Rückgabe von Dateien wird nicht unterstützt.

Sobald die Prüfung innerhalb der Aktion eine korrigierte Adresse ermittelt, wird diese dem Benutzer in einer Lightbox mit der geprüften Adresse angezeigt. Der Benutzer kann dann entscheiden, ob er die korrigierte Adresse übernehmen oder ignorieren möchte.

Das sollten die übermittelten Werte sein:

KeyDatentypValue
StreetAndHouseNumberstringStraße und Hausnummer
ZipCodestringPostleitzahl
CitystringStadt/Ort
CountryCodestringLändercode, z.B. DE

Wichtig

Unvollständig zurückgegebene Adressen werden für die Anzeige um die Eingabeparameter ergänzt, so dass sichergestellt ist, dass vollständige Adressen verglichen werden.

Tritt ein Fehler auf, weil beispielsweise die API nicht erreichbar ist, dann sollten keine Adressdaten zurückgegeben werden. Message und MessageType werden dann analog zu den anderen Aktionen verarbeitet bzw. dargestellt.

War dieser Beitrag hilfreich?

0
0 Kommentare

Es gibt noch keine Kommentare

Hinterlassen Sie einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert