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

# CSV-Import und -Export

> Kupons und Codes als CSV-Datei sichern, in Excel bearbeiten und in einen anderen Shop übertragen

## Zwei Dateien

> [card] Kupons
>
> Unter **Kupons** exportierst und importierst du ganze Kupons mit allen Einstellungen und Codes. Für Sicherungen, Massenänderungen in Excel und die Übertragung in einen anderen Shop.

> [card] Codes eines Kupons
>
> In der Code-Liste eines Kupons exportierst du seine Codes mit Links und importierst neue Codes. Mehr dazu unter [Kupons](https://docs.dreizack-medien.de/DZM-Promo-Plus/kupons.md#codes).

## Kupons exportieren

**Kupons → CSV exportieren** lädt alle Kupons als `kupons-JJJJ-MM-TT.csv`. Die Datei öffnet sich direkt in Excel.

* **Eine Zeile je Code:** Jede Zeile trägt alle Einstellungen ihres Kupons. Ein Kupon mit 500 Codes hat 500 Zeilen.
* **Spalte „Kupon“:** fasst die Zeilen eines Kupons zusammen.
* **Werte** stehen so, wie du sie im Plugin siehst: `ja`/`nein`, `Standard`, `Versandkostenfrei`, `Neukunden`, `Prozent`, `Festbetrag`, `Kaufe N, erhalte M`, `Code`, `Automatisch`, Beträge mit Dezimalkomma, Datum als `JJJJ-MM-TT HH:MM:SS`.
* **Listen** (Kategorien, Artikel, Lieferländer …) sind mit `|` getrennt.

| Bezug | steht in der Datei als |
| - | - |
| Kategorien, Hersteller, Kundengruppen | ID aus der Warenwirtschaft |
| Artikel | Artikelnummer; ohne Nummer die Artikel-ID als `#123` |
| Einzelne Kunden | Kundennummer; ohne Nummer (zum Beispiel Gastkonten) die Kunden-ID als `#123` |
| Anzeigename | je Sprache eine Spalte, zum Beispiel „Anzeigename GER“ |
| Im Shop bewerben | Spalten „Ribbon“, „Rabattbox“, „Top-Banner“ (`ja`/`nein`), „Gezeigter Code“ und je Sprache „Ribbon-Text GER“, „Box-Titel GER“, „Box-Text GER“, „Banner-Text GER“ |
| Kaufe N, erhalte M | Spalten „Kaufe“, „Erhalte“, „Höchstens rabattierte Stück“ und „Zählweise“ mit `über alle`, `je Artikel` oder `je Artikel, Varianten zusammen`; der Rabatt auf die erhaltenen Stücke steht in „Wert“ |
| Darstellung der Rabattbox | Spalte „Box-Darstellung“ mit `Abriss-Coupon`, `Kompakter Kasten` oder `Clip-Zeile`; leer = wie in den Einstellungen |
| Gratisartikel | Artikelnummer und Menge, zum Beispiel `ERDE-10:2\|KANNE-1:1` (ohne Nummer `#123:2`); dazu die Spalte „Gratisartikel-Vergabe“ mit `alle` oder `Auswahl` |

Texte dürfen mehrere Zeilen haben, zum Beispiel der Box-Text. Excel speichert sie in Anführungszeichen, das Plugin liest sie so wieder ein.

> [!NOTE]
>
> Die Spalte **Max. Einlösungen Code** ist das Limit je Code (0 = unbegrenzt) und wird beim Import gelesen, auch für vorhandene Codes, wenn du **Vorhandene Kupons überschreiben** wählst. So machst du zum Beispiel aus bestehenden Codes Einmalcodes. Die Spalte **Einlösungen Code** dient nur zur Information und wird beim Import nicht gelesen. Einlösungen lassen sich nicht per CSV setzen.

## Kupons importieren

**1. Datei wählen**

**Kupons → CSV importieren → Datei wählen** (höchstens 8 MB). Das Plugin zeigt sofort eine Vorschau, geschrieben wird noch nichts.

**2. Vorschau prüfen**

Je Kupon siehst du, was passiert: **Neu**, **Überschreiben**, **Vorhanden, übersprungen**, **Konflikt** oder **Fehler**, dazu die Zahl der Codes und alle Hinweise.

**3. Importieren**

**Importieren** schreibt die Kupons mit der Aktion „Neu“ oder „Überschreiben“.

### Vorhandene Kupons

Ob ein Kupon schon existiert, erkennt das Plugin an seinen **Codes**, nicht an der Nummer in der Spalte „Kupon“. So funktioniert der Import auch in einem anderen Shop, in dem die Kupons andere Nummern haben.

**Vorhandene Kupons überschreiben** `boolean`

**Aus (Standard):** Kupons, deren Codes es schon gibt, werden übersprungen.

**An:** Diese Kupons bekommen die Einstellungen aus der Datei, neue Codes aus der Datei werden ergänzt. Einlösungen und Codes, die nicht in der Datei stehen, bleiben erhalten.

Gehören die Codes eines Kupons aus der Datei zu mehreren Kupons im Shop, meldet die Vorschau einen **Konflikt** und der Kupon wird nicht importiert.

### Was du in Excel ändern kannst

* **Werte ändern:** Datei exportieren, Werte ändern (zum Beispiel Rabatt oder Gültigkeit), mit **Vorhandene Kupons überschreiben** importieren.
* **Neuen Kupon anlegen:** eine Zeile kopieren, in der Spalte „Kupon“ einen neuen Wert eintragen (zum Beispiel `neu1`), Name und Code ändern.
* **Codes ergänzen:** eine Zeile des Kupons kopieren und nur den Code ändern.

Unterscheiden sich die Einstellungen zwischen den Zeilen eines Kupons, gilt die erste Zeile. Die Vorschau weist darauf hin.

> [!WARNING]
>
> **Fehlende Bezüge:** Gibt es eine Kategorie, einen Hersteller, einen Artikel, eine Kundengruppe oder einen Kunden aus der Datei im Shop nicht, nennt die Vorschau ihn. Betrifft das „Gilt für“, „Nur wenn der Warenkorb enthält“, Kundengruppen oder einzelne Kunden, wird der Kupon **inaktiv** angelegt. Sonst würde aus einem eingeschränkten oder persönlichen Kupon unbemerkt ein Kupon für alle. Prüfe ihn und schalte ihn danach aktiv.

## Kupons aus dem JTL-Kuponexport

Das Plugin liest auch die Dateien aus dem CSV-Export der JTL-Kupons (Kupon-Übersicht im JTL-Backend). So übernimmst du Kupons aus einem Shop, in dem DZM Promo Plus nicht läuft.

* Kupons mit gleichen Einstellungen werden wie beim [JTL-Import](https://docs.dreizack-medien.de/DZM-Promo-Plus/jtl-import.md) zu einem Kupon mit mehreren Codes. Die Abweichungen zum JTL-Verhalten stehen in der Vorschau.
* Bisherige Einlösungen werden nicht übernommen, die Kupons in der Datei bleiben unverändert.
* Einzelne Kunden stehen im JTL-Export als Kunden-ID des Quellshops. Solche Kupons werden inaktiv angelegt, prüfe die Kunden.
* Kupons ohne Rabattwert werden nicht übernommen.

> [!TIP]
>
> Liegen die JTL-Kupons im selben Shop, nutze besser den [JTL-Import](https://docs.dreizack-medien.de/DZM-Promo-Plus/jtl-import.md). Er übernimmt auch die bisherigen Einlösungen und deaktiviert die JTL-Kupons.


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