Le fichier FINESS en CSV, la CCAM, la CIM-10 et les médicaments en fichiers propres

referentiels-sante télécharge les référentiels publics de la santé à leur source officielle et les convertit en CSV et en JSON, lisibles dans Excel, une base de données ou un script. L'outil est libre, gratuit et tient en une commande.

npx referentiels-sante finess

Cette commande récupère le flux FINESS+ du jour et écrit dans le dossier data/finess les 174 714 établissements sanitaires, sociaux et médico-sociaux (dont 104 777 en activité), les entités juridiques et les groupements hospitaliers de territoire.

Obtenir FINESS en CSV sous Windows, pas à pas

Pas besoin d'être développeur. Il faut un poste avec un accès à internet et environ dix minutes la première fois.

1. Installez Node.js, version 22 ou plus récente (la version « LTS » proposée par le site convient).
2. Créez un dossier de travail, par exemple C:\referentiels, ouvrez-le dans l'Explorateur, puis tapez powershell dans la barre d'adresse et validez.
3. Dans la fenêtre qui s'ouvre, tapez la commande suivante. À la première utilisation, npx demande l'autorisation d'installer l'outil : répondez y.

   npx referentiels-sante finess

   Si PowerShell répond que l'exécution de scripts est désactivée, utilisez plutôt :

   npx.cmd referentiels-sante finess

4. Au bout d'une minute environ, le temps de télécharger 50 Mo et de les convertir, ouvrez data\finess\etablissements.csv dans Excel. Le fichier est en UTF-8 avec séparateur point-virgule : dans un Excel en français, les accents et les colonnes s'affichent directement.

Ce que contient le dossier data/finess

Chaque colonne est rattachée au champ FINESS+ dont elle provient dans le dictionnaire des colonnes. Les libellés (catégorie d'établissement, statut juridique, département) viennent des nomenclatures officielles de l'Agence du Numérique en Santé.

Les autres référentiels

Chaque commande se lance de la même façon : npx referentiels-sante ccam, npx referentiels-sante cim10 --edition 2025, et ainsi de suite. npx referentiels-sante ccam --date 2025-06-30 donne la CCAM telle qu'elle était à cette date. La NGAP n'est pas couverte : l'Assurance Maladie ne la publie qu'en PDF.

Anomalies connues dans FINESS+

L'outil recopie la source sans la corriger. Deux défauts de FINESS+ sont signalés à l'ANS et restaient présents dans le fichier du 14 septembre 2026 :

• Dans 1 364 adresses d'établissements, la séquence « TH » a été remplacée par « E » : « rue de la Catherinette » est devenue « Caeerinette », « Thoiry » est devenu « Eoiry ». Ticket de l'ANS.
• Pour une partie des adresses, les coordonnées projetées et géographiques sont inversées. Ticket de l'ANS. Les colonnes latitude et longitude sont à contrôler avant un usage cartographique.

La comparaison complète avec l'ancienne extraction, champ par champ, est détaillée dans la documentation FINESS.

Questions fréquentes

Je cherche un fichier finess.csv : pourquoi ne plus le trouver sur data.gouv.fr ?

L'extraction FINESS diffusée en CSV sur data.gouv.fr n'est plus mise à jour : ses dernières données datent du 4 mai 2026. Depuis le 20 juillet 2026, FINESS est publié par l'Agence du Numérique en Santé sous le nom FINESS+, en JSON. referentiels-sante reconstruit un CSV à partir de ce nouveau flux, y compris au format de l'ancien fichier.

Les données sont-elles à jour ?

Pour FINESS+, oui : chaque exécution télécharge le flux du jour, et le fichier structures-resume.json indique la date exacte des données. Pour la CCAM, la page de téléchargement de l'Assurance Maladie est lue à chaque exécution. Pour la CIM-10 et les tarifs GHS, l'outil connaît les éditions publiées à la date de sa version, aujourd'hui la CIM-10 FR 2025 et les tarifs 2026.

Puis-je réutiliser les fichiers produits ?

FINESS+ et la base publique des médicaments sont publiés sous Licence Ouverte : la réutilisation est libre, en citant la source et la date. Les autres référentiels ont leurs propres conditions, détaillées dans la page des sources et licences. L'outil ne redistribue aucune donnée : il la télécharge à la source au moment où vous le lancez.

Faut-il des droits d'administrateur ?

Pour installer Node.js sur Windows, en général oui. Une fois Node.js présent, l'outil lui-même ne demande aucun droit particulier et n'installe aucune autre dépendance.

Combien de temps et de mémoire faut-il ?

Mesures sur un poste de travail :

Et si une source change de format ?

Les sources sont des pages web, pas des interfaces stables. Une vérification automatique tourne chaque semaine : elle contrôle que chaque page et chaque fichier répondent encore, et ouvre un ticket sur le dépôt en cas de problème. Vous pouvez la lancer vous-même avec npx referentiels-sante verifier.

Pour les développeurs

Le paquet s'utilise aussi comme bibliothèque Node.js. Il expose les convertisseurs et un lecteur JSON en flux qui parcourt les 751 Mo de FINESS+ objet par objet, sans charger le fichier en mémoire.

import { finess, nos, lireCollection } from 'referentiels-sante';

for await (const entite of lireCollection('finess-structures.json.gz', 'pmej')) {
  console.log(entite.informationsGeneralesPMEJ.numFinessPm, entite.ege.length);
}

const categories = await nos.chargerTable('TRE_R66-CategorieEtablissement');
nos.indexLibelles(categories).get('355'); // 'Centre hospitalier (CH)'

Code sous licence MIT, 46 tests, testé sur Linux et Windows avec Node.js 22, 24 et 26. Les signalements d'écarts, les référentiels manquants et les contributions sont bienvenus sur GitHub.