# Gutscheincodes in großer Menge generieren für PrestaShop 8 & 9: Dokumentation > Überblick Das Modul erstellt Serien eindeutiger Rabattcodes mit gemeinsamen Regeln. Jeder Code ist eine native PrestaShop-Warenkorbregel. Die Codes werden per E-Mail, als druckfertiges PDF mit QR-Code oder als CSV-Export verteilt,… - Seite: - Sprache: de - Aktualisiert am: 2026-09-24 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/bulk-coupon-codes-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/bulk-coupon-codes-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/bulk-coupon-codes-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/bulk-coupon-codes-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/bulk-coupon-codes-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/bulk-coupon-codes-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/bulk-coupon-codes-prestashop/index.md) - Index: ## Überblick Das Modul erstellt Serien eindeutiger Rabattcodes mit gemeinsamen Regeln. Jeder Code ist eine native PrestaShop-Warenkorbregel. Die Codes werden per E-Mail, als druckfertiges PDF mit QR-Code oder als CSV-Export verteilt, und jede Serie hat eigene Nutzungsstatistiken. ## Installation 1. Klicken Sie unter **Module > Modul-Manager** auf **Modul hochladen** und wählen Sie `dfbulkcoupons-1.1.0.zip`. 2. Die Installation legt den Menüpunkt **Katalog > Rabatt > Gutscheincodes in Serie** an. Die Schaltfläche **Konfigurieren** des Moduls führt ebenfalls dorthin. 3. Das Modul aktiviert die Warenkorbregeln, falls sie deaktiviert waren. Update von 1.0.0: Laden Sie das neue ZIP über das alte hoch. Das Update-Skript ergänzt die Spalten für Versand und Druck sowie den Hook für die Direktlinks, ohne bestehende Serien zu verändern. ## Eine Serie anlegen Klicken Sie auf **Neue Serie** und füllen Sie das Formular von oben nach unten aus. ### Serie Der **Name der Serie** erscheint in Statistiken und Exporten. Der **Kanal** gibt an, wo die Codes verteilt werden (E-Mail, Newsletter, SMS, soziale Netzwerke, Influencer, Affiliates, Drucksachen, Ladengeschäft, Kundenservice, Sonstiges oder ein freier Name). Er dient dem Vergleich der Kampagnen in der Tabelle Leistung nach Kanal. ### Codeformat Ein Code besteht aus Präfix, Zufallsteil und Suffix. Im Zufallsteil steht `X` für einen Buchstaben oder eine Ziffer, `A` für einen Buchstaben und `#` für eine Ziffer. Andere Zeichen, etwa Bindestriche, bleiben erhalten. Beispiel: Präfix `SOMMER-` und Zufallsteil `XXXX-XXXX` ergeben `SOMMER-K7MQ-3HWD`. Der Zeichensatz „Gut lesbar“ lässt 0, O, 1, I und L weg, um Tippfehler zu vermeiden. Mindestens 4 Zufallszeichen sind nötig, und das Format muss mindestens 20-mal mehr Kombinationen bieten als angeforderte Codes: Vorschau und Kombinationszähler zeigen es während der Eingabe. ### Empfänger und Menge - **Anonyme Codes**: Geben Sie die Anzahl an, von 1 bis 200.000. Sie können frei verteilt werden. - **Ein persönlicher Code pro Kunde der ausgewählten Gruppen**: ein Code pro aktivem Kunden der angehakten Gruppen, mit der Option „Nur Newsletter-Abonnenten“. - **Ein persönlicher Code pro Kunde aus einer E-Mail-Liste**: Fügen Sie die Adressen ein, eine pro Zeile oder durch Kommas getrennt. Adressen ohne Kundenkonto werden übersprungen und gezählt. Ein persönlicher Code funktioniert nur für das Kundenkonto, dem er zugewiesen ist. ### Rabatt Der für Kunden angezeigte Name erscheint im Warenkorb und auf der Rechnung, in jeder Sprache. Typen: Prozentsatz, fester Betrag (netto oder brutto, in einer Währung), kostenloser Versand oder Gratisgeschenk (die Standardvariante des Produkts wird verschenkt). Ein Prozentsatz oder Betrag gilt für die gesamte Bestellung ohne Versand oder für ein bestimmtes Produkt. Ein Prozentsatz kann auch für das günstigste Produkt oder die eingeschränkten Produkte gelten. ### Gültigkeit und Nutzung Start- und Enddatum, **Einlösungen pro Code** und **Einlösungen pro Kunde**: Für Einmalcodes 1 und 1 angeben. Mindestbestellwert (mit Währung, Steuern und Versand), Priorität, Option „Nicht mit anderen Rabatten kombinierbar“, Anzeige des Codes im Warenkorb seines Inhabers (nur persönliche Codes) und sofortige Aktivierung. ### Einschränkungen Einschränkung nach Produkten, Kategorien oder Marken mit einer Mindestmenge passender Produkte, erlaubte Kundengruppen, erlaubte Lieferländer und im Multishop erlaubte Shops. Ein leeres Feld bedeutet keine Einschränkung. ## Codeerzeugung Nach dem Absenden erstellt die Erzeugungsseite die Codes in Blöcken zu 250 mit Fortschrittsbalken. Lassen Sie die Seite geöffnet. Wird sie geschlossen, setzt die Erzeugung beim nächsten Öffnen der Serie fort (Link **Fortsetzen** in der Liste). Jeder Code ist eine Warenkorbregel, deren Beschreibung mit `[DFBC#id]` beginnt, sichtbar unter Katalog > Rabatt. ## Seite der Serie ### Statistiken Erzeugte Codes, genutzte Codes und Einlösequote, bestätigte Bestellungen, Bestellungen von Neukunden (Kunden ohne frühere bestätigte Bestellung), Nettoumsatz und durchschnittlicher Bestellwert, gewährter Nettorabatt und Verhältnis Umsatz zu Rabatt, noch nutzbare Codes. Darunter ein Diagramm der Einlösungen pro Tag, die 15 meistgenutzten Codes und die letzten 30 Bestellungen. Nur bestätigte Bestellungen zählen für Umsatz und Rabatt, umgerechnet in die Standardwährung. ### Serie verwalten - **Angaben**: Name, Kanal und interne Notiz. Der neue Name wird in die Beschreibung der Warenkorbregeln übernommen. - **Ende der Gültigkeit**: gilt für alle Codes der Serie. - **Codes hinzufügen**: für eine Serie anonymer Codes, mit demselben Format und denselben Regeln. - **Alle Codes deaktivieren oder aktivieren**, **nie genutzte Codes löschen**, Serie **duplizieren** oder **löschen**. Frühere Bestellungen behalten ihren Rabatt. ### Codeliste Die Schaltfläche **Codes durchsuchen** zeigt die Codes zu je 50 pro Seite, mit Reitern nach Status: verfügbar, genutzt, ausgeschöpft, abgelaufen, deaktiviert. Gesucht wird nach dem Anfang des Codes oder der E-Mail des Kunden. Pro Code: Code oder Direktlink kopieren, Einlösungen, verbleibende Einlösungen, Versanddatum, letzte Bestellung, aktivieren oder deaktivieren und Link zur nativen Warenkorbregel. ## Codes per E-Mail versenden Verfügbar für Serien persönlicher Codes, über den Bereich **Verteilung** auf der Seite der Serie. 1. Bearbeiten Sie Betreff und Nachricht für jede Sprache. Verfügbare Variablen: `{firstname}`, `{lastname}`, `{code}`, `{discount}`, `{valid_until}`, `{shop_name}`, `{link}`. Die E-Mail zeigt immer den Code in einem Rahmen, den Rabatt, das Enddatum und eine Schaltfläche, die den Code im Warenkorb anwendet. 2. Klicken Sie auf **Test-E-Mail an mich senden**: Sie geht an Ihre Mitarbeiteradresse, in Ihrer Sprache, mit einem Code der Serie. 3. Wählen Sie die Empfänger: noch nicht gesendete Codes (und fehlgeschlagene) oder alle Codes erneut als Erinnerung. Die Option „Nur Kunden, die den Newsletter akzeptiert haben“ ist standardmäßig aktiviert. 4. Stellen Sie die Anzahl der E-Mails pro Minute so ein, dass Sie unter dem Limit Ihres Mailservers oder SMTP-Anbieters bleiben, und klicken Sie auf **Speichern und senden**. Der Versand erfolgt in Paketen zu 10 mit Fortschrittsbalken und Pausenschaltfläche. Jeder Kunde erhält die Version in der Sprache seines Kontos. Bereits genutzte, deaktivierte oder abgelaufene Codes sowie gelöschte oder deaktivierte Konten werden übersprungen. Vom Server abgelehnte E-Mails werden aufgelistet und beim nächsten Versand der nicht gesendeten Codes erneut versucht. Die E-Mails nutzen die Einstellungen unter **Erweiterte Einstellungen > E-Mail**. Ist der Versand dort deaktiviert, erscheint oben auf der Seite ein Hinweis. ## Codes drucken Die Schaltfläche **Codes drucken** erzeugt ein A4-PDF: - **Karten**: 10 pro Seite (95 x 55 mm), mit Schnittlinien. - **Etiketten**: 21 pro Bogen (63,5 x 38,1 mm, übliche 3-x-7-Bögen). - **Flyer**: 4 pro Seite im Format A6, mit Schnittlinien. Wählen Sie die Codes (nicht genutzte, nie gedruckte Codes, alle nicht genutzten oder alle), die Anzahl (bis zu 2.000 pro Datei) und wie viele am Anfang übersprungen werden. Legen Sie Überschrift, Bedingungen (Variablen `{valid_until}`, `{shop_name}`, `{customer}`), Akzentfarbe, QR-Code, Shopname und bei persönlichen Codes den Kundennamen fest. Die Option „Diese Codes als gedruckt markieren“ verhindert doppelten Druck. ## Direktlink und QR-Code Jeder Code hat eine Adresse wie `https://ihr-shop.de/module/dfbulkcoupons/apply?code=CODE`. Sie öffnet den Shop und wendet den Code im Warenkorb an. Hat der Besucher noch keinen Warenkorb oder erfüllt der Warenkorb die Bedingungen nicht (Mindestbestellwert, Produkte, Konto des Inhabers), wird der Code 30 Tage im Cookie gespeichert und angewendet, sobald der Warenkorb sie erfüllt. Dieser Link steckt hinter den gedruckten QR-Codes, in der Schaltfläche der E-Mails, in der Codeliste und im CSV-Export. ## CSV-Exporte Die Dateien sind UTF-8 mit Semikolon als Trennzeichen und öffnen sich direkt in Excel. - **Codes** (alle, nicht genutzt oder genutzt): Code, Status, Einlösungen, verbleibende Einlösungen, Gültigkeitsdaten, E-Mail, Vor- und Nachname des Kunden, letzte Einlösung, letzte Bestellung, Versanddatum, Druckdatum, Direktlink. - **Nutzung pro Bestellung**: Datum, ID, Referenz und Status der Bestellung, bestätigt oder nicht, Code, Kunde, Rabatt und Summe netto und brutto, Währung. ## Leistung nach Kanal Sobald mehrere Kanäle genutzt werden, zeigt die Serienliste eine Tabelle pro Kanal: Anzahl der Serien und Codes, genutzte Codes, Quote, Bestellungen, Nettoumsatz und Nettorabatt, sortiert nach Umsatz. ## Deinstallation Die Deinstallation löscht die Tabellen des Moduls (Serien, Versand- und Druckverlauf). Bereits erzeugte Codes bleiben aktive Warenkorbregeln unter Katalog > Rabatt. ## Fehlerbehebung - **Die Erzeugung bricht ab**: Öffnen Sie die Serie erneut, die Erzeugung setzt fort. Lehnt die Datenbank die Einträge ab, erscheint eine genaue Fehlermeldung. - **„Dieses Format lässt zu wenige Kombinationen“**: Fügen Sie Zufallszeichen hinzu oder wählen Sie das vollständige Alphabet. - **Fehlgeschlagene E-Mails**: Prüfen Sie Erweiterte Einstellungen > E-Mail mit einer Test-E-Mail und senden Sie dann die nicht gesendeten Codes erneut. - **Der QR-Code reduziert den Warenkorb nicht**: Öffnen Sie den Warenkorb, der Code wird angewendet, sobald seine Bedingungen erfüllt sind. Bei einem persönlichen Code muss der Kunde in seinem Konto angemeldet sein.