# Gutschein Guthaben ## Modulbeschreibung Mit dem Modul **Gutschein Guthaben** können Ihre Kunden endlich Wertgutscheine in Teilbeträgen einlösen.\ Nach dem Einlösen eines Gutscheins im Shop, wird Ihren Kunden das Restguthaben im Warenkorb bei der Einlösung des Gutscheins angezeigt. \ Das Modul bietet den Vorteil, dass das Restguthaben nicht nach einem Einkauf verfällt, sondern der Gutschein so lange gültig ist, bis das gesamte Guthaben aufgebraucht ist. Das Modul wurde mit folgenden Zahlart-Modulen unter Oxid 6.1 - 6.4 getestet: PayPal, AmazonPay, Klarna und Payone. ## Systemvoraussetzungen ### PHP-Version OXID 4 & 5 * PHP 5.6 ### PHP-Version OXID 6 * PHP 7.0 (OXID 6.0.x) * PHP 7.1 (OXID 6.1.x) * PHP 7.2 - 7.4 (OXID 6.2.x - 6.3.x) * PHP 8.0 (OXID 6.3.x - 6.4.x) * PHP 8.1 (OXID 6.5.x) ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### Kompatibel mit den Themes * Flow * Wave * RoxIVE ### Kompatibel mit den OXID Versionen * OXID CE/PE 4.9.x bis 4.10.x * OXID EE 5.2.x bis 5.3.x * OXID CE/PE/EE 6.0 bis 6.5.x ## Installation ### Ab OXID 6 1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. Sie erhalten dieses unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "couponscredit" 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/couponscredit` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ### Bis OXID 4.10.x/5.3.x 1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. Sie erhalten dieses unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ## Update ### Ab OXID 6 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/couponscredit". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/couponscredit` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 4.10.x/5.3.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein und überschreiben Sie dabei die vorhandenen Dateien des Moduls. 4. Aktivieren Sie dieses Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Funktionsbeschreibung Dieses Modul ermöglicht es, Gutscheine mit nur einem Klick für Ihre Kunden attraktiver zu gestalten. Durch die Einstellungen im Backend legen Sie bestimmte Werte fest (Name, Wert, Menge, Gutscheinnummer, Gültigkeitsbereich usw.) und durch das Aktivieren des **"Guthabens"** können diese an den Kunden verteilt werden, damit die Kunden dann Ihren **Gutschein** als Guthaben einlösen können. Im Folgenden Abschnitt wird Ihnen näher erläutert, wie Sie die Gutscheine im Backend einstellen können. Außerdem wird die Ansicht Ihrer Kunden dargestellt. ## Backend-Einstellungen 1. Wechseln Sie im Backend-Bereich zu **"Shopeinstellungen"** und drücken Sie auf **"Gutscheinserien"** 2. Es öffnet sich ein Fenster, wo Sie Einsicht in Ihre **bereits erstellten Gutscheine** haben und diese zu bearbeiten oder **Gutscheine** zu erstellen. 3. Unten sehen Sie dann Einstellungsmöglichkeiten und füllen diese nach Bedarf aus. 4. Setzen Sie ein Häkchen bei **"Guthaben aktivieren (nur mit absoluten Rabatten möglich)"** damit das Modul wirksam wird. (Um nähere Informationen über die Einstellung zu erhalten, können Sie auf das **"?"-Symbol** daneben klicken) 5. Anschließend auf **"Speichern"** drücken 6. Danach können Sie auf der rechten Seite, weitere Einstellungen vornehmen. (Gutscheinnummer, Anzahl usw.) 7. Füllen Sie diese aus und klicken Sie anschließend auf **"Generieren",** dann sind alle wichtigen Einstellungen vorgenommen. ![Einstellungsmöglichkeiten für Gutscheine](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LPfdWfFkIJ4w7TeH3ov%2F-LPfkn2p3J_ALMEMwxGb%2FBildschirmfoto%202018-10-25%20um%2015.50.39.png?alt=media\&token=09a51bf4-ce38-4c88-b073-6f2d588bd002) \ Sie können auch einsehen, wie viel **Guthaben** auf den jeweils **ausgewählten Gutschein** noch verfügbar ist. ![verfügbares Guthaben](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LPfdWfFkIJ4w7TeH3ov%2F-LPfm0fWHHi-ETnteX7p%2FBildschirmfoto%202018-10-25%20um%2016.03.52.png?alt=media\&token=2c771ee0-b96f-410d-9ef5-282942cadc95) ## Frontend-Ansicht Nachdem der Kunde nun einen Artikel ausgesucht, einen Gutschein von Ihnen erhalten hat und bereit ist zu zahlen, kann der Kunde diesen Gutschein einlösen. Nach der Eingabe des Gutscheines, kann der Kunde rechts einsehen, welche Gutscheinnummer eingelöst wird und wie viel Restguthaben nach dem Einkauf übrig bleiben würde. ![Gutschein-Einlösung](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LPfdWfFkIJ4w7TeH3ov%2F-LPfnc6z0O1MZstifVME%2FBildschirmfoto%202018-10-25%20um%2016.15.06.png?alt=media\&token=9604f56d-9ff0-47a7-b37d-1b4b7786c31a) \ Vor dem endgültigen Bezahlen, hat der Kunde noch ein letztes mal die Möglichkeit einzusehen, welche Gutscheine benutzt werden und wie viel Restguthaben nach dem Einkauf übrig bleibt. Nach dem Bezahlen kann der Kunde durch andere Artikel Ihres Shops stöbern und den Gutschein einlösen, bis dieser komplett verbraucht wird. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LPfdWfFkIJ4w7TeH3ov%2F-LPfoc0TeXtT-G8yLT2S%2FBildschirmfoto%202018-10-25%20um%2016.22.44.png?alt=media\&token=0a15f550-f0cf-4fac-9972-94ec6299e9f4) ## Hilfe & Support Haben Sie Fragen oder benötigen Sie Hilfe bei der Installation? Gerne bieten wir Ihnen auch einen Installationsservice an. Kontaktieren Sie uns einfach! * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.digidesk.de/moduldokumentationen/gutschein-guthaben.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.