Zum Inhalt

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 Store

Funktionalitäten

  • Die Erweiterung erfasst Guthaben-Änderungen, bspw. Einlösungen im Shop.
  • Variable oder feste 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 wird 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.
  • Die Umsätze können als CSV-Datei exportiert werden.
  • 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.
  • Optional kann der Gutschein als PDF versendet werden.
  • Das Guthaben-Einlösen-Formular kann zusätzlich auf der /checkout/confirm-Seite eingeblendet werden.
  • Pro Artikel/Gutschein kann ein Bonus in Prozent definiert werden.
  • Ein Feld für eine Grußbotschaft kann beim Artikel aktiviert werden.
  • In der Guthaben-Verwaltung kannst du über den Button "Template anzeigen" den Gutschein aufrufen, welcher an deine Kunden versendet wurde.

Hinweise

  • Das Guthaben in unserer App wird steuerneutral betrachtet, d.h. es wird weder beim Kauf noch beim Einlösen des Guthabens MwSt. fällig. Optional kann beim Guthaben-Produkt ein Steuersatz hinterlegt werden, welcher für die Berechnung berücksichtigt wird.
  • Die App funktioniert aktuell nur mit einer Währung. Sofern Du mehr als eine Währung in Deinem Shop nutzt, sprich uns bitte an.
  • Sofern eine Rückerstattung des Guthabens / Gutscheins erfolgt, muss das Guthaben händisch wieder entwertet werden. Dies wird nicht von der App automatisch erledigt!
  • Nur die zeilenweise (horizontale) Steuerberechnung wird von der Erweiterung unterstützt.

Konfiguration

Guthaben

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.

Guthabenbetrag zur Bestellsumme hinzuaddieren (Admin & Bestellbestätigung)

Der eingelöste Guthabenbetrag wird zur angezeigten Bestellsumme im Adminbereich und in der Bestellbestätigungs-E-Mail hinzuaddiert, wenn diese Option aktiviert ist. Die angezeigte Summe entspricht dem ursprünglichen Bestellwert vor dem Gutschein-Abzug. Aktiviere diese Option, wenn das Guthaben bereits vom Kunden vorab bezahlt wurde und du den vollen Rechnungsbetrag in deiner Buchhaltung sehen möchtest.

Shopware Rabatte & Aktionen-Hinzufügen-Formular verstecken

Aktiviere diese Option, wenn nur das Guthaben-Feld im Warenkorb / Off-Canvas Warenkorb angezeigt werden soll.

Benutze Guthaben-Hinzufügen-Formular ebenfalls für Rabatte & Aktionen

Nach dem aktivieren der Option kann das Eingabefeld der Erweiterung ebenfalls für die Shopware-Standard Rabattcodes verwendet werden.

Account-Seite für Kunden aktivieren

Wenn diese Option aktiviert ist, wird im Kunden-Login der Menüpunkt "Guthaben-Codes" angezeigt. Dort werden dem Kunden alle erworbenen Codes inkl. aktuellem Wert angezeigt.

Zeige Umsätze auf der Account-Seite?

Wenn diese Option aktiviert ist, wird im Kunden-Konto nicht nur der Wert des Guthabens ausgegeben, sondern auch alle Bewegungen im Zusammenhang mit dem Gutschein-Code.

Guthaben-Einlösen-Formular auf /checkout/confirm-Seite anzeigen?

Diese Option muss aktiviert werden, wenn das Formular für die Gutschein-Einlösung zusätzlich auf der /checkout/confirm-Seite angezeigt werden soll.

Einlösbare Guthaben auf /checkout/confirm-Seite anzeigen?

Wenn diese Option aktiviert ist, werden im oberen Bereich der /checkout/confirm-Seite die aktuellen Guthaben des Kunden eingeblendet.

Produktnummer für Payload

Füge hier eine Produktnummer ein, die über Payload beim Kauf des Gutscheins mitgegeben wird.

Guthaben kaufen

Produkte, zum Guthaben kaufen definieren

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

Minimaler kaufbarer Wert

Lege den minimalen Wert des Guthabens fest, den Deine Kunden kaufen können.

Maximaler kaufbarer Wert

Lege den maximalen Wert des Guthabens fest, den 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.

Ist nur einlösbar von Kunden, die das Guthaben gekauft haben?

Wenn diese Option aktiviert ist, kann nur der Kunde, welcher den Gutschein erworben hat, diesen auch einlösen.

Präfix für Code-Generierung

Optional kannst Du ein Präfix für die Gutscheincodes definieren.

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.

Guthaben-Generierung ab Datum

Feste Produktnummer für Payload

Füge hier eine Produktnummer ein, die über Payload beim Einlösen des Gutscheins mitgegeben wird.

Benutze die Produktnummer des Produkts, anstatt der festen Produktnummer für Payload?

Wenn diese Option aktiv ist, wird die Produktnummer im Payload übergeben.

Verhindere die Nutzung von Rabatten & Aktionen, um Guthaben zu kaufen?

Wenn diese Option aktiv ist, kann kein Guthaben gekauft werden, wenn sich ein Rabattcode im Warenkorb befindet. Ein Hinweis wird eingeblendet und die Bestellung wird blockiert.

Verhindere die Nutzung von Rabatten & Aktionen, um Gutschein zu kaufen

Definiere die Rabatte & Aktionen, die nicht für den Kauf eines Gutscheins angewendet werden können. Ein Hinweis wird im Warenkorb/Checkout eingeblendet und die Bestellung wird blockiert.

PDF-Vorschau mit echten Daten aktivieren?

Wenn aktiviert, kann die Guthaben-PDF-Generierung mit echten Daten geprüft werden.
- URL: /lenz-credit-management/buy-credit/test-pdf?creditId=0195ae832af57025a15df98e562e62e3

Gutschein Preis bei Artikelansicht ausblenden, wenn der Preistyp "Benutzereingabe" ist

Der Preis wird auf der Artikeldetailseite nicht mehr eingeblendet, wenn der Gutschein der Preistyp "Benutzereingabe" gesetzt ist.

Experten-Einstellungen

Standard Steuersatz (Bitte 0% wählen)

Diese Einstellung darf nur verändert werden, wenn Du genau weißt, was du tust! Hier wird der Standard-Steuersatz für Gutscheine festgelegt.

Einstellungsmöglichkeiten: Produkt

Kaufgutschein: Aktiv?

Die Nutzung des Produkts als Guthaben/Gutschein kann mit dieser Option aktiviert werden. Das Produkt muss nicht zusätzlich in der Plugin-Konfiguration hinterlegt werden.

Kaufgutschein: Preistyp

Definiere, welcher Preistyp für das Produkt gelten soll.

  • Benutzereingabe: Der Kunde legt den Preis des Gutscheins fest.
  • Fester Preis: Der Preis des Produkts wird verwendet.

Kaufgutschein: Bonus in %

Mit dieser Option kannst Du einen Bonus für das Guthaben definieren. Der Bonus wird automatisch zur Höhe des Guthabens addiert.

Kaufgutschein: Steuersatz

Wenn Du einen gesonderten Steuersatz für das Guthaben definieren möchtest, kannst Du dies hier festlegen.
Wenn kein gesonderter Steuersatz definiert ist, wird der Steuersatz aus den Einstellungen der Erweiterung verwendet.

Kaufgutschein: Bild

Hinterlege ein Bild, welches auf der PDF ausgegeben wird.

Kaufgutschein: Zeige gekauft von?

Wenn diese Option aktiviert ist, kann Dein Kunde beim Kauf des Produkts eine Angabe zum Schenker machen.

Kaufgutschein: Zeige gekauft für?

Wenn diese Option aktiviert ist, kann Dein Kunde beim Kauf des Produkts eine Angabe zum Beschenkten machen.

Kaufgutschein: Zeige Nachricht an Gutscheinempfänger an?

Wenn diese Option aktiviert ist, kann Dein Kunde eine Nachricht für den Gutscheinempfänger angeben.

Kaufgutschein: Alternativer Template-Pfad

Hinterlege hier den Template-Pfad, damit die Angaben auf dem Gutschein-PDF ausgegeben werden.

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

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