---
title: "Synchronisation FINESS — Documentation Fonctionnelle"
module: sante
type: functional
status: active
updated: 2026-05-06
---

# Synchronisation FINESS — Documentation Fonctionnelle

> Importez automatiquement les établissements médico-sociaux depuis la base nationale FINESS vers vos clients ISI-App.

---

## Vue d'ensemble

La synchronisation FINESS permet aux utilisateurs disposant du module Santé de rapprocher automatiquement les données officielles de la base nationale FINESS (établissements, adresses, numéros d'activité) avec les entités déjà présentes dans leur compte ISI-App. L'outil analyse les établissements liés à vos organismes gestionnaires et détecte ceux qui ne sont pas encore enregistrés, afin de vous proposer de les créer en un seul clic.

---

## Accès

- **Menu :** Module Santé > FINESS
- **Module requis :** Santé
- **Droit requis :** Droit de gestion FINESS (code 85110101)
- **Abonnement actif obligatoire**

---

## Fonctionnalités principales

### Trois types de données synchronisées

La page de synchronisation est organisée en trois sections distinctes :

1. **Entités** — Établissements FINESS dont l'entité cliente n'existe pas encore dans ISI-App. Le système compare automatiquement les noms et les numéros SIRET pour éviter les doublons.

2. **Adresses** — Établissements dont l'adresse est absente. L'outil pré-sélectionne automatiquement l'entité la plus proche et convertit les formats d'adresse CEDEX et les abréviations de voie (AV → AVENUE, BD → BOULEVARD, etc.).

3. **Numéros FINESS** — Établissements dont le numéro d'activité médico-sociale (FINESS) n'est pas encore rattaché à une entité cliente.

### Création unitaire ou en masse

Pour chaque élément détecté, l'utilisateur peut :

- **Créer individuellement** via la fiche de l'établissement, avec possibilité de modifier le type juridique ou le secteur avant validation.
- **Créer en masse** en sélectionnant plusieurs établissements et en appliquant des paramètres communs (type juridique, entité de rattachement, adresse).

### Ignorer des éléments

Si un établissement détecté ne doit pas être importé, l'utilisateur peut l'**ignorer** (unitairement ou en sélection multiple). Les éléments ignorés sont déplacés dans une section dédiée et peuvent être **réactivés** à tout moment pour les recréer ultérieurement.

### Correspondance automatique

Lors de la suggestion d'une adresse ou d'un numéro FINESS, le système tente de pré-sélectionner l'entité cliente la plus proche en comparant le SIRET et la similarité du nom. Cette correspondance est modifiable par l'utilisateur avant validation.

---

## Comportements notables

- Les doublons de SIRET au sein d'une même sélection sont détectés et signalés avant création.
- Chaque création s'effectue dans une transaction indépendante : en cas d'erreur sur l'un des éléments, les autres sont tout de même créés.
- La page se rafraîchit automatiquement après chaque action (création ou ignorance).

---

## Tableau des activités MS (FINESS)

Le tableau des activités MS affiche pour chaque enregistrement un **badge de statut** sur le numéro FINESS :

| Badge | Couleur | Signification |
|-------|---------|---------------|
| ✓ | Vert | Numéro trouvé dans la base nationale FINESS |
| ? | Orange | Format valide mais introuvable en base nationale |
| ✗ | Rouge | Format invalide (9 chiffres attendus) |

---

## Fiche activité MS (mod 851101)

La fiche d'une activité MS (établissement médico-social) embarque plusieurs comportements spécifiques :

### Validation du FINESS en temps réel

Un composant Livewire `FinessValidator` est intégré en tête de fiche. Il indique immédiatement :
- Si le numéro FINESS est absent (alerte orange)
- Si le format est invalide (alerte rouge, 9 chiffres attendus)
- Si le numéro est introuvable dans la base nationale FINESS (alerte orange)
- Si le numéro est valide et reconnu (alerte verte avec le nom de l'établissement, sa catégorie et sa ville)

Le composant se met à jour automatiquement après chaque sauvegarde du formulaire.

### Actions disponibles

- **Vérifier le FINESS** — ouvre la fiche officielle sur `finess.esante.gouv.fr` (visible uniquement si un numéro FINESS est renseigné).
- **Transférer le FINESS** — permet de déplacer l'activité vers une autre entité/adresse au sein du même compte.

---

## Voir aussi

- Documentation technique : `.claude/technical-docs/sante/finess-synchronisation.md`
