Gérer les adresses aux États-Unis

Ce document traite de la validation des adresses spécifiques aux États-Unis :

Données USPS dans votre workflow

Lorsque vous validez des adresses aux États-Unis, l'API Address Validation peut également renseigner la partie uspsData de la réponse.

Étant donné que cet objet n'est pas toujours renseigné, vous ne devez pas vous fier à cette propriété comme seul moyen de valider les adresses. Vous devez également intégrer le verdict et les composants d'adresse dans votre système.

Validation du point de livraison USPS (DPV)

Dans le cadre de la réponse uspsData, le champ dpvConfirmation renvoie un seul caractère pour vous indiquer si l'USPS peut livrer à l'adresse fournie.

Vous pouvez utiliser ce champ pour déterminer les éléments suivants :

  • la validité de l'adresse ;
  • si un numéro de sous-établissement est manquant dans l'adresse ;
  • si le numéro de sous-établissement n'existe pas dans le système de données USPS.

Le service renvoie l'une des quatre valeurs dpvConfirmation ou 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 Créer votre logique de validation.

Valeur

Comportement

Description

N

ou vide

Corriger l'adresse

L'adresse n'a pas été confirmée par la DPV.

Cela signifie que l'USPS ne reconnaît pas le numéro d'établissement saisi dans la rue (itinéraire) et ne peut pas y livrer.

D

Corriger l'adresse

L'adresse a été confirmée par la DPV pour le numéro principal uniquement, et les informations sur le numéro secondaire étaient manquantes.

Cela signifie que le numéro d'établissement saisi existe dans la rue saisie, mais qu'un numéro de sous-établissement valide doit également être fourni pour atteindre une adresse entièrement vérifiée/livrable. En d'autres termes, le sous-établissement était manquant dans l'entrée.

S

Confirmer l'adresse

L'adresse a été confirmée par la DPV pour le numéro principal uniquement, et les informations sur le numéro secondaire étaient présentes, mais n'ont pas été confirmées.

Cela signifie que le numéro d'établissement saisi existe dans l'itinéraire saisi, mais que le sous-établissement fourni n'existe pas dans ce bâtiment, selon l'USPS.

O

Accepter l'adresse

L'adresse a été confirmée par la DPV pour le numéro principal et tous les numéros secondaires.

Cela signifie que l'adresse est entièrement livrable par l'USPS, y compris le numéro de sous-établissement, 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 par ailleurs valide.

  • Adresse saisie : 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Région : États-Unis
  • Le champ dpvConfirmation renvoie : N

Il s'agit d'un signal extrêmement fort indiquant que ce numéro d'établissement n'existe pas dans cet itinéraire. 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 de sous-établissement, qui est un élément obligatoire de l'adresse. Vous pouvez le constater en utilisant l'adresse dans la démo sans informations sur le sous-établissement.

  • Adresse saisie : 111 8th Avenue, New York, NY, 10011
  • Région : États-Unis
  • Le champ dpvConfirmation renvoie : D

Cela confirme que le sous-établissement était manquant dans l'entrée. Pour obtenir une DPV de Y, un sous-établissement valide doit être inclus dans l'entrée. Par exemple, vous pouvez inclure un sous-établissement 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-établissement qui n'existe pas dans le bâtiment :

  • Adresse saisie : 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • Région : États-Unis
  • Le champ dpvConfirmation renvoie : S

Cela indique que, bien que 1600 Amphitheatre Parkway existe en tant qu'adresse pouvant accepter le courrier, le sous-établissement Ste 101 n'est pas un élément valide de l'adresse. Votre système doit confirmer ces informations auprès de l'utilisateur et lui permettre d'apporter une correction.

Exemple de DPV Y : accepter l'adresse

Cet exemple utilise l'adresse du Googleplex à Mountain View, en Californie, comme adresse de qualité connue.

  • Adresse saisie : 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Région : États-Unis
  • Le champ dpvConfirmation renvoie : Y

L'adresse est entièrement livrable par l'USPS. Vous avez ainsi un très haut degré de confiance dans le fait que l'API a renvoyé une adresse de bonne qualité, et vous pouvez l'utiliser telle quelle.

Remarque : La DPV n'indique pas si l'API Address Validation a apporté des modifications à l'entrée, par exemple une correction orthographique.

Messages de sécurité pour les adresses aux États-Unis

Cette section traite des indicateurs de sécurité fournis dans les données USPS pour les adresses créées artificiellement. Cette mesure de sécurité est conçue pour empêcher la création artificielle d'une liste d'adresses en détectant quand une adresse envoyée semble avoir été construite artificiellement et non obtenue légitimement. Cela devrait être très rare.

Lorsque l'USPS identifie une adresse créée artificiellement, le errorMessage champ de la uspsDatauspsData 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.