KI-Retourenprognose & Analyse

Installation

1. Plugin über die Erweiterungsverwaltung (Store) installieren und aktivieren.
2. Cache leeren (Einstellungen → Caches & Indizes) bzw. bin/console cache:clear.

Erste Einrichtung

1. Im Admin das Modul Retouren Prognose öffnen.
2. Tab Einstellungen: Schwellenwerte für die Risiko-Ampel festlegen (Retourenquote für Gelb und Rot) sowie den Analyse-Zeitraum.
3. Optional E-Mail-Report aktivieren: Empfängeradresse und Versandrhythmus (wöchentlich/monatlich) einstellen. Über „Testbericht senden" lässt sich der Report sofort prüfen.
4. Optional KI-Klassifizierung: standardmäßig deaktiviert. Erst den Schalter „KI-Klassifizierung aktivieren“ setzen, dann Anbieter wählen (Anthropic Claude oder OpenAI) und den eigenen API-Key hinterlegen. Bitte vorher den Abschnitt Datenschutz weiter unten lesen.
5. Auf Neu berechnen klicken, um die erste Analyse zu starten – alternativ übernimmt das der nächtliche Scheduled Task automatisch.

Tägliche Nutzung

• Dashboard: Gesamt-Retourenquote, Zeitreihe und Prognose auf einen Blick.
• Produkte: Risiko-Ampel je Produkt, sortier- und filterbar; Detailansicht mit Retourengründen und Verlauf.
• Retourengründe: Verteilung über die sieben Kategorien; Freitext-Gründe werden bei aktivierter KI automatisch eingeordnet.
• Kunden: Hochrisiko-Kunden anhand ihrer Retouren-Historie, mit Direktsprung ins Kundenprofil.
• Produkt- und Kundenliste lassen sich als CSV exportieren.

Datenschutz: optionale KI-Klassifizierung

Analyse, Risikoampel, Prognose, Reports und Exporte laufen vollständig in Ihrem Shop. Es besteht keine Cloud-Anbindung, solange Sie die KI-Klassifizierung nicht einschalten.

Die KI-Klassifizierung ist standardmäßig deaktiviert. Schalten Sie sie ein, gilt:

• Übermittelte Daten: ausschließlich der von Kundinnen und Kunden eingegebene Freitext-Retourengrund, ohne HTML und gekürzt auf 200 Zeichen
• Nicht übermittelt: Name, Anschrift, E-Mail-Adresse, Telefonnummer, Kunden-, Bestell- und Rechnungsnummern, Zahlungsdaten, Produkt- und Preisdaten
• Empfänger: je nach Ihrer Auswahl Anthropic PBC, San Francisco, USA (api.anthropic.com) oder OpenAI, San Francisco, USA (api.openai.com)
• Zweck: Einordnung des Freitexts in eine der sieben Retourengrund-Kategorien
• Rechtsgrundlage: von Ihnen als Verantwortlichem festzulegen (regelmäßig Art. 6 Abs. 1 lit. f DSGVO)
• Auftragsverarbeitung: Sie schließen den Vertrag direkt mit dem Anbieter; das Plugin nutzt Ihren eigenen API-Key

Freitextfelder können personenbezogene Angaben enthalten, auch wenn niemand danach fragt – Kürzung und HTML-Entfernung ändern daran nichts. Nehmen Sie die Weitergabe deshalb in Ihre Datenschutzerklärung auf. Textbaustein zum Anpassen:

Zur Auswertung unserer Retouren setzen wir eine Analyse-Erweiterung ein. Sofern Sie bei einer Retoure einen Grund im Freitextfeld angeben, übermitteln wir diesen Text – gekürzt auf 200 Zeichen und ohne weitere Angaben zu Ihrer Person, Ihrer Bestellung oder Ihrer Anschrift – an [Anthropic PBC, San Francisco, USA | OpenAI, San Francisco, USA], um ihn automatisiert einer Kategorie zuzuordnen. Rechtsgrundlage ist Art. 6 Abs. 1 lit. f DSGVO; unser berechtigtes Interesse liegt in der Verbesserung unseres Sortiments und unserer Produktbeschreibungen. Mit dem Anbieter besteht ein Vertrag zur Auftragsverarbeitung.

Möchten Sie keine Daten weitergeben, lassen Sie den Schalter einfach aus. Freitext-Gründe bleiben dann als Kategorie „Sonstiges“ bzw. „Unbekannt“ erhalten; alle übrigen Funktionen sind unverändert nutzbar.

Hinweise

• Das Plugin greift ausschließlich lesend auf Bestelldaten zu und schreibt nicht in Shopware-Core-Tabellen.
• Aussagekräftige Prognosen entstehen mit wachsender Datenbasis – idealerweise nach einigen Wochen Bestell-/Retourenhistorie.
• Rechte lassen sich unter Einstellungen › Benutzer & Berechtigungen › Rollen vergeben: Ansehen und Bearbeiten in der Rechtematrix (Gruppe „Bestellungen“), Export, Kundendaten und Einstellungen unter „Zusätzliche Berechtigungen“.