L’API de validation d’adresse est une solution intelligente permettant de corriger les inexactitudes dans les coordonnées des contacts et de livrer des colis de façon plus rapide et précise. Cette API met en forme de façon appropriée les renseignements saisis sur 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 concernant l’adresse du destinataire avant d’envoyer un colis.

Remarque : N’utilisez pas cette API pour déterminer si une livraison est possible à cette adresse. FedEx ne propose pas de services de livraison pour toutes les adresses valides. FedEx ne livre pas à des cases postales, sauf via FedEx Ground^MD Economy (anciennement connu sous le nom de FedEx SmartPost^MD).

L’API vous permet de valider et de résoudre les erreurs concernant l’adresse du destinataire avant d’envoyer un colis. Une adresse exacte sur l’étiquette d’expédition évitera les retards de livraison et des frais supplémentaires de rectification d’adresse (lorsqu’elle est mal rédigée).

Note :

• 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 d’adresse

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

Capacités de l’API de validation d’adresse

• Complète les adresses de destinataires partielles. Dans certains cas, l’API de validation d’adresse peut ajouter des renseignements manquants, en vérifiant les renseignements fournis par rapport aux données de référence. L’API de validation d’adresse ne peut pas ajouter de renseignements manquants secondaires (p. ex. l’appartement ou le bureau) 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. S’applique aux adresses aux États-Unis et au Canada uniquement.
• Confirme la validité et l’exhaustivité des adresses dans de nombreux pays des régions suivantes : États-Unis, Canada, Amérique latine, Europe, Moyen-Orient et Asie-Pacifique. Vous pouvez désormais valider les renseignements sur les adresses 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.
• Il est possible de vérifier jusqu’à 100 adresses par demande à l’API.

Pays/territoires qui prennent en charge l’API de validation d’adresse

Vous pouvez utiliser l’API de validation d’adresse de FedEx dans les pays ci-après pour valider et corriger les adresses de destinataires et ainsi garantir une meilleure efficacité des livraisons.

Remarque : Les renseignements renvoyés par la demande de validation d’adresse sont fournis à titre de suggestion uniquement.

Clause de non-responsabilité : Les données fournies dans ce document sont exclusives à FedEx et constituent des renseignements confidentiels, communiqués 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. Ces données reflètent la classification actuelle des adresses commerciales/résidentielles de FedEx dans la base de données d’adresses de livraison FedEx et peuvent changer. En fournissant ces renseignements, FedEx ne garantit pas leur exactitude 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 ce document. La communication de ces renseignements ne doit pas être considérée comme modifiant les conditions des rapports entre les parties. Reportez-vous au Guide des services de FedEx et à l’accord de tarification du compte applicable pour connaître les conditions et les modalités 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. Les détails de l’adresse sont fournis et doivent être validés pour que cette dernière soit résolue. Une adresse est considérée comme résolue une fois que l’adresse saisie correspond aux données de référence connues.

Voici les renseignements d’entrée requis pour cette demande :

• Lignes d’adresse
• 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 fait un envoi vers un pays qui n’utilise pas de codes postaux.

L’API de validation d’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 voies courants comme « place » et « boulevard » par leurs abréviations standard « pl. » et « boul. », ainsi que la réorganisation des éléments d’adresse. Si une adresse saisie ne peut pas être normalisée, l’adresse résolue renvoyée sera l’adresse saisie. Les valeurs ne correspondant pas à une adresse sont supprimées.
• Deuxième étape : l’API tente d’uniformiser 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 l’uniformisation, l’adresse résolue renvoyée conservera la forme normalisée de l’adresse saisie. Consultez les éléments renvoyés pour cerner les problèmes de l’adresse soumise.
• Certains éléments de cette adresse normalisée seront également renvoyés. En cas de réussite de l’uniformisation, l’adresse résolue renvoyée sera l’adresse réelle. Dans ce cas, plusieurs autres éléments de l’adresse uniformisée et des renseignements sur la manière dont elle aura été adaptée à partir de l’adresse normalisée seront également renvoyés.

Valeurs de retour de l’API de validation d’adresse

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

• L’État de l’adresse est uniformisé
• Les attributs de l’adresse résolue sont vrais
• La validation du point de livraison (DPV) est vraie
• L’adresse interpolée est fausse

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

Pour obtenir de plus amples renseignements sur les attributs d’adresse, consultez Attributs d’adresse.

Si le message client de sortie renvoyé est INTERPOLATED.STREET.ADDRESS, il est possible que l’adresse ne soit pas valide. Pour en savoir plus sur le code de message client, reportez-vous à la description des éléments du message client.

Annotations

L’API de validation d’adresse renvoie des annotations avec chaque adresse validée renvoyée. Ces annotations fournissent des renseignements 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 d’adresse utilise des données de référence pour déterminer la classification d’une adresse donnée. La classification d’une adresse fonctionnelle est effectuée indépendamment du processus de validation d’adresse et est basée sur les commentaires du personnel d’exécution, les sources de données commerciales n’étant utilisées qu’à des fins de confirmation.

L’API de validation d’adresse propose seulement quatre classifications possibles des adresses : inconnue, commerciale, résidentielle et mixte. Dans un premier temps, la classification « inconnue » est attribuée à toutes les adresses, jusqu’à ce que les règles métier de validation d’adresse déterminent que la classification doit changer. La classification « mixte » n’est affectée à un lieu que s’il s’agit d’une adresse à plusieurs locataires qui abrite des locaux à la fois commerciaux et résidentiels.

Remarque : Le service FedEx Express fournit une ligne d’adresse supplémentaire (ligne d’adresse 3) pour l’adresse du destinataire. Ces renseignements supplémentaires sur l’adresse fournissent des détails plus complets et plus exacts sur l’emplacement, ce qui améliore vos chances d’obtenir l’adresse correcte.

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

Adresse commerciale

Une adresse commerciale est une adresse servant à désigner votre principal lieu d’affaires. 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.

Une adresse commerciale 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 d'une valeur de plusieurs millions de dollars, comme ceux où sont installés certains géants de la technologie, ainsi que tout lieu entre les deux.

Adresse résidentielle

Un supplément pour livraison résidentielle s’applique aux envois à destination d’un domicile ou d’une résidence privée à l’intérieur des États-Unis, y compris aux endroits où une entreprise est exploitée depuis un domicile. Utilisez FedEx Home Delivery pour une livraison résidentielle via FedEx Ground en un jour ouvrable, selon la distance du point de destination.

Exemple :

• Presbytère
• Couvent
• Cure
• Résidents d’un immeuble à logements multiples, par exemple :
  • Immeubles d’appartements
  • Condominiums
  • Dortoirs universitaires

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

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

• Utilisez correctement les espaces : assurez-vous que les espaces se trouvent aux bons endroits et évitez les espaces inutiles.
• Utilisez la bonne orthographe : évitez les fautes d’orthographe et les 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 certaines abréviations (rte et non pas rte.).
• Fournissez des renseignements supplémentaires sur l’adresse et la rue : la saisie de renseignements supplémentaires sur l’adresse peut augmenter l’exactitude des résultats.
  • Numéro d’immeuble ou de maison – 1, 1A, 1½, Un
  • Nom de rue – avenue, George Washington, 42^e
  • Suffixe de rue – route, avenue, rte, av.
• Entrez la ville, l’État/la province ou le code postal : la saisie des trois éléments augmentera l’exactitude des résultats de l’adresse.
• Entrez la rue et l’adresse dans l’ordre : les éléments de l’adresse de rue suivent habituellement un format commençant par le numéro d’immeuble ou de maison, suivi par un élément d’orientation préalable, un nom de rue, le type/suffixe de rue, un élément d’orientation à la suite, 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 bonnes abréviations : le service postal des États-Unis et Postes Canada emploient des abréviations standard pour l’État/la province, le suffixe de rue ainsi que les désignations d’appartements/d’unités.
  • Une abréviation non standard peut engendrer des résultats insatisfaisants.
  • Si vous n’êtes pas sûr concernant une abréviation, ne l’utilisez pas.

Par exemple :

• Numéro d’immeuble ou de maison comme 1, 1A, Un
• Nom de rue comme avenue, George Washington, 42^e
• Suffixe de rue comme route, avenue, rte, av.
• Entrez la ville, l’État/la province ou le code postal : la saisie de tous les renseignements sur l’adresse augmentera l’exactitude des résultats de l’adresse. La partie du code postal+4 n’est pas nécessaire pour vérifier une adresse.
• Utilisez les bonnes abréviations : le service postal des États-Unis et le service postal d’autres pays emploient des abréviations standard pour l’État/la province, le suffixe de rue ainsi que les désignations d’appartements/d’unités. Une abréviation non standard peut engendrer des résultats insatisfaisants. Si vous n’êtes pas sûr concernant une abréviation, ne l’utilisez pas.
• Pensez à renvoyer les commentaires sur 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 si une livraison est possible à cette adresse. FedEx ne propose pas de services de livraison pour toutes les adresses valides. FedEx ne livre pas à des cases postales (sauf via FedEx Ground^MD Economy [anciennement connu sous le nom de FedEx SmartPost^MD]).
• Les renseignements renvoyés par l’adresse résolue sont fournis à titre de suggestion uniquement.
• Il est possible de vérifier jusqu’à 100 adresses par demande.
• Le nombre de champs obligatoires varie 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 au format AUS (format d’adresse australien), le code de l’État peut être laissé vide même sans code postal.

• Les résultats de la correction d’adresse peuvent varier selon les pays/territoires.

Remarque : L’API de validation d’adresse peut ne pas s’appliquer à certains pays. Consultez la section Pays/territoires qui prennent en charge l’API de validation d’adresse.