In diesem Dokument wird die Adressbestätigung speziell für die USA behandelt:
- USPS-Daten im Workflow verwenden
- Felder für die USPS-Zustellungspunktüberprüfung (dpv)
- Sicherheitshinweise
USPS-Daten in Ihrem Workflow
Bei der Validierung von Adressen in den USA wird der Address Validation API-Dienst kann auch den uspsData-Teil 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
Als Teil der uspsData
-Antwort gibt das Feld dpvConfirmation
ein einzelnes
um dich darüber zu informieren, ob USPS an die angegebene Adresse liefern kann.
Mit diesem Feld können Sie Folgendes ermitteln:
- die Gültigkeit der Adresse.
- in der Adresse fehlt die Nummer eines Gebäudes.
- , falls die Wohnungsnummer im USPS-Datensystem nicht 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
Einzelheiten zu dieser Logik finden Sie
Workflowübersicht unter 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 nicht erkennt. auf der eingegebenen Straße (Route) vorhanden ist und keine Lieferung dorthin liefern kann. |
D |
Adresse korrigieren |
Die Adresse wurde nur für die primäre Nummer durch die Datenschutzrichtlinie bestätigt und der
Zweitnummer fehlte. |
S |
Adresse bestätigen |
Die Adresse wurde nur für die primäre Nummer durch die Datenschutzrichtlinie bestätigt und der Zweitnummer war vorhanden, aber nicht bestätigt. Das bedeutet, dass die eingegebene Gebäudenummer auf der eingegebenen Route existiert. die dafür vorgesehene Unterstelle jedoch nicht in diesem Gebäude vorhanden ist. an USPS. |
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 der Wohnungsnummer (falls vorhanden). |
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 äußerst starkes Signal, dass diese Gebäudenummer nicht existiert. auf dieser Route. 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 das Teil der Adresse ist. Sie können dies sehen, 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. So gelangen Sie zu einer Datenschutzvereinbarung
Y ist, muss eine gültige untergeordnete Prämisse als Teil der Eingabe enthalten sein. Beispiel:
können Sie eine gültige Untereinrichtung von FL 4 (4. Etage) einfügen, um eine
dpvConfirmation
-Wert von Y.
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
- Region: USA
- Das Feld
dpvConfirmation
gibt Folgendes zurück:S
Dies bedeutet, dass die Adresse 1600 Amphitheatre Parkway Post annehmen kann, ist das Gebäude Ste 101 kein gültiger Teil der Adresse. Ihr System sollte diese Informationen gegenüber dem Nutzer bestätigen und eine eine Korrekturmöglichkeit.
Beispiel für DPV Y – Adresse akzeptieren
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 wird vollständig von USPS geliefert. 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: Aus dem DPV geht nicht hervor, ob die Address Validation API an der Eingabe vornehmen, z. B. eine Rechtschreibkorrektur.
Sicherheitsnachrichten für US-Adressen
In diesem Abschnitt werden die Sicherheits-Flags behandelt, 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 enthält 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.