Widerrufs-Workflow Pro – Dokumentation

Überblick

Widerrufs-Workflow Pro ermöglicht die vollständige Verwaltung, Protokollierung und Automatisierung von Widerrufen in Shopware 6. Das Plugin deckt den gesamten Lifecycle ab:

Storefront: Widerrufsformular unter /widerruf + konfigurierbarer Button
Admin Dashboard: Übersicht aller Widerrufe mit KPIs, Statusworkflow, Notizen
Automatisierung: SLA-Fristberechnung, E-Mail-Benachrichtigungen, Flow Builder
Export & API: CSV-Export, REST-API für externe Systeme
DSGVO: Per-Datensatz-Anonymisierung

Systemanforderungen

Komponente	Mindestversion	Empfohlen
Shopware	6.6.0	6.7.x
PHP	8.2	8.3
Datenbank	MySQL 8.0 / MariaDB 10.6	–
Composer	2.x	–

Installation

Option A – Shopware Store

Im Shopware-Admin Erweiterungen → Store öffnen
Nach Widerrufs-Workflow Pro suchen
Kaufen / Installieren klicken
Unter Erweiterungen → Meine Erweiterungen aktivieren

Option B – ZIP / CLI

cd /var/www/shopware/custom/plugins
unzip WiderrufsWorkflowPro.zip
chown -R www-data:www-data WiderrufsWorkflowPro/
php bin/console plugin:refresh
php bin/console plugin:install --activate WiderrufsWorkflowPro
php bin/console cache:clear

Bei der Erstinstallation legt das Plugin die DAL-Entität wbp_withdrawal in der Datenbank an und registriert die Storefront-Route /widerruf.

Konfiguration

Öffne die Plugin-Einstellungen über Erweiterungen → Meine Erweiterungen → Widerrufs-Workflow Pro → Konfiguration.

Button-Einstellungen

Einstellung	Typ	Beschreibung
Button-Text	Text	Beschriftung des Widerrufsbuttons (z. B. „Widerruf einreichen")
Button-Farbe	Color	Hintergrundfarbe des Buttons
Button-Icon	Media	Optionales Icon für den Button
Button-Positionen	Multi-Select	Footer, Header, Kundenkonto, Bestellübersicht, CMS-Block

E-Mail & Fristen

Einstellung	Typ	Beschreibung
Admin-E-Mail	E-Mail	Empfänger für Benachrichtigungen bei neuem Widerruf
Gesetzliche Widerrufsfrist	Zahl (Tage)	Standard: 14 Tage
Interne Bearbeitungsfrist	Zahl (Tage)	SLA-Frist für das Admin-Team (Standard: 7 Tage)
Widerrufstext	HTML	Rechtlicher Widerrufstext für das Formular

Admin Dashboard

Das Plugin fügt dem Shopware-Admin unter Bestellungen → Widerrufe ein vollständiges Dashboard hinzu:

KPI-Kacheln: Offen, Fällig heute, Überfällig, Abgeschlossen
Widerrufsliste: Sortierbar nach Datum, Frist, Status; Suche nach Kundendaten oder Widerrufsnummer
Detailansicht: Vollständige Widerrufsdaten, Statusverlauf, interne Notizen
CSV-Export: Alle oder gefilterte Widerrufe als CSV-Datei

Statusworkflow

Eingegangen → In Bearbeitung → Abgeschlossen
                    ↓
               Abgelehnt (mit Begründung)

Jeder Statuswechsel wird mit Zeitstempel und Benutzer protokolliert.

Storefront

Öffentliches Formular

Unter der Route /widerruf steht ein öffentliches Widerrufsformular bereit – kein Kunden-Login erforderlich. Das Formular ist zweistufig: Vorschau → Finales Absenden.

Button-Positionen

Der Widerrufsbutton kann über die Plugin-Konfiguration an folgenden Stellen eingeblendet werden:

Storefront-Footer
Storefront-Header
Kundenkonto-Bereich
Bestellübersicht
Als CMS-Block in Erlebniswelten

Wenn ein Kunde die gesetzliche Widerrufsfrist überschritten hat, zeigt das Formular einen entsprechenden Hinweistext an (konfigurierbar).

Integrations-API

Externe Systeme (ERP, CRM, Kundenservice-Tools) können Widerrufe direkt über die REST-API anlegen.

Endpunkt

POST/api/_action/wbp/integrations/withdrawals

Authentifizierung

Shopware API-Auth (OAuth2 Client Credentials). Scope: write.

Request Body (JSON)

{
  "orderId": "abc123...",
  "customerId": "def456...",
  "reason": "Artikel entspricht nicht der Beschreibung",
  "salesChannelId": "ghi789..."
}

Response

{
  "success": true,
  "withdrawalId": "WBP-0064",
  "deadline": "2026-06-23"
}

DSGVO-Anonymisierung

Einzelne Widerrufe können auf Knopfdruck DSGVO-konform anonymisiert werden:

Widerruf im Dashboard öffnen
Schaltfläche „Personendaten anonymisieren" klicken
Bestätigung im Dialog

Nach der Anonymisierung werden alle personenbezogenen Felder (Name, E-Mail, Adresse) aus der Datenbank entfernt. Der Vorgang ist nicht rückgängig zu machen.

Achtung: Anonymisierte Datensätze sind für statistische Auswertungen weiterhin verfügbar, enthalten aber keine personenbezogenen Daten mehr.

Flow Builder Integration

Das Plugin registriert folgendes Domain-Event:

widerrufsbutton_pro.withdrawal.submitted

Über dieses Event lassen sich im Shopware Flow Builder automatische Aktionen auslösen, z. B.:

Interne Benachrichtigungs-E-Mail an Mitarbeiter
Bestätigungs-E-Mail an Kunden
Tag an Kundenprofil setzen
Webhook an externes System senden

Changelog

v1.0.0 – Erstveröffentlichung

DAL-Entität wbp_withdrawal mit vollständigem Schema
Admin Dashboard mit KPIs, Statusworkflow, Notizen
Storefront-Formular unter /widerruf
Konfigurierbarer Button: 5 Positionsoptionen
SLA-Fristberechnung und Fälligkeitsmarkierung
CSV-Export
REST-API /api/_action/wbp/integrations/withdrawals
DSGVO-Anonymisierung pro Datensatz
Flow Builder Event widerrufsbutton_pro.withdrawal.submitted
Shopware 6.6 & 6.7, PHP 8.2+