Adressen in den USA verarbeiten

In diesem Dokument wird die Adressvalidierung speziell für die USA behandelt:

USPS-Daten in Ihrem Workflow

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

Da dieses Objekt nicht immer ausgefüllt ist, sollten Sie sich nicht ausschließlich auf dieses Attribut verlassen, um Adressen zu validieren. Beziehen Sie stattdessen auch das Ergebnis und die Adresskomponenten in Ihr System ein.

USPS Delivery Point Verification (DPV)

Als Teil der uspsData-Antwort gibt das Feld dpvConfirmation ein einzelnes Zeichen zurück, das angibt, ob der USPS an die angegebene Adresse liefern kann.

Anhand dieses Felds können Sie Folgendes ermitteln:

  • Gültigkeit der Adresse.
  • wenn in der Adresse eine Wohnungsnummer fehlt.
  • wenn die Nummer des Gebäudeteils im USPS-Datensystem nicht vorhanden ist.

Der Dienst gibt entweder einen von vier dpvConfirmation-Werten oder gar keinen dpvConfirmation-Wert zurück. In der folgenden Tabelle wird das empfohlene Verhalten für die einzelnen möglichen Ergebnisse beschrieben. Weitere Informationen zu dieser Logik finden Sie unter Workflow-Übersicht im Abschnitt Validierungslogik erstellen.

Wert

Verhalten

Beschreibung

N

oder leer

Adresse korrigieren

Die Adresse wurde nicht per DPV bestätigt.

Das bedeutet, dass der USPS die eingegebene Hausnummer in der eingegebenen Straße (Route) nicht erkennt und dorthin nicht liefern kann.

D

Adresse korrigieren

Die Adresse wurde nur für die primäre Nummer DPV-bestätigt und die Informationen zur sekundären Nummer fehlten.

Das bedeutet, dass die eingegebene Hausnummer in der eingegebenen Straße existiert, aber für eine vollständig verifizierte/zustellbare Adresse auch eine gültige Nummer für die Untereinheit angegeben werden muss. Mit anderen Worten: Die Unteradresse fehlte in der Eingabe.

S

Adresse bestätigen

Die Adresse wurde nur für die primäre Nummer DPV-bestätigt. Die Informationen zur sekundären Nummer waren vorhanden, aber nicht bestätigt.

Das bedeutet, dass die eingegebene Hausnummer auf der eingegebenen Route vorhanden ist, die angegebene Untereinheit laut USPS jedoch nicht in diesem Gebäude existiert.

J

Adresse akzeptieren

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

Das bedeutet, dass die Adresse vollständig vom USPS zugestellt werden kann, einschließlich der Nummer des Untergebäudes, falls zutreffend.

Im weiteren Verlauf dieses Abschnitts werden reale Szenarien erläutert, in denen die DPV-Codes verwendet werden.

DPV-N-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
  • Region: USA
  • Das Feld dpvConfirmation gibt Folgendes zurück: N

Das ist ein sehr starkes Signal dafür, dass diese Hausnummer auf dieser Route nicht existiert. Wie bei anderen problematischen Adressen sollte Ihr System den Nutzer auffordern, Korrekturen vorzunehmen.

Beispiel für DPV D – Adresse korrigieren

In diesem Beispiel wird das Google-Büro in New York verwendet, es enthält jedoch keinen Gebäudeteil, der ein erforderlicher Teil der Adresse ist. Sie können dies anhand der Adresse in der Demo ohne Informationen zu Untereinheiten sehen.

  • Eingegebene Adresse: 111 8th Avenue, New York, NY, 10011
  • Region: USA
  • Das Feld dpvConfirmation gibt Folgendes zurück: D

Dies bestätigt, dass die Untereinheit in der Eingabe fehlte. Damit ein DPV-Wert von „Y“ erreicht wird, muss eine gültige Unteradresse als Teil der Eingabe enthalten sein. Sie können beispielsweise einen gültigen Gebäudeteil wie FL 4 (4. Etage) angeben, um den dpvConfirmation-Wert „Y“ zu erhalten.

DPV S-Beispiel – Adresse bestätigen

In diesem Beispiel wird eine Nummer für einen Gebäudeteil verwendet, die im Gebäude nicht existiert:

  • Eingegebene Adresse: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • Region: USA
  • Das Feld dpvConfirmation gibt Folgendes zurück: S

Das bedeutet, dass 1600 Amphitheatre Parkway zwar eine Adresse ist, an die Post gesendet werden kann, die Untereinheit Ste 101 jedoch kein gültiger Teil der Adresse ist. Ihr System sollte diese Informationen mit dem Nutzer bestätigen und ihm die Möglichkeit geben, sie zu korrigieren.

Beispiel für DPV Y – Adresse akzeptieren

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

  • Eingegebene Adresse: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Region: USA
  • Das Feld dpvConfirmation gibt Folgendes zurück: Y

Die Adresse ist vollständig und USPS kann dorthin liefern. In diesem Fall können Sie mit sehr hoher Wahrscheinlichkeit davon ausgehen, dass die API eine Adresse von guter Qualität zurückgegeben hat und Sie sie wie angegeben verwenden können.

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

Sicherheitsmitteilungen für US-Adressen

In diesem Abschnitt werden die Sicherheits-Flags in den USPS-Daten für künstlich erstellte Adressen behandelt. Diese Sicherheitsmaßnahme soll die künstliche Erstellung einer Adressliste verhindern. Dazu wird erkannt, ob eine eingereichte Adresse künstlich erstellt und nicht rechtmäßig erlangt wurde. Das sollte nur sehr selten vorkommen.

Wenn der USPS eine künstlich erstellte Adresse erkennt, 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.