Guthaben-Verwaltung und Kauf von Gutschein (Shopware 6)

Nutzbar in: Self-Managed

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
  • 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

  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

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

 

Changelog

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.