Ce document porte sur la validation d'adresse spécifique aux États-Unis:
- Utiliser des données USPS dans votre workflow
- Champs de la validation du point de livraison USPS (dpv)
- Messages de sécurité
Données USPS dans votre flux de travail
Lors de la validation d'adresses aux États-Unis, le service de l'API Address Validation peut également renseigner la partie uspsData du retour.
Comme cet objet n'est pas toujours renseigné, vous ne devez pas utiliser cette propriété comme seul moyen de valider les adresses, mais plutôt intégrer les composants d'évaluation et d'adresse dans votre système.
Validation du point de livraison USPS
Dans la réponse uspsData
, le champ dpvConfirmation
renvoie un seul caractère pour vous indiquer si USPS peut livrer à l'adresse fournie.
Ce champ vous permet de déterminer les éléments suivants:
- la validité de l'adresse.
- s'il manque un numéro de quartier dans l'adresse.
- si le numéro de la sous-localité n'existe pas dans le système de données USPS.
Le service renvoie l'une des quatre valeurs dpvConfirmation
ou ne renvoie aucune valeur dpvConfirmation
. Le tableau ci-dessous présente le comportement recommandé que votre logique doit utiliser pour chacun des cinq résultats possibles. Pour en savoir plus sur cette logique, consultez la section Présentation du workflow dans Utiliser la réponse de validation.
Valeur |
Comportement |
Description |
---|---|---|
N ou vide |
Corriger l'adresse |
L'adresse n'a pas été confirmée. Cela signifie que l'USPS ne reconnaît pas le numéro de local saisi qui existe dans la rue indiquée (itinéraire) et ne peut pas effectuer la livraison à cette adresse. |
D |
Corriger l'adresse |
L'adresse a été confirmée pour le numéro principal uniquement, et les informations sur le numéro secondaire étaient manquantes. |
S |
Confirmer l'adresse |
L'adresse a été confirmée pour le numéro principal uniquement. Les informations du numéro secondaire étaient présentes, mais pas confirmées. Cela signifie que le numéro de bâtiment indiqué existe sur l'itinéraire indiqué, mais que le bâtiment secondaire fourni n'existe pas dans ce bâtiment, selon USPS. |
O |
Accepter l'adresse |
L'adresse a été confirmée pour le numéro principal et les numéros secondaires. Cela signifie qu'USPS peut fournir l'intégralité de l'adresse, y compris le numéro de l'emplacement secondaire, le cas échéant. |
Le reste de cette section traite de scénarios réels qui utilisent les codes DPV.
Exemple de DPV N : corriger l'adresse
Cet exemple utilise un numéro de rue inexistant dans une adresse valide.
- Adresse saisie: 12 Amphitheatre Parkway, Mountain View, CA 94043, États-Unis
- Région: États-Unis
- Le champ
dpvConfirmation
renvoie:N
Il s'agit d'un signal fort indiquant que ce numéro d'emplacement n'existe pas sur cette route. Comme pour les autres adresses problématiques, votre système doit inviter l'utilisateur à apporter des corrections.
Exemple de DPV D : corriger l'adresse
Cet exemple utilise le bureau Google à New York, mais ne contient pas d'élément secondaire qui est obligatoire dans l'adresse. Vous pouvez le constater en utilisant l'adresse indiquée dans la démonstration, sans les informations sur le sous-site.
- Adresse saisie: 111 8th Avenue, New York, NY, 10011
- Région: États-Unis
- Le champ
dpvConfirmation
renvoie:D
Cela confirme que l'élément secondaire était absent de l'entrée. Pour obtenir une DPV de Y, une sous-hypothèse valide doit être incluse dans l'entrée. Par exemple, vous pouvez inclure un sous-emplacement valide de FL 4 (4e étage) pour obtenir une valeur dpvConfirmation
de Y.
Exemple de DPV S – Confirmer l'adresse
Cet exemple utilise un numéro de sous-localisation qui n'existe pas dans le bâtiment:
- Adresse saisie: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA 94043, États-Unis
- Région: États-Unis
- Le champ
dpvConfirmation
renvoie:S
Cela signifie que même si l'adresse "1600 Amphitheatre Parkway" existe en tant qu'adresse pouvant recevoir des e-mails, "Ste 101" ne fait pas partie des adresses valides. Votre système doit confirmer cette information auprès de l'utilisateur et lui donner la possibilité de le corriger.
Exemple de DPV Y – Accepter l'adresse
Cet exemple utilise l'adresse Googleplex de Mountain View, en Californie, comme adresse de qualité connue.
- Adresse saisie: 1600 Amphitheatre Parkway, Mountain View, CA 94043, États-Unis
- Région: États-Unis
- Le champ
dpvConfirmation
renvoie:Y
La livraison de l'adresse est assurée par USPS dans son intégralité. Vous avez ainsi l'assurance que l'API a renvoyé une adresse de bonne qualité et que vous pouvez l'utiliser telle que fournie.
Remarque: La DPV n'indique pas si l'API Address Validation a apporté des modifications à la saisie, comme une correction orthographique.
Messages de sécurité pour les adresses aux États-Unis
Cette section décrit les indicateurs de sécurité fournis dans les données USPS pour les adresses créées artificiellement. Cette mesure de sécurité vise à empêcher la création artificielle d'une liste d'adresses en détectant les adresses qui semblent avoir été construites artificiellement et non obtenues légitimement. Cela ne devrait se produire que très rarement.
Lorsque USPS identifie une adresse créée artificiellement, le champ errorMessage
de la propriété uspsData de la réponse contient un message d'erreur décrivant le problème. Exemple :
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.