Insel Zuschlag Manager

Voraussetzungen

Die PHP-Version richtet sich nach Ihrer Shop-Version, da JTL-Shop ab 5.7 selbst mindestens PHP 8.3 verlangt:

Quelltextgeprüft mit JTL-Shop 5.5.4, 5.6.3, 5.7.3 und 5.8.0; im laufenden Checkout getestet auf 5.7.3. Aus Sicherheitsgründen empfehlen wir die gepatchten Shop-Stände 5.5.4, 5.6.2+ bzw. 5.7.2+ (CVE-2026-54390). Versandklassen pflegen Sie in JTL-Wawi am Artikel; ohne Versandklassen nutzen Sie den klassenunabhängigen Betrag.

Installation

Aus dem JTL Extension Store

Nach dem Kauf erscheint die Erweiterung unter Plugin-Verwaltung → Meine Käufe. Domain anbinden, installieren, aktivieren; die Lizenz verwaltet der Shop.

Manuell (Direktlizenz)

Das ZIP aus Ihrer Lizenz-E-Mail in der Plugin-Verwaltung → Upload hochladen, installieren und aktivieren. Das Plugin finden Sie danach unter Plugins → Installierte Plugins → Insel Zuschlag Manager.

In drei Schritten eingerichtet

Der Zuschlag richtet sich nach der Versandklasse des Artikels. Versanddienstleister spielen für die Einrichtung keine Rolle — sie sind nur die Herkunft der mitgelieferten Postleitzahlenlisten.

1. Lizenz aktivieren

   Ohne gültige Lizenz oder Testlizenz berechnet das Plugin keine Zuschläge. Den Schlüssel (beginnt mit isz) im Reiter Lizenz eintragen und in der Übersicht kontrollieren, dass „Zuschlagsberechnung aktiv“ steht. Die kostenlose 14-Tage-Testlizenz bestellen Sie im Shop.

2. Gebiet prüfen

   Reiter Gebiete: Das mitgelieferte Gebiet „Deutsche Inseln“ ist bereits aktiv. Für die meisten Shops ist hier nichts zu tun.

3. Beträge eintragen

   Reiter Zuschläge: je Gebiet eine Zeile, je Versandklasse eine Spalte. Tragen Sie den Bruttobetrag ein, den der Kunde zusätzlich zahlt.

4. Prüfen

   Die Auflösungsvorschau unten im Reiter Zuschläge zeigt für jede Versandart, welcher Betrag herauskommt, und nennt fehlende Beträge oder inaktive Gebiete als Befund.

shop-backend · Übersicht

Gebiete

Ein Gebiet ist eine Menge von Postleitzahlen, für die ein Zuschlag gelten soll. Mitgeliefert und aktiv ist „Deutsche Inseln“ mit allen Insel-PLZ der hinterlegten DPD- und GLS-Zuschlagslisten — von Sylt und den Halligen über die Ostfriesischen Inseln bis Helgoland, Hiddensee und die Fraueninsel im Chiemsee. Die Listen einzelner Dienstleister (DPD, GLS, Hermes) liegen als deaktivierte Alternativen bei; sie brauchen Sie nur, wenn Sie je Dienstleister unterschiedliche Inseln bezuschlagen.

Eigenes Gebiet anlegen: Name und Postleitzahlen eintragen — eine Angabe je Zeile oder durch Komma getrennt, Bereiche mit Bindestrich (25980-25999) oder „bis“. Erlaubt sind nur fünfstellige deutsche PLZ. Überschneiden sich zwei Angaben, wird nichts gespeichert und das Plugin nennt die Stelle.

Aus vorhandenen Listen zusammenstellen: Die mitgelieferten Listen werden bei Updates abgeglichen und lassen sich deshalb nicht direkt bearbeiten. Stattdessen erzeugen Sie aus einer oder mehreren Listen ein eigenes Gebiet; überlappende und benachbarte PLZ werden zusammengefasst. Das Ergebnis gehört Ihnen und wird von Updates nie verändert. Deaktivieren Sie danach die Ausgangslisten, damit kein höherer Betrag einer anderen Regel Ihre Konfiguration übersteuert.

shop-backend · Gebiet anlegen

Zuschläge

• Beträge sind Bruttobeträge inklusive Umsatzsteuer; die Umrechnung auf netto erledigt das Plugin passend zur Steuereinstellung der jeweiligen Versandart.
• Ein leeres Feld heißt: Der Standardbetrag der Spalte „klassenunabhängig“ gilt, falls vorhanden — sonst kein Zuschlag. Mit 0 verhindern Sie für diese Klasse einen Zuschlag.
• Treffen mehrere Gebiete zu, gilt der höchste berechnete Zuschlag — Gebiete werden nicht addiert.
• Der Haken aktiv schaltet ein Gebiet scharf.

Warenkörbe mit mehreren Versandklassen

Die Mischkorb-Strategie legen Sie je Gebiet fest. Beispiel: Paket 15 €, Spedition 55 €, zwei Paketartikel und ein Speditionsartikel.

shop-backend · Zuschläge

Optional: Versandarten

Standardmäßig gilt jedes Gebiet für alle Versandarten. Den Reiter Versandarten brauchen Sie nur, wenn ein Gebiet ausschließlich für bestimmte Versandarten gelten soll — etwa um „Versandkosten AT“ auszunehmen. Keine Auswahl in einer Zeile bedeutet: gilt für alle.

Wie der Zuschlag im Shop erscheint

Der Zuschlag wird im Warenkorb und im Checkout berechnet und auf die Versandkosten aufgeschlagen: Bei 8,90 € Versand und 32 € Inselzuschlag stehen 40,90 € Versandkosten im Checkout. Eine getrennte Ausweisung gibt es in dieser Version nicht — der JTL-Shop liest seine eigene Zuschlagsposition nur aus einem Betrag je Versandart, Beträge je Versandklasse lassen sich damit nicht abbilden. Version 2.0 wird die eigene Position für alle Fälle anbieten, in denen ein Betrag je Versandart ausreicht. Auf der Artikelseite erscheint der Zuschlag bewusst nicht, weil die Lieferadresse dort noch unbekannt ist.

Gibt es für die Lieferadresse genau eine Versandart, wählt das Plugin sie automatisch, damit die Versandkosten schon im Schritt „Versand- und Zahlungsart“ in der Übersicht stehen. Das Plugin liest für die Berechnung ausschließlich aus der Sitzung und verändert weder Lieferadresse noch Warenkorb.

Prüfen und Problemlösung

Damit ein Zuschlag greift, müssen vier Dinge stimmen:

1. Das Lieferland ist Deutschland.
2. Die Liefer-Postleitzahl liegt in einem aktiven Gebiet.
3. Für die Versandklasse des Artikels ist in diesem Gebiet ein Betrag eingetragen.
4. Das Gebiet ist im Reiter „Versandarten“ nicht auf andere Versandarten eingeschränkt.

„Vor Aktivierung prüfen“ bedeutet: Für diesen Dienstleister lag keine belastbare Liste vor; das Gebiet ist deaktiviert und als Vorlage gedacht. „Liste nicht abschließend“ bedeutet: Der Dienstleister bezeichnet seine Aufzählung selbst als unvollständig — fehlende Inseln ergänzen Sie als eigenes Gebiet.

Testphase, Lizenz und Updates

Kostenlose Testlizenz (0 €, keine Zahlungsdaten): 14 Tage voller Funktionsumfang, eine je Shop-Domain. Ohne gültige Lizenz werden keine Zuschläge berechnet; Gebiete und Beträge bleiben erhalten. Dank Offline-Token läuft die Berechnung auch ohne Serverkontakt weiter. Kauflizenzen laufen dauerhaft; nach Ablauf des Lizenzzeitraums endet ausschließlich der Bezug neuer Updates. Bei Updates werden Ihre eigenen Gebiete nie verändert; entfallene Postleitzahlen mitgelieferter Listen werden deaktiviert statt gelöscht und zum Prüfen angezeigt. Preise auf der Preisseite.

Änderungen (Auszug)

War diese Seite hilfreich? Feedback per E-Mail senden — wir lesen jede Rückmeldung.