> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Format CSV

> Comment préparer le fichier CSV pour la création en masse : en-tête obligatoire, lignes, règles d'URL et erreurs de validation.

La création en masse lit un simple fichier CSV : une ligne d'en-tête, puis une ligne par code QR avec un nom et une URL de destination. Cette page liste les règles que GetQR vérifie lorsque vous l'importez.

## Fichier d'exemple

```csv bulk-qr-template.csv theme={null}
name,url
Spring Menu,https://getqr.com/spring
Store #14,https://getqr.com/store-14
Table 7,example.com/menu?table=7
"Downtown, Main St",https://example.com/stores/downtown
```

Vous pouvez aussi télécharger ce point de départ dans l'application : à l'étape **Add links**, cliquez sur **Download CSV template**.

## Règles

| Élément | Règle |
| - | - |
| Fichier | Doit être un fichier `.csv`. Les fichiers Excel et autres formats ne sont pas acceptés. |
| En-tête | La première ligne doit être exactement `name,url` : en minuscules, dans cet ordre, sans autre colonne. |
| Lignes | Jusqu'à 100 lignes non vides. Les lignes vides sont ignorées. |
| `name` | Obligatoire. Devient le nom du code QR. Jusqu'à 40 caractères ; les noms plus longs sont tronqués à 40. |
| `url` | Obligatoire. Une adresse web commençant par `http://` ou `https://`. |

### Règles d'URL

* Si vous omettez le protocole, GetQR ajoute `https://`. `example.com/menu` devient `https://example.com/menu`.
* L'adresse doit comporter un vrai domaine avec un point, comme `example.com`.
* Aucun espace, tabulation ni saut de ligne.
* Seuls les liens web fonctionnent. Les liens `mailto:`, `ftp://`, `javascript:` et les simples adresses e-mail sont refusés.

### Noms en double

Les noms n'ont pas besoin d'être uniques. Si deux lignes ont le même nom (sans tenir compte des majuscules et minuscules), GetQR numérote les doublons : `Menu`, `Menu 2`, `Menu 3`.

### Virgules et guillemets

Si un nom contient une virgule, entourez-le de guillemets droits doubles, comme dans `"Downtown, Main St"`. Les tableurs le font automatiquement lors de l'enregistrement au format CSV.

## Créer le fichier dans un tableur

**1. Créer deux colonnes**

Sur la première ligne, saisissez `name` dans la colonne A et `url` dans la colonne B.

**2. Ajouter une ligne par code**

Renseignez un nom et un lien sur chaque ligne, jusqu'à 100 lignes.

**3. Enregistrer au format CSV**

Exportez ou enregistrez la feuille au format CSV. Dans Excel, choisissez **CSV UTF-8**. Dans Google Sheets, choisissez **File > Download > Comma-separated values**.

> [!TIP]
>
> L'enregistrement en UTF-8 préserve les lettres accentuées et les autres caractères non anglais de vos noms.

## Erreurs de validation

### Erreurs de fichier

Ces erreurs bloquent l'ensemble du fichier. Corrigez le fichier et importez-le à nouveau.

| Message | Que faire |
| - | - |
| Choose a CSV file. Other file types are not supported. | Enregistrez le fichier au format `.csv`, et non `.xlsx` ou `.numbers`. |
| The CSV header must be exactly name,url in that order. | La première ligne doit être exactement `name,url`. Vérifiez les majuscules, les colonnes supplémentaires ou l'absence d'en-tête. |
| Add at least one non-empty data row to the CSV. | Le fichier a un en-tête mais aucune ligne. Ajoutez au moins un nom et un lien. |
| A CSV can contain at most 100 non-empty rows. | Divisez la liste en fichiers de 100 lignes maximum. |
| This CSV is malformed and could not be read. | Exportez à nouveau le fichier depuis votre tableur. Recherchez les guillemets non fermés. |

### Erreurs de ligne

Ces erreurs signalent des lignes individuelles. Vous pouvez les corriger et importer à nouveau le fichier, ou continuer avec les lignes valides uniquement.

| Badge ou message | Cause |
| - | - |
| **MISSING** / Name is required | La cellule `name` est vide. |
| **MISSING** / URL is required | La cellule `url` est vide. |
| **INVALID** / Enter a valid HTTP(S) URL | Le lien enfreint l'une des [règles d'URL](#règles-durl). |

La numérotation des lignes compte l'en-tête comme ligne 1 : la première ligne de données est donc la ligne 2, comme dans votre tableur.

## Problèmes courants

> **Mon en-tête semble correct mais j'obtiens toujours l'erreur d'en-tête**
>
> L'en-tête doit être en minuscules et ne contenir que deux colonnes. `Name,URL` ou `name,url,notes` échouent. Vérifiez aussi qu'il n'y a pas de colonnes vides à droite de `url` dans votre tableur.

> **Un lien qui fonctionne dans mon navigateur est marqué INVALID**
>
> Le lien contient peut-être un espace, ou utilise un protocole autre que http ou https. Encodez les espaces en `%20` ou supprimez-les, et utilisez une adresse web complète.

> **Certains noms ont été raccourcis**
>
> Les noms de plus de 40 caractères sont tronqués à 40. Raccourcissez-les dans le fichier si vous voulez choisir la formulation.

## Et ensuite

> **[Créer des codes QR à partir d'un CSV](/fr/bulk/create-from-csv)**
>
> Importez votre fichier et lancez le lot.

> **[Présentation de la création en masse](/fr/bulk/overview)**
>
> Les limites et le fonctionnement de la création en masse.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.