Adressen in den USA verarbeiten

In diesem Dokument wird die Überprüfung von Adressen für die USA behandelt:

USPS-Daten in Ihrem Workflow

Bei der Validierung von Adressen in den USA kann der Address Validation API-Dienst auch den uspsData-Teil der Rückgabe ausfüllen.

Da dieses Objekt nicht immer ausgefüllt wird, sollten Sie sich zum Validieren von Adressen nicht auf dieses Attribut verlassen, sondern auch das Ergebnis und die Adresskomponenten in Ihr System einbinden.

USPS Delivery Point Verification (DPV)

Im Rahmen der uspsData-Antwort wird im Feld dpvConfirmation ein einzelnes Zeichen zurückgegeben, mit dem Sie darüber informiert werden, ob der USPS an die angegebene Adresse liefern kann.

Mithilfe dieses Felds können Sie Folgendes festlegen:

  • die Adressengültigkeit.
  • Wenn in der Adresse eine Nummer des untergeordneten Gebäudes fehlt.
  • wenn die Sub-Premises-Nummer im USPS-Datensystem nicht vorhanden ist.

Der Dienst gibt entweder einen von vier dpvConfirmation-Werten oder keinen dpvConfirmation-Wert zurück. Die folgende Tabelle zeigt das empfohlene Verhalten, das Ihre Logik für jedes der fünf möglichen Ergebnisse verwenden sollte. Weitere Informationen zu dieser Logik finden Sie unter Workflowübersicht im Artikel Validierungsantwort verwenden.

mit tollem Preis-Leistungs-Verhältnis

Verhalten

Beschreibung

N oder leer

Adresse korrigieren

Die Adresse wurde nicht per DPV bestätigt.

Das bedeutet, dass der USPS die eingegebene Gebäudenummer auf der eingegebenen Straße (Route) nicht erkennt und diese nicht liefern kann.

D

Adresse korrigieren

Die Adresse wurde nur für die primäre Nummer per DPV bestätigt und die sekundäre Nummer fehlte.

Das bedeutet, dass die eingegebene Gebäudenummer in der eingegebenen Straße existiert. Um jedoch eine vollständig bestätigte bzw. zu liefernde Adresse zu erreichen, muss auch eine gültige Wohnnummer angegeben werden. Mit anderen Worten, die Subprämisse fehlte in der Eingabe.

S

Adresse bestätigen

Die Adresse wurde nur für die primäre Nummer per DPV bestätigt und die sekundäre Nummer war vorhanden, aber nicht bestätigt.

Laut USPS existiert die eingegebene Gebäudenummer auf der eingegebenen Route, die angegebene Wohnfläche jedoch nicht in diesem Gebäude.

Ja

Adresse akzeptieren

Die Adresse wurde für primäre und alle sekundären Nummern per DPV bestätigt.

Dies bedeutet, dass die Adresse vollständig über USPS zugestellt werden kann, einschließlich der Nummer der untergeordneten Gebäude, falls zutreffend.

Im weiteren Verlauf dieses Abschnitts werden reale Szenarien erörtert, in denen die DPV-Codes verwendet werden.

DPV-Beispiel – Adresse korrigieren

In diesem Beispiel wird eine nicht vorhandene Hausnummer für eine ansonsten gültige Adresse verwendet.

  • Eingegebene Adresse: 12 Amphitheatre Parkway, Mountain View, CA 94043, USA
  • Region: USA
  • Für das Feld dpvConfirmation wird Folgendes zurückgegeben: N

Dies ist ein sehr starkes Signal, dass diese Ortsnummer auf dieser Route nicht vorhanden ist. Wie bei anderen problematischen Adressen sollte Ihr System den Nutzer zu Korrekturen auffordern.

DPV D-Beispiel: Adresse korrigieren

In diesem Beispiel wird die Google-Niederlassung in New York verwendet, es gibt jedoch keinen untergeordneten Standort, der ein erforderlicher Teil der Adresse ist. Sie können dies durch Verwendung der Adresse in der Demo ohne Informationen zur untergeordneten Umgebung prüfen.

  • Eingegebene Adresse: 111 8th Avenue, New York, NY, 10011
  • Region: USA
  • Für das Feld dpvConfirmation wird Folgendes zurückgegeben: D

Dies bestätigt, dass die Sub-Prämise in der Eingabe fehlte. Um zu einem DPV von Y zu gelangen, muss eine gültige Sub-Premises-Lösung als Teil der Eingabe enthalten sein. Sie können beispielsweise eine gültige untergeordnete Prämisse von FL 4 (4. Etage) einbeziehen, um den dpvConfirmation-Wert Y zu erhalten.

Beispiel für DPV S: Adresse bestätigen

In diesem Beispiel wird eine Hausnummer verwendet, die im Gebäude nicht vorhanden ist:

  • Eingegebene Adresse: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043, USA
  • Region: USA
  • Für das Feld dpvConfirmation wird Folgendes zurückgegeben: S

Das bedeutet, dass 1600 Amphitheatre Parkway eine Adresse ist, über die Postsendungen empfangen werden können. Ste 101 ist jedoch kein gültiger Teil der Adresse. Ihr System sollte diese Informationen dem Nutzer bestätigen und eine Korrektur anbieten.

Beispiel für DPV Y: Adresse akzeptieren

In diesem Beispiel wird die Googleplex-Adresse in Mountain View, CA, USA als Adresse mit bekannter Qualität verwendet.

  • Eingegebene Adresse: 1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA
  • Region: USA
  • Für das Feld dpvConfirmation wird Folgendes zurückgegeben: Y

Die Adresse kann vollständig von USPS geliefert werden. Dies gibt Ihnen ein sehr hohes Maß an Sicherheit, dass die API eine Adresse von guter Qualität zurückgegeben hat und Sie diese wie angegeben verwenden können.

Hinweis: Das DPV zeigt nicht an, ob die Address Validation API Änderungen an der Eingabe vorgenommen hat, z. B. eine Rechtschreibkorrektur.

Sicherheitsnachrichten für US-Adressen

In diesem Abschnitt werden die Sicherheits-Flags beschrieben, die in den USPS-Daten für künstlich erstellte Adressen bereitgestellt werden. Diese Sicherheitsmaßnahme verhindert die künstliche Erstellung einer Adressenliste. Dazu wird erkannt, wenn eine eingereichte Adresse scheinbar künstlich erstellt und nicht legitim erlangt wurde. Das dürfte nur sehr selten vorkommen.

Wenn das USPS eine künstlich erstellte Adresse identifiziert, enthält das Feld errorMessage des Attributs uspsData der Antwort eine Fehlermeldung, in der das Problem beschrieben wird. Beispiel:

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.