Quelle: https://docs.printstack.de/gutscheine/codes-aus-csv-verwenden
Inhaltsverzeichnis: https://docs.printstack.de/llms.txt

# Codes aus CSV verwenden

Lade bereits erzeugte Codes als CSV-Datei hoch. Jeder Code wird nur einer Sendung zugeordnet; Rabatt und Ablaufdatum kannst du pro Code ergänzen.

Die hinterlegten Codes helfen Printstack außerdem, Einlösungen in den Bestellungen deines verbundenen Shops zu erkennen und bei der [Erfolgsmessung (Attribution)](https://docs.printstack.de/erfolgsmessung/attribution-verstehen) zu berücksichtigen.

Du benötigst eine CSV-Datei mit individuellen Codes aus deinem Shop. Lade sie hoch und bestätige die geprüfte Vorschau. Später kannst du über **Codes nachfüllen** weitere Codes ergänzen.

## CSV-Datei vorbereiten

- UTF-8, maximal 10 MB und 100.000 Datenzeilen **pro Datei**. Größere Bestände kannst du auf mehrere CSV-Dateien aufteilen und über **Codes nachfüllen** demselben Angebot hinzufügen.

- Semikolon `;`, Komma oder Tabulator als Trennzeichen
- erste Spalte `coupon` oder `code`

- optional `coupon_discount`: Rabatt in Prozent als ganze Zahl von 1 bis 100. Feste Beträge und kostenloser Versand werden per CSV nicht unterstützt; verwende dafür ein [Gutscheinangebot mit automatischer Shop-Erzeugung](https://docs.printstack.de/gutscheine/automatisch-im-shop-erstellen).
- optional `coupon_expiry`: Ablaufdatum des Codes
- Codes mit höchstens 64 Zeichen; erlaubt sind Buchstaben von A bis Z, Zahlen, Bindestriche und Unterstriche
- Datum als `JJJJ-MM-TT`, `TT.MM.JJJJ`, `TT/MM/JJJJ` oder `JJJJ/MM/TT`

**Beispieldatei:**

```csv
coupon;coupon_discount;coupon_expiry
DEMO-10-ALPHA;10;2026-12-31
DEMO-15-BETA;15;31.12.2026
```

## Ablaufdatum: optional, aber hilfreich

**Ein Ablaufdatum ist keine Pflicht.** Wenn deine Codes nicht ablaufen, reicht eine Datei mit der Spalte `coupon`:

```csv
coupon
DEMO-ALPHA
DEMO-BETA
```

Ohne `coupon_expiry` übernimmt Printstack die Codes und zeigt einen Hinweis, dass ihre Gültigkeit nicht geprüft werden kann. Ein fehlendes Datum macht einen Code im Shop nicht unbegrenzt gültig: Prüfe selbst, ob er dort noch einlösbar ist. Printstack kann Codes ohne Datumsangabe nicht wegen eines unbekannten Ablaufdatums aussortieren.

![Vier Codes ohne Ablaufdatum werden übernommen; Printstack weist auf die fehlende Gültigkeitsprüfung hin](https://docs.printstack.de/screenshots/gutscheine/csv-ohne-ablaufdatum.webp)

**Haben deine Codes ein Ablaufdatum, lade es mit hoch.** Dann kann Printstack automatisch prüfen, ob die verbleibende Gültigkeit für dein Mailing ausreicht. Das Datum wird dabei geprüft, nicht verlängert.

## Datei prüfen und übernehmen

Beginne in der Gutscheinbibliothek ein neues Angebot, vergib einen Namen und wähle **Codes aus CSV verwenden**.

Wähle die **Mindestgültigkeit nach der erwarteten Zustellung**: 30, 60, 90 oder 180 Tage. Für Codes mit Ablaufdatum rechnet Printstack zusätzlich **14 Tage für Produktion und Versand** ein. Lade anschließend deine CSV-Datei hoch.

![CSV-Gutscheinangebot anlegen, Mindestgültigkeit auswählen und die Vorschau mit übernommenen und aussortierten Codes prüfen](https://docs.printstack.de/animations/gutscheine/csv-gutscheine-hochladen.webp)

Printstack zeigt dir, welche Codes übernommen und welche aussortiert werden. **Prüfe das Ergebnis und bestätige die Übernahme.** Codes mit zu kurzer Restgültigkeit werden auch beim späteren Export nicht verwendet.

### Doppelte Codes werden automatisch aussortiert

Printstack prüft deine Codes über alle Gutscheinangebote deiner Organisation hinweg. Doppelte Codes innerhalb der Datei sowie bereits gespeicherte CSV- und automatisch erzeugte Shop-Codes werden aussortiert. Das gilt auch für bereits exportierte Codes, solange sie noch gespeichert sind. **Statische Gutscheincodes sind von dieser Prüfung ausgenommen.**

![Von 100.000 Codes werden 99.001 übernommen; 306 erreichen die Mindestgültigkeit nicht und 693 sind bereits vorhanden oder doppelt enthalten](https://docs.printstack.de/screenshots/gutscheine/csv-upload-pruefung.webp)

## Codes nachfüllen und Bestand prüfen

Printstack verwendet zuerst die ausreichend lange gültigen CSV-Codes mit dem frühesten Ablaufdatum. Jeder individuelle Code wird höchstens einer Sendung zugeordnet. Erst nach erfolgreichem Upload der Versanddatei gilt er in Printstack als übertragen; das bestätigt keine Einlösung im Shop.

Prüfe den verfügbaren Bestand in der Gutscheinbibliothek. Verwendest du dasselbe CSV-Angebot in mehreren Kampagnen, greifen diese auf einen gemeinsamen Bestand zu. Achte auf die Bestandshinweise in Printstack und fülle Codes nach, wenn sie für die anstehenden Sendungen nicht reichen. Auch unbenutzte Codes können mit der Zeit zu kurz gültig sein und dadurch für weitere Exporte wegfallen. Die [Sammlungsmenge](https://docs.printstack.de/versand-optimieren/sammlungsmenge) begrenzt den benötigten Gutscheinbestand nicht.

![CSV-Gutscheinangebot mit leerem Codebestand und der Schaltfläche Codes nachfüllen](https://docs.printstack.de/screenshots/gutscheine/csv-codes-nachfuellen.webp)

**Ausreichender Bestand für CSV-Angebote**

Für jede zu exportierende Sendung mit einem CSV-Angebot muss ein freier und ausreichend lange gültiger Code dieses Angebots vorhanden sein. Benötigen beispielsweise 600 Sendungen dasselbe CSV-Angebot, brauchst du 600 passende Codes – unabhängig von der eingestellten Sammlungsmenge. Reicht der Bestand für eines der benötigten CSV-Angebote nicht aus, wird der gesamte Export blockiert.

## Praxis: individuelle Codes selbst bereitstellen

Prüfe zuerst, ob du deinen [Shop direkt mit Printstack verbinden](https://docs.printstack.de/integrationen/shopsysteme-verbinden) kannst. Dann lässt du die Codes automatisch erstellen und musst keine CSV-Dateien vorbereiten oder nachfüllen.

Für den CSV-Weg kannst du individuelle Codes über die Gutscheinverwaltung deines Shops oder ein geeignetes Zusatztool erzeugen und exportieren. Wichtig ist, dass die Codes im Shop tatsächlich eingerichtet und einlösbar sind – eine Liste zufällig erzeugter Zeichen allein reicht nicht.

## Angebot in einer Kampagne verwenden

Ordne das fertige Angebot einer Kampagne zu. Den gemeinsamen Ablauf erklärt [Gutscheinangebot erstellen](https://docs.printstack.de/gutscheine/gutscheinangebot-erstellen#angebot-einer-kampagne-zuordnen).