Paramètres d'affichage

Choisissez un thème pour personnaliser l'apparence du site.

Validateur BAL

Documentation

Le Validateur BAL vérifie qu'un fichier soit conforme au format Base Adresse Locale.

Il est utilisé pour s'assurer avant la publication que toutes les adresses d'une BAL remonteront correctement dans la Base Adresse Nationale.

Il existe deux profils sur le validateur :

  • BAL 1.3 est le profil par défaut. Il assure une conformité complète avec la spécification de l'AITF.
  • BAL 1.4 est un profil qui intégre les identifiants uniques de la BAN.

Si le fichier est invalide, le validateur BAL affiche un rapport en deux parties.

Tout d'abord une validation générale sur tout le fichier qui renvoie les éléments suivants :

  • Les erreurs sont bloquantes et entraînent un rejet du fichier BAL. Il sera considéré comme non valide.
  • Les alertes n'empêchent pas la publication et le fichier BAL sera donc accepté, mais ces dernières peuvent être corrigées pour une meilleure intégrité des données.

Puis une validation ligne par ligne qui renvoie les éléments suivants :

  • Les erreurs sont bloquantes et entraînent un rejet de l'ligne concernée. La BAL publiée sera alors incomplète.
  • Les alertes n'empêchent pas la publication et l'ligne sera donc acceptée, mais les informations rattachées à l'adresse seront dégradées.

Voici le détail des erreurs et avertissements que vous pouvez rencontrer lors de la validation de votre fichier BAL suivant la spécification choisie :

BAL 1.3 (legacy)

CodeLibellé
cle_interop.structure_invalideLa clé d’interopérabilité doit contenir au moins 3 segments
cle_interop.commune_invalideClé d’interopérabilité invalide (commune)
cle_interop.numero_invalideClé d’interopérabilité invalide (numéro)
voie_nom.valeur_manquanteLe champ voie_nom ne doit pas être vide
voie_nom.trop_courtLe nom de la voie est trop court (3 caractères minimum)
voie_nom.trop_longLe nom de la voie est trop long (200 caractères maximum)
voie_nom.caractere_invalideLe champ voie_nom contient des caractères non valides
numero.valeur_manquanteLe champ numero ne doit pas être vide
numero.type_invalideLa valeur du champ numéro doit être un nombre entier
numero.trop_grandLe numéro doit être compris entre 0 et 9999 (sauf toponyme)
suffixe.debut_invalideLa valeur du champ suffixe doit commencer par un caractère alphanumérique.
suffixe.trop_longLa valeur du champ suffixe est trop longue
commune_insee.commune_invalideLe code INSEE de la commune n’est pas un code ayant existé
x.valeur_invalideLa valeur du champ x est incorrecte
y.valeur_invalideLa valeur du champ y est incorrecte
long.valeur_invalideLa valeur du champ long est incorrecte
lat.valeur_invalideLa valeur du champ lat est incorrecte
row.incoherence_numeroLe numéro ne correspond pas à la valeur présente dans la clé
row.commune_manquanteAucun code commune valide n’est renseigné
row.longlat_videsLes coordonnées long/lat ne sont pas renseignées
row.longlat_invalidesLes coordonnées long/lat sont en dehors du territoire ou invalides
row.adresse_incompleteL’adresse est incomplète (numéro ou nom de la voie non renseignés)
field.voie_nom.missingLa colonne voie_nom n’existe pas
field.numero.missingLa colonne numero n’existe pas
rows.emptyAucune ligne détecté
cle_interop.valeur_manquanteLe champ cle_interop ne doit pas être vide
cle_interop.numero_prefixe_manquantLa partie numéro de la clé d’interopérabilité doit contenir 5 caractères
cle_interop.casse_invalideLa clé d’interopérabilité doit être en minuscules
suffixe.espaces_debut_finLa valeur du champ suffixe ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
numero.contient_prefixeLa valeur du champ numéro ne doit pas être préfixée par des zéros
commune_insee.valeur_manquanteLe champ commune_insee ne doit pas être vide
commune_insee.espaces_debut_finLa valeur du champ commune_insee ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
x.separateur_decimal_invalideLe séparateur des décimales du champ x doit être le point
y.separateur_decimal_invalideLe séparateur des décimales du champ y doit être le point
long.separateur_decimal_invalideLe séparateur des décimales du champ long doit être le point
lat.separateur_decimal_invalideLe séparateur des décimales du champ lat doit être le point
date_der_maj.date_invalideDate invalide
field.commune_insee.missingLa colonne commune_insee n’existe pas
field.long.missingLa colonne long n’existe pas
field.lat.missingLa colonne lat n’existe pas
file.encoding.non_standardfile.encoding.non_standard
file.delimiter.non_standardfile.delimiter.non_standard
file.linebreak.non_standardfile.linebreak.non_standard

CodeLibellé
cle_interop.voie_invalideClé d’interopérabilité invalide (voie)
cle_interop.commune_ancienneLa commune référencée est une commune ancienne
voie_nom.casse_incorrecteLe nom de la voie est en majuscules
voie_nom.contient_tiret_basLe nom de la voie contient un caractère tiret bas
voie_nom_@@.casse_incorrecteLe nom de la voie est en majuscules [eus]
voie_nom_@@.contient_tiret_basLe nom de la voie contient un caractère tiret bas [eus]
voie_nom_@@.trop_courtLe nom de la voie est trop court (3 caractères minimum) [eus]
voie_nom_@@.trop_longLe nom de la voie est trop long (200 caractères maximum) [eus]
voie_nom_@@.caractere_invalideLe champ voie_nom contient des caractères non valides
commune_insee.commune_ancienneLe code INSEE de la commune est le code d’une commune ancienne
commune_deleguee_insee.commune_invalideLe code INSEE renseigné n’est pas un code valide ou n’a jamais existé
commune_deleguee_insee.commune_actuelle_non_delegueeLe code INSEE renseigné correspond au code d’une commune actuelle dont le chef lieu n’est pas une commune déléguée
commune_deleguee_insee.commune_ancienne_non_delegueeLe code INSEE renseigné correspond au code d’une commune ancienne qui n’a pas le statut de commune déléguée
position.enum_fuzzyLa valeur de la position a été acceptée mais n’est pas conforme à la spécification
position.valeur_invalideLa valeur du champ position est incorrecte
cad_parcelles.valeur_invalideLa valeur du champ cad_parcelles est incorrecte
cad_parcelles.pipe_debut_finLe symbole | ne doit pas être utilisé en début ou fin de chaîne
source.valeur_manquanteLe champ source ne doit pas être vide
date_der_maj.valeur_manquanteLe champ date_der_maj ne doit pas être vide
date_der_maj.date_ancienneDate trop ancienne
date_der_maj.date_futureDate dans le futur
certification_commune.valeur_invalideLa valeur du champ certification_commune est incorrecte
row.position_manquantePosition nulle
row.chef_lieu_invalideLa code INSEE de la commune courante ne correspond pas au chef lieu de la commune disparue renseignée
row.longlat_xy_incoherentsLes coordonnées long/lat et x/y ne sont pas cohérentes
field.suffixe.missingLa colonne suffixe n’existe pas
field.cle_interop.missingLa colonne cle_interop n’existe pas
field.position.missingLa colonne position n’existe pas
field.long.missingLa colonne long n’existe pas
field.lat.missingLa colonne lat n’existe pas
field.x.missingLa colonne x n’existe pas
field.y.missingLa colonne y n’existe pas
field.source.missingLa colonne source n’existe pas
field.date_der_maj.missingLa colonne date_der_maj n’existe pas
field.certification_commune.missingLa colonne certification_commune n’existe pas
cle_interop.espaces_debut_finLa valeur du champ cle_interop ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
commune_nom.espaces_debut_finLa valeur du champ commune_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
commune_deleguee_insee.espaces_debut_finLa valeur du champ commune_deleguee_insee ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
commune_deleguee_nom.espaces_debut_finLa valeur du champ commune_deleguee_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
uid_adresse.espaces_debut_finLa valeur du champ uid_adresse ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
voie_nom.espaces_debut_finLa valeur du champ voie_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
voie_nom_@@.espaces_debut_finLa valeur du champ voie_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
lieudit_complement_nom.espaces_debut_finLa valeur du champ lieudit_complement_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
lieudit_complement_nom_@@.espaces_debut_finLa valeur du champ lieudit_complement_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
numero.espaces_debut_finLa valeur du champ numero ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
position.espaces_debut_finLa valeur du champ position ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
long.espaces_debut_finLa valeur du champ long ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
lat.espaces_debut_finLa valeur du champ lat ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
x.espaces_debut_finLa valeur du champ x ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
y.espaces_debut_finLa valeur du champ y ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
cad_parcelles.espaces_debut_finLa valeur du champ cad_parcelles ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
source.espaces_debut_finLa valeur du champ source ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
date_der_maj.espaces_debut_finLa valeur du champ date_der_maj ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
uid_adresse.type_invalideLa valeur de uid_adresse n’est pas valide
uid_adresse.incoherence_ids_banLes ids ban renseignés ne sont pas cohérents

CodeLibellé
cle_interop.voie_non_renseigneeLa partie voie de la clé d’interopératibilité a été laissée à nul (0000 ou xxxx)

BAL 1.4 (defaut)

CodeLibellé
cle_interop.structure_invalideLa clé d’interopérabilité doit contenir au moins 3 segments
cle_interop.commune_invalideClé d’interopérabilité invalide (commune)
cle_interop.numero_invalideClé d’interopérabilité invalide (numéro)
voie_nom.valeur_manquanteLe champ voie_nom ne doit pas être vide
voie_nom.trop_courtLe nom de la voie est trop court (3 caractères minimum)
voie_nom.trop_longLe nom de la voie est trop long (200 caractères maximum)
voie_nom.caractere_invalideLe champ voie_nom contient des caractères non valides
numero.valeur_manquanteLe champ numero ne doit pas être vide
numero.type_invalideLa valeur du champ numéro doit être un nombre entier
numero.trop_grandLe numéro doit être compris entre 0 et 9999 (sauf toponyme)
suffixe.debut_invalideLa valeur du champ suffixe doit commencer par un caractère alphanumérique.
suffixe.trop_longLa valeur du champ suffixe est trop longue
commune_insee.commune_invalideLe code INSEE de la commune n’est pas un code ayant existé
x.valeur_invalideLa valeur du champ x est incorrecte
y.valeur_invalideLa valeur du champ y est incorrecte
long.valeur_invalideLa valeur du champ long est incorrecte
lat.valeur_invalideLa valeur du champ lat est incorrecte
row.incoherence_numeroLe numéro ne correspond pas à la valeur présente dans la clé
row.commune_manquanteAucun code commune valide n’est renseigné
row.longlat_videsLes coordonnées long/lat ne sont pas renseignées
row.longlat_invalidesLes coordonnées long/lat sont en dehors du territoire ou invalides
row.adresse_incompleteL’adresse est incomplète (numéro ou nom de la voie non renseignés)
field.voie_nom.missingLa colonne voie_nom n’existe pas
field.numero.missingLa colonne numero n’existe pas
rows.emptyAucune ligne détecté
cle_interop.valeur_manquanteLe champ cle_interop ne doit pas être vide
cle_interop.numero_prefixe_manquantLa partie numéro de la clé d’interopérabilité doit contenir 5 caractères
cle_interop.casse_invalideLa clé d’interopérabilité doit être en minuscules
suffixe.espaces_debut_finLa valeur du champ suffixe ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
numero.contient_prefixeLa valeur du champ numéro ne doit pas être préfixée par des zéros
commune_insee.valeur_manquanteLe champ commune_insee ne doit pas être vide
commune_insee.espaces_debut_finLa valeur du champ commune_insee ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
x.separateur_decimal_invalideLe séparateur des décimales du champ x doit être le point
y.separateur_decimal_invalideLe séparateur des décimales du champ y doit être le point
long.separateur_decimal_invalideLe séparateur des décimales du champ long doit être le point
lat.separateur_decimal_invalideLe séparateur des décimales du champ lat doit être le point
date_der_maj.date_invalideDate invalide
field.commune_insee.missingLa colonne commune_insee n’existe pas
field.long.missingLa colonne long n’existe pas
field.lat.missingLa colonne lat n’existe pas
file.encoding.non_standardfile.encoding.non_standard
file.delimiter.non_standardfile.delimiter.non_standard
file.linebreak.non_standardfile.linebreak.non_standard
id_ban_commune.type_invalideLa valeur de id_ban_commune n’est pas un uuidv4 valide
id_ban_toponyme.type_invalideLa valeur de id_ban_toponyme n’est pas un uuidv4 valide
id_ban_adresse.type_invalideLa valeur de id_ban_adresse n’est pas un uuidv4 valide
row.incoherence_ids_banLes ids ban renseignés ne sont pas cohérents
row.id_ban_adresses_requiredid_ban_adresses est requis les ids ban et le numero sont renseigné
rows.ids_required_everyLes ids ban sont requis pour toutes les lignes si ils sont utlisés

CodeLibellé
cle_interop.voie_invalideClé d’interopérabilité invalide (voie)
cle_interop.commune_ancienneLa commune référencée est une commune ancienne
voie_nom.casse_incorrecteLe nom de la voie est en majuscules
voie_nom.contient_tiret_basLe nom de la voie contient un caractère tiret bas
voie_nom_@@.casse_incorrecteLe nom de la voie est en majuscules [eus]
voie_nom_@@.contient_tiret_basLe nom de la voie contient un caractère tiret bas [eus]
voie_nom_@@.trop_courtLe nom de la voie est trop court (3 caractères minimum) [eus]
voie_nom_@@.trop_longLe nom de la voie est trop long (200 caractères maximum) [eus]
voie_nom_@@.caractere_invalideLe champ voie_nom contient des caractères non valides
commune_insee.commune_ancienneLe code INSEE de la commune est le code d’une commune ancienne
commune_deleguee_insee.commune_invalideLe code INSEE renseigné n’est pas un code valide ou n’a jamais existé
commune_deleguee_insee.commune_actuelle_non_delegueeLe code INSEE renseigné correspond au code d’une commune actuelle dont le chef lieu n’est pas une commune déléguée
commune_deleguee_insee.commune_ancienne_non_delegueeLe code INSEE renseigné correspond au code d’une commune ancienne qui n’a pas le statut de commune déléguée
position.enum_fuzzyLa valeur de la position a été acceptée mais n’est pas conforme à la spécification
position.valeur_invalideLa valeur du champ position est incorrecte
cad_parcelles.valeur_invalideLa valeur du champ cad_parcelles est incorrecte
cad_parcelles.pipe_debut_finLe symbole | ne doit pas être utilisé en début ou fin de chaîne
source.valeur_manquanteLe champ source ne doit pas être vide
date_der_maj.valeur_manquanteLe champ date_der_maj ne doit pas être vide
date_der_maj.date_ancienneDate trop ancienne
date_der_maj.date_futureDate dans le futur
certification_commune.valeur_invalideLa valeur du champ certification_commune est incorrecte
row.position_manquantePosition nulle
row.chef_lieu_invalideLa code INSEE de la commune courante ne correspond pas au chef lieu de la commune disparue renseignée
row.longlat_xy_incoherentsLes coordonnées long/lat et x/y ne sont pas cohérentes
field.suffixe.missingLa colonne suffixe n’existe pas
field.cle_interop.missingLa colonne cle_interop n’existe pas
field.position.missingLa colonne position n’existe pas
field.long.missingLa colonne long n’existe pas
field.lat.missingLa colonne lat n’existe pas
field.x.missingLa colonne x n’existe pas
field.y.missingLa colonne y n’existe pas
field.source.missingLa colonne source n’existe pas
field.date_der_maj.missingLa colonne date_der_maj n’existe pas
field.certification_commune.missingLa colonne certification_commune n’existe pas
cle_interop.espaces_debut_finLa valeur du champ cle_interop ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
commune_nom.espaces_debut_finLa valeur du champ commune_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
commune_deleguee_insee.espaces_debut_finLa valeur du champ commune_deleguee_insee ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
commune_deleguee_nom.espaces_debut_finLa valeur du champ commune_deleguee_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
uid_adresse.espaces_debut_finLa valeur du champ uid_adresse ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
voie_nom.espaces_debut_finLa valeur du champ voie_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
voie_nom_@@.espaces_debut_finLa valeur du champ voie_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
lieudit_complement_nom.espaces_debut_finLa valeur du champ lieudit_complement_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
lieudit_complement_nom_@@.espaces_debut_finLa valeur du champ lieudit_complement_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
numero.espaces_debut_finLa valeur du champ numero ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
position.espaces_debut_finLa valeur du champ position ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
long.espaces_debut_finLa valeur du champ long ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
lat.espaces_debut_finLa valeur du champ lat ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
x.espaces_debut_finLa valeur du champ x ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
y.espaces_debut_finLa valeur du champ y ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
cad_parcelles.espaces_debut_finLa valeur du champ cad_parcelles ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
source.espaces_debut_finLa valeur du champ source ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
date_der_maj.espaces_debut_finLa valeur du champ date_der_maj ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère
uid_adresse.type_invalideLa valeur de uid_adresse n’est pas valide
uid_adresse.incoherence_ids_banLes ids ban renseignés ne sont pas cohérents
field.id_ban_commune.missingLa colonne id_ban_commune n’existe pas
field.id_ban_toponyme.missingLa colonne id_ban_toponyme n’existe pas
field.id_ban_adresse.missingLa colonne id_ban_adresse n’existe pas
uid_adresse.type_invalideLa valeur de uid_adresse n’est pas valide
uid_adresse.incoherence_ids_banLes ids ban renseignés ne sont pas cohérents

CodeLibellé
cle_interop.voie_non_renseigneeLa partie voie de la clé d’interopératibilité a été laissée à nul (0000 ou xxxx)

Télécharger le validateur

Pour une utilisation avancée, vous pouvez télécharger le validateur sur cette page.