Zum Inhalt
Neu: 3 GARAN-Labels kostenlos, ohne AnmeldungJetzt erstellen
EU-Gewährleistungs-
und GARAN Label
AnleitungStand 9. Oktober 20264 Min. Lesezeit

EU-Gewährleistungslabel in JTL-Shop einbinden

Das amtliche EU-Gewährleistungslabel in wenigen Minuten in Ihrem JTL-Shop, mit dem kostenlosen Widget.

Im JTL-Shop 5 setzen Sie das Gewährleistungslabel für alle Artikel über das Child-Template der Artikeldetailseite ein. Für einzelne Artikel geht auch der OnPage Composer mit einem Text-Portlet in der Quellcode-Ansicht.

Neu seit JTL-Shop 5.8: JTL-Shop bringt beide Labels mit. Sie schalten sie unter Darstellung → Einstellungen → Global im Bereich „Gewährleistungs- und Garantielabel“ ein. Das Gewährleistungslabel zeigt JTL in der Bestellübersicht, auf der Seite „Gesetzliche Gewährleistung“ im Fußbereich und als PDF an der Bestellbestätigung, laut JTL aber nicht auf der Artikeldetailseite. Dafür ist das Widget gedacht. Das GARAN-Label liest JTL aus den Wawi-Funktionsattributen jtl_guarantee_manufacturer, jtl_guarantee_model_identifier und jtl_guarantee_years.

Der Code für JTL-Shop

<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>

Weitere Optionen wie Darstellung und Sprache stellen Sie im Code-Baukasten ein.

Schritt für Schritt in JTL-Shop

  1. Child-Template nutzen
    Änderungen gehören in ein Child-Template (bei NOVA: NOVAChild), damit Updates sie nicht überschreiben.
  2. Vorlage erweitern
    Im Child-Template die Vorlage der Artikeldetailseite erweitern und den Widget-Code unter den Warenkorb-Knopf setzen. Das gilt dann für alle Artikel.
  3. Einzelner Artikel
    Nur für einen Artikel: im OnPage Composer ein Text-Portlet unter den Warenkorb-Knopf ziehen und den Code in der Quellcode-Ansicht einsetzen. Der OnPage Composer bearbeitet jede Seite einzeln.
  4. Prüfen
    Cache leeren bzw. Entwurf veröffentlichen und auf einem Artikel prüfen.

Besonderheiten in JTL-Shop

Wo der Hinweis im JTL-Shop hingehört

Die Artikeldetailseite baut das NOVA-Template aus productdetails/details.tpl auf. Den Kaufbereich bindet dort der Block productdetails-details-include-basket ein. Der Warenkorb-Knopf selbst steht in productdetails/basket.tpl im Block productdetails-basket-add-to-cart. Im Child-Template legen Sie die Datei mit demselben Pfad an und ergänzen den Block mit append oder prepend. So bleibt der Original-Inhalt erhalten, und der Kaufbereich ändert sich nicht.

Ab JTL-Shop 5.8 bringt der Shop beide Labels selbst mit. Sie schalten sie unter Darstellung → Einstellungen → Global im Bereich „Gewährleistungs- und Garantielabel“ ein. Das Gewährleistungs-Label zeigt JTL dann in der Bestellübersicht und auf der Seite „Gesetzliche Gewährleistung“. Diese Seite ergänzt JTL automatisch im Fußbereich „Gesetzliche Informationen“, der Linkgruppe mit dem Template-Namen „Fuss“. Die Artikeldetailseite nennt JTL für das Gewährleistungs-Label nicht. Dort ergänzt das Widget den Hinweis.

Kindartikel, Funktionsattribute und GARAN-Label

JTL-Wawi unterscheidet Variationsartikel und Kindartikel (früher Variationskombinationen). Variationen ohne Kindartikel sind keine eigenständigen Artikel, viele Einstellungen lassen sich dort nicht je Variation vornehmen. Kindartikel sind dagegen eigene Artikel. Sie erben vom Vaterartikel zum Beispiel Attribute und Merkmale, lassen sich aber wie gewöhnliche Artikel pflegen.

Das eingebaute Garantie-Label (GARAN-Label) liest drei Funktionsattribute aus JTL-Wawi: jtl_guarantee_manufacturer für den Hersteller, jtl_guarantee_model_identifier für die Modellkennung und jtl_guarantee_years für die Dauer in Jahren. Ab JTL-Wawi 2.1 sind sie schon angelegt, sie müssen aber für den Onlineshop aktiviert sein. Fehlt einer der drei Werte, zeigt der Shop für diesen Artikel kein Garantie-Label. Haben Kindartikel eigene Modellkennungen, tragen Sie jtl_guarantee_model_identifier am jeweiligen Kindartikel ein.

Wo das Label erscheint, stellen Sie einzeln ein: Artikelliste, Artikeldetailseite, Warenkorb, Bestellübersicht und Bestellbestätigung. Auf der Artikeldetailseite steht es unter Artikelnummer, GTIN, Kategorie und Hersteller. Nutzen Sie das eingebaute Garantie-Label, lassen Sie data-garan-voll und data-garan-klein im Widget weg, sonst erscheint das Label doppelt.

Typische Stolpersteine im JTL-Shop

Weitere Quellen

Gewährleistungslabel in der Bestellbestätigung

Laut Leitlinien der Kommission soll der Hinweis auch in der Bestätigungs-E-Mail stehen. E-Mail-Vorlagen pflegen Sie im JTL-Shop-Backend unter den E-Mail-Vorlagen. In der Bestellbestätigung lässt sich die amtliche Grafik als Bild ergänzen. Ein bloßer Link reicht als dauerhafter Datenträger voraussichtlich nicht (EuGH, Rs. C-49/11); am sichersten steht der Hinweis als Bild, Text oder Anhang direkt in der Mail. Die amtlichen Dateien finden Sie im Download.

Herstellergarantie? Dann gehört das GARAN-Label dazu

Gibt der Hersteller eine kostenlose Haltbarkeitsgarantie von mehr als zwei Jahren auf die ganze Ware, gehört zusätzlich das GARAN-Label auf die Produktseite. Mit dem GARAN-Label-Generator erstellen Sie es in Sekunden aus Jahren, Marke und Modell, die ersten drei kostenlos und ohne Anmeldung. Unter jedem fertigen Label steht ein Einbett-Code mit dauerhaften Bild-Adressen: Sie laden nichts hoch und setzen ihn wie oben in JTL-Shop ein.

Lieber eigene Dateien? Dann laden Sie die vollständige und die geschachtelte Fassung in die Medienverwaltung von JTL-Shop und tragen die Adressen im Widget-Code ein:

<div data-garantielabel
  data-garan-voll="https://…/GARAN-MX-500.svg"
  data-garan-klein="https://…/GARAN-MX-500-geschachtelt.svg"></div>

Das Widget zeigt dann die geschachtelte Fassung unter dem Gewährleistungslabel, ein Klick öffnet das vollständige GARAN-Label.

Häufige Fragen

Geht das auch mit JTL-Wawi-Daten?

Ja. Wer die Adressen der GARAN-Labels als Artikelattribut pflegt und im Template in data-garan-voll und data-garan-klein ausgibt, zeigt je Artikel das passende Label.

Brauche ich ein Plugin?

Nein. Das Child-Template reicht. Ein HTML-Portlet gibt es nur als Plugin aus dem Extension Store, nötig ist es nicht.

Wird das bei Updates überschrieben?

Nein, wenn die Änderung im Child-Template steht. Inhalte aus dem OnPage Composer bleiben ebenfalls erhalten.

Zeigt JTL-Shop 5.8 die Labels von selbst?

Ja, nach dem Einschalten unter Darstellung → Einstellungen → Global. Standardmäßig sind beide aus. Das Gewährleistungs-Label erscheint dann in der Bestellübersicht und auf der Seite „Gesetzliche Gewährleistung“, das Garantie-Label an den Stellen, die Sie wählen.

Warum fehlt das Garantie-Label bei einem Artikel?

Meist fehlt einer der Werte jtl_guarantee_manufacturer, jtl_guarantee_model_identifier oder jtl_guarantee_years, oder der Onlineshop-Abgleich steht noch aus. Prüfen Sie auch, ob die Funktionsattribute für den Onlineshop aktiviert sind.

In welchen Block setze ich das Widget?

Zum Beispiel mit append an den Block productdetails-details-include-basket in productdetails/details.tpl des Child-Templates. Dann steht es direkt hinter dem Kaufbereich.

GARAN‑Label erstellen, Gewährleistungslabel einbinden.

Der Generator erstellt GARAN-Labels in Sekunden, die ersten 3 sind kostenlos. Für Shopify bindet die App beide Labels automatisch ein.