# 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                    |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.tousquali.fr/formations/02-import-apprenants.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.