Gérer les adresses aux États-Unis

Ce document porte sur la validation d'adresse spécifique aux États-Unis:

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 l'utiliser l'établissement comme seul moyen de valider les adresses, mais d'intégrer à la place les composants d'évaluation et d'adresse dans votre système.

USPS Delivery Point Verification (DPV)

Dans 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 :

  • 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 pas ne renvoie pas une 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 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 l'établissement indiqué sur la rue (voie) indiquée et ne peut pas y effectuer de livraison.

D

Corriger l'adresse

L'adresse a fait l'objet d'une DPV confirmée uniquement pour le numéro principal, et les informations relatives au numéro secondaire étaient manquantes.

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

S

Confirmer l'adresse

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

Cela signifie que le numéro de l'établissement saisi existe sur 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 DPV pour le numéro principal et tous les numéros secondaires.

Cela signifie que l'intégralité de l'adresse peut être livrée par USPS, y compris le de l'emplacement secondaire, le cas échéant.

Le reste de cette section décrit des 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 pour 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 de local n'existe pas sur cet itinéraire. Comme pour toute autre adresse problématique, votre système doit afficher l'utilisateur pour obtenir des corrections.

Exemple de DPV D : corriger l'adresse

Cet exemple utilise les bureaux de Google à New York, mais ne contient pas qui est une partie requise de l'adresse. Vous pouvez le voir en utilisant l'adresse indiquée dans la démonstration sans les informations sur le site secondaire.

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

Cela confirme que le sous-site était manquant dans la saisie. Pour accéder à une DPV de Y, une sous-hypothèse valide doit être incluse dans l'entrée. Par exemple : vous pouvez inclure un sous-site valide de FL 4 (4e étage) pour obtenir un Valeur dpvConfirmation de Y.

Exemple de DPV S : confirmation de 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
  • Région : États-Unis
  • Le champ dpvConfirmation renvoie: S

Cela signifie que, même si 1600 Amphitheatre Parkway est l'adresse accepte les e-mails, l'adresse 101 secondaire "Ste 101" n'est pas une partie valide de l'adresse. Votre système doit confirmer ces informations auprès de l'utilisateur et lui donner la possibilité de les corriger.

Exemple de DPV Y – Accepter l'adresse

Cet exemple utilise l'adresse du Googleplex de Mountain View, en Californie, 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 desservie par USPS. Vous pouvez ainsi être sûr à 99 % que l'API a renvoyé une adresse de bonne qualité et que vous pouvez l'utiliser telle quelle.

Remarque: La DPV n'indique pas si l'API Address Validation a effectué des des modifications de l'entrée, comme une correction orthographique.

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

Cette section aborde les indicateurs de sécurité fournis dans les données USPS pour créées artificiellement. Cette mesure de sécurité vise à empêcher la création artificielle d'une liste d'adresses en détectant quand une adresse envoyée semble avoir été créée artificiellement et non obtenue légitimement. Ce genre de situation est exceptionnel.

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.