Product Return Manager — Vollständiger Leitfaden

DataFirefly Product Return Manager verwandelt die Retourenverwaltung von PrestaShop 8 in einen durchgängig automatisierten Ablauf: Self-Service-Anfrage des Kunden (mit Konto oder als Gast), PDF-Etikett mit QR-Code, Scan-Validierung beim Wareneingang, Analytik mit 13 Achsen, Gutschein oder Rückerstattung, manuelle Admin-Retoure, automatische Übersetzung der Gründe via ChatGPT und ERP-Integration per Hook. Diese Dokumentation behandelt Installation, vollständige Konfiguration und den täglichen Gebrauch.

Installation

Standardinstallation in PrestaShop: Gehen Sie zu Module → Modul-Manager → Modul hochladen, wählen Sie die Datei dfproductreturn.zip und bestätigen Sie. Das Modul erstellt automatisch 9 Tabellen mit den Präfixen df_return_* und df_product_return*, installiert Standard-Retourengründe, registriert seine Hooks (displayCustomerAccount, displayMyAccountBlock, displayHeader usw.) und fügt zwei Menüeinträge im Back-Office hinzu: Produktretouren (Verwaltung) und Retouren-Analytik (Statistiken).

Konfiguration

Gehen Sie zu Module → Modul-Manager → DataFirefly Product Return Manager → Konfigurieren. Die wichtigsten Einstellungen:

• Retourenfrist (Tage) — Zeitfenster, in dem der Kunde nach seiner Bestellung eine Retoure anfordern kann. Standard: 30 Tage. Gilt nur für kundeninitiierte Retouren; die manuelle Admin-Retoure ignoriert sie.
• Zulässige Bestellstatus — nur Bestellungen in diesen Status zeigen die Schaltfläche „Retoure anfordern“ (typischerweise „Geliefert“).
• Gutschein aktivieren — bietet die Gutschein-Option als Entschädigungsmodus an.
• Rückerstattung aktivieren — bietet die Rückerstattung auf das ursprüngliche Zahlungsmittel an.
• Admin-E-Mail — Adresse, die bei jeder neuen Retourenanfrage benachrichtigt wird.
• Status Teil-/Vollrückerstattung — die beiden Bestellstatus, die je nach Rückerstattungstyp angewendet werden.
• OpenAI-API-Schlüssel — nur für die automatische Übersetzung der Retourengründe via ChatGPT erforderlich (siehe eigener Abschnitt).

Retourengründe und Kategorien

Das Modul organisiert die Gründe auf zwei Ebenen: Kategorien („Produktproblem“, „Logistikproblem“, „Meinungsänderung“…) und Gründe, die jeder Kategorie zugeordnet sind („Falsche Größe“, „Defekter Artikel“, „Lieferung zu lang“…). Diese Hierarchie speist die Analytik: Sie sehen die Makro-Verteilung nach Kategorie, dann das Detail nach Grund.

Verwalten Sie sie über den Tab Gründe der Konfiguration: Erstellen, Bearbeiten, Deaktivieren, Anzeigereihenfolge. Standard-Gründe werden mit dem Modul installiert — passen Sie sie an Ihren Katalog an.

Automatische Übersetzung via ChatGPT

Sobald Ihr OpenAI-API-Schlüssel in der Konfiguration hinterlegt ist, erscheint auf jedem Grund und jeder Kategorie eine Schaltfläche Übersetzen. Ein Klick übersetzt die Bezeichnung in alle aktivierten Sprachen des Shops, mit kontextualisiertem E-Commerce-Vokabular. Die Übersetzungen bleiben nach der Generierung manuell editierbar. Ihren Schlüssel erhalten Sie auf platform.openai.com — die Kosten pro Übersetzung sind vernachlässigbar (Bruchteile eines Cents).

Kundenablauf (mit Konto)

Der eingeloggte Kunde sieht einen Link „Meine Retouren“ in seinem Kundenbereich. So startet er eine Retoure:

1. Er öffnet die berechtigte Bestellung und klickt „Retoure anfordern“.
2. Er wählt die zurückzusendenden Produkte aus und passt die Mengen an.
3. Er wählt eine Grundkategorie, dann einen präzisen Grund, und fügt einen optionalen Kommentar hinzu.
4. Er bestätigt — die Retoure wechselt in den Status „Ausstehend“ und zwei E-Mails werden versendet: Bestätigung an den Kunden mit dem PDF-Etikett im Anhang, Benachrichtigung an den Admin.

Der Kunde verfolgt anschließend den Status seiner Retoure (ausstehend, akzeptiert, abgelehnt, erstattet) unter „Meine Retouren“ und kann sein PDF-Etikett jederzeit erneut herunterladen.

Gast-Retoure (ab v1.7)

Kunden, die ohne Kontoerstellung bestellt haben, erreichen die Retoure über dieselbe URL wie eingeloggte Kunden. Ein nicht authentifizierter Besucher sieht ein Formular „Bestellnummer + E-Mail“ anstelle der Liste „Meine Bestellungen“. Die Funktionsweise:

• Die Validierung erfolgt serverseitig: Das Paar Bestellreferenz + E-Mail muss exakt einer bestehenden Bestellung entsprechen (Groß-/Kleinschreibung der E-Mail wird ignoriert).
• Bei Nichtübereinstimmung ist die Fehlermeldung bewusst generisch — Anti-Enumerations-Schutz, es werden keine Informationen über existierende Referenzen preisgegeben.
• Nach der Validierung erhält der Besucher Zugang zum Standard-Retourenablauf nur für diese Bestellung (begrenzte PrestaShop-Session).
• Das PDF-Etikett bleibt über den per E-Mail erhaltenen Link ohne Login zugänglich, geschützt durch ein zufälliges 64-Zeichen-Token, das für die Retoure einmalig ist.
• Ein Banner „Use a different order“ ermöglicht das Zurücksetzen der Gast-Session und den Wechsel zu einer anderen Bestellung.

Das PDF-Etikett und der QR-Code

Jede Retoure erzeugt ein PDF mit: Rücksendeadresse, Retourennummer, Liste der Produkte und Mengen, Anweisungen und einem einmaligen QR-Code mit kryptografischem Verifizierungstoken. Der Kunde druckt es aus und klebt es auf sein Paket.

Mehrere Rücksendeadressen

Konfigurieren Sie mehrere Adressen im Tab Adressen (Hauptlager, Standort für große Volumina, EU- vs. Nicht-EU-Adresse…). Jede Retoure ist einer Adresse zugeordnet, die auf ihrem Etikett erscheint.

Validierung per QR-Scan beim Wareneingang

Wenn das Paket ankommt, scannt Ihr Mitarbeiter den QR-Code mit einem Telefon oder USB-Scanner. Der Scan öffnet die gesicherte Validierungsseite — eine aktive PrestaShop-Admin-Session ist erforderlich; ohne Session leitet die Seite zum Back-Office-Login weiter. Der Mitarbeiter sieht dann die vollständigen Details der Retoure, prüft den physischen Zustand der Produkte und klickt Bestätigen oder Ablehnen.

Die Bestätigung löst eine Kaskade aus: Wechsel der Bestellung in den konfigurierten Status (Teil- oder Vollrückerstattung), Erzeugung des Gutscheins oder der Rückerstattung, Status-E-Mail an den Kunden und Dispatch des Hooks actionOrderSlipAdd für Drittanbieter-Integrationen.

Manuelle Admin-Retoure (ab v1.6)

Der Kundenservice kann eine Retoure für jede beliebige Bestellung erstellen, unabhängig von der konfigurierten Retourenfrist und dem Bestellstatus — konzipiert für Kulanzgesten, telefonisch vereinbarte Retouren und rückwirkende Korrekturen.

1. Klicken Sie auf „Create manual return“ im Header der Retourenliste im Back-Office.
2. Schritt 1 — geben Sie die Referenz oder die ID der Bestellung ein (auch eine Bestellung von 2022, storniert oder im Entwurf wird akzeptiert).
3. Schritt 2 — wählen Sie die zurückzusendenden Produkte, ihre Mengen, ihren Grund, die Entschädigungsart (Gutschein oder Gutschrift) und passen Sie bei Bedarf den Erstattungsbetrag pro Zeile an.
4. Bestätigen: Die Retoure wird sofort verarbeitet — Gutschein oder Gutschrift wird umgehend erzeugt, Bestand wiederhergestellt, Bestellstatus aktualisiert, Fastmag-Hook dispatcht.

Eine Checkbox „Kunden benachrichtigen“ (standardmäßig deaktiviert) sendet auf Wunsch die Standard-Bestätigungs-E-Mail. Eine freie Admin-Notiz kann der Retoure beigefügt werden.

Der anpassbare Erstattungsbetrag (ab v1.7)

Jede Zeile der manuellen Retoure hat ein editierbares Feld „Refund amount“. Der Standardwert (Einzelpreis × Menge) wird automatisch neu berechnet, wenn sich die Menge ändert — bis ein Betrag manuell eingegeben wird; dieser Wert wird dann unverändert übernommen. Das proportionale Rabattverhältnis der Bestellung, das bei klassischen Kundenretouren angewendet wird, ist bei manuellen Retouren deaktiviert: Der eingegebene Betrag ist exakt der erstattete Betrag. Nützlich für Teilerstattungen (beschädigtes Produkt zu 50 % erstattet), Kulanzgesten oder Korrekturen. Die erzeugte Gutschrift behält die Netto-/Brutto-Aufteilung proportional zum Steuersatz der Originalzeile.

Gutschein oder Rückerstattung

Je nach Konfiguration erzeugt die Bestätigung einer Retoure entweder einen Gutschein (native PrestaShop-Warenkorbregel, bei einer zukünftigen Bestellung einlösbar) oder eine Rückerstattung auf das ursprüngliche Zahlungsmittel. Die beiden dedizierten Bestellstatus (teilweise / vollständig) unterscheiden die Fälle in Ihren Exporten und Buchhaltungsberichten.

Analytik-Dashboard

Das Menü Retouren-Analytik bietet 13 Analyseachsen, alle nach Zeitraum und Shop filterbar:

• Globale KPIs — Retourenvolumen, Retourenquote, zurückgesendeter Wert, Verteilung Gutschein / Rückerstattung.
• Nach Grundkategorie und nach Grund — identifizieren Sie die dominierenden Ursachen.
• Nach Land — erkennen Sie geografische Anomalien (mangelhafter Transporteur in einer Region).
• Top zurückgesendete Produkte — die zu prüfenden Referenzen (Größentabelle, Lieferantenqualität).
• Kreuzungen Grund × Land und Grund × Produkt — die Detailtiefe zum Handeln.
• Monatstrend (12 Monate) und Tagestrend — Saisonalität und Spitzen.
• Durchschnittliche Bearbeitungszeit — die Leistung Ihres Kundenservice.
• Verteilung nach Wochentag und Top-Retournierer — Missbrauchserkennung.

Die Schaltfläche CSV-Export lädt alle Retouren des gefilterten Zeitraums herunter (Retourennummer, Bestellung, Kunde, Produkte, Grund, Status, Daten, Betrag) für externe Analysen oder BI-Import.

Fastmag- und ERP-Integration

Bei jeder bestätigten Retoure dispatcht das Modul den PrestaShop-Hook actionOrderSlipAdd mit der Bestellung, der Produktliste und den Mengen. Jedes Modul, das diesen Hook abhört (DataFirefly-Fastmag-Modul, ERP-Konnektoren, Systempay…), erhält die Benachrichtigung in Echtzeit. Manuelle Admin-Retouren dispatchen denselben Hook.

Die Schaltfläche „Re-sync past returns to Fastmag“ (Toolbar der Retourenliste) löst den Hook für alle vergangenen Retouren erneut aus — unverzichtbar nach der Installation eines ERP-Konnektors nach diesem Modul oder nach einem Synchronisationsvorfall.

Transaktions-E-Mails

Drei automatische E-Mails, in 6 Sprachen geliefert (FR, EN, ES, IT, PT, DE): Anfragebestätigung an den Kunden (mit PDF im Anhang), Benachrichtigung an den Admin, Statusaktualisierung an den Kunden (Bestätigung / Ablehnung / Rückerstattung). Bei manuellen Admin-Retouren ist die Kunden-E-Mail optional (Checkbox standardmäßig deaktiviert). Passen Sie die Vorlagen in modules/dfproductreturn/mails/<sprache>/ oder über das native E-Mail-Übersetzungssystem von PrestaShop an.

Multi-Shop

Alle Tabellen tragen eine id_shop: Jeder Shop hat seine eigenen Gründe, Rücksendeadressen und Analytik. Der Multi-Shop-Selektor des Back-Office filtert die Retourenliste und das Dashboard automatisch.

Fehlerbehebung

Die Schaltfläche „Retoure anfordern“ erscheint nicht

Prüfen Sie drei Punkte: Die Bestellung ist in einem zulässigen Status (Konfiguration), die Retourenfrist ist nicht abgelaufen, und das Modul ist im betreffenden Shop aktiv (Multi-Shop-Kontext). Hinweis: Für eine Retoure außerhalb der Frist nutzen Sie die manuelle Admin-Retoure.

Das Gast-Formular lehnt eine gültige Bestellung ab

Die eingegebene E-Mail muss exakt die der Bestellung sein (Groß-/Kleinschreibung wird ignoriert, Tippfehler nicht). Prüfen Sie die Bestellreferenz — es ist die alphanumerische Referenz (z. B. XKBKNABJK), nicht die numerische ID.

Der QR-Scan zeigt „Access denied“

Das ist das erwartete Verhalten ohne Admin-Session: Der Mitarbeiter muss im selben Browser im PrestaShop-Back-Office eingeloggt sein. Einloggen und erneut scannen.

Die ChatGPT-Übersetzung schlägt fehl

Prüfen Sie den API-Schlüssel in der Konfiguration, das verfügbare Guthaben auf Ihrem OpenAI-Konto und dass Ihr Server ausgehende Verbindungen zu api.openai.com (Port 443) erlaubt.

Fastmag empfängt die Retouren nicht

Prüfen Sie, dass das Fastmag-Modul installiert und am Hook actionOrderSlipAdd registriert ist, und nutzen Sie dann „Re-sync past returns to Fastmag“, um die Historie nachzuholen.