PIM für Shopware — Dokumentation

Vollständige Anleitung für das PIM für Shopware Produktinformationsmanagement-Plugin für Shopware 6. Version 1.0, kompatibel mit Shopware 6.7.

1. Installation & Ersteinrichtung

1.1 Plugin hochladen & aktivieren

1. Laden Sie die PIM für Shopware-ZIP-Datei aus Ihrem Konto herunter.
2. Öffnen Sie Ihre Shopware 6 Administration und navigieren Sie zu Erweiterungen → Meine Erweiterungen.
3. Klicken Sie auf „Erweiterung hochladen“ und wählen Sie die PIM für Shopware-ZIP-Datei aus.
4. Klicken Sie nach dem Upload neben PIM für Shopware auf „Installieren“.
5. Nach der Installation klicken Sie auf „Aktivieren“.

1.2 Cache & Assets

Nach der Installation oder einem Update:

1. Navigieren Sie zu Einstellungen → System → Caches & Indizes.
2. Klicken Sie auf „Cache leeren“.
3. Aktualisieren Sie die Administrationsseite mit Strg + F5 (harter Reload).

1.3 Menüstruktur

Nach der Aktivierung finden Sie drei neue Menüpunkte unter Kataloge:

Menüpunkt	Beschreibung
PIM Dashboard	Übersicht über Kataloggesundheit, KPIs und Vollständigkeit
PIM	Die Hauptproduktliste mit Detail-, Filter- und Bulk-Edit-Funktionen
PIM Konfigurationsmatrix	Alle Einstellungen: Felder, Layout, Berechtigungen, KI, Import/Export

2. Konfigurationsmatrix

Die Konfigurationsmatrix ist das Herzstück von PIM für Shopware. Alle Einstellungen werden in der Datenbank gespeichert und für alle Admin-Benutzer geteilt. Die Matrix ist in mehrere Tabs aufgeteilt:

2.1 Allgemein

• Produktliste zur PIM umleiten: Leitet die Standard-Shopware-Produktliste automatisch zu PIM für Shopware um.
• Standardseite (Seitengröße): Anzahl der Produkte pro Seite in der Liste (Standard: 10).
• Spalten-Konfiguration: Wählen Sie, welche Spalten in der Produktliste erscheinen und in welcher Reihenfolge.
• Bearbeitungssperre: Verhindert, dass zwei Benutzer gleichzeitig dasselbe Produkt bearbeiten. Nutzt einen Heartbeat-Mechanismus.
• Vollständigkeitsbewertung: Konfigurieren Sie die Gewichtung einzelner Felder für den Vollständigkeits-Score.

2.2 Dashboard

• KPI-Sichtbarkeit: Wählen Sie, welche Kennzahlen auf dem Dashboard angezeigt werden.
• Qualitätsprüfungen: Aktivieren oder deaktivieren Sie einzelne Prüfungen (z.B. „Ohne Bilder“, „Ohne SEO“).

2.3 Produkte (Feldsichtbarkeit)

• Sektionsreihenfolge: Per Drag-and-Drop die Reihenfolge von Stammdaten, Preise, Medien, SEO etc. anpassen.
• Feldsichtbarkeit: Einzelne Felder in der Detailansicht ein- oder ausblenden.
• Pflichtfelder: Felder als Pflichtfeld markieren — der Speicher-Button wird gesperrt, wenn Pflichtfelder leer sind.

2.4 Varianten

• Varianten-Sektionsreihenfolge: Drag-and-Drop für die Sektionen innerhalb der Varianten-Detailansicht.
• Varianten-Feldsichtbarkeit: Felder, die im Varianten-Detail-Modal angezeigt werden.

2.5 Texte & Übersetzungen

• Sprachfilter: Nur Sprachen anzeigen, die dem aktuellen Verkaufskanal zugeordnet sind.
• Visuelle Hilfen: Hauptsprache als Platzhalter in leeren Übersetzungsfeldern anzeigen.
• Kanal-Sprach-Kombinationen: Konfigurieren, welche Sprachen pro Verkaufskanal in der Mehrfachänderung und im CSV-Export verfügbar sind.
• DeepL-Integration: API-Key eingeben, Quellsprache wählen, bestehende Texte überschreiben (optional).
• KI-Textgenerierung in Mehrfachänderung: Aktivierung der Bulk-ChatGPT-Funktion.
• ChatGPT-Integration: OpenAI API-Key, Modell-Auswahl (z.B. gpt-4o-mini, gpt-4o).
• Parallelität: Anzahl gleichzeitiger API-Aufrufe für KI-Operationen (1–10).

2.6 Import / Export

• Batch-Größe: Anzahl der Produkte pro Sync-Batch beim Import.
• Indexierung deaktivieren: Performance-Optimierung während des Imports.
• Auto-Reindex: Nach dem Import automatisch den Shopware-Index aktualisieren.
• Fehler-Schwellwert: Import abbrechen nach n Fehlern (0 = nie abbrechen).

2.7 Mehrfachänderung

• Batch-Größe: Produkte pro Batch beim Lesen und Schreiben.
• Bestätigung erforderlich: Vor dem Anwenden von Änderungen eine Bestätigung anfordern.
• Auto-Revert bei Abbruch: Bei Abbruch automatisch den Snapshot wiederherstellen.

2.8 Freigabe-Workflow

• Freigabe aktivieren: Mehrstufiger Freigabeprozess für Produktänderungen.
• Status-Stufen: Entwurf → Überprüfung → Freigegeben.
• Kommentare: Optionale Kommentare bei Freigabe oder Ablehnung.

2.9 Änderungshistorie

• Audit-Log aktivieren: Jede Produktänderung mit Zeitstempel und Benutzer protokollieren.
• Aufbewahrungsfrist: Log-Einträge nach n Tagen automatisch bereinigen.

2.10 Snapshots

• Snapshots aktivieren: Automatische Sicherungskopien bei Mehrfachänderungen erstellen.
• Maximale Anzahl: Älteste Snapshots werden entfernt, wenn das Limit erreicht ist.
• Snapshot-Manager: Alle gespeicherten Snapshots einsehen, wiederherstellen oder löschen.

2.11 Berechtigungen

PIM für Shopware bietet granulare rollenbasierte Berechtigungen:

Berechtigung	Beschreibung
Produkte erstellen	Neue Produkte über das PIM anlegen
Produkte löschen	Produkte einzeln oder per Bulk löschen
Mehrfachänderung	Zugriff auf die Bulk-Edit-Funktion
CSV Import	Produkte per CSV/TSV/XML importieren
CSV Export	Produktdaten exportieren
Snapshots	Zugriff auf Snapshot-Manager und Wiederherstellung
Audit-Log	Änderungshistorie einsehen
Freigabe	Produkte freigeben oder ablehnen

3. PIM Dashboard

3.1 Kennzahlen (KPIs)

Das Dashboard zeigt auf einen Blick die wichtigsten Metriken Ihres Katalogs:

• Produkte gesamt — Anzahl aller Hauptprodukte (ohne Varianten)
• Ø Vollständigkeit — Durchschnittlicher Vollständigkeits-Score aller Produkte
• Neu (7 Tage) — In den letzten 7 Tagen erstellte Produkte
• Ohne Bilder — Produkte ohne zugewiesene Medien
• Ohne Beschreibung — Produkte mit leerem Beschreibungsfeld
• Ohne SEO — Produkte ohne Meta-Title oder Meta-Description
• Kurze Beschreibung — Beschreibungen unter einer konfigurierbaren Mindestlänge

3.2 Datenqualität & Vollständigkeit

Ein Balkendiagramm zeigt die Verteilung der Produkte nach Vollständigkeits-Score (0–20%, 21–40%, 41–60%, 61–80%, 81–100%). Die Gewichtung der einzelnen Felder ist in der Konfigurationsmatrix anpassbar.

3.3 Produktlisten

• Zuletzt geändert: Die 5 zuletzt bearbeiteten Produkte mit Zeitstempel und Score.
• Am wenigsten vollständig: Die 5 Produkte mit dem niedrigsten Vollständigkeits-Score — ideal zum Priorisieren.

4. Produktliste

4.1 Spalten & Sortierung

Die Produktliste zeigt konfigurierbare Spalten an. Klicken Sie auf einen Spaltenkopf, um nach diesem Feld zu sortieren. Die sichtbaren Spalten werden in der Konfigurationsmatrix unter „Allgemein“ festgelegt.

Verfügbare Spalten umfassen: Bild, Name, Artikelnummer, Hersteller, Preis (brutto/netto), Bestand, Aktiv, Vollständigkeit, Kategorien, Erstellungsdatum, Änderungsdatum und weitere.

4.2 Filter & Presets

PIM für Shopware bietet über 25 Filterkriterien:

Kategorie	Filter
Status	Aktiv, Inaktiv, Topseller, Abverkauf, Versandkostenfrei
Zuordnung	Hersteller, Kategorie, Tags, Verkaufskanal, Sichtbarkeitsstufe
Eigenschaften	Bestimmte Eigenschaften/Optionen zugewiesen
Qualität	Ohne Bilder, Ohne Beschreibung, Ohne SEO, Ohne EAN
Preise	Preisbereich (von–bis), Steuerklasse
Bestand	Bestandsbereich (von–bis)
Varianten	Nur Hauptprodukte, Nur Varianten, Mit Varianten, Ohne Varianten
Datum	Erstellt nach, Geändert nach, Lieferzeit
Sonstiges	Gewicht, Duplizierte EAN

Jede Filterkombination kann als benanntes Preset gespeichert werden. Presets stehen auch als Quelle in der Mehrfachänderung zur Verfügung.

4.3 Schnellfilter

Schnellfilter-Badges am oberen Rand der Liste ermöglichen den Ein-Klick-Zugriff auf häufig genutzte Ansichten wie „Ohne Bilder“, „Ohne Beschreibung“, „Ohne SEO“ oder „Inaktiv“. Die sichtbaren Schnellfilter sind in der Konfigurationsmatrix konfigurierbar.

4.4 Auswahl & Navigation

• Einzelauswahl: Klicken Sie auf die Checkbox eines Produkts.
• Massenauswahl: Checkbox im Spaltenkopf wählt alle sichtbaren Produkte.
• Tastaturnavigation: Nutzen Sie die Pfeiltasten ↑ ↓ um zwischen Produkten zu navigieren.
• Detailansicht: Klicken Sie auf einen Produktnamen, um die Detailseite zu öffnen.

5. Produktdetailseite

Die Detailseite zeigt alle Produktinformationen in einer übersichtlichen Einzelansicht mit aufklappbaren Akkordeons. Die Reihenfolge und Sichtbarkeit der Sektionen wird in der Konfigurationsmatrix definiert.

5.1 Stammdaten

Name, Artikelnummer, Hersteller, EAN/GTIN, Aktiv-Status, Topseller, Abverkauf, Versandkostenfrei, Gewicht, Maße, Lieferzeit, Mindest-/Maximalbestellmenge, Staffelung, Verpackungseinheit.

5.2 Preise & Staffelpreise

• Hauptpreis: Brutto-/Nettopreis mit automatischer Steuerberechnung.
• Listenpreis (UVP): Für Streichpreis-Darstellung.
• Regulierungspreis: Für die PAngV-konforme Darstellung.
• Einkaufspreis: Interner Einkaufspreis.
• Staffelpreise: Mengenbasierte Preisregeln mit mehreren Stufen pro Preisregel. Jede Stufe definiert einen Mengenbereich (von–bis) mit eigenem Preis.

5.3 Bilder & Medien

• Hochladen: Bilder per Drag-and-Drop oder Dateiauswahl hochladen.
• Neuordnen: Position der Bilder per Drag-and-Drop ändern.
• Cover setzen: Ein Bild als Hauptbild/Cover markieren.
• Alt-Texte: SEO-relevante Alternativtexte direkt in der Detailansicht bearbeiten.
• Löschen: Einzelne Bilder aus der Zuordnung entfernen.

5.4 SEO-Felder

Meta-Title, Meta-Description, Keywords und Canonical URL direkt in der Detailansicht bearbeitbar. Eine Vorschau zeigt die Darstellung in den Suchergebnissen.

5.5 Eigenschaften

Eigenschaftsgruppen und -optionen können direkt im PIM erstellt und bearbeitet werden. Die Eigenschaften-Verwaltung unterstützt:

• Farbfelder (Color Swatches)
• Bilder als Optionswerte
• Übersetzungen pro Option
• Sortierung und Anzeigeeinstellungen

5.6 Cross-Selling

Cross-Selling-Gruppen erstellen, bearbeiten und sortieren. Zwei Modi:

• Produktliste: Manuell ausgewählte Produkte mit frei definierbarer Reihenfolge.
• Dynamische Produktgruppe: Automatische Auswahl basierend auf Shopware-Produkt-Streams.

5.7 Zusatzfelder

Alle im Shopware definierten Zusatzfeld-Sets werden automatisch in der Detailansicht angezeigt. Die Darstellung erfolgt basierend auf dem Feldtyp (Text, Zahl, Boolean, Select, Datum etc.).

5.8 Übersetzungen

Für jede konfigurierte Sprache können alle übersetzbaren Felder (Name, Beschreibung, Meta-Title, Meta-Description, Keywords, Zusatzfelder) direkt in der Detailansicht bearbeitet werden. Optionale visuelle Hilfe: Die Hauptsprache wird als Platzhalter in leeren Feldern angezeigt.

5.9 Vorschau für inaktive Produkte

Inaktive Produkte können im Frontend vorgeschaut werden, ohne sie öffentlich sichtbar zu machen:

1. PIM für Shopware aktiviert das Produkt temporär.
2. Die Sichtbarkeit wird auf „Nur per Direktlink“ gesetzt.
3. Nach Ablauf der konfigurierbaren Dauer (15s, 30s, 60s oder 120s) werden beide Änderungen automatisch rückgängig gemacht.

6. Variantenverwaltung

6.1 Variantengenerator

Der Variantengenerator im Tab „Varianten“ ermöglicht:

• Gruppen erstellen: Neue Eigenschaftsgruppen direkt im Generator anlegen (z.B. Farbe, Größe).
• Optionen verwalten: Optionen pro Gruppe hinzufügen, bearbeiten, suchen.
• Optionen auswählen: Per Checkbox festlegen, welche Optionen kombiniert werden sollen.
• Kombinationen anzeigen: Die grüne Zusammenfassung zeigt die Anzahl der entstehenden Kombinationen.
• Generieren: Varianten werden mit allen gewählten Kombinationen erzeugt.

6.2 Varianten-Detailansicht

Klicken Sie auf eine Variante, um die Detailansicht zu öffnen. Die Varianten-Detailansicht enthält eigene Sektionen für Basisdaten, Preise, Bilder, SEO, Zusatzfelder und Übersetzungen — unabhängig vom Hauptprodukt konfigurierbar.

6.3 Daten übertragen (Parent → Varianten)

In der Mehrfachänderung gibt es zwei spezielle Aktionen:

• Staffelpreise → Varianten: Kopiert die Staffelpreise des Hauptprodukts auf alle Kindvarianten.
• Cross-Selling → Varianten: Kopiert die Cross-Selling-Zuweisungen des Hauptprodukts auf alle Kindvarianten.

7. Mehrfachänderung (Bulk Edit)

7.1 Quellauswahl

Die Mehrfachänderung unterstützt zwei Quellen:

• Auswahl: Die in der Produktliste per Checkbox markierten Produkte.
• Preset-Filter: Alle Produkte, die einem gespeicherten Filter-Preset entsprechen.

Optional können Varianten eingeschlossen werden — der Toggle „Inkl. Varianten“ erweitert die Zielgruppe um alle Kindvarianten der gewählten Hauptprodukte.

7.2 Verfügbare Felder

Die Mehrfachänderung ist in Tabs organisiert:

Eigenschaften

Feld	Modi
Status	Aktivieren / Deaktivieren
Topseller	Aktivieren / Deaktivieren
Abverkauf	Aktivieren / Deaktivieren
Versandkostenfrei	Aktivieren / Deaktivieren
EAN/GTIN	Setzen / Prefix / Suffix / Leeren
Erscheinungsdatum	Datum setzen
Listing-Konfiguration	Hauptprodukt / Varianten-Anzeige

Zuordnung

Feld	Modi
Kategorien	Hinzufügen / Entfernen / Ersetzen
Tags	Hinzufügen / Entfernen
Eigenschaften	Hinzufügen / Entfernen
Hersteller	Zuweisen
Sichtbarkeit	Hinzufügen / Entfernen / Ersetzen (mit Sichtbarkeitsstufe)
Hauptkategorie	Pro Verkaufskanal setzen

Preise & Lager

Feld	Modi
Preis	Festpreis / Prozentuale Erhöhung / Prozentuale Senkung / Betrag addieren / Betrag subtrahieren
Bestand	Setzen / Erhöhen / Reduzieren
Steuerklasse	Neue Steuerklasse zuweisen (Brutto bleibt, Netto wird neu berechnet)
Gewicht	Setzen
Lieferzeit	Zuweisen
Min/Max Abnahme	Setzen
Staffelung	Setzen
Verpackungseinheit	Setzen

SEO

Feld	Beschreibung
Meta-Title	Vorlage mit Variablen: {name}, {productNumber}, {manufacturer}, {price}
Meta-Description	Vorlage mit gleichen Variablen, automatisch gekürzt
SEO-URL	Generiert aus Vorlage (nicht reversibel)

Zusatzfelder

Alle im Shopware definierten Zusatzfelder können per Bulk gesetzt werden.

7.3 Snapshots & Revert

Vor jeder Mehrfachänderung erstellt PIM für Shopware automatisch einen Snapshot aller betroffenen Produkte. Der Snapshot umfasst alle 22 regulären Felder sowie AI-generierte Texte pro Sprache.

• Quick-Revert: Direkt nach der Anwendung über den „Rückgängig“-Button in der Bulk-Edit-Ansicht.
• Snapshot-Manager: In der Konfigurationsmatrix unter „Snapshots“ — alle gespeicherten Snapshots einsehen, wiederherstellen oder löschen.

7.4 KI-Textgenerierung in der Mehrfachänderung

Im Tab „KI & Texte“ können ChatGPT-gestützte Produkttexte für mehrere Produkte gleichzeitig generiert werden:

1. Kontext wählen: Welche Produktdaten als Grundlage dienen sollen (Name, Beschreibung, Hersteller, Preis, EAN, Kategorien, Eigenschaften, Gewicht).
2. Zielfelder: Welche Felder generiert werden (Beschreibung, Meta-Title, Meta-Description, Keywords).
3. Tonalität: Professionell, Locker, Luxuriös, Technisch oder Emotional.
4. Sprachen: Zielsprachen pro Verkaufskanal wählen. Gleiche Sprachen über mehrere Kanäle werden automatisch synchronisiert.
5. Individuelle Texte: Pro Kanal-Sprach-Kombination eigene Texte generieren (mehr API-Aufrufe, besser für SEO) oder einen Text für alle Kombinationen nutzen.
6. Zusätzliche Anweisungen: Freier Prompt-Text für spezielle Anforderungen.

7.5 DeepL-Übersetzung in der Mehrfachänderung

Im selben Tab können Produkttexte per DeepL in alle konfigurierten Sprachen übersetzt werden. Felder: Name, Beschreibung, Meta-Title, Meta-Description, Keywords. Optional: Nur fehlende Felder übersetzen oder bestehende überschreiben.

8. CSV Import & Export

8.1 Export

1. Öffnen Sie den CSV-Dialog über den Button in der Produktliste.
2. Wählen Sie ein Profil oder konfigurieren Sie die Felder manuell.
3. Optional: Setzen Sie Filter (Status, Hersteller, Preisbereich, Bestand etc.).
4. Klicken Sie auf „Exportieren“.

Der Export unterstützt alle Produktfelder einschließlich Varianten, Bilder-URLs, Übersetzungen, Zusatzfelder, Eigenschaften und Cross-Selling.

8.2 Import

1. Laden Sie eine CSV/TSV/XML-Datei hoch oder geben Sie eine URL ein.
2. Prüfen Sie die Vorschau der ersten Zeilen.
3. Konfigurieren Sie das Spalten-Mapping — PIM für Shopware versucht automatisch zuzuordnen.
4. Wählen Sie den Import-Modus:
   • Nur aktualisieren: Nur bestehende Produkte ändern.
   • Nur erstellen: Nur neue Produkte anlegen.
   • Erstellen & aktualisieren: Beides.
5. Wählen Sie das Match-Feld (Artikelnummer, ID oder EAN).
6. Klicken Sie auf „Import starten“.

Der Import umfasst automatische Lookups für Hersteller, Tags, Kategorien, Steuerklassen, Lieferzeiten und Eigenschaften — fehlende Einträge werden automatisch erstellt.

Importierbare Felder

Alle Stammdaten, Preise (brutto/netto), Bestand, SEO-Felder, Maße/Gewicht, Booleans (aktiv, Topseller, Abverkauf, Versandkostenfrei), Zusatzfelder (JSON), Varianten (Parent-Zuordnung, Optionen), Sichtbarkeit, Bilder (URLs), Übersetzungen, Cross-Selling und Eigenschaften.

8.3 Profile

PIM für Shopware enthält 7 vordefinierte Export-Profile:

Profil	Enthaltene Felder
Stammdaten	Artikelnummer, Name, Beschreibung, Aktiv, EAN, Hersteller, Tags, Kategorien etc.
Preise & Lager	Preis, Steuer, Bestand, Einkaufspreis, Listenpreis, Lieferzeit, Min/Max etc.
SEO	Meta-Title, Meta-Description, Keywords, Canonical URL, Suchbegriffe
Bilder	Cover-URL, Alle Bilder-URLs
Übersetzungen	Alle übersetzbaren Felder pro Sprache
Varianten	Artikelnummer, Eltern-Artikelnummer, Optionen, Preis, Bestand, EAN
Vollexport	Alle verfügbaren Felder

Zusätzlich können benutzerdefinierte Profile erstellt und gespeichert werden.

8.4 Formate

Neben CSV (Semikolon, Komma) unterstützt PIM für Shopware auch TSV (Tab-getrennt), XML und DATANORM. Das Trennzeichen wird beim Import automatisch erkannt oder kann manuell gesetzt werden.

9. KI & Übersetzung

9.1 ChatGPT-Integration

Voraussetzung: Ein gültiger OpenAI API-Key, eingetragen in der Konfigurationsmatrix unter „Texte & Übersetzungen“.

• Modellauswahl: gpt-4o-mini (günstig, schnell), gpt-4o (beste Qualität), oder andere verfügbare Modelle.
• Verfügbar in: Produktdetail (einzeln) und Mehrfachänderung (bulk).
• Testen: Der „Testen“-Button prüft die Verbindung und zeigt eine Bestätigung.

9.2 DeepL-Integration

Voraussetzung: Ein gültiger DeepL API-Key (Free oder Pro).

• Quellsprache: Wählbar in der Konfigurationsmatrix.
• Überschreiben: Optional bestehende Übersetzungen überschreiben.
• Verfügbar in: Übersetzungs-Dashboard (einzeln und bulk) und Mehrfachänderung (bulk).

9.3 Textgenerierung im Detail

In der Produktdetailansicht bietet die KI-Sektion die Möglichkeit, für das aktuelle Produkt Texte zu generieren:

1. Kontext-Felder wählen (Name, Beschreibung, Hersteller etc.).
2. Zielfelder wählen (Beschreibung, Meta-Title, Meta-Description, Keywords).
3. Tonalität und Sprache wählen.
4. „Generieren“ klicken — die Ergebnisse werden sofort in die Felder eingetragen.

10. Freigabe-Workflow

Wenn aktiviert, durchlaufen Produkte einen mehrstufigen Freigabeprozess:

1. Entwurf: Produkt ist in Bearbeitung und nicht freigegeben.
2. Überprüfung: Produkt wurde zur Überprüfung eingereicht.
3. Freigegeben: Ein autorisierter Benutzer hat das Produkt freigegeben.

Der Freigabestatus ist in der Produktliste und Detailansicht jederzeit sichtbar. Freigabe und Ablehnung können mit optionalen Kommentaren versehen werden.

11. Änderungshistorie & Audit-Log

Jede Produktänderung wird in einem detaillierten Audit-Log protokolliert:

• Zeitstempel: Wann die Änderung erfolgte.
• Benutzer: Wer die Änderung durchgeführt hat.
• Feld-Diffs: Welche Felder geändert wurden (alter Wert → neuer Wert).

Die Aufbewahrungsfrist und die automatische Bereinigung sind in der Konfigurationsmatrix konfigurierbar.

12. Übersetzungs-Dashboard

Ein dediziertes Dashboard zeigt den Übersetzungsstatus aller Produkte über alle Shop-Sprachen:

• Filterung: Nach Sprache, Status (vollständig, unvollständig, fehlend) und Feld.
• Einzelübersetzung: Produkte direkt im Dashboard übersetzen.
• Bulk-Übersetzung: Massen-DeepL-Übersetzungen mit der Option, nur fehlende Felder zu übersetzen oder bestehende zu überschreiben.

13. Tastaturkürzel

Kürzel	Funktion
↑ / ↓	Zwischen Produkten in der Liste navigieren
Enter	Produkt öffnen
Strg + S	Produkt speichern (in der Detailansicht)

14. Häufige Fragen (FAQ)

Die Menüpunkte werden nicht angezeigt

Cache leeren unter Einstellungen → System → Caches & Indizes, dann die Seite mit Strg + Shift + F5 neu laden. Falls das Problem bestehen bleibt: Plugin deaktivieren und wieder aktivieren.

CSS-Änderungen werden nicht übernommen

PIM für Shopware kopiert Assets bei Installation, Aktivierung und Update automatisch. Falls Änderungen nicht sichtbar sind: Plugin einmal deaktivieren und wieder aktivieren, Cache leeren, harter Browser-Reload.

Die KI-Textgenerierung erzeugt falsche oder leere Texte

Prüfen Sie:

• Ist der OpenAI API-Key in der Konfigurationsmatrix korrekt eingetragen?
• Nutzen Sie den „Testen“-Button, um die Verbindung zu prüfen.
• Haben Sie genügend Kontext-Felder aktiviert? Mindestens „Name“ sollte aktiv sein.
• Haben Sie eine Zielsprache gewählt?

Der Snapshot-Revert funktioniert nicht

Snapshots für KI-Texte enthalten die Originaltexte pro Sprache. Stellen Sie sicher, dass Sie über den Snapshot-Manager in der Konfigurationsmatrix reverten (nicht nur über Quick-Revert). Beide Pfade unterstützen seit Version 1.0 den vollständigen Revert einschließlich KI-Texte.

Der CSV-Import schlägt fehl

Häufige Ursachen:

• Trennzeichen: PIM für Shopware erkennt das Trennzeichen automatisch. Bei Problemen: Manuell auf Semikolon oder Komma setzen.
• Pflichtfelder: Beim Modus „Nur erstellen“ sind Artikelnummer und Name Pflichtfelder.
• Match-Feld: Das gewählte Match-Feld muss in der CSV vorhanden und korrekt gemappt sein.
• Kodierung: Verwenden Sie UTF-8 Kodierung für Umlaute und Sonderzeichen.

Kann ich PIM für Shopware parallel zur Standard-Produktliste nutzen?

Ja. Die automatische Weiterleitung ist optional. Wenn deaktiviert, existieren beide Ansichten nebeneinander. PIM für Shopware ändert keine Shopware-Core-Daten — alle Änderungen erfolgen über die offizielle Shopware API.

15. Kompatibilität & Systemanforderungen

Anforderung	Details
Shopware	6.7.x
PHP	8.2+ (wie von Shopware gefordert)
Datenbank	MySQL 8.0+ oder MariaDB 10.4+
OpenAI (optional)	Gültiger API-Key für ChatGPT-Textgenerierung
DeepL (optional)	Gültiger API-Key (Free oder Pro) für Übersetzungen
Externe Abhängigkeiten	Keine — alle Funktionen laufen im Shopware-Admin ohne externe Services (außer optionale KI/Übersetzungs-APIs)
Lokalisierung	Deutsch und Englisch (2.690 Übersetzungsschlüssel)

PIM für Shopware 6
© Stone & Water · stoneandwater.online