Gérer les adresses aux États-Unis

Ce document concerne la validation d'adresse spécifiquement aux États-Unis:

Données USPS dans votre workflow

Lors de la validation d'adresses aux États-Unis, le service de l'API Address Validation peut également renseigner la partie uspsData du retour.

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

Vérification du point de livraison USPS (DPV)

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

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

  • valide.
  • si le numéro d'un sous-lieu n'est pas indiqué dans l'adresse.
  • si ce numéro n'existe pas dans le système de données USPS.

Le service renvoie soit l'une des quatre valeurs dpvConfirmation, soit aucune valeur dpvConfirmation. Le tableau ci-dessous indique le comportement recommandé que votre logique doit utiliser pour chacun des cinq résultats possibles. Pour en savoir plus sur cette logique, consultez 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 par la DPV.

Cela signifie que l'USPS ne reconnaît pas le numéro d'établissement saisi et ne figure pas dans la rue saisie (route) et ne peut donc pas fournir d'adresse.

D

Corriger l'adresse

L'adresse était confirmée par la DPV uniquement pour le numéro principal, et le numéro secondaire manquait.

Cela signifie que le numéro d'établissement saisi se trouve dans la rue que vous avez saisie, mais que vous devez également fournir un numéro d'adresse secondaire valide afin que l'adresse puisse être entièrement validée ou non. En d'autres termes, il manquait l'élément secondaire dans l'entrée.

S

Confirmer l'adresse

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

Cela signifie que le numéro de bâtiment indiqué existe sur l'itinéraire indiqué, mais que le sous-lieu fourni n'existe pas dans ce bâtiment, selon USPS.

O

Accepter l'adresse

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

Cela signifie que l'USPS peut entièrement livrer l'adresse, y compris le numéro du bâtiment secondaire, le cas échéant.

Le reste de cette section traite de scénarios réels utilisant les codes DPV.

Exemple de DPV N – Corriger l'adresse

Cet exemple utilise un numéro de rue inexistant pour 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 extrêmement fort indiquant que ce numéro de site 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 les bureaux de Google à New York, mais ne contient pas de sous-lieu, qui doit obligatoirement faire partie de l'adresse. Pour le vérifier, utilisez l'adresse indiquée dans la démonstration sans 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 l'absence du sous-compte dans l'entrée. Pour accéder à une VDP de Y, un sous-domaine valide doit être inclus dans l'entrée. Par exemple, vous pouvez inclure un sous-hébergement 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-logement qui n'existe pas à l'intérieur du 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 indique que même si l'adresse du 1600 Amphitheatre Parkway existe en tant qu'adresse pouvant accepter le courrier, mais que le bâtiment secondaire Ste 101 ne constitue pas une partie valide de l'adresse. Votre système doit confirmer ces informations auprès de l'utilisateur et lui permettre de la corriger.

Exemple de DPV Y – Accepter l'adresse

Cet exemple utilise l'adresse Googleplex de Mountain View, en Californie, en tant qu'adresse de qualité connue.

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

L'adresse peut être entièrement livrée par USPS. Vous avez ainsi un très haut niveau de certitude quant au fait que l'API a renvoyé une adresse de bonne qualité, et vous pouvez l'utiliser telle qu'elle vous a été fournie.

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

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

Cette section présente les indicateurs de sécurité fournis dans les données USPS pour les adresses créées de manière artificielle. Cette mesure de sécurité vise à empêcher la création artificielle d'une liste d'adresses en détectant les adresses envoyées qui semblent avoir été créées de manière artificielle et ne pas avoir été obtenues légitimement. Cela devrait être un cas très rare.

Lorsque l'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.