L’API de validation de l’adresse est une solution intelligente permettant de corriger les inexactitudes dans les coordonnées et de livrer des colis de façon précise. Cette API met en forme de façon appropriée les informations saisies concernant l’adresse du destinataire qui ressemblent de près à une adresse valide, et renvoie une adresse réelle qui correspond probablement à celle voulue.

L’API fournit également des annotations concernant les erreurs de saisie de l’adresse ou les modifications qui ont été apportées à votre saisie, pour parvenir à l’adresse réelle. L’API vous permet de valider et de résoudre les erreurs de coordonnées du destinataire avant d’expédier un colis.

Remarque : n’utilisez pas cette API pour déterminer la disponibilité d’une adresse à la livraison. FedEx ne propose pas de service de livraison pour certaines adresses valides. FedEx ne livre pas à des boîtes postales (sauf via FedEx Ground® Economy anciennement FedEx SmartPost®). FedEx ne propose pas de service de livraison pour certaines adresses valides. FedEx ne livre pas à des boîtes postales (sauf via FedEx Ground® Economy anciennement FedEx SmartPost®).

L’API vous permet de valider et de corriger les erreurs de coordonnées du destinataire avant d’expédier un colis. La présence d’une adresse correcte sur l’étiquette d’expédition évitera les retards de livraison et des frais de supplémentaires de rectification d’adresse mal rédigée.

Remarque :

• Les résultats de la correction d’adresse varient selon les pays/territoires.
• L’adresse saisie dans la demande est comparée aux données de référence de la base de données FedEx, puis l’adresse correspondante est renvoyée.

Fonctionnalités de l’API de validation de l’adresse

• Fournit des correspondances d’adresse au niveau de la rue.
• Sa base de données d’adresses est mise à jour mensuellement.
• Fait la distinction entre les adresses professionnelles et résidentielles si elle trouve une correspondance exacte.
• Ne vérifie pas, à l’heure actuelle, les numéros de suite ou d’appartement.

Services de l’API de validation de l’adresse

• Complète les adresses de destinataires incomplètes. Dans certains cas, l’API de validation de l’adresse peut ajouter des informations manquantes, en vérifiant les informations fournies par rapport aux données de référence. L’API de validation d’adresse ne peut pas ajouter d’informations manquantes secondaires (p. ex. appartement ou suite) pour le moment.
• Sa base de données d’adresses est mise à jour mensuellement.
• Corrige les adresses de destinataires non valides. Par exemple, correction d’un code postal incorrect pour correspondre au reste de la saisie.
• Détermine si une adresse est commerciale ou résidentielle pour augmenter la précision des estimations de tarifs. Applicable aux adresses aux États-Unis et au Canada uniquement.
• Confirme la validité et l’exhaustivité des adresses dans de nombreux pays des zones suivantes : États-Unis, Canada, Amérique latine, Europe, Moyen-Orient et Asie Pacifique. Vous pouvez désormais valider les informations d’adresse nationales et internationales avant d’expédier un colis, ce qui évite les retards de livraison inutiles et les frais de service supplémentaires.
• Fournit des correspondances au niveau de la rue.
• Jusqu’à 100 adresses peuvent être vérifiées lors d’une requête à l’API.

Pays/territoires pour lesquels l’API de validation de l’adresse est utilisable

L’API de validation de l’adresse de FedEx est utilisable dans les pays ci-après et vous permet de valider et de corriger les adresses de destinataires pour garantir le bon déroulement des livraisons.

Remarque : les informations renvoyées par la requête de validation d’adresse sont fournies à titre de suggestion uniquement.

Clause de non-responsabilité : les données fournies dans les présentes appartiennent à FedEx et sont des informations confidentielles, communiquées gratuitement à votre demande. Aucune partie de ces données ne peut être distribuée ni divulguée à un tiers sous quelque forme que ce soit sans autorisation écrite de FedEx. Elles reflètent la classification actuelle des adresses commerciales/résidentielles de FedEx dans la base de données d’adresses de livraison FedEx, qui peut faire l’objet de modifications. En fournissant ces informations, FedEx ne garantit pas leur précision actuelle ou future, ni le fait que les colis expédiés à ces adresses seront facturés selon la classification des adresses commerciales/résidentielles fournie dans les présentes. La communication de ces informations ne doit pas être considérée comme modifiant les termes des rapports entre les parties. Pour des explications détaillées, reportez-vous au Guide des services FedEx et à l’accord de tarification du compte applicable pour les conditions légales régissant l’expédition et les frais de FedEx.

Valider l’adresse

Ce point de terminaison vous permet de valider et de résoudre les adresses saisies, et renvoie des adresses réelles à la place. Les détails de l’adresse sont fournis et doivent être validés afin de la résoudre. Une adresse est marquée comme résolue une fois que l’adresse saisie correspond aux données référencées.

Voici les informations de saisie requises pour cette requête :

• Lignes de rue
• Ville (facultatif)
• Code d’État ou de province (facultatif)
• Code postal (facultatif)
• Code de pays

Remarque : le code d’État ou le nom de la ville est suffisant lorsque le client effectue un envoi vers un pays ne disposant pas de codes postaux.

L’API de validation de l’adresse renvoie une adresse réelle en effectuant les opérations suivantes sur l’adresse saisie :

• Première étape : l’API tente de normaliser l’adresse saisie. Cela peut signifier le remplacement des identifiants de route communs comme Rue et Route par leurs abréviations standard R et RTE, ainsi que la réorganisation des éléments d’adresse. Si une adresse saisie ne peut être normalisée, l’adresse résolue sera l’adresse saisie. Les valeurs ne correspondant pas à une adresse sont supprimées.
• Deuxième étape : l’API tente de standardiser l’adresse normalisée, en trouvant une adresse possible ou l’adresse réelle qui correspond probablement à l’adresse souhaitée. En cas d’échec de la standardisation, l’adresse résolue renvoyée sera la forme normalisée de l’adresse saisie. Consultez les éléments renvoyés pour déterminer les problèmes rencontrés avec l’adresse saisie.
• Certains éléments de cette adresse normalisée seront également renvoyés. En cas de réussite de la standardisation, l’adresse résolue renvoyée sera l’adresse réelle. Dans ce cas, plusieurs autres éléments de l’adresse standardisée et les informations sur la manière dont elle aura été adaptée à partir de l’adresse normalisée seront également renvoyés.

Valeurs renvoyées par l’API de validation de l’adresse

Si l’adresse renvoyée inclut les valeurs suivantes pour les attributs ci-dessous, l’adresse est alors valide :

• Address State (État de l’adresse) est standardisé
• Les attributs de Resolved address (Adresse résolue) sont True (Vrai)
• Delivery Point Valid (DPV) (Point de livraison valide) est True (Vrai)
• Interpolated Address (Adresse interpolée) est False (Faux)

Si ces valeurs sont absentes, utilisez les autres attributs pour déterminer les éventuels problèmes liés aux valeurs d’adresse.

Pour plus d’informations sur les attributs d’adresse, consultez Attributs d’adresse.

Si le message de sortie client renvoyé est INTERPOLATED.STREET.ADDRESS, il est probable que l’adresse ne soit pas valide. Pour plus d’informations sur le code de message client, référez-vous à la description des éléments du message client.

Annotations

L’API de validation de l’adresse renvoie des annotations avec chaque adresse validée renvoyée. Ces annotations fournissent des informations sur les éventuelles erreurs et sur les modifications apportées à l’adresse que vous avez saisie, pour parvenir à l’adresse réelle.

L’API de validation de l’adresse utilise des données de référence pour déterminer la classification d’une adresse donnée. La classification d’une adresse commerciale est effectuée indépendamment du processus de validation d’adresse et est basée sur les retours du personnel opérationnel, les sources de données commerciales étant utilisées pour confirmation uniquement.

L’API de validation de l’adresse propose seulement quatre classifications possibles des adresses : unknown (inconnue), business (commerciale), residential (résidentielle) et mixed (mixte). Dans un premier temps, la classification inconnue est attribuée à toutes les adresses jusqu’à ce que les règles de validation d’adresse commerciale déterminent que les classifications doivent changer. Un lieu est affecté à la classification mixte s’il s’agit d’une adresse partagée qui abrite des locaux à la fois commerciaux et résidentiels.

Remarque : le service FedEx Express présente une ligne d’adresse supplémentaire (ligne d’adresse 3) pour l’adresse du destinataire. Ces informations supplémentaires concernant l’adresse fournissent des détails plus complets et plus exacts sur le point de dépôt, ce qui améliore vos chances d’obtenir l’adresse correcte.

Les adresses réelles sont classifiées comme suit :

Adresse professionnelle

Une adresse professionnelle est une adresse servant à désigner le lieu principal de votre activité professionnelle. C’est à cette adresse qu’il est présumé que votre entreprise mène ses activités, bien que ce ne soit pas toujours le cas.

L’adresse professionnelle désigne l’emplacement officiel des locaux d’une entreprise. Cette adresse peut correspondre à tout type de lieu, qu’il s’agisse du domicile d’une personne ou d’un campus possédant un capital de plusieurs millions de dollars, comme ceux où sont implantés certains géants de la tech.

Adresse résidentielle

Des frais pour livraison à domicile de colis s’appliquent aux envois à l’intérieur des États-Unis vers un domicile ou une résidence privée, y compris les logements utilisés à des fins professionnelles. Utilisez FedEx Home Delivery pour une livraison à domicile via FedEx Ground sous 1 jour ouvré, selon la distance du destinataire.

Exemple :

• Presbytère
• Couvent
• Paroisse
• Résidents de logements collectifs, p. ex. :
  • Immeubles d’appartements
  • Copropriétés
  • Résidences universitaires

• Une résidence où des produits sont vendus et/ou distribués

Voici quelques conseils pratiques sur l’utilisation de l’API de validation de l’adresse :

• Utilisez correctement les espaces : assurez-vous qu’ils se trouvent aux bons endroits et évitez les espaces inutiles.
• Utilisez une orthographe correcte : évitez les fautes d’orthographe et fautes de frappe. Veillez également à faire bon usage du nombre « zéro » (0) et de la lettre O.
• Évitez les caractères spéciaux : abstenez-vous d’utiliser des caractères spéciaux non requis pour l’adresse, par exemple un point après une abréviation (Ave, et non Ave.).
• Fournissez des informations supplémentaires concernant l’adresse et la rue : la saisie d’informations supplémentaires pour l’adresse peut améliorer l’exactitude des résultats.
  • Numéro d’immeuble ou de maison - 1, 1A, 1½, One
  • Nom de rue - Main, George Washington, 42^nd
  • Suffixe de rue - Road, Avenue, Rd, Ave
• Saisissez la ville, l’État/la province ou le code postal : La saisie des trois éléments augmentera l’exactitude des résultats.
• Saisissez la rue et l’adresse dans l’ordre : les éléments de l’adresse suivent un format commençant par le numéro d’immeuble ou de maison, suivi par un élément de direction initial, un nom de rue, le type/le suffixe de rue, un élément de direction final, la désignation de l’appartement, le numéro d’appartement et/ou la désignation et le numéro de boîte postale privée.
• Utilisez les abréviations correctes : le service postal des États-Unis et les postes canadiennes emploient des abréviations standard pour l’État/la province, le suffixe de rue ainsi que les désignations d’appartements/de logements.
  • Une abréviation non standard peut engendrer des résultats médiocres.
  • Si vous n’êtes pas certain de l’écriture d’une abréviation, ne l’utilisez pas.

Par exemple :

• Numéro d’immeuble ou de maison : 1, 1A, One.
• Nom de rue : Main, George Washington, 42nd.
• Suffixe de rue : Route, Avenue, Rte, Av
• Saisissez la ville, l’État/la province ou le code postal : la saisie des trois éléments augmentera la précision des résultats. La partie ZIP+4 d’un code postal aux États-Unis n’est pas nécessaire pour vérifier une adresse.
• Utilisez les abréviations correctes : l’USPS (service postal des États-Unis) et les administrations postales des autres pays définissent des abréviations standards pour l’État/la province, le suffixe de rue ainsi que les désignations d’appartements/de logements. Une abréviation non standard peut engendrer des résultats médiocres. Si vous n’êtes pas certain de l’écriture d’une abréviation, ne l’utilisez pas.
• Pensez à renvoyer la réponse de la validation d’adresse à l’utilisateur pour qu’il choisisse l’adresse la plus précise.

• N’utilisez pas cette API pour déterminer la disponibilité d’une adresse à la livraison. FedEx ne propose pas de service de livraison pour certaines adresses valides. FedEx ne livre pas à des boîtes postales (sauf via FedEx Ground® Economy (anciennement FedEx SmartPost^®).
• Les informations renvoyées par l’adresse résolue sont fournies à titre de suggestion uniquement.
• Jusqu’à 100 adresses peuvent être vérifiées lors d’une requête.
• Les champs obligatoires varient selon les pays.

  Par exemple, pour les adresses aux États-Unis, au moins une ligne d’adresse et un code postal ou un code de ville et d’État sont requis, mais pour les adresses AUS (format d’adresse australien), le code de l’État peut être laissé vide même sans code postal.

• Le résultat de la correction d’adresse varie selon les pays/territoires.

Remarque : l’API de validation de l’adresse peut ne pas s’appliquer à certains pays. Consultez la section Pays/territoires pour lesquels l’API de validation de l’adresse est utilisable.