Guthaben-Verwaltung und Kauf von Gutschein (Shopware 6)
Dieses Plugin unterstützt Dich bei der Verwaltung von Gutschein-Guthaben. Eine besondere Funktion ist die Guthaben-Verwaltung von Shopify-Gutscheinen.
Guthaben-Verwaltung Plugin für Shopware 6 im Shopware Community Store
Funktionalitäten
- 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.
Konfiguration
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.
Installationsanleitung
- Installiere und aktiviere das Plugin.
- Mindestens 1 Produkt anlegen, das verwendet wird, um Guthaben zu kaufen.
- Das Produkt/die Produkte in den Plugin-Einstellungen zuweisen.
- Den Flow mit dem Trigger „lenz_credit_management.buy_credit_charged” überprüfen und ggf. anpassen, damit die Mail an die Kunden versendet wird.
- 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
Enthaltene Textbausteine
- lenzCreditManagementCredit.checkout.addVoucherPlaceholder
- Label DE: Guthaben-Code eingeben...
- Label GB: Enter credit code...
- lenzCreditManagementCredit.checkout.buyCreditItemLabel
- Label DE: Guthaben-/Gutschein-Code per E-Mail über %price% %currencySymbol%
- Label GB: Credit-/Coupon-Code via E-Mail (%price% %currencySymbol%)
- lenzCreditManagementCredit.checkout.codeAddedSuccessful
- Label DE: Code "%code%" wurde erfolgreich zum Warenkorb hinzugefügt.
- Label GB: Code "%code%" added to cart.
- lenzCreditManagementCredit.checkout.codeNotFoundError
- Label DE: Der Code "%code%" wurde nicht gefunden.
- Label GB: Code "%code%" not found.
- lenzCreditManagementCredit.checkout.creditAlreadyInCartError
- Label DE: Der Code "%code%" ist bereits im Warenkorb.
- Label GB: Code "%code%" is already in cart.
- lenzCreditManagementCredit.checkout.expiresAtMsg
- Label DE: Gültig bis %expiresAt%
- Label GB: Expires at %expiresAt%
- lenzCreditManagementCredit.checkout.moreThanOneCodeFoundError
- Label DE: Code "%code%" nicht eindeutig! Bitte nehmen Sie Kontakt zu uns auf.
- Label GB: Code "%code%" is ambiguous. Please contact us.
- lenzCreditManagementCredit.checkout.nonResidualCreditValueNotReachedError
- Label DE: Der Code "%code%" kann nur gesamt eingelöst werden. Wert: %value%
- Label GB: The code "%code%" can only be used at once. Value: %value%
- lenzCreditManagementCredit.checkout.redeemCreditPaySum
- Label DE: Zahlbetrag
- Label GB: Pay sum
- lenzCreditManagementCredit.productDetail.buyCreditForm.priceFieldLabel
- Label DE: Gewünschter Guthabenwert (Max: %maxValuePerCredit% %currencySymbol%)
- Label GB: Credit value (Max: %maxValuePerCredit% %currencySymbol%)
- lenzCreditManagementCredit.productDetail.buyCreditForm.priceFieldPlaceholder
- Label DE: Hier Wunschpreis eingeben, z.B. 130 €
- Label GB: Enter price here, e.g. 130 €
- lenzCreditManagementCredit.productDetail.buyCreditForm.submitButtonText
- Label DE: Guthaben zum Warenkorb hinzufügen
- Label GB: Add to cart
Variablen in manipulierter Bestell-Entity (OrderEntity)
Sofern die Bestellmanipulation (LenzPlatformCreditManagement.config.manipulateOrderEntityLoading) aktiviert ist, stehen folgende Variablen zusätzlich zur Verfügung.
Beschreibung der Variable | Zugriff auf die Variable |
Zahlbetrag | order.customFields.lenzCreditManagementCredit.paySum |
Originaler Nettopreis | order.customFields.lenzCreditManagementCredit.originalAmountNet |
Originaler Gesamtpreis | order.customFields.lenzCreditManagementCredit.originalAmountTotal |
Originaler Positionspreis | order.customFields.lenzCreditManagementCredit.originalPositionPrice |
Manipulierter Nettopreis | order.customFields.lenzCreditManagementCredit.amountNet |
Manipulierter Gesamtpreis | order.customFields.lenzCreditManagementCredit.amountTotal |
Manipulierter Positionspreis | order.customFields.lenzCreditManagementCredit.positionPrice |
Gibt es einen Gutschein in der Bestellung? | order.customFields.lenzCreditManagementCredit.hasVoucher |
Fragen & Antworten
Die E-Mail mit dem Gutschein-Code wurde nicht versendet. Was kann ich tun?
- Bitte prüfe, ob die Bestellung als "bezahlt" markiert ist. Erst dann wird der Gutschein versendet.
- Du kannst den Versand der E-Mail anstoßen. Gehe hierzu im Adminbereich in die Bestellung und dort zu den Zusatzfeldern. In dem Reiter "Guthaben-Verwaltung - Bestellung" setzt Du den Haken der Option "Kaufgutschein: Bearbeitet" zurück (inaktiv). Im Anschluss wird die Mail in den nächsten 5-10 Minuten nochmals versendet.
Changelog
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.