Import und Export

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 fünf Import/Export-Profile des Plugins
ProfilEine Zeile enthält
iwv_eu_guarantee_productsDie Garantie eines Produkts, also die Angaben aus dem Tab “Garantie”
iwv_eu_guarantee_manufacturersDie Garantievorgaben eines Herstellers
iwv_eu_guarantee_label_rulesEine EU-Label-Regel mit ihren Bedingungen
iwv_eu_guarantee_order_recordsDen Nachweis zum gesetzlichen Hinweis für eine Bestellung
iwv_eu_guarantee_order_line_recordsDen Garantienachweis für eine Bestellposition

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.

Import einer CSV-Datei mit dem Produktprofil und die Import-Aktivität

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.