PIM für Shopware 6 — Handbuch

Systemvoraussetzungen

Das PIM-Plugin läuft in jeder Standard-Installation von Shopware 6 ohne zusätzliche Server-Konfiguration.

• Shopware: 6.5, 6.6 oder 6.7 (alle drei Major-Versionen werden parallel gepflegt)
• PHP: 8.2 oder neuer
• Datenbank: MySQL 8 oder MariaDB 10.11
• Speicher: Standard-Empfehlung von Shopware reicht aus (256 MB+ PHP memory_limit)
• Berechtigungen: Shopware-Admin-Zugang als Administrator-Rolle

Installation

Die Installation erfolgt über den Shopware Store oder per manuellem Upload.

Über den Shopware Store

1. Im Shopware-Admin unter Erweiterungen → Store nach "PIM für Shopware" suchen.
2. Plugin laden — es erscheint danach unter Erweiterungen → Meine Erweiterungen.
3. Mit Klick auf Installieren wird das Plugin installiert. Anschließend Aktivieren.

Manuelle Installation

1. ZIP-Datei aus dem Shopware Store herunterladen.
2. Im Shopware-Admin unter Erweiterungen → Meine Erweiterungen die ZIP-Datei hochladen.
3. Installieren und aktivieren wie oben.

Plugin aktivieren

Nach der Installation muss das Plugin aktiviert werden. Beim Aktivieren werden folgende Vorgänge ausgeführt:

• Anlage der Plugin-Konfigurationseinträge in der Datenbank.
• Registrierung der ACL-Berechtigungen (siehe Berechtigungen).
• Registrierung der Menüpunkte in der Shopware-Admin-Sidebar.
• Aufbau der initialen Konfigmatrix mit Defaults.

PIM aufrufen

Nach der Aktivierung erscheint der Menüpunkt PIM in der Shopware-Admin-Sidebar. Beim ersten Aufruf wird das Listing aller Produkte geladen (Sichtbar gemäß Sales-Channel-Berechtigungen des angemeldeten Users).

Das PIM ersetzt nicht die Standard-Produktverwaltung von Shopware, sondern ergänzt sie um eine alternative Bedienoberfläche, die für Massenoperationen optimiert ist.

Konfigmatrix

Die Konfigmatrix ist das zentrale Steuerungselement des Plugins. Sie liegt unter Einstellungen → System → PIM-Konfiguration und steuert sechs Bereiche:

1. Sichtbare Felder im Listing — welche Spalten standardmäßig angezeigt werden.
2. Editierbare Felder in Mehrfachänderung — welche Felder für Bulk-Edit zur Verfügung stehen.
3. Aktive Sprachen — welche Sprachen im PIM gepflegt werden können.
4. Default-Muster für Varianten-Generator — SKU- und Name-Patterns als Vorlage.
5. KI-Anbieter-Konfiguration — welche Anbieter aktiv sind, welche Modelle, mit welchem Tone.
6. Export-Einstellungen für CSV — welche Spalten standardmäßig im Export enthalten sind.

Änderungen in der Konfigmatrix wirken sich sofort auf alle Nutzer aus, ohne dass diese den Browser neu laden müssen.

Berechtigungen

Das Plugin nutzt das Standard-ACL-System von Shopware. Folgende Berechtigungen werden registriert und können pro Rolle einzeln vergeben werden:

• staw_pim.viewer — PIM aufrufen und Listing anzeigen (lesend)
• staw_pim.editor — Inline-Bearbeitung und Mehrfachänderung
• staw_pim.csv_export — CSV-Export-Funktion
• staw_pim.csv_import — CSV-Import-Funktion
• staw_pim.variant_generator — Varianten-Generator
• staw_pim.ai_textgen — KI-Textgenerierung
• staw_pim.config — Konfigmatrix bearbeiten

Vergabe unter Einstellungen → System → Benutzer und Berechtigungen → Rollen.

Sprachen

Das PIM unterstützt alle in Shopware angelegten Sprachen. Sichtbar und editierbar werden Sprachen, die in der Konfigmatrix als aktiv markiert sind.

Pro Sprache wird ein eigener Tab im Detail-Editor angeboten. Bei der Mehrfachänderung kann die Zielsprache pro Operation gewählt werden.

Sales Channels

Sales-Channel-Sichtbarkeit wird im Listing als Spalte angezeigt und kann per Mehrfachänderung pro Produkt gepflegt werden. Für mehrkanalige Setups gibt es einen Sales-Channel-Filter, der das Listing auf Produkte eingeschränkt anzeigt, die in einem bestimmten Kanal sichtbar sind.

Aufbau des Listings

Das zentrale Produktlisting ist die Hauptansicht des PIM. Es zeigt alle Produkte deines Shops in einer datentabellenartigen Ansicht mit folgenden Elementen:

• Filter-Bar oben — beliebig viele Filter-Bedingungen mit UND/ODER-Verknüpfung
• Spalten-Header — sortierbar, breitenanpassbar, ein-/ausblendbar
• Datenzeilen — pro Produkt eine Zeile, mit Variantenartikel-Aufklappen on-demand
• Footer-Toolbar — Auswahl-Anzahl, Bulk-Aktionen, Export/Import-Buttons
• Bottom-Save-Bar — erscheint bei aktiven Inline-Änderungen mit Speichern/Verwerfen

Das Listing nutzt native HTML-Tabellen-Virtualisierung, sodass auch große Kataloge (5.000+ Produkte) flüssig scrollen.

Filter mit UND/ODER

Filter-Bedingungen können beliebig kombiniert werden:

• 9 Vergleichsmodi pro Feld: enthält, enthält nicht, ist gleich, ist nicht gleich, beginnt mit, endet mit, ist leer, ist nicht leer, ist in Liste
• UND/ODER-Logik zwischen Filter-Bedingungen — auch verschachtelt
• Variantsartikel-aware — Filter berücksichtigen sowohl Hauptartikel als auch Varianten
• Verfügbar für alle Felder inklusive Custom Fields und mehrsprachiger Felder

Beispiele

• Alle Produkte mit Bestand < 5 UND Kategorie "Reduziert"
• Alle Produkte ohne Beschreibung ODER ohne Bild
• Alle Varianten mit Farbe "rot" UND Hersteller "Nike"

Spalten konfigurieren

Sichtbare Spalten lassen sich pro User individuell konfigurieren:

• Hinzufügen über Plus-Icon oben rechts — alle verfügbaren Felder sind durchsuchbar
• Reihenfolge per Drag-and-Drop änderbar
• Breite per Drag am Spalten-Rand
• Sortierung per Klick auf den Spaltenkopf

Alle Einstellungen werden pro User in der Datenbank gespeichert und sind nach Login auf einem anderen Gerät wieder verfügbar.

Filter- und Spalten-Presets

Häufig genutzte Filter- und Spalten-Konfigurationen können als Preset gespeichert werden:

• Eigene Presets — nur für den eigenen User sichtbar
• Geteilte Presets — für andere User mit gleicher Rolle sichtbar
• System-Presets — vom Admin gesetzte Vorlagen, schreibgeschützt

Presets können per Klick aktiviert und mit einer Tastenkombination (Strg+F) durchsucht werden.

Inline-Bearbeitung

Direkt im Listing können Felder per Klick editiert werden. Unterstützte Eingaben:

• Text-Felder — Klick öffnet einfaches Input
• Zahlenfelder — mit Locale-bewusster Tausender-/Dezimaltrennung
• Boolesche Felder — Toggle-Slider
• Auswahl-Felder — Dropdown mit Suche
• Mehrfachauswahl — Chips mit Add/Remove
• Datum/Zeit — natives Date-Picker

Änderungen werden sofort an die Bottom-Save-Bar gemeldet. Speichern erst per Klick — bis dahin sind alle Änderungen lokal und verwerfbar.

Tastenkürzel: Enter bestätigt, Esc bricht ab, Tab springt zum nächsten Feld.

Variantenanzeige

Variantsartikel werden im Listing als Hauptartikel-Zeile dargestellt. Per Klick auf das Plus-Icon werden die Varianten inline darunter aufgeklappt, ohne Page-Wechsel.

Im aufgeklappten Zustand:

• Varianten erscheinen eingerückt unter dem Hauptartikel
• Pro Variante eigene Inline-Bearbeitung
• Filter werden auf Varianten angewendet (variantsartikel-aware)
• Mehrfachauswahl kann Hauptartikel und Varianten kombinieren

Mehrfachänderung — Übersicht

Die Mehrfachänderung ist eine der zentralen Funktionen des PIM. Sie ermöglicht es, in einem Vorgang Felder bei beliebig vielen ausgewählten Produkten gleichzeitig zu ändern.

Ablauf

1. Produkte im Listing auswählen (über Checkboxen oder "Alle auswählen")
2. Klick auf Mehrfachänderung in der Footer-Toolbar
3. Dialog öffnet sich — Zielfeld wählen, neuen Wert eingeben
4. Live-Vorschau zeigt für jedes Produkt das Ergebnis
5. Bestätigen — Operation wird ausgeführt mit Progress-Anzeige
6. Snapshot wird automatisch angelegt für Revert-Option

Editierbare Felder

Per Mehrfachänderung können 25+ Felder gepflegt werden:

Stammdaten

• Name (pro Sprache)
• Beschreibung (pro Sprache)
• Meta-Title, Meta-Description, Keywords
• Hersteller
• EAN, Artikelnummer

Preise

• Listenpreis und UVP
• Staffelpreise (Bulk-Apply auf alle Staffeln)
• Grundpreis und Grundpreiseinheit
• Steuersatz

Bestand und Versand

• Bestand
• Lieferzeit
• Versandfrei-Flag
• Gewicht, Höhe, Breite, Länge

Sales Channels und Kategorien

• Sales-Channel-Sichtbarkeit (mehrere parallel)
• Hauptkategorie
• Zusatzkategorien
• Cross-Selling-Zuordnungen

Properties und Custom Fields

• Properties (zuweisen und entfernen)
• Custom Fields aller Typen
• Tags

Snapshot & Revert

Bei jeder Mehrfachänderung wird automatisch ein Snapshot der vorherigen Werte gespeichert. Damit kann eine versehentliche Operation rückgängig gemacht werden.

• Snapshots bleiben 30 Tage erhalten
• Übersicht aller Snapshots unter PIM → Snapshots
• Revert pro Produkt einzeln möglich oder für die gesamte Operation
• Diff-Anzeige: vorher/nachher direkt im Snapshot-Detail

Live-Vorschau

Vor dem Speichern zeigt eine Tabelle für jedes ausgewählte Produkt:

• Aktuellen Wert
• Neuen Wert nach Operation
• Diff-Markierung bei Text-Feldern
• Hinweis, wenn das Feld bei einem Produkt nicht änderbar ist (zum Beispiel bei aktivem Vererbungsmodus)

Grenzen und Hinweise

• Maximalanzahl: keine harte Grenze — getestet mit 10.000 Produkten in einem Vorgang.
• Speicherdauer Snapshots: 30 Tage. Danach werden sie automatisch gelöscht.
• Variantenartikel: Eine Änderung am Hauptartikel wirkt sich auf Vererbung an Varianten aus. Eine Warnung zeigt das im Dialog.
• Konfigmatrix: Welche Felder editierbar sind, steuerst du in der Konfigmatrix — Felder, die dort deaktiviert sind, erscheinen nicht im Bulk-Dialog.

CSV-Export

Der CSV-Export erzeugt eine Datei mit allen oder gefilterten Produkten. Konfigurierbar über Konfigmatrix → Export.

• Spalten beliebig auswählbar — Standard-Felder, Custom Fields, Properties, Übersetzungen
• Trenner wählbar: Komma, Semikolon, Tab
• Encoding: UTF-8 (mit BOM-Option für Excel-Kompatibilität)
• Filter berücksichtigen: Aktive Listing-Filter werden auf den Export angewandt

Berechtigung erforderlich: staw_pim.csv_export.

CSV-Import

Der CSV-Import liest eine Datei und legt neue Produkte an oder aktualisiert bestehende. Match-Logik: per Artikelnummer (productNumber).

Ablauf

1. Datei hochladen (Drag-and-Drop oder File-Picker)
2. Spalten-Mapping anzeigen — automatische Erkennung anhand der Header
3. Mapping anpassen, falls Spaltennamen abweichen
4. Datentyp-Erkennung-Vorschau prüfen
5. Trockenlauf (Dry-Run) zeigt: Wieviele neu, wieviele Update, wieviele übersprungen
6. Echter Import läuft mit Progress-Bar und ETA

Berechtigung erforderlich: staw_pim.csv_import.

Datentyp-Erkennung

Der Importer erkennt Datentypen automatisch je Sprache und Spalte:

• Boolean: 1/0, true/false, ja/nein, aktiv/inaktiv
• Datum: ISO-Notation (2026-05-15) und deutsche Notation (15.05.2026) — beide funktionieren
• Zahl: Komma oder Punkt als Dezimaltrenner, Tausender-Trenner werden erkannt
• Array: Pipe-Separator (|) bei Multi-Select-Custom-Fields
• JSON: bei komplexen Feldern wie Übersetzungen

Mehrsprachige Felder

Pro Sprache wird eine eigene Spalte angelegt. Spaltennamen folgen dem Muster name_de-DE, name_en-GB.

Beim Import:

• Sprach-Spalten werden automatisch erkannt
• Vorhandene Übersetzungen werden ergänzt, nicht überschrieben (JSON-Merge)
• Leere Zellen führen nicht zu Datenverlust — sie werden ignoriert

Spalten-Mapping

Falls die CSV-Header nicht mit Shopware-Feldnamen übereinstimmen, kann das Mapping manuell überschrieben werden:

• Per Drag-and-Drop zwischen CSV-Spalte und Shopware-Feld
• Mapping kann als Vorlage gespeichert werden (für wiederkehrende Imports)
• Vorlagen sind pro User oder Shop-weit verfügbar

Import-Protokoll

Jeder Import wird protokolliert. Übersicht unter PIM → Import-Historie:

• Zeitstempel, User, Anzahl Datensätze
• Erfolge (neu / aktualisiert / übersprungen)
• Fehler mit Zeilennummer und Begründung
• Download der originalen CSV-Datei möglich (30 Tage Aufbewahrung)

Varianten-Generator — Eigenschaftsauswahl

Der Varianten-Generator erzeugt aus Property-Kombinationen automatisch Varianten zu einem Hauptartikel.

Auswahl-Modus

• Visuelle Auswahl aller Properties des Shops mit Suche
• Property-Werte werden gruppiert angezeigt (zum Beispiel "Farbe → rot/blau/grün")
• Per Klick werden Werte zur Auswahl hinzugefügt
• Live-Vorschau der Kombinationen unten

Beispiel

Auswahl: Farbe (rot, blau, grün) × Größe (S, M, L) = 9 Varianten.

Muster für SKU und Name

Pro Variante können SKU und Name automatisch erzeugt werden anhand eines Musters.

Verfügbare Variablen

• {base} — SKU des Hauptartikels
• {property:Farbe} — Wert der Property "Farbe" für diese Variante
• {property:Größe} — Wert der Property "Größe"
• {counter} — fortlaufende Nummer (1, 2, 3, …)
• {counter:03} — mit führenden Nullen (001, 002, …)

Beispiele

• SKU-Muster: {base}-{property:Farbe}-{property:Größe} → SW-1001-rot-S
• Name-Muster: {base} ({property:Farbe}, {property:Größe}) → T-Shirt Basic (rot, S)

Live-Vorschau

Während der Konfiguration zeigt eine Tabelle die ersten 8 zu erzeugenden Kombinationen mit konkretem SKU und Name. Bei mehr als 8 Varianten erscheint ein "+ X weitere"-Hinweis.

Vor dem Erzeugen wird die exakte Gesamtanzahl angezeigt.

Standard-Muster

SKU- und Name-Muster können global in der Konfigmatrix als Default gesetzt werden. Dann werden sie automatisch im Generator vorausgefüllt.

Per-Produkt-Override möglich: Im Produktdetail unter "Varianten-Generator" können abweichende Muster gespeichert werden, die für diesen Hauptartikel statt der globalen Defaults greifen.

Sicheres Löschen

Beim Löschen von Varianten prüft das Plugin auf offene Bestellungen.

• Modus "Sicher" (empfohlen): Varianten mit offenen Bestellungen werden nicht gelöscht. Stattdessen werden sie deaktiviert und aus dem Verkauf genommen. Daten bleiben erhalten für Buchhaltung und Reklamationen.
• Modus "Vollständig": Varianten werden gelöscht, auch wenn Bestellungen vorliegen. Achtung: kann Buchhaltungs- und Reklamations-Workflows betreffen.

KI-Textgenerierung — Anbieter und Modelle

Das PIM integriert zwei KI-Anbieter direkt im Shopware-Admin. Beide können parallel aktiv sein — Auswahl pro Operation.

• Anthropic Claude: Haiku 4.5, Sonnet 4.6, Opus 4.6 / 4.7
• OpenAI ChatGPT: GPT-4o Mini, GPT-4o, GPT-4.1 Mini, GPT-4.1

Aufrufe erfolgen serverseitig — der eigene API-Key wird nicht an den Browser ausgeliefert.

API-Key einrichten

Beide Anbieter benötigen einen eigenen API-Key. Abrechnung läuft direkt mit dem Anbieter.

Einrichtung

1. Unter console.anthropic.com oder platform.openai.com einen API-Key erzeugen.
2. Im PIM unter Konfigmatrix → KI den Key eintragen.
3. Mit "Verbindung testen" prüfen, ob der Key gültig ist.
4. Mit "Bulk freischalten" aktivieren für die Mehrfachänderung.

Was kann generiert werden

Der KI-Generator erzeugt vier Feldtypen, einzeln oder zusammen:

• Beschreibung (HTML): ausformulierte Produktbeschreibung mit Absatzstruktur
• Meta-Title: max 60 Zeichen, SEO-optimiert
• Meta-Description: max 155 Zeichen, SEO-optimiert
• Keywords: komma-separierte Liste

Generierung erfolgt für ein einzelnes Produkt im Detail-Editor oder per Mehrfachänderung für viele Produkte parallel.

Kontext-Kontrolle

Pro Generierung kann gesteuert werden, welche Daten dem KI-Anbieter mitgegeben werden:

• Name (immer enthalten)
• Vorhandene Beschreibung als Inspirationsbasis
• Eigenschaften aus Properties
• Custom Fields mit relevantem Inhalt
• Hersteller, Kategorie

Pro Feld einstellbar per Chip ("Mit Properties", "Mit Beschreibung", "Mit Custom Fields"). So lässt sich die Token-Anzahl pro Aufruf kontrollieren.

Stilvorlagen

5 vordefinierte Tone-Templates stehen zur Auswahl:

• Professionell: sachlich, faktenorientiert
• Locker-modern: direkter, jüngerer Tone
• Premium/Luxus: erlesener Ausdruck, sensorische Sprache
• Technisch: präzise, mit Fachterminologie
• Emotional: Storytelling-Ansatz, Nutzererfahrung im Fokus

Standard-Tone pro Shop in der Konfigmatrix setzbar, Override pro Operation möglich.

Kosten und Limits

Abrechnung erfolgt direkt mit dem Anbieter (Anthropic oder OpenAI). Das PIM verlangt keine zusätzlichen Gebühren.

• Token-Anzeige: Pro Aufruf werden geschätzte Tokens und Kosten in € angezeigt
• Bulk-Limits: Konfigurierbare Obergrenze (zum Beispiel "max 100 Produkte / Bulk-Aufruf") als Sicherheitsnetz
• Kostenwarnung: Wenn der geschätzte Bulk-Aufruf eine konfigurierbare Schwelle übersteigt (Standard: 5 €), erscheint eine Bestätigungs-Dialog

Cross-Selling-Pflege

Cross-Selling-Streams können pro Produkt manuell oder per Bulk gepflegt werden.

• Manuell: Produktdetail → Tab "Cross-Selling" → Drag-and-Drop aus Produktsuche
• Bulk: Per Mehrfachänderung — Operation "Cross-Selling-Stream zuordnen"
• Vererbung auf Varianten möglich (mit Hinweis im Dialog)

Preise und Staffeln

Preise lassen sich pro Produkt mit allen Shopware-Standard-Optionen pflegen:

• Listenpreis, UVP, Nettopreis pro Customer-Group
• Staffelpreise: ab X Stück = Preis Y
• Grundpreis und Grundpreiseinheit
• Steuersatz
• Bulk-Apply: Preis-Änderungen auf hunderte Produkte gleichzeitig

Properties

Properties (in Shopware "Eigenschaften") werden im PIM als zusätzliche Spalten im Listing angezeigt und sind über die Mehrfachänderung pflegbar.

• Property-Werte zuweisen: Mehrfachauswahl im Bulk-Dialog
• Property-Werte entfernen: Bulk-Aktion "Property entfernen"
• Neue Property anlegen: direkt im Detail-Editor möglich (mit Berechtigung)

Custom Fields

Alle Shopware-Custom-Fields stehen automatisch im PIM zur Verfügung — keine zusätzliche Konfiguration nötig.

• Alle Typen unterstützt: Text, Zahl, Boolean, Datum, Auswahl, Mehrfachauswahl, JSON
• Per-Language Custom Fields werden mit Sprach-Tab angezeigt
• Filterbar im Listing wie Standard-Felder
• Editierbar per Inline-Edit und Mehrfachänderung

Kategorien

Kategorien werden im Listing als Hierarchie-Pfad angezeigt. Bearbeitung:

• Hauptkategorie pro Sales-Channel zuweisbar
• Zusatzkategorien (Mehrfachzuordnung)
• Bulk-Apply: Kategorie für 100+ Produkte gleichzeitig setzen
• Hierarchie-Auswahl per Tree-Picker

Medien

Medien (Bilder, Videos) sind im PIM-Listing per Thumbnail sichtbar.

• Bilder per Drag-and-Drop hochladen direkt im Listing
• Sortierung der Bilder per Drag
• Cover-Bild markieren
• Alt-Texte pro Sprache pflegbar

Für massenhafte Medien-Uploads ist der Shopware-Standard-Media-Manager weiterhin der bessere Weg — das PIM ergänzt nur Quick-Edits direkt am Produkt.

Performance

Das PIM ist auf große Kataloge ausgelegt.

• Native Virtualisierung: Das Listing rendert nur sichtbare Zeilen — auch bei 50.000+ Produkten flüssig
• Server-side Filtering: Alle Filter werden in der Datenbank ausgeführt, nicht im Browser
• Lazy-Loading: Varianten werden erst bei Aufklappen geladen
• Bulk-Operations: Batchgrößen sind konfigurierbar — bei großen Operationen wird in Batches gespeichert mit Progress

Troubleshooting

Listing lädt nicht

• Cache leeren: Einstellungen → Caches & Indizes → Cache leeren
• Browser-Konsole prüfen — JavaScript-Fehler deuten meist auf Konflikt mit anderem Plugin hin
• PHP-Memory-Limit prüfen — bei sehr großen Katalogen 512 MB empfohlen

CSV-Import bricht ab

• Encoding prüfen — UTF-8 empfohlen
• Trenner prüfen — bei Excel-Exports oft Semikolon statt Komma
• PHP-Limits prüfen: upload_max_filesize, post_max_size, max_execution_time

KI-Generierung schlägt fehl

• API-Key prüfen unter Konfigmatrix → KI → Verbindung testen
• Bei Anthropic: Guthaben aufladen unter console.anthropic.com
• Bei OpenAI: Billing-Status prüfen unter platform.openai.com/billing
• Server-Logs prüfen: var/log/prod-*.log in der Shopware-Installation

Kontakt & Support

Bei Fragen zu Features, Bug-Reports oder Wünschen für neue Funktionen:

• Feature anfragen: über das Formular auf pim-shopware.de
• Häufige Fragen: FAQ mit 76 Antworten
• E-Mail-Support: Über das Kontaktformular oder direkt unter pim@stoneandwater.online
• Hersteller: Stone & Water — Shopware-Agentur aus Schöppingen

Antwortzeit: in der Regel 1–2 Werktage.