Zum Inhalt springen
Stone & Water

Häufige Fragen

Antworten auf die häufigsten Fragen zum PIM-Plugin für Shopware 6 — sortiert nach Themengebiet.

Allgemeines

Was ist das PIM für Shopware?

Das PIM (Product Information Management) ist ein Plugin für Shopware 6, das die Produktpflege drastisch beschleunigt — mit Mehrfachänderung von 25+ Feldern, mehrsprachigem CSV-Import, Varianten-Generator, KI-Textgenerierung mit ChatGPT und Claude. Alles direkt im Shopware-Admin, ohne ETL-Tool oder Drittsystem.

Mit welchen Shopware-Versionen ist es kompatibel?

Shopware 6.5, 6.6 und 6.7 — alle drei Versionen werden parallel gepflegt. Jede Funktion ist in allen drei Versionen identisch verfügbar.

Brauche ich einen externen Dienst dafür?

Nein. Das PIM läuft komplett auf deinem Shopware-Server. Keine Telemetrie, keine Datenübertragung an Stone & Water. Externe KI-Anbieter (ChatGPT/Claude/DeepL) werden nur kontaktiert, wenn du sie aktiv anstößt — und mit deinen eigenen API-Keys.

Wie installiere ich das Plugin?

Über den Shopware Store: Unter Erweiterungen → Store nach „PIM für Shopware" suchen, installieren, aktivieren. Oder manuell: ZIP herunterladen und unter Meine Erweiterungen hochladen.

Welche PHP-Version brauche ich?

PHP 8.2 oder neuer. Datenbank: MySQL 8 oder MariaDB 10.11. Memory: mindestens 256 MB, 512 MB empfohlen für große Kataloge.

Mehrfachänderung

Welche Felder kann ich bulk-bearbeiten?

Über 25 Felder: Stammdaten (Name, Beschreibung, Meta-Daten, EAN, Hersteller), Preise und Staffelpreise, Einkaufspreis brutto/netto getrennt, Streichpreis/UVP, Omnibus-Preis, Grundpreis, Produkteinheit, Bestand und Versand, Sales-Channel-Sichtbarkeit, Kategorien, Properties, Cross-Selling, Custom Fields aller Typen. Welche Felder verfügbar sind, steuerst du in der Konfigmatrix.

Wie funktioniert der Einkaufspreis brutto/netto?

In der Mehrfachänderung gibt es zwei getrennte Aktionen: „Einkaufspreis brutto setzen" und „Einkaufspreis netto setzen". Du gibst nur einen der beiden Werte an — der jeweils andere wird automatisch über die Steuerklasse des Produkts berechnet. Currency und Linked-Status bleiben erhalten.

Was passiert wenn ich versehentlich etwas Falsches setze?

Vor jeder Bulk-Operation wird automatisch ein Snapshot der vorherigen Werte gespeichert. Per Ein-Klick-Revert aus dem Audit-Log kannst du alles zurückrollen. Snapshots werden 30 Tage aufbewahrt.

Welche Filter werden vor der Mehrfachänderung angezeigt?

Alle aktiven Filter aus dem ausgewählten Preset werden als lesbare Chips dargestellt: Hersteller, Kategorien, Tags, Eigenschaften, Lagerbestand, Preis-Range, Gewicht-Range, Datumsbereiche, Sichtbarkeit, Steuerklasse, Lieferzeit, dynamische Produktgruppen, Verkaufskanal, EAN-Status, Closeout, Versandfrei und SEO-Meta-Status. IDs werden in Klarnamen aufgelöst (z.B. Verkaufskanal-Name statt UUID). „Keine Filter aktiv" wird mit rotem Rahmen als Warnung markiert.

Welche Felder unterstützen Sprachauswahl in der Mehrfachänderung?

Übersetzbare Bulk-Felder zeigen ein Sprachdropdown, sobald ein Wert eingetragen ist. Verfügbar bei: Meta-Title, Meta-Description, SEO-URL (SEO-Tab), übersetzbare Custom Fields (Zusatzfelder), und Verpackungseinheit (Versand-Tab). Der Wert wird in der Standardsprache gesetzt UND in jede gewählte Sprache geschrieben — eine Aktion, mehrere Sprachen gleichzeitig. Bewusst ohne Sprachauswahl: Produkteinheit/Maßeinheit (nur Referenz) und sprachunabhängige Felder (Preis, Lager, EAN, Gewicht, Hersteller, Status, Maße).

Was ist die Aktion „Auf Filter beschränken"?

Wenn du nach einem Variantenfeld filterst und bulk-änderst, will man normalerweise nur die filter-treffenden Varianten anfassen. Mit diesem Toggle bleibt der Parent unangetastet — die Bulk-Aktion folgt dem Filter exakt.

Kann ich mehrere Aktionen in einem Bulk-Lauf kombinieren?

Ja. In einem Vorgang kannst du z.B. Hersteller setzen + Steuersatz ändern + Sales-Channel-Sichtbarkeit + Produkteinheit gleichzeitig — alles in einem Lauf mit einem gemeinsamen Snapshot.

Wie viele Produkte kann ich gleichzeitig ändern?

Keine harte Obergrenze. Getestet mit 10.000 Produkten in einem Vorgang. Bei großen Mengen siehst du Live-Progress mit Counter, Phase (Snapshot/Apply) und ETA — jederzeit abbrechbar.

Was bedeutet „Daten-Vererbung Parent → Varianten"?

Eine dedizierte Bulk-Aktion, die Felder vom Stammartikel auf alle Varianten überträgt: Beschreibung, Staffelpreise, Cross-Selling, Bilder, SEO-Felder. Sinnvoll für Werte, die sich zwischen Varianten nicht unterscheiden.

Welche Felder sind nicht snapshot-fähig?

Drei Felder: SEO-URL (wird generiert, nicht reversibel), Staffelpreise → Varianten und Cross-Selling → Varianten. Bei diesen erscheint im Dialog eine Warnung.

CSV-Import & Export

Kann ich mehrere Sprachen in einer CSV-Datei haben?

Ja. Pro Sprache wird eine eigene Spalte angelegt — Muster name_de-DE, name_en-GB. Auch Custom Fields pro Sprache (cf_meinFeld_de-DE). Beim Import werden Sprach-Spalten automatisch erkannt, vorhandene Übersetzungen ergänzt (JSON-Merge), nicht überschrieben.

Wie funktionieren die Einkaufspreis-Spalten brutto und netto?

Zwei getrennte Spalten: purchasePrice_gross und purchasePrice_net. Beim Import sind alle Kombinationen möglich — nur brutto angeben (netto wird via Steuerklasse berechnet), nur netto angeben (brutto wird berechnet), beide angeben (1:1 übernommen), oder die alte Legacy-Spalte purchasePrice nutzen (rückwärtskompatibel). Der Importer erkennt auch deutsche und englische Schreibweisen automatisch: ek_brutto, einkaufspreis_netto, cost_gross/net.

Wie werden Varianten exportiert?

Als eigene Zeilen. Der Varianten-Export ist pro Profil oder global in der Konfigmatrix aktivierbar. Parents und Varianten erscheinen mit klar identifizierbaren productNumber-Werten in derselben Datei.

Muss ich UUIDs für die Variant-Parents kennen?

Nein. Beim Import lassen sich parentId und mainVariantId auch über Artikelnummer oder EAN auflösen — UUIDs sind nicht zwingend nötig. Lookup-Cache verhindert doppelte Treffer.

Wie funktioniert die Spalte „Einheit (Name)"?

Statt einer kryptischen UUID exportiert das Plugin die Produkteinheit als Klarname („Liter", „Kilogramm", „Stück"). Beim Import wird der Name automatisch in die richtige Shopware-Einheits-ID aufgelöst — Excel-freundlich.

Werden Custom Fields beim Import zerstört?

Nein. Custom-Field-JSON wird gemerged, nicht überschrieben. Wenn nur eine Spalte cf_xy in deiner CSV steht, werden andere Custom-Field-Einträge des Produkts nicht angerührt.

Wie viele Produkte kann ich pro Import verarbeiten?

Bis 10.000 Produkte sind getestet — auch in wenigen Minuten. Alles läuft über die Shopware-Sync-API in Batches mit Progress-Bar und ETA.

Kann der CSV-Import abgebrochen werden?

Ja. Während des Imports siehst du Live-Progress mit Counter, Phasenanzeige und ETA — und einen Abbrechen-Button. Bereits importierte Produkte bleiben dann im Shop, der Rest wird übersprungen.

Wer darf importieren?

Der Import-Tab ist ausschließlich Superadmins zugänglich — zusätzlich zur Berechtigung staw_pim.csv_import. Nicht-Superadmins sehen den Tab nicht.

Varianten-Generator

Wie viele Varianten kann ich auf einmal erzeugen?

Praktisch unlimitiert. Getestet mit 100+ Varianten in einem Lauf in unter 10 Sekunden. Bei sehr vielen Optionen empfiehlt sich die Live-Vorschau, um die exakte Anzahl vorab zu prüfen.

Was ist die „vereinheitlichte Suche"?

Eine einzige Suche oben im Varianten-Generator durchsucht Eigenschaften und Optionen gleichzeitig. Tippst du „rot", bleiben alle Eigenschafts-Gruppen sichtbar, die irgendwo „rot" als Option haben, und die Treffer werden hervorgehoben.

Was sind „Pattern-Akkordeons"?

Artikelnummer- und Variantenname-Muster werden als getrennte Akkordeons angezeigt. Eingeklappt sehen sie aktuelle Pattern als Chip; aufgeklappt erscheint das Eingabefeld plus klickbare Variable-Chips. Klick auf einen Chip fügt die Variable direkt ein.

Was kann die Variantenmatrix?

Sie zeigt alle Varianten eines Produkts in einer Tabelle: eine Achse die erste Eigenschaft, die andere die zweite. Pro Zelle Preis und Bestand direkt editierbar. Spaltenkonfiguration umschaltbar, Eigenschafts-Sortierung per Drag-and-Drop.

Welche Variablen gibt es in Mustern?

{number}, {parentName}, {option1} bis {optionN}, {group1} bis {groupN}, {counter}, {counter:03} (mit führenden Nullen).

Was passiert wenn ich Varianten lösche?

Im Modus „Sicher" (empfohlen) werden Varianten mit offenen Bestellungen nicht gelöscht, sondern deaktiviert. Daten bleiben für Buchhaltung erhalten. Im Modus „Vollständig" werden alle gelöscht — Vorsicht.

KI-Textgenerierung

Welche KI-Anbieter werden unterstützt?

Anthropic Claude (Modelle: Haiku 4.5, Sonnet 4.6, Opus 4.6 / 4.7) und OpenAI ChatGPT (GPT-4o Mini, GPT-4o, GPT-4.1 Mini, GPT-4.1). Beide parallel aktiv nutzbar, mit Provider-Auswahl pro Generierung. Zusätzlich DeepL für reine Übersetzungen.

Brauche ich eigene API-Keys?

Ja. Du erstellst die Keys bei console.anthropic.com bzw. platform.openai.com und trägst sie im PIM unter Konfigmatrix → Übersetzungen ein. Die Keys werden verschlüsselt in der Datenbank gespeichert und nur serverseitig verwendet — sie verlassen niemals den Browser.

Welche Texte kann die KI generieren?

Beschreibung (HTML), Meta-Title (max 60 Zeichen), Meta-Description (max 155 Zeichen) und Keywords (Komma-Liste). Einzeln oder zusammen, für ein Produkt oder per Mehrfachänderung für viele.

Wer zahlt für die KI-Nutzung?

Du, direkt beim Anbieter. Stone & Water erhebt keine zusätzlichen Kosten oder Margen. Das Plugin proxyt nur die Calls.

Wie kontrolliere ich die Kosten?

Pro Aufruf zeigt das PIM geschätzte Tokens und Kosten in € an. Konfigurierbare Bulk-Limits (z.B. „max 100 Produkte/Bulk-Aufruf"). Bei Überschreiten einer Schwelle (Standard: 5 €) erscheint ein Bestätigungs-Dialog.

Kann ich beide KIs parallel nutzen?

Ja. Sind beide aktiv, wählst du im Generator-Modal pro Aufruf den passenden Anbieter — Claude für anspruchsvolle Beschreibungen, ChatGPT für schnelle Meta-Daten zum Beispiel.

Was sind die fünf Stilvorlagen?

Professionell (sachlich), Locker-modern (jüngerer Ton), Premium/Luxus (sensorisch), Technisch (Fachterminologie), Emotional (Storytelling). Standard pro Shop in der Konfigmatrix setzbar, Override pro Operation.

Konfiguration & UX

Was steckt in der „Konfigmatrix"?

Die zentrale Steuerung des Plugins. Sieben Tabs für: sichtbare Listing-Spalten, editierbare Bulk-Felder, aktive Sprachen, Varianten-Default-Muster, KI-Anbieter-Konfiguration, CSV-Export-Einstellungen, sichtbare Quickview-Felder.

Was ist die Sektionsreihenfolge per Drag-and-Drop?

Die Reihenfolge der Sektionen in der Produkt-Detailansicht (Stammdaten, Preise, Medien, SEO, …) und im Varianten-Modal lässt sich per Drag-and-Drop frei festlegen. Sektionen ohne aktivierte Felder werden automatisch ausgeblendet.

Was bedeutet „Eigenes SEO-URL-Pattern pro Shop"?

In der Konfigmatrix unter SEO-URL gibt es eine Toggle-Option. Aktiviert → erscheint ein durchsuchbares Shop-Dropdown. Pro Verkaufskanal lässt sich ein abweichendes URL-Pattern festlegen. Shops ohne eigenes Pattern verwenden weiterhin das Standard-Pattern (als Placeholder sichtbar). Variablen-Chips fügen in das fokussierte Feld ein; die Live-Vorschau zeigt das Pattern des gewählten Shops.

Werden auch SEO-URLs für Varianten erzeugt?

Ja. Der SEO-URL-Generator schrieb bisher nur für Stammartikel — jetzt auch für Varianten. Geerbte Felder (Name, Hersteller, Kategorien, Hauptkategorie inkl. sales-channel-spezifischer) werden aus dem Eltern-Produkt aufgelöst. Variantenspezifische Werte wie {options} bleiben die der Variante.

Wie funktioniert der Standard-Steuersatz?

Beim Anlegen eines neuen Produkts wird automatisch der erste Steuersatz aus dem System vorausgewählt (sortiert nach position ASC). Brutto/Netto-Berechnung funktioniert sofort, ohne Klick.

Was bewirkt das Validation-Modal?

Speichern bei leeren Pflichtfeldern: statt einer Warn-Banner-Wand öffnet sich ein Modal mit allen Fehlern. Klick auf einen Fehler springt direkt zur Sektion — sie wird aufgeklappt, das Feld wird mit indigo Outline hervorgehoben.

Was tut das Quickview-Modal?

Ein kompaktes Modal direkt aus dem Listing — zeigt Stammdaten, Preise (Brutto/Netto inkl. Einkaufspreis brutto+netto getrennt), Bestand, SEO und Beschreibung zum direkten Editieren. Der Modal-Header zeigt den Variantennamen groß vorne und die Artikelnummer dahinter — analog zur Stammartikel-Variantenmaske. Alle Eingabefelder einheitlich mit 42 px Höhe. „Alles ausklappen / einklappen"-Button im Header. Sektionen sind konfigurierbar und werden ohne aktivierte Felder automatisch ausgeblendet.

Was kann ich inline im Listing bearbeiten?

Bestand, Preis, EAN, Herstellernummer, Gewicht und Aktiv-Toggle direkt in der Zeile — auch für Varianten. Nach dem Speichern wird der Wert verifiziert; wenn Shopware ihn verwirft, erscheint ein Warnhinweis statt fälschlich Erfolg.

Feed-Generator

Was ist ein Feed und wofür brauche ich das?

Ein Feed liefert deine Produktdaten unter einer eindeutigen, tokenisierten URL aus — automatisch aktualisiert, ohne manuellen Export. Typische Empfänger: Google Shopping, idealo, Billiger.de, ERP-Systeme oder Auswertungs-Pipelines.

Wie lege ich einen Feed an?

Oben im Feeds-Tab gibt es den Selektor „Feed aus Vorlage / Profil anlegen". Du wählst entweder eine Built-in-Vorlage (Stammdaten, Preise & Lager, SEO, Bilder, Varianten, Vollexport) oder ein eigenes gespeichertes Export-Profil. Ein Klick → Profil wird angelegt, Feed aktiviert, Token generiert, URL ist sofort abrufbar.

Wie sieht die Feed-Liste aus?

Alle Feeds als kompakte Akkordeon-Liste. Pro Zeile siehst du: Name, Status-Pille („Feed aktiv"/„kein Feed"), Feed-URL-Vorschau, Filtervorlage-Chip, Produktanzahl-Chip (live aus dem Katalog), Stift-Symbol zum Bearbeiten und Papierkorb-Symbol zum Löschen. Klick auf die Zeile öffnet und schließt den Editor zuverlässig (Chevron rechts dreht sich).

Kann ich einen Feed umbenennen?

Ja. Im aufgeklappten Editor gibt es ein Namensfeld. Der Name muss eindeutig sein — Kollisionen mit vorhandenen Feeds oder Built-in-Profilen werden abgelehnt. Aktives Profil, Anzahl-Chip und Editor-Zustand wandern automatisch auf den neuen Namen.

Wie lösche ich einen Feed?

Über das Papierkorb-Symbol rechts in der Zeile. Es kommt eine Sicherheitsabfrage. Der Lösch-Button reagiert separat vom Klick auf die Zeile — du klappst also nichts versehentlich auf, wenn du löschst.

Kann ich mehrere Feeds für dasselbe Profil anlegen?

Ja. Feeds sind über einen eigenen Storage-Key (exportFeeds) vom Quell-Profil entkoppelt. Du kannst beliebig viele Feeds für dasselbe Profil anlegen — z.B. ein „Stammdaten"-Profil als Basis für mehrere Feeds mit unterschiedlichen Filtervorlagen pro Verkaufskanal oder Zielmarkt.

Welche Filterkriterien werden im Feed angewendet?

Im Feed-Editor wählst du eine gespeicherte Filtervorlage. Übernommen werden die serverseitig zuverlässig abbildbaren Kriterien: Aktiv-Status, Lagerbestand, Hersteller, Kategorie, Verkaufskanal. Diese werden vom FeedExportService direkt im CSV/XML angewendet (inkl. Varianten-Vererbung auf den Hauptartikel).

Warum werden Qualitätskriterien im Feed nicht angewendet?

Qualitäts-/Vollständigkeitskriterien aus der Filtervorlage (z.B. „Bilder fehlen", „Meta-Daten unvollständig", „ohne Beschreibung", „SEO-Score < X") werden bewusst nicht angewendet — diese Bewertungen werden im Listing live berechnet und sind im Feed-Kontext nicht zuverlässig serverseitig abbildbar. Würde der Feed sie still anwenden, würde dein ERP eine verfälschte Produktmenge bekommen. Mit der klaren Trennung weißt du genau: Filtervorlage definiert welche Produkte, der Feed liefert diese Produkte.

Wie sehe ich die Produktanzahl pro Feed?

In jeder Feed-Zeile steht ein Produktanzahl-Chip. Dieser Wert wird live aus dem Katalog ermittelt (über die Filtervorlage-Kriterien) und aktualisiert sich, wenn du eine andere Filtervorlage wählst.

Was passiert mit meinen bisherigen Feeds beim Update?

Bestehende Feeds, die am Export-Profil hingen, werden beim ersten Laden automatisch in die neue Liste übernommen. Bestehende Feed-URLs in deinem ERP, Google-Shopping-Konto oder bei Preisvergleichsportalen bleiben gültig — kein Re-Konfigurieren nötig.

Welche Formate liefert ein Feed?

XML, CSV, TSV und JSON. URL-Format: https://dein-shop.de/staw-pim/feed/{token}.xml (entsprechend mit anderer Endung).

Wie ist die Sicherheit des Feeds?

Feed-URLs sind tokenisiert und nicht öffentlich indexierbar (kein Eintrag in der sitemap.xml, noindex-Header). Wer den Token nicht hat, sieht nichts. Der Token kann jederzeit per Klick regeneriert werden — die alte URL wird damit ungültig.

Wie performant ist der Feed bei großen Katalogen?

Sehr — der Feed ist gezielt für große Kataloge ausgelegt. Vier Performance-Layer arbeiten zusammen: (1) DBAL-Streaming in 2.000er-Batches (Daten werden per PHP-Generator zeilenweise ausgegeben, kein Komplett-Laden im Speicher). (2) Keyset-Pagination über die Artikelnummer statt LIMIT/OFFSET (bleibt linear schnell, auch auf tiefen Seiten). (3) gzip-Komprimierung mit ~80–90 % Reduktion bei Text-CSVs. (4) Datei-Modus mit vorgenerierter Datei alle 15 Min. Damit laufen auch Kataloge mit zehntausenden Produkten ohne Memory-Probleme durch.

Wird der Feed komprimiert ausgeliefert?

Ja, automatisch. Wenn der Client Accept-Encoding: gzip sendet (alle modernen ERP-/Crawler-/Browser-Clients tun das), wird die Antwort serverseitig per gzencode() komprimiert und mit Content-Encoding: gzip + Vary: Accept-Encoding ausgeliefert. Feed-CSVs komprimieren typisch um 80–90 % — eine 50 MB CSV wird zu ~5–10 MB übertragen. Der Client dekomprimiert transparent.

Was ist der Unterschied zwischen Modus „Live" und „Datei"?

Live bei Abruf: Feed wird bei jedem Aufruf direkt aus der Datenbank generiert. Immer tagesaktuell, geeignet für seltenes Polling oder kleinere Kataloge. Datei: Ein Scheduled Task generiert die Datei vorab (alle 15 Min, atomar geschrieben), und der Controller liefert die fertige Datei aus. Keine DB-Last, sehr schneller Response — ideal für ERPs, die alle paar Minuten pollen. Wenn die Cron-Datei noch nicht existiert, fällt der Controller automatisch auf Live-Generierung zurück.

Performance & Sicherheit

Funktioniert das PIM bei 50.000+ Produkten?

Ja. Browser-native Virtualisierung via content-visibility: auto sorgt für flüssiges Scrolling. Server-side Filtering, Lazy-Loading der Varianten, Bulk-Operations in Batches mit Progress.

Werden meine Daten an Stone & Water gesendet?

Nein. Das Plugin läuft komplett auf deinem Shopware-Server. Keine Telemetrie. Audit-Log und Snapshots werden in deiner Shopware-Datenbank gespeichert.

Wer hat Zugriff auf was?

Sieben feingranulare ACL-Berechtigungen: viewer, editor, csv_export, csv_import, variant_generator, ai_textgen, config. Plus zusätzliche Superadmin-Beschränkung für den Import-Tab. Superadmin umgeht alle Gates.

Wie sicher sind meine API-Keys?

Verschlüsselt in der Datenbank gespeichert, nur serverseitig verwendet. Sie verlassen niemals den Browser. Bei einem Verbindungstest wird der Key serverseitig gegen den Anbieter geprüft.

Wo finde ich das Audit-Log?

Unter PIM → Audit-Log. Jede Bulk-Operation, jeder CSV-Import, jede Snapshot-Aktion mit User, Zeitstempel und Vorher/Nachher-Werten.

Lizenz, Update & Support

Wie wird das Plugin lizenziert?

Standardlizenz über den Shopware Store. Updates kommen ebenfalls über den Store automatisch zur Verfügung.

Werden Updates kostenlos sein?

Updates innerhalb der gleichen Major-Version sind kostenlos. Stone & Water erweitert das Plugin kontinuierlich um Funktionen, die aus echten Pflege-Workflows entstehen.

Wie lange dauert der Support-Antwort?

In der Regel 1–2 Werktage. Bei kritischen Bugs gibt es auch außerhalb eines Releases einen Hotfix.

Kann ich eigene Features vorschlagen?

Ja, gerne. Per Feature-Request-Formular. Die meisten konkreten Wünsche landen innerhalb weniger Wochen im Plugin.

Wo bekomme ich Hilfe?

E-Mail an pim@stoneandwater.online oder über das Kontaktformular. Bei Fragen zur Doku ergänzen wir gerne den entsprechenden Artikel.

Frage nicht dabei?

Frage nicht dabei?

Schreib uns über das Kontaktformular oder direkt an pim@stoneandwater.online. Wir antworten in der Regel innerhalb von 1–2 Werktagen.