Adresserfassung und -anzeige implementieren

Adressen der Kunden sind erforderlich, um einen Auftrag zu erstellen, zu ändern und auszuführen. Ein Filialmitarbeiter kann gültige Kundenadressen erfassen und Sterling Store Engagement zeigt die Adressen in den entsprechenden Formaten an. In diesem Abschnitt werden APIs, Benutzerexits, Services und andere Komponenten beschrieben, die für die Implementierung der Adresserfassung und -anzeige sowie für die Unterstützung länderbasierter Adresserfassungsformulare und -vorlagen verwendet werden.

Hinweis: Weitere Informationen zur Erweiterung der Adresserfassung und -anzeige finden Sie unter Erweitern der Adresserfassung und Erweitern der Adressanzeige.

Lösung

Das Verkaufspersonal kann die Adresse eines Kunden während der Auftragserstellung oder Auftragsänderung hinzufügen oder bearbeiten.

Wenn bei der Erfassung der Adresse das Land und die Postleitzahl des Kunden nicht erfasst werden, werden sie als Standardland und Postleitzahl des aktuellen Geschäfts verwendet.
Wenn der Kunde jedoch eine Adresse für ein anderes Land angeben möchte, kann das Verkaufspersonal ein Land aus der Liste Land/Region auswählen.
Zum Ausfüllen der Länderliste wird die API getCommonCodeList mit CodeType als COUNTRY aufgerufen.
Die API getRegionList gibt eine Liste von Regionen zurück, die den Eingabekriterien entsprechen. Diese API ermittelt das Regionsschema aus der Regel Regionsschema für Statusauswahl und gibt eine Liste der Regionen zurück, die vom Attribut State im Element PersonInfo der Entität verwendet werden.
Wenn das Verkaufspersonal das Land auswählt, werden die entsprechenden Adresserfassungsfelder angezeigt und die entsprechende Liste der Bundesländer wird mithilfe der getRegionList -API abgerufen. Wenn keine Regionen abgerufen werden, wird die Liste durch ein Textfeld ersetzt.
Das Bundesland und der Ort werden automatisch mit der API getRegionList ausgefüllt, wenn eine gültige Postleitzahl angegeben wird.

Adressüberprüfung

Die Adressen der Kunden werden überprüft, bevor sie in der Bestellung gespeichert werden. Die API verifyAddress wird zum Überprüfen der Adresse aufgerufen. Die API ruft wiederum den Benutzerexit YCDVerifyAddressWithAVSUE auf, der die vom Benutzer bereitgestellte Eingabe überprüft.

Wenn alle Attribute gültig sind und die Adresse ordnungsgemäß überprüft wurde, wird das Flag IsAddressVerified entsprechend aktualisiert. Die Anwendung verwendet den Benutzerexit für die Interaktion mit dem Adressprüfsystem (Address Verification System, AVS) und gibt entsprechende Werte an die verifyAddress -API zurück.

Die folgenden Werte werden als Ergebnis der Adressüberprüfung zurückgegeben:

In: VERIFIED. Die Anzeige wird geschlossen und die Adresse wird als verifiziert markiert.
In: FAILED. Die von der verifyAddress -API zurückgegebenen Fehlerursachen werden in der Anzeige angezeigt, damit das Verkaufspersonal sie auflösen kann. Wenn das Verkaufspersonal Anwenden (Apply)auswählt, wird angenommen, dass die Adresse gültig ist und als verifiziert zurückgegeben wird.
In: AVS_DOWN. Die Anzeige wird geschlossen und die Adresse wird als nicht geprüft markiert, aber als gültig betrachtet.

Wenn mehrere Adressen zurückgegeben werden oder das Attribut ProceedWithSingleAVSResult mit dem Wert Nzurückgegeben wird, wechselt die Anzeige in den Auswahlmodus für mehrere Adressen, in dem dem Verkaufspersonal eine Liste mit Ergebnissen zusammen mit der ursprünglichen Adresse angezeigt wird, aus der das Verkaufspersonal eine Adresse auswählen kann.

Die folgenden APIs werden verwendet, um die Adressen zu überprüfen:

In: getCommonCodeList. Ruft die Liste der Länder mit CodeType als COUNTRYab.
In: getRegionList. Ruft die Liste der Bundesländer basierend auf dem ausgewählten Land und dem Regionsschema aus der Regel Region Schema To Use For State Selection ab. Außerdem werden der Staat und die Stadt anhand der Postleitzahl abgerufen.
In: verifyAddress. Validiert die Eingabeadresse anhand eines Adressprüfsystems (AVS).

Schnittstellenkomponente für die Adresserfassung

Die gemeinsame Komponente zur Adresserfassung wird in app-common-module erstellt, um Adressen in Sterling Store Engagement zu erfassen. Sie können diese Komponente zum Hinzufügen oder Ändern der Adressen von Kunden während der Auftragserfassung verwenden.

Standardmäßig werden Adresserfassungsvorlagen für USA und Kanada unterstützt. Sie können Adressenerfassungsvorlagen für andere Länder hinzufügen und die Adressfelder den Ländern zuordnen. Weitere Informationen zur Erweiterung der Implementierung der Adresserfassung finden Sie unter Erweiterung der Adresserfassung.