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'incorporer à la place 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 pour vous indiquer si l'USPS peut livrer à l'adresse indiquée.

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.

Soit le service renvoie l'une des quatre valeurs dpvConfirmation, soit il ne renvoie pas ne renvoie pas une valeur dpvConfirmation. Le tableau ci-dessous présente les recommandations comportement que votre logique doit utiliser pour chacun des cinq résultats possibles. Pour plus 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.

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

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 l'hypothèse le numéro saisi existe dans la rue saisie, mais pour atteindre un d'adresse validée/de livraison, un numéro de sous-site valide doit également être fournies. En d'autres termes, il manquait la sous-hypothèse dans l'entrée.

S

Confirmer 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 présentes, mais pas confirmées.

Cela signifie que le numéro de bâtiment indiqué existe sur l'itinéraire indiqué, mais le sous-site fourni n'existe pas dans ce bâtiment, d'après à USPS.

O

Accepter l'adresse

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

Cela signifie que l'intégralité de l'adresse peut être livrée par USPS, y compris le 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

Cela indique très clairement que ce numéro d'établissement n'existe pas. sur cet itinéraire. Comme pour toute autre adresse problématique, votre système doit envoyer l'utilisateur pour obtenir des corrections.

Exemple de DPV D : corriger l'adresse

Cet exemple utilise les bureaux 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 l'élément secondaire était absent de l'entrée. 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 – 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
  • Région: États-Unis
  • Le champ dpvConfirmation renvoie: S

Cela signifie que même si 1600 Amphitheatre Parkway est une 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 fournir une possibilité de correction.

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, É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é. Cela vous donne un très haut degré de que l'API a renvoyé une adresse de bonne qualité, et vous pouvez l'utiliser tel qu'indiqué.

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 les adresses semblent avoir été construits artificiellement et ne pas avoir été obtenus légitimement. Cela ne devrait se produire que très rarement.

Lorsque l'USPS identifie une adresse créée artificiellement, le errorMessage de la propriété uspsData de la réponse contient une 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.