Adressen in den USA verarbeiten

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

USPS-Daten in Ihrem Workflow

Bei der Bestätigung von Adressen in den USA kann die Address Validation API auch den Teil uspsData der Antwort ausfüllen.

Da dieses Objekt nicht immer ausgefüllt ist, sollten Sie sich nicht ausschließlich auf dieses Attribut verlassen, um Adressen zu bestätigen. Stattdessen sollten Sie auch das Ergebnis und die Adresskomponenten in Ihr System einbeziehen.

USPS-Bestätigung des Zustellpunkts (Delivery Point Verification, DPV)

Als Teil der uspsData-Antwort gibt das Feld dpvConfirmation ein einzelnes Zeichen zurück, um Sie darüber zu informieren, ob die USPS an die angegebene Adresse liefern kann.

Mit diesem Feld können Sie Folgendes ermitteln:

  • Gültigkeit der Adresse
  • ob eine Nummer für eine untergeordnete Einheit in der Adresse fehlt
  • ob die Nummer für eine untergeordnete Einheit im USPS-Datensystem nicht vorhanden ist

Der Dienst gibt entweder einen von vier dpvConfirmation-Werten zurück oder gar keinen dpvConfirmation-Wert. In der folgenden Tabelle ist das empfohlene Verhalten aufgeführt, das Ihre Logik für jedes der fünf möglichen Ergebnisse verwenden sollte. Weitere Informationen zu dieser Logik finden Sie unter Workflow-Übersicht in Bestätigungslogik erstellen.

Wert

Verhalten

Beschreibung

N

oder leer

Adresse korrigieren

Die Adresse wurde nicht per DPV bestätigt.

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

D

Adresse korrigieren

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

Das bedeutet, dass die eingegebene Nummer der Einheit in der eingegebenen Straße vorhanden ist. Um eine vollständig bestätigte/zustellbare Adresse zu erhalten, muss jedoch auch eine gültige Nummer für eine untergeordnete Einheit angegeben werden. Mit anderen Worten: Die Nummer für die untergeordnete Einheit fehlte in der Eingabe.

S

Adresse bestätigen

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

Das bedeutet, dass die eingegebene Nummer der Einheit in der eingegebenen Route vorhanden ist, die angegebene untergeordnete Einheit jedoch laut USPS 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 von der USPS zugestellt werden kann, einschließlich der Nummer für die untergeordnete Einheit, falls zutreffend.

Im Rest dieses Abschnitts werden reale Szenarien beschrieben, in denen die DPV-Codes verwendet werden.

Beispiel für DPV N: Adresse korrigieren

In diesem Beispiel wird eine nicht vorhandene Hausnummer in einer ansonsten gültigen Adresse verwendet.

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

Dies ist ein extrem starkes Signal dafür, dass diese Nummer der Einheit in dieser Route nicht vorhanden ist. 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, enthält aber keine Nummer für eine untergeordnete Einheit, die ein erforderlicher Bestandteil der Adresse ist. Sie können dies sehen, wenn Sie die Adresse in der Demo ohne Informationen zur untergeordneten Einheit verwenden.

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

Dies bestätigt, dass die Nummer für die untergeordnete Einheit in der Eingabe gefehlt hat. Um einen DPV-Wert von „Y“ zu erhalten, muss eine gültige Nummer für eine untergeordnete Einheit als Teil der Eingabe enthalten sein. Sie können beispielsweise eine gültige Nummer für eine untergeordnete Einheit von FL 4 (4. Stock) angeben, um einen dpvConfirmation-Wert von „Y“ zu erhalten.

Beispiel für DPV S: Adresse bestätigen

In diesem Beispiel wird eine Nummer für eine untergeordnete Einheit verwendet, die im Gebäude nicht vorhanden ist:

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

Das bedeutet, dass die Adresse 1600 Amphitheatre Parkway zwar vorhanden ist und Post empfangen kann, die untergeordnete Einheit 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, Korrekturen vorzunehmen.

Beispiel für DPV Y: Adresse akzeptieren

In diesem Beispiel wird die Adresse des Googleplex in Mountain View, Kalifornien, als bekannte Qualitätsadresse 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 von der USPS zustellbar. So können Sie sich sehr sicher sein, dass die API eine Adresse von guter Qualität zurückgegeben hat, und Sie können sie so verwenden, wie sie ist.

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

Sicherheitsmeldungen für US-Adressen

In diesem Abschnitt werden die Sicherheitsflags behandelt, die in den USPS-Daten für künstlich erstellte Adressen enthalten sind. Diese Sicherheitsmaßnahme soll die künstliche Erstellung einer Adressliste verhindern, indem erkannt wird, wenn eine eingereichte Adresse künstlich erstellt und nicht auf rechtmäßige Weise erhalten wurde. Das sollte nur sehr selten vorkommen.

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