Docly Documentation

Mit dem Plugin EU Gewährleistungshinweis & GARAN zeigst du in deinem Shopware-6-Shop zwei Dinge an, die ab dem 27. September 2026 für Online-Shops in der EU gelten: den gesetzlichen Gewährleistungshinweis der EU-Kommission und das GARAN-Label für Herstellergarantien, die länger als zwei Jahre laufen.

Das Plugin verwendet dafür ausschließlich die offiziellen Grafiken der EU-Kommission. Du hinterlegst die Garantiedaten einmal am Hersteller, per Regel oder am Produkt. Das Plugin prüft, welche Produkte das GARAN-Label tragen dürfen, und zeigt Hinweis und Label an den passenden Stellen im Shop an.

Gesetzlicher Hinweis und GARAN-Label

Die beiden Kennzeichen haben unterschiedliche Aufgaben. Das Plugin behandelt sie deshalb getrennt.

Der gesetzliche Hinweis hängt nicht von der Herstellergarantie ab. Auch wenn du für ein Produkt keine Garantie hinterlegst oder sie deaktivierst, wird der Hinweis weiterhin angezeigt.

Voraussetzungen

• Shopware 6.7
• Die offiziellen Grafiken sind im Plugin enthalten. Du musst nichts herunterladen.

Das Plugin unterstützt dich bei der Umsetzung, ersetzt aber keine Rechtsberatung. Ob eine Garantie die Voraussetzungen erfüllt, klärst du mit dem Hersteller und gegebenenfalls mit deiner Rechtsberatung.

Plugin aktivieren

Aktiviere das Plugin unter Erweiterungen -> Meine Erweiterungen mit dem Regler neben “EU Gewährleistungshinweis & GARAN”. Über “Konfigurieren” gelangst du direkt zu den Einstellungen.

Nach der Aktivierung findest du im Menü unter Kataloge den neuen Eintrag EU-Label-Regeln. Außerdem erhalten Produkte den Tab Garantie und Hersteller die Karte EU-Gewährleistung & GARAN-Vorgaben.

Hinweis für Shopware ab Version 6.7.14

Shopware bringt einen eigenen Gewährleistungshinweis für den Bestellabschluss mit. Du findest ihn unter Einstellungen -> Warenkorb als “Gewährleistungshinweis auf Bestellabschlussseite anzeigen”. Wenn diese Einstellung und das Plugin gleichzeitig aktiv sind, sehen deine Kunden den Hinweis beim Bestellabschluss doppelt. Nutze nur eine der beiden Lösungen.

Die Einstellungen findest du unter Erweiterungen -> Meine Erweiterungen bei “EU Gewährleistungshinweis & GARAN” über “Konfigurieren”. Alle Einstellungen lassen sich je Verkaufskanal festlegen. Die Standardwerte folgen den Beispielen im Praxisleitfaden der EU-Kommission. Du kannst das Plugin also direkt nach der Installation nutzen.

Allgemein

GARAN-Label auf der Produktseite

GARAN-Label in der Produktliste

Gilt für Kategorieseiten und Suchergebnisse.

GARAN-Label im Warenkorb

Auch wenn das Label im Off-Canvas-Warenkorb deaktiviert ist, erscheint dort die Garantiedauer, solange “Garantiedauer und Beschreibung anzeigen” aktiviert ist.

Gesetzlicher Gewährleistungshinweis

Kundengruppen

Bestellbestätigung

Betrieb

Du kannst Garantien auf drei Ebenen hinterlegen. Nutze die Ebene, die zu deinem Sortiment passt:

• Am Hersteller, wenn ein Hersteller für sein ganzes Sortiment dieselbe Garantie gibt.
• Per EU-Label-Regel, wenn eine Garantie für eine Gruppe von Produkten gilt, zum Beispiel für eine Kategorie.
• Am Produkt oder an der Variante, wenn ein einzelnes Produkt abweicht.

Die drei Ebenen haben weitgehend dieselben Felder:

Die Modellkennung trägst du nur am Produkt ein, denn sie bezeichnet ein einzelnes Modell.

Am Hersteller

Öffne Kataloge -> Hersteller und den gewünschten Hersteller. In der Karte “EU-Gewährleistung & GARAN-Vorgaben” trägst du die Garantie ein und aktivierst Diese Vorgaben anwenden. Solange dieser Schalter aus ist, gelten die Vorgaben für kein Produkt.

Unter “Validierungsvorschau” siehst du, wie viele Produkte die Vorgaben nutzen, wie viele davon das GARAN-Label erhalten und wie das Label für ein Beispielprodukt aussieht.

Per EU-Label-Regel

Unter Kataloge -> EU-Label-Regeln siehst du alle Regeln mit Priorität, Status, Garantiedauer und Gültigkeit.

Mit EU-Label hinzufügen legst du eine neue Regel an. Du gibst ihr einen Namen, eine Priorität und die Garantiedaten. Unter “Bedingungen” legst du fest, für welche Produkte sie gilt, zum Beispiel für einen Hersteller, eine Kategorie, einen Tag oder eine Eigenschaft.

• Es stehen nur Bedingungen zum Produkt selbst zur Verfügung. So ist das Ergebnis auf der Produktseite, im Warenkorb und in der Bestellung immer gleich.
• Treffen mehrere Regeln auf ein Produkt zu, gilt die Regel mit der höheren Priorität.
• Eine Regel ohne Bedingungen gilt für jedes Produkt ohne eigene Garantie.
• Eine Regel kann auch den gesetzlichen Hinweis ausblenden, zum Beispiel für eine Kategorie mit Gutscheinen.

Am Produkt

Öffne das Produkt und den Tab Garantie. Unter Konfigurationsmodus wählst du:

• Überschreiben: Die Werte auf dieser Seite gelten für das Produkt.
• Vererben: Das Produkt übernimmt die Garantie vom Hauptprodukt, von einer EU-Label-Regel oder vom Hersteller. Die meisten Felder sind dann gesperrt. Nur die Modellkennung kannst du weiterhin eintragen.
• Deaktiviert: Für das Produkt wird keine Herstellergarantie angezeigt. Der gesetzliche Hinweis erscheint trotzdem.

Unter “Validierungsvorschau” siehst du sofort, ob das Produkt das GARAN-Label erhält und woher die Garantie stammt. Gespeichert wird mit dem normalen Speichern-Button des Produkts.

Keine Verbrauchsgüter – gesetzlichen Hinweis ausblenden: Aktiviere diese Option nur für Produkte, die keine Waren sind, zum Beispiel Geschenkgutscheine, Dienstleistungen oder Kautionen. Für alle anderen Produkte ist der Hinweis vorgeschrieben. Varianten übernehmen diese Einstellung vom Hauptprodukt.

Varianten

Jede Variante hat ihren eigenen Tab “Garantie”. Wenn eine Variante eine andere Garantie hat, zum Beispiel ein Set mit längerer Laufzeit, stellst du sie auf “Überschreiben”. Eine Variante mit eigener Garantie behält diese auch dann, wenn das Hauptprodukt deaktiviert ist.

Welche Garantie gilt?

Das Plugin prüft für jedes Produkt der Reihe nach:

1. Hat das Produkt oder die Variante eine eigene Garantie (Überschreiben)? Dann gilt diese.
2. Ist das Produkt oder die Variante deaktiviert? Dann wird keine Garantie angezeigt.
3. Bei Varianten: Hat das Hauptprodukt eine eigene Garantie oder ist es deaktiviert? Dann gilt das Hauptprodukt.
4. Trifft eine aktive EU-Label-Regel zu? Dann gilt die Regel mit der höchsten Priorität.
5. Hat der Hersteller aktive Vorgaben? Dann gelten diese.
6. Sonst wird keine Herstellergarantie angezeigt.

Beispiel: Der Hersteller Nordwerk gibt auf alle Geräte 3 Jahre Garantie. Du trägst das einmal am Hersteller ein. Alle Nordwerk-Produkte zeigen dann “3 Jahre Garantie” und das GARAN-Label. Für die Variante mit großem Akku gibt Nordwerk 4 Jahre. Du stellst nur diese Variante auf “Überschreiben” und trägst 48 Monate ein.

Die Modellkennung

Das GARAN-Label nennt das Modell, für das die Garantie gilt. Ohne Modellkennung erscheint kein Label. Das Plugin sucht die Modellkennung in dieser Reihenfolge:

1. die Modellkennung im Tab “Garantie” des Produkts oder der Variante,
2. das Feld, das du am Hersteller unter “Dieses Produktfeld verwenden, wenn keine Modellkennung gesetzt ist” auswählst: Produktnummer (SKU), Produktname, EAN / GTIN oder ein Zusatzfeld,
3. die Hersteller-Artikelnummer des Produkts.

In den meisten Fällen reicht es, die Hersteller-Artikelnummer am Produkt zu pflegen. Deine interne Produktnummer verwendet das Plugin nur, wenn du sie am Hersteller ausdrücklich auswählst. Die Auswahl am Hersteller gilt für alle seine Produkte, auch wenn die Garantievorgaben des Herstellers nicht aktiv sind.

Mehrere Produkte auf einmal bearbeiten

• In der Produktliste: Markiere Produkte und wähle “Gewährleistung bearbeiten”. Aktiviere nur die Felder, die du ändern möchtest. Alle anderen Werte bleiben unverändert.
• Import/Export: Garantiedaten lassen sich als CSV importieren und exportieren. Mehr dazu unter Import und Export.
• Anbindung: Warenwirtschaft oder PIM können die Daten direkt schreiben. Mehr dazu unter Anbindung an andere Systeme.

Wann erscheint das GARAN-Label?

Das Label erscheint nur, wenn alle folgenden Punkte erfüllt sind:

• Die Garantie ist aktiv und liegt im eingetragenen Gültigkeitszeitraum.
• Die Garantie läuft länger als 24 Monate, in ganzen Halbjahren. Die kürzeste mögliche Dauer ist also 30 Monate, danach 36, 42, 48 Monate und so weiter.
• Marke und Modellkennung sind vorhanden.
• Alle vier Qualifikationsschalter sind aktiviert.
• Das Label ist für die jeweilige Ansicht nicht deaktiviert.

Fehlt etwas, zeigt dir die Validierungsvorschau im Tab “Garantie” den Grund. Deine Kunden sehen solche Meldungen nie.

Garantieangaben ohne Label

Auch ohne Label zeigt das Plugin die Garantiedauer und den Garantietext an, sofern eine Garantie hinterlegt und aktiv ist. Eine Garantie von genau 24 Monaten erscheint zum Beispiel als “2 Jahre Garantie” mit Link zu den Garantiebedingungen, aber ohne GARAN-Label.

Was steht auf dem Label?

Das Plugin setzt in die offizielle Vorlage nur drei Werte ein: die Marke, die Modellkennung und die Laufzeit in Jahren. Alles andere, auch der QR-Code, bleibt so, wie die EU-Kommission es veröffentlicht hat. Der QR-Code führt zur Seite der EU-Kommission über Haltbarkeitsgarantien.

Garantien in ganzen Jahren erscheinen im Shop als “3 Jahre Garantie”. Andere Laufzeiten erscheinen in Monaten, zum Beispiel “30 Monate Garantie”. Auf dem Label selbst steht die Dauer in Jahren, also 2,5.

Produktseite

Unter dem Kaufen-Button stehen die Garantiedauer, der Garantietext, das GARAN-Label und der Link “Mehr zur EU-Haltbarkeitsgarantie”. Darunter folgt “Gesetzliche Gewährleistung”. Stammt die Garantie aus den Vorgaben des Herstellers, steht zusätzlich “vom Hersteller angeboten” dabei.

Ein Klick auf das Label öffnet ein Fenster mit dem vollständigen Label, dem QR-Code und den Links “Mehr zur EU-Haltbarkeitsgarantie” und “Garantiebedingungen”.

Ein Klick auf “Gesetzliche Gewährleistung” klappt den offiziellen Hinweis der EU-Kommission auf.

Produktliste

In Kategorien und Suchergebnissen erscheinen Garantiedauer und ein kleines Label je Produkt.

Warenkorb

Im Warenkorb stehen Garantiedauer und Label bei jeder Position. Den gesetzlichen Hinweis kannst du dort zusätzlich einblenden.

Bestellabschluss

Auf der Seite “Bestellung abschließen” erscheinen der gesetzliche Hinweis über der Produktliste und das Label bei jeder Position.

Bestellbestätigung

Die Bestellbestätigung enthält den gesetzlichen Hinweis als PDF-Anhang. Damit erhält der Kunde den Hinweis nach dem Kauf dauerhaft. Hast du am Produkt, am Hersteller oder an einer Regel ein Garantiedokument hochgeladen, wird es ebenfalls angehängt.

Im Text der Standard-E-Mail von Shopware erscheinen keine Garantieangaben. Wenn du sie dort anzeigen möchtest, kannst du deine E-Mail-Vorlage anpassen. Das Plugin stellt die Daten dafür bereit.

Nachweis in der Bestellung

Zu jeder Bestellung speichert das Plugin, welcher Hinweis und welche Garantie zum Zeitpunkt des Kaufs galten. Du siehst die Angaben in der Bestellung in der Karte “EU-Gewährleistung & GARAN (zum Bestellzeitpunkt)”: Sprache und Version des Hinweises, ob er der Bestellbestätigung beigefügt wurde und wann.

Diese Angaben ändern sich nicht mehr, auch wenn du später die Garantie am Produkt anpasst.

Alle Garantiedaten des Plugins lassen sich über den normalen Shopware Import/Export als CSV-Datei exportieren und wieder importieren. So kannst du Garantien für viele Produkte auf einmal pflegen, zum Beispiel mit Daten aus deinem Warenwirtschaftssystem.

Profile

Unter Einstellungen -> Import/Export findest du im Tab “Profile” fünf Profile des Plugins. In der Auswahlliste beim Import und Export erscheinen sie mit ihrem technischen Namen:

Die Profile sind Standardprofile und lassen sich nicht bearbeiten. Wenn du nur einzelne Spalten brauchst, dupliziere ein Profil und passe die Kopie an.

Exportieren

Wähle im Tab “Export” das Profil aus und klicke auf “Export starten”. Die fertige Datei kannst du in der Export-Aktivität herunterladen. Die Datei ist eine CSV-Datei mit Semikolon als Trennzeichen. Am einfachsten startest du mit einem Export und bearbeitest diese Datei.

Importieren

Wähle im Tab “Import” deine CSV-Datei und das Profil aus. Mit “Testlauf starten” prüfst du die Datei, ohne etwas zu ändern. Mit “Import starten” werden die Daten übernommen.

Das solltest du beim Import wissen:

• Produkte über die Produktnummer: Du brauchst keine Shopware-IDs. Eine Zeile mit der Spalte product.productNumber findet das Produkt. Hat es schon eine Garantie, wird sie aktualisiert, sonst wird sie angelegt. Hersteller findest du entsprechend über ihren Namen, Regeln über ihren Namen.
• Leere Zellen ändern nichts: Eine leere Zelle lässt den gespeicherten Wert unverändert. Du kannst also nur die Spalten importieren, die du ändern möchtest.
• Nichts wird gelöscht: Der Import legt Einträge an oder aktualisiert sie. Löschen kannst du nur in der Administration.
• Ja und Nein schreibst du als 1 und 0, Datumsangaben im Format 2026-12-31.
• Fehlerhafte Zeilen: Gibt es eine Produktnummer nicht, wird nur diese Zeile übersprungen. Die übrigen Zeilen werden importiert. In der Import-Aktivität siehst du die Anzahl der fehlerhaften Einträge und kannst sie als Datei mit dem Grund herunterladen. Der Status lautet in diesem Fall “Fehlgeschlagen”, auch wenn die anderen Zeilen übernommen wurden.
• Sofort geprüft: Nach dem Import prüft das Plugin die importierten Produkte sofort. Ob sie das GARAN-Label erhalten, siehst du direkt im Shop und in der Validierungsvorschau.

Beispiel

Diese Datei setzt für den Wasserkocher eine eigene Garantie über 3 Jahre und trägt für den Bohrhammer eine Modellkennung ein. Die übrigen Garantieangaben übernimmt der Bohrhammer weiter vom Hersteller:

product.productNumber;configurationMode;modelIdentifier;durationMonths
LU-20020;override;LWK-170;36
NW-10010;inherit;BH-800-SDS;

Für configurationMode gibt es die Werte override (Überschreiben), inherit (Vererben) und disabled (Deaktiviert). Wenn du die Spalte weglässt, wird eine neue Garantie auf “Vererben” gesetzt.

EU-Label-Regeln importieren

Die Bedingungen einer Regel stehen in der Spalte conditions. Am einfachsten legst du eine Regel einmal in der Administration an, exportierst sie und verwendest die Datei als Vorlage. Beim Import ersetzen die Bedingungen aus der Datei die bisherigen Bedingungen der Regel. Bleibt die Spalte leer, behält eine bestehende Regel ihre Bedingungen.

Achtung: Eine neue Regel ohne Bedingungen gilt für jedes Produkt ohne eigene Garantie.

Bestellnachweise

Die Nachweise zu Bestellungen kannst du exportieren, zum Beispiel für dein Archiv. Importiere sie nur, wenn du Bestellungen in einen anderen Shop überträgst, und nur aus einer Datei, die du vorher exportiert hast. Importiere zuerst die Bestellnachweise und danach die Positionsnachweise.

Wenn deine Garantiedaten in einem anderen System gepflegt werden, zum Beispiel in deiner Warenwirtschaft, einem PIM oder einem Lieferanten-Feed, kann dieses System die Daten direkt über die Shopware-Schnittstelle lesen und schreiben. So musst du nichts doppelt eintragen.

Brauchst du keine Anbindung? Die Pflege im Tab “Garantie”, die Bearbeitung mehrerer Produkte in der Produktliste und der Import und Export per CSV funktionieren ohne Programmierung.

Was die Anbindung kann

• Die aktuelle Garantie eines Produkts lesen, auch wenn sie vom Hauptprodukt, von einer EU-Label-Regel oder vom Hersteller stammt.
• Alle Werte aus dem Tab “Garantie” schreiben: Laufzeit, Marke, Modellkennung, die vier Qualifikationsschalter, Garantiebedingungen, Garantietext und ob die Konfiguration aktiv ist.
• Bis zu 500 Produkte in einer Anfrage ändern.

Jede Änderung wird sofort geprüft. Die Validierungsvorschau und der Shop zeigen danach direkt den neuen Stand.

1. Rolle mit Berechtigungen anlegen

Lege unter Einstellungen -> Benutzer & Rechte eine neue Rolle an. Aktiviere bei “EU-Gewährleistung & GARAN” die Rechte Ansehen, Bearbeiten und Erstellen.

Alle drei Rechte sind nötig. “Erstellen” braucht die Anbindung auch dann, wenn sie nur bestehende Produkte ändert, denn beim ersten Schreiben wird für ein Produkt die Garantie angelegt. Fehlt das Recht, kann die Anbindung lesen, aber nichts ändern.

Ein System, das die Daten nur auswerten soll, zum Beispiel ein Reporting, erhält nur “Ansehen”. Es kann dann nichts verändern.

2. Integration anlegen

Lege unter Einstellungen -> Integrationen mit “Integration anlegen” eine Integration an und weise ihr die Rolle zu. Gib ihr einen Namen, an dem du das System später wiedererkennst, zum Beispiel “ERP-Anbindung”.

3. Schlüssel weitergeben

Shopware zeigt dir eine Zugangs-ID und einen Sicherheitsschlüssel. Den Sicherheitsschlüssel siehst du nur einmal. Gib beide Werte sicher an den Entwickler des anderen Systems weiter, nicht per unverschlüsselter E-Mail. Die technischen Angaben für den Entwickler findest du unter API für Entwickler.

Wird die Anbindung nicht mehr gebraucht, lösche die Integration. Die Schlüssel sind dann sofort ungültig.

Funktioniert die Anbindung?

Öffne ein Produkt, das das andere System geändert hat, und den Tab “Garantie”. Dort stehen die neuen Werte, und die Validierungsvorschau zeigt, ob das Produkt das GARAN-Label erhält.

Häufige Probleme

• Der Entwickler meldet Fehler 403: Der Rolle fehlt ein Recht. Zum Schreiben sind “Ansehen”, “Bearbeiten” und “Erstellen” nötig.
• Von Hand eingetragene Werte sind verschwunden: Das andere System sendet leere Werte für Felder, die es nicht kennt. Es sollte nur die Felder senden, die es selbst pflegt.
• Nichts passiert: Prüfe unter Einstellungen -> Integrationen, ob die Integration noch existiert. Ein neu erzeugter Sicherheitsschlüssel macht den alten ungültig.

Die Anbindung prüft keine Angaben des Herstellers. Setze die Qualifikationsschalter nur aus Informationen, die der Hersteller dir tatsächlich gegeben hat.

Diese Seite richtet sich an Entwickler, die ein anderes System an die Garantiedaten anbinden. Wie der Shopbetreiber die Zugangsdaten anlegt, steht unter Anbindung an andere Systeme.

Anmeldung

Die Anmeldung erfolgt wie bei jeder Shopware-Integration mit der Zugangs-ID und dem Sicherheitsschlüssel:

POST /api/oauth/token
{
  "grant_type": "client_credentials",
  "client_id": "<Zugangs-ID>",
  "client_secret": "<Sicherheitsschlüssel>"
}

Das erhaltene access_token sendest du bei jeder Anfrage als Authorization: Bearer <token>. Mit Accept: application/json erhältst du einfaches JSON.

Endpunkte

Garantie lesen

GET /api/_action/iwv-eu-guarantee/product-configuration?productNumber=LU-20040

Die Antwort enthält drei Teile:

• stored: die Werte, die direkt am Produkt gespeichert sind. Ist leer (null), wenn das Produkt keine eigenen Werte hat.
• resolved: die Garantie, die tatsächlich gilt, nach Vererbung vom Hauptprodukt, einer EU-Label-Regel oder dem Hersteller. sourceLevel nennt die Herkunft: product, parent, label, manufacturer oder none.
• eligibility: der Status für das GARAN-Label, zum Beispiel eligible oder not_eligible, mit den Gründen unter blockingViolations.

Lies für die Frage “Welche Garantie gilt?” immer resolved, nicht stored. Ein Produkt mit stored: null kann trotzdem eine gültige Garantie haben.

Garantie ändern

POST /api/_action/iwv-eu-guarantee/product-configuration
{
  "productNumber": "LU-20040",
  "values": {
    "producerGuaranteeConfirmed": true,
    "informationSuppliedToSeller": true
  }
}

Hat das Produkt noch keine Garantie, wird sie angelegt. Die Antwort hat dasselbe Format wie beim Lesen, ergänzt um created und die geschriebenen fields. Der Status für das Label ist darin bereits neu berechnet.

Viele Produkte ändern

POST /api/_action/iwv-eu-guarantee/bulk-apply
{
  "productIds": ["<uuid>", "<uuid>"],
  "values": { "durationMonths": 36, "producerBrand": "Nordwerk" }
}

Hier werden Produkt-IDs statt Produktnummern erwartet, höchstens 500 je Anfrage. Die Antwort enthält die Anzahl der geänderten und neu angelegten Einträge und den neuen Status je Produkt.

Wichtige Regeln

• Nur gesendete Felder werden geändert. Ein Feld, das nicht in der Anfrage steht, behält seinen Wert. Ein Feld mit dem Wert null wird geleert. Sende deshalb nur die Felder, die dein System pflegt.
• Pflichtfelder lassen sich nicht leeren. configurationMode, active und suppressStatutoryNotice mit null führen zu Fehler 400.
• Unbekannte Produktnummer: Fehler 400 “No product matches the given productId or productNumber.”
• Fehlende Berechtigung: Fehler 403 mit dem fehlenden Recht in missingPrivileges.

Schreibbare Felder

Headless-Shops (Store API)

Für eigene Frontends liefert eine Store-API-Route die Garantieangaben, die Label-Daten und den gesetzlichen Hinweis in der Sprache des Verkaufskanals:

POST /store-api/iwv-eu-guarantee/product
sw-access-key: <Zugangsschlüssel des Verkaufskanals>
{ "productIds": ["<uuid>"], "view": "product" }

Der gesetzliche Hinweis ist in der Antwort immer enthalten, außer du schaltest ihn ausdrücklich ab.

Warum erscheint bei meinem Produkt kein GARAN-Label?

Öffne den Tab “Garantie” am Produkt. Die Validierungsvorschau nennt den Grund. Häufig fehlt die Modellkennung, die Laufzeit ist zu kurz oder ein Qualifikationsschalter ist nicht aktiviert.

Die Garantie ist abgelaufen, aber die Dauer wird noch angezeigt.

Liegt das Datum außerhalb von “Gültig ab” und “Gültig bis”, blendet das Plugin das GARAN-Label aus. Die Garantiedauer und der Text werden aber weiter angezeigt. Wenn die Garantie nicht mehr gilt, stelle die Konfiguration auf “Deaktiviert” oder schalte “Konfiguration aktiv” aus.

Der gesetzliche Hinweis erscheint beim Bestellabschluss doppelt.

Prüfe unter Einstellungen -> Warenkorb die Shopware-Einstellung “Gewährleistungshinweis auf Bestellabschlussseite anzeigen” und deaktiviere sie, wenn du das Plugin nutzt.

Wie blende ich den Hinweis für Gutscheine aus?

Aktiviere am Produkt “Keine Verbrauchsgüter – gesetzlichen Hinweis ausblenden”. Für viele Gutscheine auf einmal legst du eine EU-Label-Regel mit der Bedingung Kategorie an und aktivierst dort dieselbe Option. Im Warenkorb verschwindet der Hinweis nur, wenn alle Positionen Gutscheine oder andere Nicht-Waren sind.

Wo kommt die Modellkennung her?

Aus dem Tab “Garantie” des Produkts. Ist sie dort leer, nimmt das Plugin das am Hersteller gewählte Feld und zuletzt die Hersteller-Artikelnummer. Mehr dazu unter Garantien hinterlegen.

Gibt es das Label auch für eine Garantie von genau 2 Jahren?

Nein. 24 Monate entsprechen der gesetzlichen Gewährleistung. Das GARAN-Label ist nur für längere Garantien vorgesehen, die kürzeste mögliche Dauer ist 30 Monate. Eine Garantie von genau 2 Jahren zeigt das Plugin trotzdem als Garantieangabe an, nur ohne Label.

Um das Plugin EU Gewährleistungshinweis & GARAN zu erwerben, besuche bitte unseren Shopware-Store:

SHOPWARE 6

Zum Shopware-Store

Mit dem Plugin Digitaler Produktpass ordnest du den Produkten in deinem Shopware-6-Shop digitale Produktpässe zu und machst sie für deine Kunden erreichbar. Die meisten Händler erhalten die Pässe von ihren Lieferanten. Das Plugin verknüpft diese Pässe mit dem richtigen Produkt, zeigt auf der Produktseite einen Link zum Pass und hilft dir zu erkennen, welche Produkte noch keinen Pass haben.

So funktioniert es

• Du legst einen Pass an und gibst an, wo die Inhalte liegen: bei deinem Lieferanten (Lieferanten-URL oder GS1 Digital Link) oder direkt im Shop.
• Du ordnest den Pass einem Produkt, einer Variante oder einem Hersteller zu.
• Jeder Pass erhält einen festen Code. Deine Kunden erreichen den Pass immer über eine Adresse in deinem Shop, zum Beispiel https://dein-shop.de/dpp/QX3A4BE0RAT5.
• Der QR-Code für Etikett oder Verpackung enthält nur diese Adresse, nie die Adresse des Lieferanten. Ändert der Lieferant später seine URL, passt du sie im Pass an. Bereits gedruckte QR-Codes funktionieren weiter.

Was das Plugin nicht macht

• Es prüft nicht, ob die Angaben deiner Lieferanten richtig oder vollständig sind.
• Es meldet keine Pässe an ein EU-Register.
• Es ist kein vollständiger GS1-Resolver und kein PIM-System.

Voraussetzungen

• Shopware 6.7
• PHP 8.2 oder neuer. Für QR-Codes als PNG braucht der Server die PHP-Erweiterung gd, für den Download aller QR-Codes als ZIP die Erweiterung zip.

Für keine Produktgruppe gilt bisher eine Passpflicht. Batterien haben als Erste ein festes Datum. Das Plugin unterstützt dich bei der Vorbereitung, ersetzt aber keine Rechtsberatung.

Plugin installieren und aktivieren

Installiere und aktiviere das Plugin unter Erweiterungen -> Meine Erweiterungen bei “Digitaler Produktpass”. Shopware lädt dabei die benötigte Bibliothek für QR-Codes automatisch nach.

Nach der Aktivierung findest du:

• unter Kataloge -> Produktpässe die Seiten Bereitschaft und Pässe,
• in jedem Produkt den neuen Tab Produktpass,
• die Einstellungen über “Konfigurieren” beim Plugin.

Deinstallieren

Wenn du beim Deinstallieren die Daten behältst, bleiben alle Pässe und Zuordnungen erhalten. Ohne diese Option entfernt Shopware alle Pässe, Zuordnungen und Einstellungen des Plugins.

Die Einstellungen findest du unter Erweiterungen -> Meine Erweiterungen bei “Digitaler Produktpass” über “Konfigurieren”. Alle Einstellungen lassen sich je Verkaufskanal festlegen.

Allgemein

Der Link erscheint innerhalb der Kaufbox. Produkte, die nicht gekauft werden können, zeigen ihn deshalb nicht an.

Datenträger

Alle Pässe findest du unter Kataloge -> Produktpässe -> Pässe. Die Liste zeigt Titel, Code, Quelle, Status, GTIN und das Ende der Gültigkeit. Über “Pass anlegen” erstellst du einen neuen Pass. Löschen kannst du einen Pass über das Menü in der Liste.

Ein neuer Pass startet als Entwurf. Den Code vergibt das Plugin automatisch. Speichere den Pass mit “Speichern”, erst dann sind auch neue Produktzuordnungen gespeichert.

Beschreibung

Diese Texte pflegst du je Sprache. Wechsle dazu oben die Sprache.

Wo der Pass liegt

Beispiel für einen Batteriepass mit GS1 Digital Link:

Produkte

Hier ordnest du den Pass Produkten zu. Wie Varianten, Hauptprodukte und Hersteller zusammenspielen, erklärt die Seite Produkte zuordnen.

Identifikation und Gültigkeit

Feldprofil

Das Feldprofil legt fest, welche Angaben die Passseite in Gruppen anzeigt, zum Beispiel Materialien, Reparatur und Lebensende. Es gibt ein allgemeines Profil und ein vorläufiges Profil für Batteriepässe. Das Batterieprofil ist als vorläufig gekennzeichnet, weil die Vorgaben noch nicht endgültig sind.

Die Werte der Profilfelder und weitere Inhalte für die Quelle “Hier gepflegt” überträgst du derzeit über die API.

Datenträger

Der Code steht fest und ändert sich nie. Er steckt im QR-Code, den du auf Etikett oder Verpackung druckst. Alle QR-Codes lädst du gesammelt auf der Seite Bereitschaft herunter.

Produktseite

Hat ein Produkt einen gültigen Pass, erscheint unter der Kaufbox der Link Digitaler Produktpass. Er führt immer auf die Passseite in deinem Shop. Liegt der Pass beim Lieferanten, steht darunter der Hinweis “Dieser Pass wird vom Hersteller oder Lieferanten veröffentlicht.”

Bei Varianten wechselt der Link mit der gewählten Variante. Hier hat die Größe L einen eigenen Pass:

Passseite

Die Passseite liegt unter /dpp/CODE in deinem Shop und nutzt dein Shop-Layout. Suchmaschinen sollen sie nicht indexieren. Sie zeigt:

• Titel und Kurzbeschreibung,
• bei Pässen vom Lieferanten den Button Vollständigen Pass öffnen (öffnet in einem neuen Tab),
• den Abschnitt Identifikation mit Kennungen, GTIN, Ebene und Gültigkeit,
• bei der Quelle “Hier gepflegt” die Angaben des Feldprofils und weitere Inhalte,
• den QR-Code und den Hinweis für Kunden.

Pass vom Lieferanten:

Pass mit Inhalten aus dem Shop:

Batteriepass mit GS1 Digital Link auf Chargenebene:

Ersetzte und archivierte Pässe

Gedruckte QR-Codes zeigen auch später noch auf die Passseite. Hat ein Pass den Status “Ersetzt” oder “Archiviert”, sieht der Kunde einen entsprechenden Hinweis.

Sprachen

Die Passseite erscheint in der Sprache des Verkaufskanals. Texte, die du im Pass je Sprache gepflegt hast, werden entsprechend angezeigt. Die Oberfläche ist auf Deutsch und Englisch verfügbar.

Ein Pass gilt erst, wenn er einem Produkt, einem Hauptprodukt oder einem Hersteller zugeordnet ist. Für jedes Produkt sucht das Plugin den passenden Pass in dieser Reihenfolge:

1. ein Pass, der genau diesem Produkt oder dieser Variante zugeordnet ist,
2. sonst ein Pass des Hauptprodukts (alle Varianten erben ihn),
3. sonst ein Pass, der als Hersteller-Rückfallebene für den Hersteller des Produkts hinterlegt ist.

Dabei zählen nur veröffentlichte Pässe innerhalb ihrer Gültigkeit. Ein Entwurf oder ein abgelaufener Pass wird übersprungen.

Im Pass zuordnen

In der Karte Produkte wählst du bei “Produkt zuordnen” ein Produkt oder eine einzelne Variante. Mit “Zuordnung aufheben” entfernst du sie wieder.

Sind einem Produkt mehrere Pässe zugeordnet, gewinnt ein Pass mit “Überschreibt Hauptprodukt”, danach der mit der höheren Priorität.

Hersteller-Rückfallebene

Viele Lieferanten stellen einen Pass für ihr ganzes Sortiment bereit. Wähle dazu in der Karte Produkte den Hersteller bei “Hersteller-Rückfallebene”. Der Pass gilt dann für jedes Produkt dieses Herstellers, das keinen eigenen Pass hat.

Im Produkt: Tab Produktpass

Im Produkt zeigt der Tab Produktpass, welcher Pass gilt und woher er kommt.

Ein Pass, der direkt am Produkt hängt:

Eine Variante ohne eigenen Pass erbt den Pass des Hauptprodukts:

Ein Produkt ohne eigenen Pass erhält den Pass seines Herstellers:

Gilt kein Pass, kannst du über “Pass zuordnen” direkt einen Pass wählen. Eine Zuordnung an dieser Stelle gilt nur für dieses Produkt und hat Vorrang vor allem Geerbten.

Die Seite Kataloge -> Produktpässe -> Bereitschaft zeigt dir, wie weit dein Katalog vorbereitet ist.

Überblick

Produkte ohne Pass

Über “Produkte ansehen” öffnest du eine Liste aller Produkte ohne Pass. Ein Klick auf die Produktnummer öffnet das Produkt.

Massenimport und Massenexport

Siehe Import und Export.

Auf der Seite Bereitschaft ordnest du vielen Produkten auf einmal einen Pass zu und exportierst alle Pässe.

Massenimport

1. Wähle bei “CSV-Datei” deine Datei aus.
2. Klicke auf Änderungen vorab prüfen. Die Vorschau zeigt für jede Zeile, ob ein Pass angelegt oder aktualisiert wird oder ob die Zeile einen Fehler hat. Noch wird nichts gespeichert.
3. Klicke auf Import ausführen. Zeilen mit Fehler werden übersprungen.

Das Ergebnis siehst du als Meldung, zum Beispiel “1 angelegt, 1 aktualisiert, 1 übersprungen”.

Aufbau der CSV-Datei

UTF-8, Trennzeichen Semikolon oder Komma, erste Zeile mit den Spaltennamen. Pflicht ist nur product_number. Für Varianten gibst du die Produktnummer der Variante an.

Beispiel:

product_number;source_type;source_url;gtin;status;title
DPP-AUD-002;external_url;https://pass.klangwerk.example/k2;4260712345011;active;Produktpass Kopfhörer K2 Studio

Hat das Produkt noch keinen eigenen Pass, legt der Import einen neuen Pass an und ordnet ihn zu. Leere Felder erhalten dann diese Werte: Quelle Lieferanten-URL, Ebene Modell, Status Veröffentlicht. Hat das Produkt bereits einen eigenen Pass, aktualisiert der Import diesen Pass.

Massenexport

• Pässe exportieren (CSV) lädt alle Pässe mit ihren Zuordnungen als product-passports.csv herunter, eine Zeile je Zuordnung.
• QR-Codes herunterladen (ZIP) lädt für jeden Pass den QR-Code als SVG-Datei herunter, benannt nach dem Code. Das funktioniert für bis zu 1000 Pässe.

Berechtigungen für Mitarbeiter

Unter Einstellungen -> Benutzer & Rechte -> Rollen findest du in der Gruppe “Andere” den Eintrag Produktpässe. Damit legst du fest, wer Pässe ansehen, bearbeiten, anlegen oder löschen darf.

• Ansehen: Bereitschaft, Liste und Pässe lesen, Export.
• Bearbeiten: Pässe ändern.
• Erstellen: Pässe anlegen, Produkte zuordnen und den Massenimport nutzen.
• Löschen: Pässe und Zuordnungen entfernen.

Pässe aus einem anderen System übertragen

Wenn dein PIM oder Warenwirtschaftssystem die Pässe verwaltet, legst du für dieses System eine Integration an:

1. Öffne Einstellungen -> System -> Integrationen und klicke auf “Integration hinzufügen”.
2. Vergib einen Namen und wähle eine Rolle mit den Rechten für Produktpässe.
3. Kopiere die Zugangs-ID und den Sicherheitsschlüssel und gib sie deinem Dienstleister. Der Schlüssel wird nur einmal angezeigt.

Entziehst du den Zugriff, löschst du die Integration. Die technischen Details stehen unter API für Entwickler.

Alle Daten des Plugins sind über die Admin-API von Shopware erreichbar. Eine Store-API gibt es nicht. Zur Anmeldung nutzt du eine Integration (siehe Anbindung an andere Systeme) mit POST /api/oauth/token und grant_type=client_credentials.

Entitäten

Die Standard-Endpunkte von Shopware gelten, zum Beispiel POST /api/search/iwv-dpp-passport oder PATCH /api/iwv-dpp-passport/{id}. Eine doppelte Zuordnung desselben Produkts beantwortet die API mit 409 IWV_DPP__PASSPORT_ALREADY_ATTACHED.

Beispiel: Feldwert für einen Pass setzen

POST /api/iwv-dpp-field-value
{
  "passportId": "<Pass-ID>",
  "fieldKey": "repair_information",
  "languageId": "<Sprach-ID>",
  "valueType": "text",
  "value": "Ersatzteile sind zehn Jahre lang beim Hersteller erhältlich."
}

Zusätzliche Endpunkte

Öffentliche Adressen

Unbekannte Codes liefern 404.

Das Plugin Digitaler Produktpass erhältst du im Shopware Store:

Digitalen Produktpass im Shopware Store ansehen

Dort findest du die aktuell angebotene Version, Kompatibilitätsangaben und Konditionen.

Mit Bundles für Shopware 6 kombinierst du vorhandene Produkte zu festen Paketangeboten. Allgemeine Bundles verwaltest du zentral unter Kataloge > Bundles. Auf der Produktdetailseite sehen Kunden Name und Verfügbarkeitsstatus; Preis und Warenkorb-Schaltfläche erscheinen bei verfügbaren Bundles.

So funktioniert es

1. Lege ein allgemeines Bundle an und vergib einen verständlichen Namen.
2. Wähle die Preisstrategie Summe der Produkte, Prozentualer Rabatt oder Fester Bundle-Preis.
3. Füge die festen Bestandteile hinzu und lege im Feld Menge die benötigte Anzahl fest.
4. Aktiviere und speichere das Bundle.
5. Prüfe Produktdetailseite und Warenkorb mit einem realistischen Testkauf.

Was das Plugin bietet

• Zentrale Verwaltung allgemeiner Bundles unter Kataloge > Bundles.
• Drei Preisstrategien für Pakete ohne Nachlass, prozentuale Aktionen und feste Bundle-Preise.
• Feste Bestandteile und benötigte Mengen je Produkt.
• Anzeige von Name und Status auf den Produktdetailseiten der enthaltenen Produkte.
• Gruppierte Darstellung der Bestandteile und Preisanpassungen im Warenkorb.

Wichtiger Hinweis für Version 1.6.0

Vor einem produktiven Einsatz muss die Warenkorblogik so abgesichert sein, dass Bestandteile, Mengen, Verfügbarkeit und Preisstrategie serverseitig aus den gespeicherten Bundle-Daten neu aufgebaut und geprüft werden. Version 1.6.0 übernimmt diese Angaben beim Warenkorb-Aufbau noch aus dem übermittelten Bundle-Payload. Setze die Version deshalb erst nach einer entsprechenden technischen Absicherung und einem realistischen Checkout-Test öffentlich ein.

Der Quellcode enthält außerdem einen Bereich Spezifisches Bundle in der Produktdetailansicht der Administration. Der Erstellungsablauf ist in Version 1.6.0 nicht vollständig nutzbar, weil bei einem neuen spezifischen Bundle keine erste Komponente hinzugefügt werden kann. Diese Dokumentation beschreibt deshalb den verifizierten Arbeitsablauf für allgemeine Bundles.

Screenshots

Voraussetzungen

• Plugin-Version 1.6.0 unterstützt offiziell Shopware 6.6.
• Die enthaltenen Produkte müssen im Shop gepflegt und für den vorgesehenen Verkauf vorbereitet sein.
• Vor dem Livegang sind Preis, Bestand, Steuerdarstellung und Checkout im Ziel-Verkaufskanal zu prüfen.

Support

Bei Fragen erreichst du uns unter support@iwv-plugins.de.

Plugin installieren und aktivieren

1. Erwirb das Plugin im Shopware Store und füge es deinem Shopware-Konto hinzu.
2. Öffne in der Shopware Administration Erweiterungen > Meine Erweiterungen.
3. Installiere und aktiviere Bundles.
4. Leere bei Bedarf den Cache und kompiliere das Theme neu.

Bereiche nach der Aktivierung

Allgemeine Bundles findest du unter Kataloge > Bundles. Dort kannst du Angebote anlegen, aktivieren und bearbeiten.

Der Quellcode stellt zusätzlich in der Detailansicht eines Produkts den Bereich Spezifisches Bundle bereit. In Version 1.6.0 ist der Erstellungsablauf dort nicht vollständig nutzbar, weil bei einem neuen spezifischen Bundle keine erste Komponente hinzugefügt werden kann. Verwende bis zur Behebung allgemeine Bundles.

Kompatibilität

Plugin-Version 1.6.0 deklariert Shopware 6.6 als unterstützte Version. Prüfe vor einem Update auf eine andere Shopware-Haupt- oder Nebenversion den aktuellen Eintrag im Shopware Store.

Hinweis für produktive Shops

Vor dem öffentlichen Einsatz muss der Warenkorb-Aufbau serverseitig gegen die gespeicherten Bundle-Daten abgesichert werden. Teste außerdem Festpreise, Steuerregeln, Währungen, Mengenänderungen und Checkout im Zielshop.

Deinstallation und gespeicherte Daten

• Mit der Shopware-Option zum Beibehalten der Benutzerdaten bleiben gespeicherte Bundles und Zuordnungen erhalten.
• Ohne diese Option werden gespeicherte Bundles, Bestandteile und Zuordnungen gelöscht.

Erstelle vor einer endgültigen Deinstallation eine Sicherung, wenn du die Daten später wiederverwenden möchtest.

Allgemeine Bundles verwaltest du unter Kataloge > Bundles. Die Liste Allgemeine Bundles zeigt Name, Aktivstatus und Preisstrategie. Über Bundle erstellen legst du ein neues Angebot an.

Feldreferenz

Wichtige Datenregeln

• Aktiviere niemals ein leeres Bundle. Version 1.6.0 verhindert dies technisch nicht zuverlässig.
• Füge dasselbe Produkt nicht mehrfach als eigene Zeile hinzu. Verwende eine Zeile und trage die gewünschte Menge ein.
• Prüfe vor dem Livegang Produktdetailseite, Warenkorb und Checkout im vorgesehenen Verkaufskanal.

Weiterführende Konfiguration

• Bundle anlegen
• Produkte und Mengen
• Preisstrategien
• Storefront
• Warenkorb

Neues Bundle erstellen

1. Öffne in der Shopware Administration das Dashboard.
2. Klappe im Hauptmenü Kataloge auf und wähle Bundles.
3. Klicke in Allgemeine Bundles auf Bundle erstellen.
4. Vergib im Feld Name eine kundenseitig verständliche Bezeichnung.
5. Wähle die gewünschte Preisstrategie und pflege die dazugehörigen Preisfelder.
6. Klicke unter Zugewiesene Produkte auf Zugewiesenes Produkt hinzufügen.
7. Wähle im Feld Produkt den Bestandteil und trage im Feld Menge die benötigte Anzahl ein.
8. Füge mindestens einen Bestandteil hinzu. Version 1.6.0 erzwingt dies technisch nicht; aktiviere deshalb niemals ein leeres Bundle.
9. Füge dasselbe Produkt nicht mehrfach als eigene Zeile hinzu. Verwende eine Zeile mit der gewünschten Menge.
10. Aktiviere das Bundle und klicke auf Speichern.

Ergebnis prüfen

Öffne eine Produktdetailseite eines enthaltenen Produkts. Das Bundle sollte dort mit Name und Verfügbarkeitsstatus erscheinen. Bei verfügbarem Bundle werden zusätzlich Preis und die Schaltfläche Bundle in den Warenkorb angezeigt.

Führe anschließend einen Testkauf durch und kontrolliere Bestandteile, Mengen, Preisanpassung, Steuerdarstellung und Gesamtsumme.

Produkte hinzufügen

Die Produkte bilden die festen Bestandteile des Bundles. Wähle für jede Position das konkrete Shopware-Produkt, das beim Kauf in den Warenkorb gelegt werden soll.

1. Klicke unter Zugewiesene Produkte auf Zugewiesenes Produkt hinzufügen.
2. Wähle im Feld Produkt den Artikel oder die konkrete Variante.
3. Trage im Feld Menge die benötigte Anzahl je Bundle ein.
4. Speichere das Bundle.

Mengen richtig planen

Die Komponentenmenge ergibt sich aus Bundle-Anzahl mal benötigter Menge. Enthält ein Bundle zwei Stück eines Verbrauchsartikels, werden beim Kauf eines Bundles zwei Stück dieser Position in den Warenkorb gelegt.

Varianten

Das Bundle bietet Kunden keine eigene Variantenauswahl. Soll eine bestimmte Variante enthalten sein, wähle diese konkrete Variante als Bestandteil aus.

Verfügbarkeit

Die Plugin-Verfügbarkeitsanzeige setzt für jeden Bestandteil voraus, dass das Produkt aktiv ist, Shopware es als verfügbar kennzeichnet und der verfügbare Bestand mindestens der benötigten Menge entspricht. Eine Verkaufskanal-Sichtbarkeit prüft der Plugin-Service nicht ausdrücklich; die anschließende Verarbeitung der Produktpositionen unterliegt zusätzlich den Shopware-Warenkorbregeln.

Doppelte und leere Bestandteile vermeiden

• Aktiviere kein Bundle ohne Bestandteil.
• Füge ein Produkt nur einmal hinzu und steuere die Anzahl über das Feld Menge.
• Prüfe nach Produktänderungen erneut Storefront, Warenkorb und Checkout.

Allgemeine und spezifische Bundles

Allgemeine Bundles werden ohne separate Zielzuordnung auf den Produktdetailseiten ihrer Bestandteile angeboten. Der Quellcode unterstützt außerdem ein produktspezifisches Bundle für ein direkt zugeordnetes Zielprodukt. Der Erstellungsablauf dieses Bereichs ist in Version 1.6.0 jedoch nicht vollständig nutzbar; verwende deshalb den hier dokumentierten allgemeinen Bundle-Workflow.

Summe der Produkte

Die Strategie Summe der Produkte verwendet die Summe der übermittelten Preise der Bestandteile. Sie eignet sich für kuratierte Zusammenstellungen ohne zusätzlichen Paketnachlass.

Prozentualer Rabatt

Bei Prozentualer Rabatt pflegst du im Feld Rabatt in Prozent den gewünschten Nachlass. Im Warenkorb erscheint eine separate Rabattposition.

Fester Bundle-Preis

Mit Fester Bundle-Preis gibst du im Feld Bundle-Preis einen festen Gesamtpreis vor. Die Differenz zur Summe der Bestandteile wird im Warenkorb über Preispositionen abgebildet.

Wichtig für Version 1.6.0: Bei einer Bundle-Anzahl größer als 1 skaliert die Komponentenmenge, die Festpreiskorrektur jedoch nicht korrekt. Verwende Bundles mit festem Preis bis zur Behebung nur mit Bundle-Anzahl 1.

Hinweis zur Preisprüfung

Version 1.6.0 baut die Warenkorbposition aus dem übermittelten Bundle-Payload auf. Vor einem produktiven Einsatz müssen Bestandteile, Mengen und Preisstrategie serverseitig gegen die gespeicherten Bundle-Daten neu geprüft werden.

Preise vor dem Livegang testen

• Prüfe Produktdetailseite, Warenkorb und Checkout.
• Teste Mengenänderungen und unterschiedliche Bestandslagen.
• Vergleiche Rabatt und Gesamtsumme mit der erwarteten Preisstrategie.
• Teste Festpreise, Steuerregeln und mehrere Währungen in einem realistischen Checkout; diese Kombinationen sind durch die vorhandene QA nicht als produktionsreif bestätigt.
• Beachte mögliche Rundungsdifferenzen von einem Cent bei positionsweiser Rabattberechnung.

Ein aktives, der geöffneten Produktseite zugeordnetes Bundle erscheint auch dann, wenn einzelne Bestandteile nicht verfügbar sind. Das Storefront zeigt immer Name und Verfügbarkeitsstatus. Bundle-Preis und die Schaltfläche Bundle in den Warenkorb werden nur für verfügbare Bundles ausgegeben.

Wann erscheint ein Bundle?

• Das Bundle ist aktiv.
• Bei einem allgemeinen Bundle gehört die geöffnete Produktseite zu seinen Bestandteilen.
• Bei einem produktspezifischen Bundle ist die geöffnete Produktseite das zugeordnete Zielprodukt; der Erstellungsablauf dieses Bereichs ist in Version 1.6.0 nicht vollständig nutzbar.

Wann ist ein Bundle kaufbar?

Sind alle Bestandteile in den erforderlichen Mengen verfügbar, zeigt das Plugin zusätzlich Preis und die Schaltfläche Bundle in den Warenkorb. Die Plugin-Prüfung berücksichtigt aktiv, verfügbar und verfügbaren Bestand. Eine Verkaufskanal-Sichtbarkeit wird vom Plugin-Service nicht ausdrücklich geprüft; die Warenkorbverarbeitung unterliegt zusätzlich den Shopware-Regeln.

Wenn der Status “Nicht verfügbar” erscheint

• Prüfe Aktivstatus und Shopware-Verfügbarkeit jedes Bestandteils.
• Vergleiche den verfügbaren Bestand mit der benötigten Menge.
• Prüfe den konkreten Artikel beziehungsweise die hinterlegte Variante.
• Teste anschließend erneut Produktdetailseite und Warenkorb.

Beim Hinzufügen legt das Plugin das Bundle als zusammengehörige Gruppe in den Shopware-Warenkorb. Die enthaltenen Produkte bleiben einzelne Positionen innerhalb dieser Gruppe.

Darstellung im Warenkorb

• Der Bundle-Name bildet die übergeordnete Gruppe.
• Die enthaltenen Produkte erscheinen als untergeordnete Positionen.
• Die benötigten Mengen werden je Bestandteil berücksichtigt.
• Rabatte und Festpreisanpassungen erscheinen als eigene Preispositionen.

Bundle-Anzahl ändern

Bei einer höheren Bundle-Anzahl werden die Produktmengen entsprechend vervielfacht. Wichtig für Version 1.6.0: Bei der Strategie Fester Bundle-Preis skaliert die Festpreiskorrektur nicht korrekt. Verwende feste Bundle-Preise deshalb bis zur Behebung nur mit Bundle-Anzahl 1.

Produktionshinweis

Version 1.6.0 übernimmt Bestandteile, Mengen, Verfügbarkeitsangaben und Preisstrategie beim Warenkorb-Aufbau aus dem übermittelten Bundle-Payload. Vor einem öffentlichen Einsatz müssen diese Angaben serverseitig aus den gespeicherten Bundle-Daten neu aufgebaut und geprüft werden.

Prüfung vor dem Livegang

• Stimmen Produktpositionen und Mengen mit der Konfiguration überein?
• Entspricht die Preisanpassung der gewählten Strategie?
• Werden Versandkosten, Steuern und Gesamtsumme wie erwartet berechnet?
• Funktionieren mehrere Währungen und Steuerregeln im realistischen Checkout?
• Entsteht eine Rundungsdifferenz von einem Cent durch positionsweise Berechnung?

Warum erscheint das Bundle nicht auf der Produktdetailseite?

Prüfe zuerst, ob das Bundle aktiv und der geöffneten Produktseite zugeordnet ist. Nicht verfügbare Bestandteile verhindern die Anzeige des Bundles nicht, sondern führen zum Status Nicht verfügbar.

Warum ist das Bundle nicht kaufbar?

Prüfe bei jedem Bestandteil den Aktivstatus, die Shopware-Verfügbarkeit und den verfügbaren Bestand im Verhältnis zur benötigten Menge. Die Plugin-Prüfung kontrolliert die Verkaufskanal-Sichtbarkeit nicht ausdrücklich; die weitere Verarbeitung unterliegt zusätzlich den Shopware-Warenkorbregeln.

Auf welchen Produktseiten erscheint ein allgemeines Bundle?

Ein allgemeines Bundle wird auf den Produktdetailseiten seiner Bestandteile angeboten. Eine zusätzliche freie Zielprodukt-Zuordnung ist in der Administration für allgemeine Bundles nicht verfügbar.

Was ist ein spezifisches Bundle?

Der Quellcode unterstützt ein produktspezifisches Bundle, das direkt einem Zielprodukt zugeordnet ist. In Version 1.6.0 ist der Erstellungsablauf in der Administration nicht vollständig nutzbar, weil bei einem neuen spezifischen Bundle keine erste Komponente hinzugefügt werden kann. Verwende bis zur Behebung allgemeine Bundles.

Können Kunden einzelne Bestandteile auswählen oder abwählen?

Nein. Die Bestandteile sind fest vorgegeben. Das Plugin bietet keine optionale Komponentenauswahl im Storefront.

Können Kunden eine Variante innerhalb des Bundles wählen?

Nein. Hinterlege die konkrete Produktvariante als Bestandteil, wenn das Bundle eine bestimmte Ausführung enthalten soll.

Kann dasselbe Produkt mehrfach hinzugefügt werden?

Version 1.6.0 verhindert doppelte Produktzeilen nicht zuverlässig. Füge ein Produkt nur einmal hinzu und pflege die gewünschte Anzahl im Feld Menge.

Darf ein Bundle leer sein?

Nein. Aktiviere niemals ein Bundle ohne Bestandteil; die aktuelle Version verhindert dies technisch nicht zuverlässig.

Warum weicht der Warenkorb um einen Cent von der Vorschau ab?

Bei prozentualen Rabatten können Rundungen auf Positionsebene zu einer Abweichung von einem Cent führen. Prüfe die Berechnung mit deinen Steuer- und Währungseinstellungen.

Kann ich die Bundle-Anzahl erhöhen?

Die Produktmengen skalieren grundsätzlich mit. Bei Fester Bundle-Preis skaliert die Festpreiskorrektur in Version 1.6.0 jedoch nicht korrekt. Verwende diese Strategie bis zur Behebung nur mit Bundle-Anzahl 1.

Gibt es Import, Export oder eine öffentliche API?

Ein Import oder Export für Bundles sowie eine öffentliche Bundle-API sind in Version 1.6.0 nicht verfügbar. Pflege Bundles in der Shopware Administration.

Welche Shopware-Version wird unterstützt?

Die unterstützte Version findest du auf der Seite Installation und im aktuellen Shopware-Store-Eintrag.

Was passiert bei der Deinstallation?

Wenn du die Shopware-Option zum Beibehalten der Benutzerdaten auswählst, bleiben gespeicherte Bundle-Daten erhalten. Ohne diese Option werden Bundles, Bestandteile und Zuordnungen gelöscht.

Wo erhalte ich Unterstützung?

Schreibe an support@iwv-plugins.de und nenne Shopware-Version, Plugin-Version, Preisstrategie und die Schritte zum Problem.

Das Plugin Bundles für Shopware 6 erhältst du im Shopware Store:

Bundles im Shopware Store ansehen

Dort findest du die aktuell angebotene Version, Kompatibilitätsangaben und Konditionen.

Mit dem CSS/JS-Manager für Shopware 6 verwaltest du eigene Storefront-Styles und JavaScript zentral in der Administration. Änderungen liegen in benannten Containern, lassen sich pro Verkaufskanal und optional per Rule Builder ausspielen und werden kontrolliert über die Theme-Kompilierung veröffentlicht.

Die wichtigsten Vorteile

• SCSS/CSS und JavaScript ohne zusätzliche Theme-Dateien verwalten.
• Shopware-Theme-Variablen, Mixins und Funktionen in SCSS verwenden.
• Container pro Verkaufskanal und optional nach Rule-Builder-Regel begrenzen.
• Code nach Name und Inhalt suchen, Container duplizieren und über Positionen ordnen.
• Fehler einem Container und einer Codezeile zuordnen; bei einem Sass-Fehler bleibt das zuvor kompilierte Theme online.
• Lesen, Bearbeiten, Erstellen, Löschen und Kompilieren getrennt über Rollen steuern.

Schnellstart

1. Plugin installieren und aktivieren.
2. Unter Inhalte > CSS/JS-Manager einen Container hinzufügen.
3. Name, Aktivstatus, Verkaufskanäle, optionale Regel und Position festlegen.
4. SCSS/CSS oder JavaScript eintragen.
5. Mit Speichern & kompilieren veröffentlichen.
6. Ergebnis im passenden Verkaufskanal und Besucher-Kontext prüfen.

Dokumentation

• Installation
• Konfiguration
• FAQs
• Kaufen

Geprüftes Storefront-Ergebnis

Ein JavaScript-Container setzte im selben Test nach bestätigter Theme-Kompilierung eine Body-Klasse. Beide Effekte wurden ohne Browser-Konsolenfehler geprüft.

Kompatibilität

Diese Dokumentation bezieht sich auf Plugin-Version 1.7.1 für Shopware 6.7. Verifiziert wurde sie mit Shopware 6.7.15.0. Teste eigenen Code vor der Veröffentlichung in einer Staging-Umgebung und prüfe ihn nach Theme- oder Shopware-Updates erneut.

Plugin installieren

1. Erwirb den CSS/JS-Manager im Shopware Store.
2. Öffne Erweiterungen > Meine Erweiterungen.
3. Installiere und aktiviere das Plugin.
4. Öffne Inhalte > CSS/JS-Manager.

Nach der Aktivierung

Die Aktivierung allein liefert noch keinen eigenen Code aus. Lege einen aktiven Container an und kompiliere anschließend das Theme. Beim Deaktivieren kompiliert das Plugin die Themes ohne seine Container neu.

Vor dem produktiven Einsatz

• Eigene SCSS- und JavaScript-Snippets zuerst in einer Testumgebung prüfen.
• Eine Sicherung der eingesetzten Snippets führen.
• Rollen für Bearbeitung und Theme-Kompilierung bewusst vergeben.
• Storefront und Browser-Konsole nach der Veröffentlichung kontrollieren.

Du findest die Verwaltung unter Inhalte > CSS/JS-Manager. Die Liste zeigt Name, Codearten, Aktivstatus, Verkaufskanäle, Regel, Position und Änderungsdatum.

Aufgaben

• Container anlegen, ordnen und duplizieren
• SCSS/CSS und JavaScript einsetzen
• Verkaufskanäle und Regeln
• Kompilieren und Fehler beheben
• Berechtigungen

Wichtig

Speichern aktualisiert den Datensatz. Sichtbar wird der neue Stand erst nach einer erfolgreichen Theme-Kompilierung. Verwende dafür Speichern & kompilieren in der Detailansicht oder Theme kompilieren in der Liste.

Container anlegen

1. Öffne Inhalte > CSS/JS-Manager.
2. Klicke auf Container hinzufügen.
3. Vergib einen eindeutigen Namen und optional eine interne Notiz.
4. Wähle Verkaufskanäle und optional eine Regel oder lasse die Felder für alle Verkaufskanäle beziehungsweise alle Besucher leer.
5. Setze die Position und aktiviere den Container.
6. Trage SCSS/CSS, JavaScript oder beides ein.
7. Nutze Speichern & kompilieren.

Reihenfolge und Duplikate

Container werden zuerst nach ihrer Position aufsteigend und danach nach Erstellungszeit verarbeitet. Über das Kontextmenü kannst du einen Container duplizieren. Die Kopie erhält den Zusatz (Kopie) und startet inaktiv, damit sie nicht versehentlich veröffentlicht wird.

Suche

Die Suche berücksichtigt sowohl den Namen als auch den enthaltenen Code.

SCSS und CSS

Normales CSS ist gültiges SCSS. Beim Kompilieren wird der Code aktiver Container nach den Theme- und Plugin-Styles eingebunden. Dadurch stehen Theme-Variablen, Mixins und Funktionen zur Verfügung und das Ergebnis landet im Theme-CSS ohne zusätzlichen Stylesheet-Request.

• Verwende Shopware-Variablen wie $sw-asset-theme-url statt fest codierter Asset-Pfade.
• Für seitenspezifische Styles kannst du Body-Klassen wie body.is-ctl-checkout voranstellen.
• Container mit Rule-Builder-Regel dürfen kein @extend verwenden; wiederhole Deklarationen oder nutze ein Mixin.

JavaScript

JavaScript wird beim erfolgreichen Theme-Kompilieren erfasst und am Ende des <body> inline ausgegeben. Jeder Container läuft in einem eigenen Funktionsbereich und in einem eigenen try/catch. Ein Fehler in einem Container stoppt dadurch nicht die übrigen Container; Details erscheinen mit dem Container-Namen in der Browser-Konsole.

• Der Code läuft vor der Initialisierung der Shopware-Storefront-Plugins.
• Warte bei Bedarf auf window.load.
• Der Code wird nicht von webpack oder Vite verarbeitet.
• Das Plugin bietet keine Twig-/HTML-Templates, Planung, Medienverwaltung, Import/Export oder Live-Vorschau.

Verkaufskanäle

Wählst du keine Verkaufskanäle, gilt ein aktiver Container für alle Verkaufskanäle. Eine Auswahl begrenzt ihn auf die gewählten Kanäle.

Rule Builder

Optional kannst du eine Regel aus Einstellungen > Rule Builder zuweisen, zum Beispiel für eine Kundengruppe, ein Land oder einen Warenkorbwert. Der Container wird dann nur ausgeliefert, wenn zusätzlich zur Verkaufskanal-Auswahl auch die Regel passt.

• Regelbasiertes CSS wird mit dem Theme kompiliert, aber nicht dauerhaft in dessen allgemeine CSS-Datei geschrieben; es wird passenden Besuchern inline bereitgestellt.
• Regelbasiertes JavaScript wird ebenfalls nur passenden Besuchern inline bereitgestellt.
• Änderst du nur die Bedingungen einer bestehenden Regel, ist keine erneute Theme-Kompilierung nötig.
• Eine zugewiesene Regel kann nicht gelöscht werden. Im Reiter Zuweisungen der Regel werden die Container angezeigt.

Hinweis: Regeln steuern Besucher-Kontexte, nicht einzelne Seitentypen. Seitenspezifische Ausführung setzt du im Code über Shopware-Body-Klassen um.

Änderungen veröffentlichen

Das Plugin veröffentlicht Container zusammen mit der Shopware-Theme-Kompilierung:

• Speichern & kompilieren in der Detailansicht.
• Theme kompilieren in der Container-Liste.
• Die native Theme-Kompilierung in der Administration.
• Der Konsolenbefehl bin/console theme:compile.

Der Listendialog kompiliert alle Storefront-Themes, die einem Verkaufskanal zugewiesen sind.

SCSS-Fehler

Wenn Sass fehlschlägt, nennt die Fehlermeldung den betroffenen Container sowie Zeile und Spalte. Das zuvor erfolgreich kompilierte Theme bleibt online. Korrigiere den markierten Code und kompiliere erneut.

JavaScript-Fehler

Öffne die Entwicklerkonsole des Browsers. Fehler werden mit [CSS/JS Manager] <Containername> protokolliert. Da jeder Container isoliert läuft, können andere Container trotzdem weiter ausgeführt werden.

Prüfliste

1. Container aktiv?
2. Richtiger Verkaufskanal ausgewählt?
3. Passt die optionale Regel zum Testbesucher?
4. Theme nach der letzten Änderung erfolgreich kompiliert?
5. Browser- und Shopware-Cache erneuert?
6. Selektor oder JavaScript-Einstiegspunkt noch aktuell?

Rollen konfigurieren

Öffne Einstellungen > Benutzer & Rechte > Rollen. Das Plugin ergänzt:

• CSS/JS-Manager: Anzeigen, Bearbeiten, Erstellen und Löschen von Containern.
• Zusätzliche Berechtigungen > CSS/JS-Manager > Theme kompilieren: startet die Theme-Kompilierung.

Die Kompilierberechtigung ist bewusst getrennt, weil dieser Vorgang Storefront-Theme-Dateien neu schreibt.

Empfehlung

• Leserechte an Mitarbeitende vergeben, die Container nur prüfen sollen.
• Bearbeitungsrechte nur an Personen mit SCSS-/JavaScript-Kenntnissen vergeben.
• Die Kompilierberechtigung auf Verantwortliche begrenzen, die Änderungen vor der Veröffentlichung testen.

Wann werden Änderungen sichtbar?

Erst nach einer erfolgreichen Theme-Kompilierung.

Kann ich normales CSS eintragen?

Ja. Normales CSS ist gültiges SCSS.

Erzeugt das Plugin zusätzliche CSS- oder JS-Datei-Requests?

Allgemeines SCSS landet im Theme-CSS. JavaScript wird aus dem erfolgreichen Kompilierstand inline ausgegeben. Regelbasierter Code wird passenden Besuchern inline bereitgestellt.

Kann ich Code auf einzelne Seiten begrenzen?

Nicht über ein eigenes Seitenfeld. Nutze Body-Klassen wie is-ctl-product in CSS-Selektoren oder JavaScript-Bedingungen.

Was passiert bei fehlerhaftem SCSS?

Die Kompilierung meldet Container und Zeile. Das vorherige Theme bleibt online.

Kann ein JavaScript-Fehler andere Container stoppen?

Nein. Jeder Container läuft in einem eigenen Funktionsbereich und try/catch.

Warum ist @extend mit einer Regel nicht erlaubt?

@extend könnte Selektoren außerhalb des Containers verändern und dadurch Styles an alle Besucher ausliefern. Verwende Deklarationen oder Mixins.

Werden Daten beim Deinstallieren gelöscht?

Nur wenn bei der Deinstallation das Löschen der Daten gewählt wird. Ohne Datenlöschung bleiben Container in der Datenbank.

Den CSS/JS-Manager für Shopware 6 erhältst du im Shopware Store:

CSS/JS-Manager im Shopware Store ansehen

Dort findest du die aktuell angebotene Version, Kompatibilitätsangaben und Konditionen.