Normalisation d'adresses postales: Validation en Python avec la BAN

Pourquoi valider les adresses postales ?

La qualité des données d'adresses est un enjeu critique pour toute entreprise opérant en France. Des adresses incorrectes entraînent des retours de courrier, des livraisons échouées et des coûts opérationnels évitables. Selon La Poste, environ 10 % des adresses dans les bases de données françaises contiennent des erreurs.

Ces erreurs se traduisent concrètement par des plis non distribués (PND) — aussi appelésNPAI (N'habite Pas à l'Adresse Indiquée) — qui plombent le taux de délivrabilité d'une campagne mailing postal et engendrent des surcoûts de réexpédition. Pour un fichier client de plusieurs dizaines de milliers de lignes, l'impact financier est rapidement significatif.

La validation d'adresses consiste à vérifier qu'une adresse existe dans un référentiel officiel et à la normaliser selon les standards postaux. En France, le référentiel de référence est la Base Adresse Nationale (BAN), qui recense plus de 26 millions d'adresses géocodées.

RNVP, validation postale, validation géographique : quelles différences ?

Ces trois notions sont souvent confondues. Il est important de les distinguer avant de choisir votre outil.

La RNVP (Restructuration, Normalisation, Validation Postale)

La RNVP est un processus certifié La Poste, défini par la norme Afnor NF Z 10-011, qui s'applique à la validation postale d'un fichier en vue d'une routage courrier. Il s'agit d'un traitement en lot qui opère sur le pavé adresse complet (lignes 2 à 6 d'une enveloppe) et repose sur le référentiel postal SNA (Service National de l'Adresse) de La Poste.

La RNVP comprend trois étapes :

1. Restructuration : analyse et reformatage du pavé adresse pour isoler le numéro, le type de voie, le libellé, le code postal et la commune.
2. Normalisation : application de la norme Afnor pour obtenir un libellé conforme au standard La Poste (abréviations, casse, longueur de ligne).
3. Validation postale : confrontation au référentiel SNA pour certifier la distribuabilité du courrier.

La RNVP est indispensable pour les campagnes mailing postal professionnelles, notamment pour bénéficier des tarifs préférentiels de La Poste. Elle inclut généralement un dédoublonnage fichier et peut débloquer une siretisation bloquée (association d'un SIRET à une adresse d'établissement) en corrigeant le pavé adresse en amont.

La validation géographique (ce que fait TrustyData)

TrustyData ne réalise pas de RNVP. Son positionnement est différent et complémentaire : il s'agit de validation géographique, basée sur la Base Adresse Nationale (BAN) et le Code Officiel Géographique (COG) de l'INSEE.

Concrètement, l'API TrustyData répond à des cas d'usage différents :

Si votre objectif est de fiabiliser la saisie adresse dans un formulaire, d'enrichir un fichier client avec des coordonnées GPS, des codes INSEE ou des données IRIS, ou de détecter les géocodages dégradés (adresse reconnue à la voie uniquement, sans numéro), TrustyData est l'outil adapté. Si vous avez besoin d'une certification RNVP pour votre routeur postal, orientez-vous vers un prestataire agréé SNA.

Le problème : intégrer la BAN soi-même

La BAN est un jeu de données open data accessible librement. Cependant, l'intégrer dans votre application implique :

• Télécharger et mettre à jour régulièrement les fichiers CSV (plusieurs gigaoctets)
• Mettre en place un moteur de recherche performant (Elasticsearch, PostgreSQL FTS…)
• Gérer la normalisation des voies, les abréviations, les fautes de frappe
• Maintenir l'infrastructure serveur associée

Pour un projet en phase de démarrage ou une PME, cette complexité est souvent disproportionnée.

La solution : une API de validation

Une API de validation d'adresses vous permet d'interroger la BAN en temps réel, sans infrastructure à maintenir. Voici comment utiliser l'API TrustyData en Python avec la bibliothèque requests :

import requests

def valider_adresse(adresse: str) -> dict:
    """Valide une adresse française via l'API TrustyData."""
    response = requests.get(
        "https://api.trustydata.fr/v1/address/verify",
        params={"q": adresse, "limit": 1},
        headers={"Authorization": "Bearer VOTRE_CLE_API"},
    )
    response.raise_for_status()
    return response.json()

# Exemple d'utilisation
resultat = valider_adresse("10 rue de la paix 75002 paris")
print(resultat)

Validation en lot (batch)

Pour traiter un fichier CSV complet, vous pouvez paralléliser les appels :

import csv
import requests
from concurrent.futures import ThreadPoolExecutor

def valider_lot(fichier_csv: str, colonne_adresse: str = "adresse"):
    """Valide toutes les adresses d'un fichier CSV."""
    with open(fichier_csv) as f:
        lignes = list(csv.DictReader(f))

    def traiter(ligne):
        resultat = valider_adresse(ligne[colonne_adresse])
        ligne["adresse_validee"] = resultat.get("label", "")
        ligne["score"] = resultat.get("score", 0)
        return ligne

    with ThreadPoolExecutor(max_workers=10) as pool:
        resultats = list(pool.map(traiter, lignes))

    return resultats

Bonnes pratiques

1. Validez à la saisie adresse : intégrez l'autocomplétion dans vos formulaires pour éviter les erreurs en amont et réduire le taux de plis non distribués dans vos envois.
2. Traitez les géocodages dégradés : mettez en place un workflow de vérification pour les adresses dont le score est compris entre 0,5 et 0,8 — la voie est reconnue mais le numéro est absent du référentiel.
3. Dédoublonnez sur les coordonnées : après validation, utilisez la latitude/longitude pour détecter les doublons dans votre fichier client avant une campagne mailing postal.
4. Anticipez la restructuration adresse : si vos données proviennent de sources hétérogènes (CRM, ERP, import manuel), nettoyez les champs avant l'appel API pour améliorer le taux de correspondance.
5. Mettez à jour régulièrement : les adresses changent (nouvelles voies, fusions de communes), revalidez vos bases périodiquement. Le référentiel BAN est mis à jour mensuellement.
6. Respectez les limites d'API : utilisez un debounce de 200 ms pour l'autocomplétion et un parallélisme raisonnable pour le batch.

Conclusion

La validation d'adresses françaises en Python est simplifiée grâce aux API basées sur la BAN. En quelques lignes de code, vous pouvez normaliser, vérifier et enrichir vos données d'adresses sans infrastructure complexe.

Rappel de positionnement : TrustyData effectue une validation géographique (BAN + COG INSEE), pas une RNVP au sens de la norme Afnor NF Z 10-011. C'est une distinction importante : si vous préparez un fichier en vue d'un routage postal certifié ou que vous devez débloquer une siretisation bloquée via un traitement RNVP, un prestataire agréé SNA sera nécessaire en complément. En revanche, pour fiabiliser la saisie adresse dans vos applications, enrichir un fichier client avec des codes INSEE et des coordonnées GPS, ou réduire le taux de NPAI / PND en corrigeant les adresses à la source, TrustyData est la solution la plus directe.

TrustyData propose un plan gratuit avec 5 000 requêtes par mois — idéal pour démarrer votre intégration et tester la qualité de vos données.