Guthaben-Verwaltung und Kauf von Gutschein (Shopware 6)

• Plugin erfasst Guthaben-Änderungen bspw. Einlösungen im Shop.
• Variable Gutscheine können im Shop verkauft werden
• Ein minimaler und/oder maximaler Gutscheinbetrag kann festgelegt werden
• Kunde erhält nach erfolgter Zahlung den Gutschein per Mail zugesendet.
• Restwerterhalt ist möglich.
• Ablaufdatum kann für das Guthaben hinterlegt werden.
• Optional: Ablaufdatum des Gutscheins wir im Checkout angezeigt.
• Die Guthaben können auch händisch im Adminbereich geändert werden.
• Alle Transaktionen werden erfasst und ein Kommentar wird dazu angegeben.
• Shopify-Modus: Kunden können weiterhin Shopify-Gutscheine einlösen.
• Bei aktivem Shopify-Modus vergleicht das Plugin die letzten 4 Stellen und die Gesamtlänge des Gutscheincodes.

Zeige Ablaufdatum des Gutscheins im Checkout
Wenn Du Gutscheine mit einer zeitlichen Begrenzung vertreibst, kann bei Aktivierung dieser Option das Ablaufdatum Deinem Kunden im Shop angezeigt werden.

Laden der Bestell-Entität verändern (wenn keine Wawi angebunden)
Aktiviere diese Option, wenn Du keine Warenwirtschaft nutz, um die Anzeige der Rechnungsbeträge im Adminbereich anzupassen.

Shopware Rabatte & Aktionen-Hinzufügen-Formular verstecken
Aktiviere diese Option, wenn nur das Guthaben-Feld im Warenkorb / Off-Canvas Warenkorb angezeigt werden soll.

Produkte, zum Guthaben kaufen definieren
Hinterlege hier Deine Produkte, die Du verwendest um Guthaben anzubieten.

Maximaler kaufbarer Wert
Lege den maximalen Wert des Guthabens fest, das Deine Kunden kaufen können.

Gültig bis
Entscheide, ob das Guthaben bis Ende des 3. Jahres gültig sein soll oder kein Fälligkeitsdatum haben soll.

Code-Länge der Generierung
Definiere die Länge des Guthaben-Codes.

Trennzeichen nach bestimmter Anzahl an Zeichen einfügen?
Lege fest, ob der Guthaben-Code Trennzeichen beinhalten soll.

Trennzeichen
Definiere hier das Trennzeichen, das verwendet werden soll.

Trennzeichen nach Anzahl Zeichen anzeigen
Lege fest, nach welcher Anzahl von Zeichen die Trennzeichen in den Code eingebunden werden sollen.

1. Installiere und aktiviere das Plugin.
2. Mindestens 1 Produkt anlegen, das verwendet wird, um Guthaben zu kaufen.
3. Das Produkt/die Produkte in den Plugin-Einstellungen zuweisen.
4. Den Flow mit dem Trigger „lenz_credit_management.buy_credit_charged” überprüfen und ggf. anpassen, damit die Mail an die Kunden versendet wird.
5. Den Cronjob bin/console lenz-platform-credit-management:charge-buy-credit einrichten.

Warum verwenden wir einen Konsolenbefehl anstelle eines Scheduled Task?
Scheduled Tasks werden nicht zuverlässig zu einer bestimmten Zeit ausgeführt. Wir möchten aber das die Gutscheine schnellstmöglich dem Kunden zugeschickt werden, daher benutzten wir den Konsolenbefehl.

Möchtest Du für den Guthaben-Kauf eine eigene Versandart anlegen? Dann gelangst Du über den Button zur Anleitung:
Guthaben-Verwaltung und Kauf von Gutschein (SW6): eigene Versandart anlegen

Version 1.1.15
TASK | Kompatibilität mit Shopware 6.5.
Anforderungen: Das Plugin erfordert nun mindestens Shopware Version 6.5.0.0
Hinweis: VOR DEM UPDATE AUF SHOPWARE 6.5.0.0 die App deaktivieren, dann aktualisieren, dann aktivieren.
Manuelle Aufgaben nach dem Update im E-Mail-Template "LENZ Guthabenverwaltung: Code senden":
- Setze vor alle Variablen in Betreff, Absender, Text und HTML "templateData.", Beispiele:
{{ credit.code }} -> {{ templateData.credit.code }}
{{ order.orderNumber }} -> {{ templateData.order.orderNumber }}
{{ order.orderNumber }} -> {{ templateData.order.orderNumber }}
{{ salesChannel.translated.name }} -> {{ templateData.salesChannel.translated.name }}
{{ order.orderCustomer.firstName }} -> {{ templateData.order.orderCustomer.firstName }}

Version 1.1.14
TASK | UTF-8 Content-Typ zu Standard-Guthaben-Dokument hinzugefügt.
IMPROVEMENT | Route zur Guthaben-PDF-Vorschau hinzugefügt (/lenz-credit-management/buy-credit/test-pdf).
IMPROVEMENT | Option hinzugefügt, um "Ab-Datum" für Guthaben-Generierung zu setzen.
IMPROVEMENT | Guthaben-Code-Import Command verbessert.
IMPROVEMENT | Guthaben-Erstellung + Anhang-Erstellung verbessert.
TASK | "limit"-Parameter zu Befehl "lenz-platform-credit-management:charge-buy-credit" hinzugefügt.

Version 1.1.13
BUGFIX | Constraint fk.lenz_credit_management_credit.order_line_item_id korrigiert.

Version 1.1.12
TASK | Kompatibilität mit Plugins, die nicht EntityRepository verwenden.

Version 1.1.11
IMPROVEMENT | Steuersatz für Guthaben kann jetzt gewählt werden.
Hinweis: Bitte wähle 0% als Steuersatz in den Plugin-Einstellungen nach dem Update auf diese Plugin-Version.

Version 1.1.10
IMROVEMENT | Mindestbestellwert für Gutscheine hinzugefügt.

Version 1.1.9
BUGFIX | Behebt einen Fehler beim Bearbeiten von Bestellzeiten (Bestellung erstellen).

Version 1.1.8
FEATURE | PDF kann nun zu Kaufguthaben-Mail hinzugefügt werden.

Version 1.1.7
BUGFIX | Behebt einen Fehler beim Bearbeiten von Bestellzeilen.

Version 1.1.6
BUGFIX | Behebt Bestellmanipulation bei frontend.checkout.finsh.order und frontend.checkout.finish.page
IMPROVEMENT | Bestellmanipulation zu Mail-Templates mit OrderEntity hinzugefügt.

Version 1.1.5
BUGFIX | Notwendige Anpassungen zu checkout/register-Seite hinzugefügt.
IMPROVEMENT | Suche nach Guthaben im Adminbereich verbessert.
TASK | PHP 8.1 Kompatibilität

Version 1.1.4
BUGFIX | "In den Warenkorb"-Button im Listing versteckt.

Version 1.1.3
TASK | Kompatibilität für Produkt-Detailseite-CMS-Layout hinzugefügt.
IMPROVEMENT | "lenzcreditmanagementbuycredit" zu lineItemOfTypeRule hinzugefügt.

Version 1.1.2
IMPROVEMENT | Button hinzugefügt, um Code zu generieren.
IMPROVEMENT | Option hinzugefügt, um Shopware "Rabatte und Aktionen-Hinzufügen-Formular" zu verstecken.
BUGFIX | Verhalten beim Bearbeiten von Bestellungen korrigiert.
BUGFIX | Verhalten beim Bearbeiten von Bestellungen für Kaufgutscheine korrigiert.

Version 1.1.1
IMPROVEMENT | Option hinzugefügt, um Bestelldaten beim laden für bessere Dokumente zu manipulieren.
IMPROVEMENT | Zahlbetrag auf Dokumenten anzeigen.
BUGFIX | IF-Statement bei Bestellmanipulation korrigiert.
BUGFIX | Mail-Templates wurden bei Deinstallation nicht korrekt entfernt.
IMPROVEMENT | URL als Variable in Mail-Template ergänzt.
TASK | Beschreibung in Plugin-Konfiguration verdeutlicht.

Version 1.1.0
FEATURE | Guthaben kann nun von Kunden als "Produkt" gekauft werden.

Version 1.0.2
IMPROVEMENT | Ablaufdatum für Guthaben hinzugefügt.

Version 1.0.1
IMPROVEMENT | Shopify-Modus hinzugefügt.
IMPROVEMENT | Import-Kommando für Shopify-Gutscheine hinzugefügt.
IMPROVEMENT | Regel für Typ "lenzcreditmanagementcredit" hinzugefügt.
IMPROVEMENT | Suche nach Code in Administration hinzugefügt.
TASK | Übersetzungen in Administration hinzugefügt.
IMPROVEMENT | Unterstützung für Komma im Wertveränderungsfeld.
BUGFIX | Deinstallation löscht nun alle Tabellen korrekt.
TASK | Code ist nun ein erforderliches Feld.
IMPROVEMENT | Informativere Fehlermeldungen für Credit-Controller hinzugefügt.
TASK | Fehlende Sichtbarkeit einer Funktion hinzugefügt.
BUGFIX | Unklare Fehlermeldung verhindert.