Adressen in den USA verarbeiten

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

USPS-Daten in Ihrem Workflow

Beim Validieren 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 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.

Verifizierung des Versandpunkts durch USPS

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

Mit diesem Feld können Sie Folgendes ermitteln:

  • die Gültigkeit der Adresse.
  • in der Adresse fehlt.
  • , falls die Wohnungsnummer im USPS-Datensystem nicht vorhanden ist.

Der Dienst gibt entweder einen von vier dpvConfirmation-Werten oder gar 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.

Wert

Verhalten

Beschreibung

N oder leer

Adresse korrigieren

Die Adresse wurde nicht von DPV bestätigt.

Das bedeutet, dass der USPS die eingegebene Gebäudenummer auf 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 durch DPV bestätigt und die Informationen zur Zweitnummer fehlten.

Das bedeutet, dass die eingegebene Gebäudenummer in der eingegebenen Straße existiert. Um eine vollständig bestätigte Adresse zu erreichen, muss jedoch eine gültige Gebäudenummer angegeben werden. Mit anderen Worten: Die untergeordnete Voraussetzung fehlte in der Eingabe.

S

Adresse bestätigen

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

Dies bedeutet, dass die eingegebene Gebäudenummer auf der eingegebenen Route vorhanden ist, die angegebene Gebäudenummer jedoch laut USPS nicht in diesem Gebäude vorhanden ist.

Ja

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 gegebenenfalls der Nummer des Untergebäudes.

Im weiteren Verlauf dieses Abschnitts werden reale Szenarien erläutert, in denen die DSV-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, USA
  • Region: USA
  • Das Feld dpvConfirmation gibt Folgendes zurück: N

Das ist ein extrem starkes Signal, dass diese Gebäudenummer auf dieser Route nicht vorhanden ist. Wie bei anderen problematischen Adressen sollte Ihr System den Nutzer zur Fehlerbehebung auffordern.

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

Damit wird bestätigt, dass die untergeordnete Einrichtung in der Eingabe fehlte. Um zu einem Datenverarbeitungsprogramm von Y zu gelangen, muss eine gültige Untereinrichtung als Teil der Eingabe angegeben werden. Sie können beispielsweise eine gültige untergeordnete Voraussetzung von FL 4 (4. Etage) angeben, 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
  • Das Feld dpvConfirmation gibt Folgendes zurück: S

Das bedeutet, dass 1600 Amphitheatre Parkway zwar als Adresse vorhanden ist, die Post empfangen kann, das untergeordnete Gebäude 101 jedoch kein gültiger Teil der Adresse. 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 qualitativ hochwertige Adresse verwendet.

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

Die Adresse wird vollständig von USPS geliefert. 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: Aus der Datenverarbeitungsbedingungen geht nicht hervor, 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 enthalten sind. Diese Sicherheitsmaßnahme soll die künstliche Erstellung einer Adressenliste verhindern, indem erkannt wird, wenn eine eingereichte Adresse scheinbar künstlich erstellt und nicht rechtmäßig abgerufen wurde. Das dürfte nur sehr selten der Fall sein.

Wenn der USPS eine künstlich erstellte Adresse identifiziert, enthält das Feld errorMessage der Eigenschaft uspsData der Antwort eine Fehlermeldung, die das Problem beschreibt. 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.