> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/administration/import-collaborateurs.md).

# Comment importer des collaborateurs en masse ?

### Présentation

La fonctionnalité d'import permet d'ajouter ou de synchroniser des collaborateurs en masse à partir d'un fichier, sans avoir à les ajouter un par un.

### Fonctionnement

#### Étape 1 — Historique des traitements

Depuis l'administration des collaborateurs, accédez à la page **Import** qui liste l'historique des synchronisations précédentes.

#### Étape 2 — Choisir le type d'import

Sélectionnez le type d'opération : **ajout**, **suppression** ou **synchronisation miroir**.

#### Étape 3 — Téléverser le fichier

Téléversez le fichier Excel ou CSV contenant les collaborateurs.

#### Étape 4 — Consulter les alertes

Le système analyse le fichier et affiche un rapport d'**alertes** sur les anomalies détectées (lignes invalides, champs manquants, etc.).

#### Étape 5 — Vérifier l'analyse

Un rapport d'**analyse** détaille les opérations qui seront exécutées (créations, mises à jour, suppressions).

#### Étape 6 — Lancer l'exécution

Validez pour lancer le **runner** qui applique les opérations. Le statut est mis à jour en direct.

#### Types d'opérations

* **Ajout** (upsert) : créer de nouveaux collaborateurs ou mettre à jour les existants
* **Suppression** (delete) : retirer des collaborateurs
* **Synchronisation miroir** (mirror) : remplacer la liste complète — les collaborateurs absents du fichier sont retirés

#### Mode test (dry run)

Il est possible de lancer une simulation avant d'exécuter réellement les modifications. Le mode test affiche un rapport des opérations prévues sans les appliquer.

#### Suivi des messages

Chaque opération de synchronisation génère des messages de suivi indiquant le résultat pour chaque collaborateur (succès, erreur, etc.).

### Alternative : provisioning SCIM

Pour une synchronisation automatique et continue avec un annuaire d'entreprise (Azure Active Directory, Okta, etc.), voir l'article "Approvisionnement automatique des collaborateurs (Provisioning / SCIM)".

### Ce que l'assistant peut faire

L'assistant ne peut pas lancer un import en masse. Il peut expliquer le fonctionnement et guider vers l'interface d'administration. Avec le périmètre Administration, l'assistant peut ajouter des collaborateurs un par un.