Guthaben / Kauf Gutscheine

Über die Erweiterung

Möchtest Du für Deine Kunden Gutscheine in Deinem Onlineshop anbieten? Oder benötigst Du eine Lösung für die Verwaltung Deiner Gutscheine? Dann unterstützt Dich unsere App „Guthaben-Verwaltung“ optimal bei der Verwaltung der Guthaben / Gutscheine mit Restwert.

Gutschein erwerben

Mit der App können Deine Kunden in Deinem Onlineshop einen Gutschein erwerben. Du kannst definieren, ob der Gutschein einen festen Wert haben soll oder Deine Kunden den Wert individuell festlegen können. Für einen individuellen Wert kannst Du den minimalen und/oder maximalen Gutscheinbetrag zuvor in den App-Einstellungen fest legen. Sobald die Bestellung bezahlt ist, wird bei der nächsten Ausführung des Cronjobs ein Guthaben erstellt und eine Mail mit dem Guthabencode an den Kunden gesendet. Mit der Versendung des Guthabens wird zeitgleich in der Guthaben-Verwaltung der Gutschein angelegt.

Bei der Erstellung des Guthabens wird der Werterhalt automatisch aktivieren. Dadurch kann Dein Kunde das Guthaben Stück für Stück einlösen und muss es nicht bei einer Bestellung komplett einlösen.
Deinem Kunden wird der Gutscheincode nicht nur per Mail zugesendet sondern wird im Kundenaccount unter "Guthaben-Codes" angezeigt.

Wenn das Guthaben nur für 3 Jahre gültig sein soll, kannst Du dies in den App-Einstellungen festlegen. Nach den 3 Jahren wird der Gutschein im Shop nicht mehr angenommen. Damit Deine Kunden immer informiert sind wie lange das Guthaben gültig ist, kannst Du in der App die Option „Ablauf des Gutscheins im Checkout anzeigen“ aktivieren.
NEU: Du kannst nun pro Artikel/Gutschein einen Bonus in % definieren. Sobald ein Bonus definiert wurde, wird dieser automatisch für den jeweiligen Gutschein berechnet und erhöht das Guthaben. Dein Kunde zahlt weiterhin den vom ihm gewählten Ursprungsbetrag. Beispiel: Als Bonus wird 10% definiert. Dein Kunde möchte einen Gutschein in Höhe von 10€ erwerben. Der Wert des Gutscheins wird automatisch auf 11€ erhöht, aber nur 10€ werden deinem Kunden berechnet.

Gutschein als PDF versenden

Die Erweiterung ermöglicht es für die gekauften Guthaben/Gutscheine ein automatisches PDF zu generieren und diese dem Kunden zu senden. Damit die PDF erstellt werden kann wird ein Template benötigt, welches die Variablen für die Ausstellung des Gutscheins enthalten muss. Auf unserer Webseite lenz-ebusiness.de findest Du die Variablen sowie weitere Informationen zur Einrichtung des PDF-Versands. 
NEU: In den Zusatzfeldern des Produkts kannst Du ein Bild hinterlegen, welches in der PDF ausgegeben wird. Zudem kannst Du die Eingabefelder "Von", "Für" und "Persönlicher Gruß" optional aktivieren. Die Eingaben aus diesen Feldern werden anschließend in der PDF ausgegeben.

Gutschein einlösen

Mit dem Guthaben-Code kann Dein Kunde nun den Gutschein in Deinem Onlineshop einlösen. Der Guthaben-Code kann im Off-Canvas-Warenkorb und auf der /checkout/confirm-Seite eingelöst werden. Optional kannst Du in den Einstellungen festlegen, dass die vorhandenen Guthaben des Kunden im oberen Bereich auf der /checkout/confirm-Seite eingeblendet werden.

Alle Transkationen mit Zusammenhang mit dem Guthaben sind in dem Abschnitt „Umsätze“ auf einen Blick ersichtlich. Wenn beispielsweise das Guthaben für eine Bestellung genutzt wird, erscheint die Bestellnummer in der Spalte „Kommentar“.
Seit v5.0.6 steht die Funktion eines csv-Exports der Umsätze zur Verfügung. Unter "Marketing" -> "Guthaben-Verwaltung" -> "Umsätze" kann die .csv-Datei erstellt werden.

Gutschein händisch im Adminbereich anlegen

Neben der Erstellung eines Guthabens beim Verkauf eines Gutscheins über den Onlineshop ist es ebenso möglich ein Guthaben händisch anzulegen und aufzuladen. 

Dabei können alle Einstellungen wie Werterhalt und Ablaufdatum festgehalten werden. Die Höhe des Guthabens kann dabei variabel festgelegt und mit einem Kommentar versehen werden. Im Adminbereich ist es sowohl möglich ein Guthaben aufzuladen, wie auch das Guthaben zu verringern. 

Wichtige Hinweise:

• Das Guthaben in unserer App wird steuerneutral betrachtet, d.h. es wird dafür 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 von der Erweiterung unterstützt. 

Shopify-Modus

Ein besonderes Features der App "Guthaben-Verwaltung" ist der Shopify-Modus. Solltest Du Deinen Onlineshop von Shopify auf Shopware umgestellt haben, können Deine Kunden mit dem aktivierten Shopify-Modus die bisherigen Gutscheine weiterhin in Deinem Onlineshop einlösen. Regulär werden beim Export der Gutscheindaten aus Shopify für den Gutscheincode nur die letzten 4 Stellen angezeigt. Du kannst die bestehenden Gutscheine einpflegen und den Shopify-Modus für diese Gutscheine aktiveren. Möchte nun ein Kunde einen Shopify-Gutschein einlösen, überprüft die App ob die letzten 4 Stellen und die Gesamtlänge übereinstimmen.

Sollten mehrere Gutscheincodes, die in der Guthaben-Verwaltung hinterlegt sind, zutreffen können, haben immer die Gutscheine ohne Shopify-Modus Vorrang. 

Einsatzmöglichkeiten der App "Guthaben-Verwaltung"

• Gutscheine
• Kundenkarten
• Guthabenkarten

Optionen

Guthaben

• Zeige Ablaufdatum des Gutscheins im Checkout: Wenn Du Gutscheine mit zeitlicher Begrenzung vertreibst, kann das Ablaufdatum im Shop Deinem Kunden angezeigt werden.
• Laden der Bestell-Entität verändern (wenn keine Wawi angebunden): Aktiviere diese Option, wenn Du keine Warenwirtschaft nutz und die Anzeige der Rechnungsbeträge im Adminbereich anpassen möchtest. Mit aktiver Option wird der Gutscheinwert zur Gesamtsumme der Bestellung hinzugefügt. Bitte prüfe vor der aktiven Verwendung im Shop, ob Du die Option aktivieren 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. 
• 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 Guthaben 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 Gutschein 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, das Deine Kunden kaufen können. 
• Maximaler kaufbarer Wert: Lege den maximalen Wert des Guthabens fest, das Deine Kunden kaufen können.
• Gültig bis: Ende des 3. Jahres / deaktiviert: Entscheide, ob die Guthaben ein Fälligkeitsdatum haben sollen.
• Ist nur einlösbar von Kunden, die das Guthaben gekauft haben?: aktiv / inaktiv: 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 kann ein Präfix für die Gutscheincodes definiert werden
• Code-Länge für Generierung: Definiere die Länge des Guthaben-Codes.
• Trennzeichen nach bestimmter Anzahl an Zeichen einfügen?: aktiv/inaktiv: Lege fest, ob der Guthaben-Code Trennzeichen aufweisen 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 Guthaben, um Guthaben zu kaufen? Diese Option verhindert die Nutzung eines Gutscheins beim Kauf eines anderen Gutscheins. Ein Hinweis wird eingeblendet und die Bestellung wird blockiert.
• 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 diesen Rabatten & Aktionen, um Guthaben 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

• 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. Beim Preistyp "Benutzereingabe" legt der Kunde den Preis des Gutscheins fest. Beim Preistyp "Fester Preis" wird der Preis des Produkt 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 dem 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 Produkt eine Angabe zum Schenker angeben.
• Kaufgutschein: Zeige gekauft für?: Wenn diese Option aktiviert ist, kann Dein Kunde beim Kauf des Produkt eine Angabe zum Beschenkten angeben.
• 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.

Weitere Informationen

Allgemein
Unsere Erweiterungen basieren auf Standardfunktionen von Shopware 6 (Community Edition) und dem Standard Responsive Theme. Individuelle oder stark angepasste Themes können bei der Entwicklung nicht berücksichtigt werden. In solchen Fällen können Anpassungen nötig sein, um eine vollständige Kompatibilität sicherzustellen.

Kompatibilität
Unsere Erweiterungen sind grundsätzlich untereinander kompatibel. Wenn sich Funktionen gegenseitig ausschließen oder überschneiden, weisen wir in der Erweiterungs-Beschreibung explizit darauf hin.
Wir garantieren die Kompatibilität mit der Community Edition  und dem Standard-Theme. Bei Nutzungs-Schwierigkeiten unterstützen wir dich selbstverständlich gern. Eine Kompatibilität mit Erweiterungen von Drittanbietern oder Shopware Premium-Erweiterungen können wir nicht garantieren.

Support
Unser Support-Team ist gerne für dich da! Bitte stelle deine Supportanfrage über deinen Shopware Account.
Prüfe dies vorab:

• Aktuellste Version der Erweiterung installiert
• Gültige Mietlizenz
• Fehler tritt auch im Standard Theme auf
• Drittanbieter-Erweiterungen sind deaktiviert
• keine eigenen Code-Anpassungen an der Erweiterung 

Für die Analyse benötigen wir:

• Uneingeschränkten Admin-Zugriff
• Ggf. zusätzlich SSH- oder Datenbankzugang

Wichtig: Einrichtung und Entfernung der Zugänge liegt in deiner Verantwortung. Zudem empfehlen wir für den Support eine Staging- oder Entwicklungsumgebung.
Wird festgestellt, dass die Ursache nicht in unserer Erweiterung liegt (z.B. Theme-Anpassungen, Drittanbieter-Plugins oder Serverkonfiguration), erfolgt eine weitere Analyse kostenpflichtig nach vorheriger Rücksprache.

Testversion
Bei der erstmaligen Miete kannst du unsere Erweiterung 30 Tage kostenlos testen. Nutze die Testphase, um alle Funktionen in Ruhe zu prüfen. Bei Fragen unterstützt dich unser Support-Team jederzeit gern.

Individuelle Anpassungen
Du brauchst eine individuelle Erweiterung oder Anpassung? Wir helfen dir gerne weiter:

• info@lenz-ebusiness.de – mit kurzer Beschreibung deiner Anforderung
• Oder direkt Termin buchen unter: https://lenz-ebusiness.de/kontakt/

Features
Neue Features und Erweiterungen entwickeln wir stets auf Basis der jeweils aktuellen Shopware-Version. Alle beschriebenen Funktionen beziehen sich immer auf die neuste Version der jeweiligen Erweiterung. 

Haftungssauschluss
Unsere Erweiterungen werden sorgfältig entwickelt und regelmäßig aktualisiert. Dennoch übernehmen wir keine Gewährleistung für einen jederzeit fehlerfreien Betrieb, da Shop-Konfigurationen, Serverumgebungen oder Drittanbieter-Erweiterungen individuelle Einflüsse haben können.
Wir haften nicht für Schäden, sofern diese nicht auf vorsätzlichem oder grob fahrlässigem Verhalten unsererseits beruhen. Bitte prüfe vor Updates stets die Systemvoraussetzungen und die Kompatibilität in deiner Shopumgebung.

Transparenz
Offene und transparente Kommunikation ist uns wichtig. Dein Feedback hilft uns dabei, unsere Erweiterungen kontinuierlich zu verbessern.
Wenn du zufrieden bist, freuen wir uns über eine positive Bewertung – sie hilft uns und auch anderen Shopbetreibern gleichermaßen.

Weitere Informationen zu unseren Erweiterungen findest Du in unserer Dokumentation: https://docs.lenz-ebusiness.de/