Adressen in den USA verarbeiten

In diesem Dokument wird die Adressbestätigung speziell für die USA beschrieben:

USPS-Daten in Ihrem Workflow

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

Da dieses Objekt nicht immer gefüllt wird, sollten Sie sich zum Validieren von Adressen nicht nur 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 gibt das Feld dpvConfirmation ein einzelnes Zeichen zurück, das angibt, ob die USPS an die angegebene Adresse liefern kann.

Mit diesem Feld können Sie Folgendes ermitteln:

  • die Gültigkeit der Adresse.
  • wenn in der Adresse eine Nebenstellennummer fehlt.
  • wenn die Nummer der untergeordneten Örtlichkeit nicht im USPS-Datensystem vorhanden ist.

Der Dienst gibt entweder einen von vier dpvConfirmation-Werten oder gar keinen dpvConfirmation-Wert zurück. In der folgenden Tabelle sehen Sie, wie sich Ihre Logik für die fünf möglichen Ergebnisse verhalten sollte. Weitere Informationen zu dieser Logik finden Sie unter Workflowübersicht unter Validierungsantwort verwenden.

Wert

Verhalten

Beschreibung

„Nein“ oder leer

Adresse korrigieren

Die Adresse wurde nicht durch DPV bestätigt.

Das bedeutet, dass die USPS die eingegebene Hausnummer in der angegebenen Straße (Route) nicht erkennt und dort keine Zustellung vornehmen kann.

D

Adresse korrigieren

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

Die eingegebene Hausnummer existiert in der angegebenen Straße. Um eine vollständig bestätigte/zustellbare Adresse zu erreichen, muss jedoch auch eine gültige Nebengebäudenummer angegeben werden. Mit anderen Worten: Die untergeordneten Räumlichkeiten fehlten in der Eingabe.

S

Adresse bestätigen

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

Das bedeutet, dass die eingegebene Hausnummer auf der angegebenen Route vorhanden ist, die angegebene untergeordnete Adresse aber laut USPS nicht in diesem Gebäude existiert.

J

Adresse akzeptieren

Die Adresse wurde für die primäre und alle sekundären Telefonnummern durch die Datenschutzvereinbarung bestätigt.

Das bedeutet, dass die Adresse von USPS vollständig zugestellt werden kann, einschließlich der Nummer der untergeordneten Örtlichkeit (falls zutreffend).

Im Rest dieses Abschnitts werden reale Szenarien mit DPV-Codes beschrieben.

Beispiel für DPV N – Adresse korrigieren

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

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

Dies ist ein sehr starkes Signal, dass diese Gebäudenummer 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 die Google-Niederlassung in New York verwendet, es ist jedoch keine untergeordnete Einrichtung enthalten, die ein erforderlicher Teil der Adresse ist. Sie können dies sehen, wenn Sie die Adresse in der Demo ohne Informationen zur Umgebung verwenden.

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

Das bestätigt, dass die untergeordneten Räumlichkeiten in der Eingabe fehlten. Um eine DPV von „Y“ zu erhalten, muss als Eingabe eine gültige untergeordnete Örtlichkeit enthalten sein. Sie können beispielsweise eine gültige untergeordnete Voraussetzung von FL 4 (4. Etage) angeben, um den dpvConfirmation-Wert Y zu erhalten.

DPV S example - confirm the address

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

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

Das bedeutet, dass 1600 Amphitheatre Parkway zwar eine Adresse ist, an die Post zugestellt werden kann, die untergeordnete Adresse „Ste 101“ jedoch kein gültiger Teil der Adresse ist. Ihr System sollte diese Informationen beim Nutzer bestätigen und die Möglichkeit zur Korrektur bieten.

Beispiel für DPV Y – Adresse akzeptieren

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

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

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

Hinweis: Der 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 beschrieben, die in den USPS-Daten für künstlich erstellte Adressen bereitgestellt werden. Diese Sicherheitsmaßnahme soll das künstliche Erstellen einer Adressenliste verhindern. Dabei wird erkannt, ob eine eingereichte Adresse scheinbar künstlich erstellt und nicht rechtmäßig erlangt wurde. Das sollte aber nur sehr selten vorkommen.

Wenn das USPS eine künstlich erstellte Adresse erkennt, enthält das Feld errorMessage der Property 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.