Produkte verwalten

Produkte sind das Herzstück des Shops. Diese Anleitung erklärt den gesamten Lebenszyklus eines Produkts – von der Anlage über die Variantenpflege bis zur Deaktivierung.

Ort

Dashboard → Katalog → Produkte

Produkt anlegen

1. Grunddaten

1. Auf „Neues Produkt“ klicken
2. Produkttyp wählen – dieser legt fest, welche Attribute verfügbar sind
3. Titel und Beschreibung eingeben
4. Produktklasse zuweisen – steuert u.a. ob Pfand erhoben wird und ob das Produkt versandpflichtig ist

2. Kategorisierung

1. Eine oder mehrere Kategorien zuweisen (Mehrfachauswahl möglich)
2. Die erste Kategorie wird als Hauptkategorie verwendet (Breadcrumbs, URL)
3. Reihenfolge innerhalb der Kategorie kann per Drag & Drop im Kategorie-Baum angepasst werden

3. Bilder & Medien

1. Im Tab „Bilder“ neue Bilder hochladen
2. Das erste Bild wird automatisch als Hauptbild in Listen und der Detailseite verwendet
3. Reihenfolge per Drag & Drop anpassen
4. Unterstützte Formate: JPG, PNG, WebP
5. Empfohlene Größe: mindestens 800×800 Pixel
6. Bilder werden automatisch in folgende Größen skaliert:
   • Thumbnail (für Listen)
   • Medium (für Detailseite)
   • Large (für Lightbox)

4. Preis & Lager

1. Tab „Preis & Lager“ öffnen
2. Partner auswählen (in der Regel der Standard-Partner)
3. Preis inkl. MwSt. eingeben – Netto und MwSt. werden automatisch berechnet
4. Bestandsanzahl setzen (0 = nicht vorrätig, leer = unbegrenzt)
5. Lagerort optional für die Warenwirtschaft

Preisangabe

Preise werden inklusive Mehrwertsteuer erfasst. Der Netto-Preis und die MwSt. werden automatisch berechnet und in der API entsprechend ausgewiesen.

5. SEO & Metadaten

Feld	Beschreibung
Slug	URL-Pfad (wird aus dem Titel generiert, kann manuell angepasst werden)
Meta-Titel	Browser-Titel (falls abweichend vom Produkttitel)
Meta-Beschreibung	SEO-Description (max. 160 Zeichen empfohlen)
UPC/GTIN	Barcode für Preisvergleichsportale und Warenwirtschaft

6. Produktattribute

Je nach Produkttyp stehen unterschiedliche Attribute zur Verfügung:

Produkttyp	Typische Attribute
Getränkekiste	Inhalt (Liter), Anzahl Flaschen, Pfandbetrag, Mehrweg
Einzelflasche	Inhalt (Liter), Pfand, Einweg/Mehrweg
Fass	Inhalt (Liter), Anschlusstyp, Pfandbetrag

Varianten (Kind-Produkte)

Ein Produkt kann Varianten haben (z.B. verschiedene Größen oder Farben). Das Elternprodukt dient dann als Gruppierung und wird aus dem Shop ausgeblendet.

Varianten anlegen

1. Elternprodukt öffnen → Tab „Varianten“
2. Auf „Neue Variante“ klicken
3. Varianten-Attribute setzen
4. Variante speichern

Verhalten

• Sobald ein Produkt Varianten hat, wird das Elternprodukt automatisch ausgeblendet
• Jede Variante hat eigene Preise, Lagerbestände und Bilder
• Attribute des Elternprodukts werden an Varianten vererbt, können aber überschrieben werden
• In der Kategorie-Ansicht erscheint die günstigste Variante mit „ab“-Preis

Massenbearbeitung

Für die gleichzeitige Bearbeitung mehrerer Produkte:

1. In der Produktliste die gewünschten Produkte per Checkbox auswählen
2. Über das Dropdown „Aktion“ eine Massenaktion wählen:
   • Preise aktualisieren – Prozentuale oder absolute Änderung
   • Kategorie zuweisen/entfernen
   • Status ändern – Aktivieren/Deaktivieren
   • Produktklasse ändern
3. Auf „Ausführen“ klicken

Pfand

Produkte können pfandpflichtig sein. Dies wird über die Produktklasse gesteuert (Feld is_deposit):

1. Produkt öffnen
2. Produktklasse prüfen
3. Der Pfandbetrag wird im Warenkorb separat ausgewiesen
4. Pfand zählt nicht zum Warenkorbwert für Versandkosten-Schwellwerte oder Rabatt-Berechnungen

Produkt deaktivieren

1. Produkt öffnen
2. Haken bei „Ist öffentlich“ entfernen
3. Optional: Datum bis setzen (automatische Deaktivierung)
4. Speichern

Das Produkt bleibt in der Datenbank, wird aber im Shop nicht mehr angezeigt. Bestehende Bestellungen und Links bleiben erhalten.

Produktstruktur (Übersicht)

Produktklasse (ProductClass)
  └── Produkt (Product)
        ├── Kategorie (Category) — Mehrfachzuweisung
        ├── Bilder (ProductImage)
        ├── Preis (StockRecord)
        ├── Attribute (ProductAttributeValue)
        ├── Empfehlungen (ProductRecommendation)
        └── Varianten (parent → Product)
              ├── Preis (StockRecord)
              └── Attribute (ProductAttributeValue)

Wichtige Hinweise

• Ein Produkt darf nicht gelöscht werden, wenn bereits Bestellungen darauf verweisen – stattdessen deaktivieren
• Bei Pfand-Produkten muss die Produktklasse das Flag is_deposit gesetzt haben
• Änderungen an der Produktklasse wirken sich nicht rückwirkend auf bestehende Bestellungen aus