> For the complete documentation index, see [llms.txt](https://documentation.tousquali.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.tousquali.fr/formations/02-import-apprenants.md).

# Importer des apprenant·es via CSV

L'import CSV te permet d'ajouter rapidement plusieurs participant·es à une ou plusieurs sessions en une seule opération, à partir d'un fichier tableur.

***

## Préparer ton fichier CSV

Télécharge un template depuis TousQuali pour t'assurer que ton fichier respecte le bon format :

* **Import par session** : depuis la fiche d'une session → bouton **Importer des apprenant·es** → lien *Télécharger le template CSV*.
* **Import multi-sessions** : depuis **OF → Importer des apprenant·es** → lien *Télécharger le template CSV multi-sessions*.

### Colonnes disponibles

#### Sessions inter-entreprises (obligatoires)

| Colonne       | Description                                      |
| ------------- | ------------------------------------------------ |
| `prenom`      | Prénom de l'apprenant·e                          |
| `nom`         | Nom de famille                                   |
| `email`       | Adresse email (doit être unique dans la session) |
| `adresse`     | Adresse postale                                  |
| `code_postal` | Code postal                                      |
| `ville`       | Ville                                            |
| `prix`        | Prix de la participation (ex : `1200`)           |

#### Sessions intra-entreprises (obligatoires)

Seules `prenom`, `nom` et `email` sont obligatoires. Le prix est récupéré automatiquement depuis le tarif intra de la formation.

#### Colonnes optionnelles (toutes sessions)

| Colonne                  | Description                       |
| ------------------------ | --------------------------------- |
| `telephone`              | Numéro de téléphone               |
| `prise_en_charge`        | Mode de financement               |
| `subrogation`            | `oui` ou `non`                    |
| `structure_juridique`    | Type de structure de l'entreprise |
| `raison_sociale`         | Nom de l'entreprise               |
| `siret`                  | Numéro SIRET                      |
| `tva_intracommunautaire` | Numéro de TVA intracommunautaire  |
| `commentaire`            | Commentaire libre                 |

#### Colonne supplémentaire pour l'import multi-sessions

| Colonne       | Description                                                                        |
| ------------- | ---------------------------------------------------------------------------------- |
| `ref_session` | Référence de la session au format `S104` (S + identifiant numérique de la session) |

Le séparateur peut être `;` (point-virgule) ou `,` (virgule) — TousQuali le détecte automatiquement.

***

## Import par session

1. Depuis la fiche d'une session, clique sur **Importer des apprenant·es**.
2. Dépose ton fichier CSV ou clique pour le sélectionner.
3. Clique sur **Prévisualiser l'import**.
4. TousQuali affiche un résumé des lignes :
   * **Valides** : seront importées
   * **Doublons** : email déjà présent dans la session — ignorées
   * **Erreurs** : champ obligatoire manquant ou email invalide — à corriger dans ton fichier
5. Choisis le statut initial des participant·es (**En attente** ou **Inscription en cours**), puis clique sur **Confirmer l'import**.

***

## Import multi-sessions

Cet import te permet d'ajouter des apprenant·es dans plusieurs sessions différentes depuis un seul fichier.

1. Va dans **OF → Importer des apprenant·es**.
2. Assure-toi que ton fichier contient une colonne `ref_session` avec le format `S{id}` (ex : `S104`).
3. Dépose ton fichier et prévisualise.
4. TousQuali vérifie pour chaque ligne :
   * Que la session référencée existe et t'est accessible
   * Que les champs obligatoires sont bien remplis selon le format de la session (intra ou inter)
   * Que l'email n'est pas déjà inscrit dans cette session
5. Confirme l'import pour créer toutes les participations d'un coup.

{% hint style="info" %}
L'identifiant d'une session (`S104`) est visible sur la fiche de session et dans les listes de sessions, sous forme de badge.
{% endhint %}

***

## Résolution des erreurs courantes

| Problème                 | Cause                                                     | Solution                                                   |
| ------------------------ | --------------------------------------------------------- | ---------------------------------------------------------- |
| "Colonnes manquantes"    | Des colonnes obligatoires sont absentes du fichier        | Utilise le template téléchargeable et vérifie les en-têtes |
| "Adresse email invalide" | Le format de l'email est incorrect                        | Corrige l'email dans ton fichier                           |
| "Doublon"                | L'email est déjà inscrit dans cette session               | Supprime la ligne ou utilise une autre adresse             |
| "Session introuvable"    | La référence `ref_session` ne correspond à aucune session | Vérifie l'identifiant de la session dans TousQuali         |
| "Session inaccessible"   | Tu n'as pas les droits sur cette session                  | Contacte l'administrateur de ton espace                    |