Produktspezifische Garantie¶
Während die gesetzliche Gewährleistung automatisch für alle Produkte gilt (Plugin-Konfig), wird die Hersteller-Garantie pro Produkt gepflegt. So wird sie eingerichtet.
Wo werden die Werte gepflegt¶
Bei der Plugin-Installation legt sich automatisch ein Custom-Field-Set namens „EU-Gewährleistung & Hersteller-Garantie" an, das mit der Bestell-Entity (Produkt) verknüpft ist.
Im Admin Produkt öffnen → Tab „Custom Fields" → Box „EU-Gewährleistung & Hersteller-Garantie":
| Feld | Typ | Beschreibung |
|---|---|---|
| Garantie vorhanden | Bool | Wenn aktiv, wird der zusätzliche Garantie-Hinweis angezeigt. |
| Garantie-Marke | Text | z.B. „HP", „Apple", „Bosch". Wird als %brand% im Snippet eingesetzt. |
| Garantiedauer (Jahre) | Zahl (1–10) | Garantiezeit in Jahren. |
Beispiel: Notebook mit 3-Jahres-Garantie¶
- Produkt im Admin öffnen
- Tab „Custom Fields" → Box „EU-Gewährleistung & Hersteller-Garantie"
- Garantie vorhanden → an
- Garantie-Marke →
HP - Garantiedauer →
3 - Speichern
Im Storefront erscheint am Produkt:
✓ Mit 2 Jahren gesetzlicher Gewährleistung ✓ 3 Jahre HP Hersteller-Garantie
Anzeige-Logik¶
Das Plugin zeigt im Storefront pro Produkt:
- Gewährleistungs-Hinweis – immer (Konfig oben)
- Garantie-Hinweis – nur wenn:
- Plugin-Konfig „Garantie-Hinweis aktiv" = ein
- Custom Field „Garantie vorhanden" am Produkt = true
- Garantiedauer > 0
Wenn keines der Bedingungen erfüllt ist, erscheint nur der Gewährleistungs-Hinweis.
Bulk-Pflege bei vielen Produkten¶
Wenn Du viele Produkte hast, ist die Pflege Klick-für-Klick mühsam. Drei Wege:
A) Per Bulk-Edit in Shopware Standard¶
Im Produkt-Listing mehrere Produkte selektieren → „Massenbearbeitung" → Custom Fields → die drei Werte setzen → speichern.
Funktioniert wenn alle ausgewählten Produkte die gleiche Garantie haben sollen.
B) Per Import Export Pro¶
Mit unserem Import Export Pro-Plugin: CSV mit Spalten productNumber;kommora_warranty_has_guarantee;kommora_warranty_guarantee_brand;kommora_warranty_guarantee_duration einlesen → komplettes Mapping in einem Lauf.
C) Per API¶
PATCH /api/product/{id}
{
"customFields": {
"kommora_warranty_has_guarantee": true,
"kommora_warranty_guarantee_brand": "HP",
"kommora_warranty_guarantee_duration": 3
}
}
Verkürzte Gewährleistung für Gebrauchtwaren¶
Bei Gebrauchtwaren ist die gesetzliche Gewährleistung auf mindestens 1 Jahr verkürzbar (§ 476 BGB). Konfigurationsweg:
Option 1: Sales-Channel-weit für reine Gebrauchtwaren-Shops:
- Plugin-Konfig → „Modus für Gebrauchtwaren" auf ein → Text passt sich automatisch an.
Option 2: Pro Produkt (Mischshop mit Neu- und Gebrauchtware):
Über ein weiteres Custom Field markieren („Gebrauchtware"), und im Snippet/Template eine Bedingung einbauen. Wir liefern dafür ab Version 1.1 eine eingebaute Lösung; bis dahin als Custom-Anpassung möglich.
Variants¶
Bei Variants hat jede Variant ihre eigenen Custom-Field-Werte. So kannst Du z.B.:
- Hauptprodukt: 2 Jahre HP-Garantie
- Variant A (Refurbished): keine zusätzliche Garantie
- Variant B (Open Box): 1 Jahr verkürzt
Allerdings ist die Pflege dann pro Variant nötig – kein Bulk-Inherit-Modus aktuell.
Anzeige im Bestellprozess¶
Wenn in der Plugin-Konfig aktiviert, erscheint der Garantie-Hinweis ebenfalls:
- Im Warenkorb unter jeder Position (kompakter Badge)
- In der Bestellbestätigung als Footer-Block
- Auf dem Lieferschein (PDF) als Footer
Das hilft, die Compliance-Hinweise auch im After-Sales-Prozess sichtbar zu halten.
Weiter¶
- Konfiguration – Anzeige, Sales-Channel, Mail-Templates
- Rechtlicher Hintergrund – warum das überhaupt nötig ist