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

# CSV-Format

> So bereiten Sie die CSV-Datei für die Bulk-Erstellung vor: erforderliche Kopfzeile, Zeilen, URL-Regeln und Validierungsfehler.

Die Bulk-Erstellung liest eine einfache CSV-Datei: eine Kopfzeile, dann eine Zeile pro QR-Code mit einem Namen und einer Ziel-URL. Diese Seite listet die Regeln auf, die GetQR beim Hochladen prüft.

## Beispieldatei

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

Sie können diese Vorlage auch in der App herunterladen: Klicken Sie im Schritt **Add links** auf **Download CSV template**.

## Regeln

| Teil | Regel |
| - | - |
| Datei | Muss eine `.csv`-Datei sein. Excel- und andere Formate werden nicht akzeptiert. |
| Kopfzeile | Die erste Zeile muss genau `name,url` lauten: kleingeschrieben, in dieser Reihenfolge, ohne weitere Spalten. |
| Zeilen | Bis zu 100 nicht leere Zeilen. Leere Zeilen werden ignoriert. |
| `name` | Erforderlich. Wird zum Namen des QR-Codes. Bis zu 40 Zeichen; längere Namen werden auf 40 gekürzt. |
| `url` | Erforderlich. Eine Webadresse, die mit `http://` oder `https://` beginnt. |

### URL-Regeln

* Wenn Sie das Schema weglassen, ergänzt GetQR `https://`. Aus `example.com/menu` wird `https://example.com/menu`.
* Die Adresse muss eine echte Domain mit Punkt enthalten, z. B. `example.com`.
* Keine Leerzeichen, Tabulatoren oder Zeilenumbrüche.
* Nur Weblinks funktionieren. `mailto:`, `ftp://`, `javascript:` und reine E-Mail-Adressen werden abgelehnt.

### Doppelte Namen

Namen müssen nicht eindeutig sein. Haben zwei Zeilen denselben Namen (ohne Berücksichtigung der Groß- und Kleinschreibung), nummeriert GetQR die Wiederholungen: `Menu`, `Menu 2`, `Menu 3`.

### Kommas und Anführungszeichen

Enthält ein Name ein Komma, setzen Sie ihn in doppelte Anführungszeichen, wie in `"Downtown, Main St"`. Tabellenkalkulationen erledigen das beim Speichern als CSV automatisch.

## Die Datei in einer Tabellenkalkulation erstellen

**1. Zwei Spalten anlegen**

Geben Sie in der ersten Zeile `name` in Spalte A und `url` in Spalte B ein.

**2. Eine Zeile pro Code hinzufügen**

Tragen Sie in jede Zeile einen Namen und einen Link ein, bis zu 100 Zeilen.

**3. Als CSV speichern**

Exportieren oder speichern Sie die Tabelle als CSV. Wählen Sie in Excel **CSV UTF-8**. Wählen Sie in Google Sheets **File > Download > Comma-separated values**.

> [!TIP]
>
> Beim Speichern als UTF-8 bleiben Umlaute, Akzente und andere Sonderzeichen in Ihren Namen erhalten.

## Validierungsfehler

### Dateifehler

Diese betreffen die gesamte Datei. Korrigieren Sie die Datei und laden Sie sie erneut hoch.

| Meldung | Was zu tun ist |
| - | - |
| Choose a CSV file. Other file types are not supported. | Speichern Sie die Datei als `.csv`, nicht als `.xlsx` oder `.numbers`. |
| The CSV header must be exactly name,url in that order. | Die erste Zeile muss genau `name,url` lauten. Achten Sie auf Großbuchstaben, zusätzliche Spalten oder eine fehlende Kopfzeile. |
| Add at least one non-empty data row to the CSV. | Die Datei hat eine Kopfzeile, aber keine Zeilen. Fügen Sie mindestens einen Namen und einen Link hinzu. |
| A CSV can contain at most 100 non-empty rows. | Teilen Sie die Liste in Dateien mit bis zu 100 Zeilen auf. |
| This CSV is malformed and could not be read. | Exportieren Sie die Datei erneut aus Ihrer Tabellenkalkulation. Achten Sie auf nicht geschlossene Anführungszeichen. |

### Zeilenfehler

Diese markieren einzelne Zeilen. Sie können sie korrigieren und erneut hochladen oder nur mit den gültigen Zeilen fortfahren.

| Kennzeichnung oder Meldung | Ursache |
| - | - |
| **MISSING** / Name is required | Die Zelle `name` ist leer. |
| **MISSING** / URL is required | Die Zelle `url` ist leer. |
| **INVALID** / Enter a valid HTTP(S) URL | Der Link verstößt gegen eine der [URL-Regeln](#url-regeln). |

Bei der Zeilennummerierung zählt die Kopfzeile als Zeile 1, die erste Datenzeile ist also Zeile 2 – genau wie in Ihrer Tabellenkalkulation.

## Häufige Probleme

> **Meine Kopfzeile sieht richtig aus, aber ich erhalte trotzdem den Kopfzeilenfehler**
>
> Die Kopfzeile muss kleingeschrieben sein und darf nur zwei Spalten enthalten. `Name,URL` oder `name,url,notes` schlagen fehl. Prüfen Sie in Ihrer Tabelle auch, ob rechts von `url` leere Spalten vorhanden sind.

> **Ein Link, der in meinem Browser funktioniert, ist als INVALID markiert**
>
> Der Link enthält möglicherweise ein Leerzeichen oder verwendet ein anderes Schema als http oder https. Kodieren Sie Leerzeichen als `%20` oder entfernen Sie sie und verwenden Sie eine vollständige Webadresse.

> **Einige Namen wurden gekürzt**
>
> Namen mit mehr als 40 Zeichen werden auf 40 gekürzt. Kürzen Sie sie in der Datei selbst, wenn Sie die Formulierung bestimmen möchten.

## Wie geht es weiter?

> **[QR-Codes aus einer CSV-Datei erstellen](/de/bulk/create-from-csv)**
>
> Laden Sie Ihre Datei hoch und starten Sie den Stapel.

> **[Übersicht Bulk-Erstellung](/de/bulk/overview)**
>
> Limits und Funktionsweise der Bulk-Erstellung.


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