Adressen in den USA verarbeiten

In diesem Dokument wird die Adressbestätigung speziell 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 Teil uspsData der Rückgabe ausfüllen.

Da dieses Objekt nicht immer ausgefüllt wird, sollten Sie sich nicht auf diese zur Validierung von Adressen verwendet. Stattdessen muss das Attribut und adressieren Komponenten in Ihr System ein.

Verifizierung des Versandpunkts durch USPS

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.

Anhand dieses Felds 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 zurück oder nicht einen dpvConfirmation-Wert zurückgeben. In der folgenden Tabelle sehen Sie Verhalten, das Ihre Logik für jedes der fünf möglichen Ergebnisse anwenden sollte. Weitere Informationen zu dieser Logik finden Sie unter Workflow-Übersicht im Abschnitt Validierungsantwort verwenden.

Wert

Verhalten

Beschreibung

N oder leer

Adresse korrigieren

Die Adresse wurde nicht von 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 durch die Datenschutzrichtlinie bestätigt und der Zweitnummer fehlte.

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 untergeordnete Voraussetzung 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 Gebäudenummer auf der eingegebenen Route existiert. Die dafür vorgesehene Unterstelle ist jedoch nicht in diesem Gebäude vorhanden, an USPS.

J

Adresse akzeptieren

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

Das bedeutet, dass die Adresse vollständig von USPS geliefert werden kann, einschließlich der Gebäudenummer, falls zutreffend.

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

DPV N example - fix the address

In diesem Beispiel wird eine nicht vorhandene Hausnummer in einer ansonsten gültigen 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 und den Nutzer um Korrekturen bitten.

Beispiel für DPV D – Adresse korrigieren

In diesem Beispiel wird die Google-Niederlassung in New York verwendet, es ist jedoch kein die Teil der Adresse ist. Sie können dies anzeigen, indem Sie die Adresse in der Demo ohne Informationen zur Umgebung

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

Damit wird bestätigt, dass die untergeordnete Einrichtung in der Eingabe fehlte. Um eine DPV von „Y“ zu erhalten, muss die Eingabe eine gültige untergeordnete Örtlichkeit enthalten. Sie können beispielsweise eine gültige untergeordnete Örtlichkeit wie FL 4 (4. Etage) angeben, um den Wert „Y“ für dpvConfirmation zu erhalten.

Beispiel für DPV S – Adresse bestätigen

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 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 mit dem Nutzer bestätigen und ihm die Möglichkeit zur Korrektur geben.

DPV Y example - accept the address

In diesem Beispiel wird die Googleplex-Adresse in Mountain View, CA als Qualität bekannt ist.

  • 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. So erhalten Sie ein sehr hohes Maß an sich darauf verlassen, dass die API eine Adresse von guter Qualität zurückgegeben hat, und dass Sie diese verwenden können wie angegeben.

Hinweis: Die DPV gibt 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 erzeugten Adressen. Diese Sicherheitsmaßnahme soll verhindern, die künstliche Erstellung einer Adressenliste, indem erkannt wird, die offenbar künstlich erstellt und nicht rechtmäßig erworben wurden. Das dürfte nur sehr selten der Fall sein.

Wenn das USPS eine künstlich erstellte Adresse identifiziert, wird die errorMessage der Eigenschaft uspsData der Antwort ein erhalten Sie 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.