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

# JTL-Import

> Bestehende JTL-Kupons übernehmen und bei Bedarf zu den JTL-Kupons zurückkehren

## Kupons übernehmen

Unter **JTL-Import** übernimmst du deine bestehenden JTL-Kupons in das Plugin.

**1. Vorschau prüfen**

Die Vorschau zeigt, welche Kupons übernommen werden, mit Art, Rabatt, Codes und bisherigen Verwendungen. Die Vorschau schreibt nichts. Mit **Inaktive JTL-Kupons einbeziehen** übernimmst du auch inaktive Kupons.

**2. Abweichungen lesen**

Je Kupon listet die Spalte **Abweichungen zum bisherigen Verhalten** auf, was das Plugin anders rechnet als JTL (siehe unten).

**3. Importieren**

Klicke auf **Jetzt importieren**. Die übernommenen JTL-Kupons werden im selben Schritt deaktiviert, damit nicht Shop und Plugin denselben Code einlösen.

> [!TIP]
>
> Ein zweiter Import legt nichts doppelt an. Schon übernommene Kupons stehen unter **Bereits importiert** und werden übersprungen.

### Was übernommen wird

* **Gruppierung:** JTL legt bei der Massengenerierung für jeden Code einen eigenen Kupon an. Kupons mit identischen Einstellungen werden zu **einem** Kupon mit vielen Codes.
* **Felder:** Name und Übersetzungen, Rabattart und Wert, Mindestbestellwert, Verwendungen gesamt und je Kunde, Gültigkeit, Aktiv, Artikel, Hersteller und Kategorien, Kundengruppen und einzelne Kunden.
* **Verwendungen:** Die bisherigen Einlösungen gesamt und je Kunde. So bekommt kein Kunde seine Limits zurück.
* **Versandkupons** werden zu Versandkostenfrei mit Lieferländern und Zuschlägen.
* **Neukunden-Kupons** bekommen einen Code `NEUKUNDE-…` und die Einlösung **Automatisch**, wie in JTL.
* **„Ganzen Warenkorb rabattieren“** wird zu „Gilt für: alle“. Hatte der Kupon Einschränkungen, werden sie zu „Nur wenn der Warenkorb enthält“. Die Freigaben eines Versandkupons werden ebenso zu „Nur wenn der Warenkorb enthält“.
* **Kombinierbarkeit:** Standard- und Neukunden-Kupons werden nicht kombinierbar angelegt, weil JTL davon immer nur einen gleichzeitig zulässt. Versandkostenfrei bleibt kombinierbar.
* **Limit je Code:** „Verwendungen gesamt“ hängt in JTL an jedem einzelnen Kupon und wird deshalb zum Limit des jeweiligen Codes.

Ein JTL-Kupon wird nur deaktiviert, wenn sein Code im Plugin angelegt ist. Ist ein Code im Plugin schon vergeben, bleibt dieser JTL-Kupon aktiv, die übrigen Codes der Gruppe werden übernommen. Scheitert ein Kupon beim Schreiben, bleibt er mit allen Codes in JTL aktiv, und das Ergebnis nennt ihn.

### Daten aus Coupon Master

Nutzt dein Shop das Plugin „Rabatt Coupon Master“, übernimmt der Import auch dessen Zusatzdaten:

* **Gratisartikel:** der verbundene Gratisartikel, 1 Stück, automatisch. Vater- und Konfigurationsartikel werden nicht übernommen, die Vorschau weist darauf hin.
* **Kundengruppen:** zusätzliche Kundengruppen ergänzen die Kundengruppe des JTL-Kupons.
* **Länder:** Eine Länder-Beschränkung für Rabatt-Kupons gibt es im Plugin nicht. Die Vorschau nennt sie, übernommen wird sie nicht.

Banner, Badges und Fortschrittsbalken von Coupon Master ersetzt du durch die Funktionen unter [Im Shop bewerben](https://docs.dreizack-medien.de/DZM-Promo-Plus/bewerben.md).

### Abweichungen zu JTL

> [accordion] Geschützte Artikel
>
> Artikel mit dem Funktionsattribut `dzm_promo_excluded` werden nicht mehr mitrabattiert, auch nicht bei „Ganzen Warenkorb rabattieren“.

> [accordion] Einschränkungen gelten je Artikel
>
> In JTL kann ein Kupon gelten, weil ein Artikel die Kategorie und ein anderer den Hersteller erfüllt. Im Plugin muss ein Artikel alle gesetzten Einschränkungen erfüllen.

> [accordion] Grundlage für Festbeträge
>
> JTL berücksichtigt bei Festbeträgen nur Artikel- und Hersteller-Einschränkungen. Das Plugin berücksichtigt alle Einschränkungen, auch Kategorien.

> [accordion] Unterkategorien
>
> JTL berücksichtigt nur Artikel, die direkt in einer freigegebenen Kategorie liegen. Im Plugin zählen auch Artikel aus Unterkategorien.

> [accordion] Mindestbestellwert bei Festbeträgen mit Artikeln
>
> Bei Festbetrag-Kupons mit freigegebenen Artikeln oder Herstellern verlangt JTL den Mindestbestellwert zusätzlich von diesen Artikeln. Im Plugin zählt der ganze Warenkorb.

> [accordion] Verwendungen je Kunde bei mehreren Codes
>
> Gleiche JTL-Kupons werden zu einem Kupon mit mehreren Codes zusammengefasst. JTL zählt „Verwendungen je Kunde“ je Code, das Plugin je Kupon: Ein Kunde kann den Kupon dann insgesamt so oft einlösen, nicht je Code.

> [accordion] Unlesbares Datum
>
> Ist ein Gültigkeitsdatum nicht lesbar, wird der Kupon ohne dieses Datum und inaktiv übernommen. Prüfe dann die Gültigkeit und schalte ihn aktiv.

> [accordion] Kupons ohne Wert und Code-Konflikte
>
> Kupons ohne Rabattwert werden inaktiv übernommen und markiert. Gibt es einen Code schon im Plugin, wird er übersprungen und in der Vorschau durchgestrichen angezeigt.

## Zurück zu JTL-Kupons

Willst du das Plugin deaktivieren oder deinstallieren, führe vorher **Zurück zu JTL-Kupons** aus:

* Die importierten Kupons werden im Plugin deaktiviert.
* Die JTL-Kupons, die beim Import aktiv waren, werden wieder aktiviert, sofern sie noch gültig sind. Abgelaufene bleiben inaktiv.
* Optional werden die Verwendungen aus dem Plugin nach JTL übernommen (**Verwendungen aus dem Plugin nach JTL übernehmen**).
* Gibt ein Kunde danach einen dieser Codes ein, löst ihn wieder JTL ein. Das gilt für jeden Code eines inaktiven Plugin-Kupons, zu dem es einen aktiven JTL-Kupon gibt.

> [!WARNING]
>
> Ohne diesen Schritt bleiben die übernommenen JTL-Kupons nach dem Deaktivieren des Plugins inaktiv. Ihre Codes lassen sich dann nicht mehr einlösen. Die Kupon-Übersicht und der JTL-Import im Plugin weisen dich darauf hin. Deaktivierst du das Plugin trotzdem, zeigt die Plugin-Verwaltung danach eine Warnung. Aktiviere es dann wieder und führe den Schritt nach.

> [!NOTE]
>
> Beim Deaktivieren oder Deinstallieren passiert bewusst nichts automatisch an den JTL-Kupons. Eine Deaktivierung kann vorübergehend sein, und alte Kupons mit veralteten Zählerständen würden sonst unbemerkt wieder gültig.

## Neue JTL-Kupons nach dem Import

Legt jemand nach dem Import wieder einen Kupon im JTL-Backend an, löst der Shop ihn weiter selbst ein. Die Kupon-Übersicht im Plugin meldet aktive, nicht importierte JTL-Kupons und listet Codes, die Kunden eingegeben haben. Ein erneuter Import übernimmt sie.


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