Kortingscodes in Bulk Genereren voor PrestaShop 8 & 9: documentatie
De module installeren, een reeks aanmaken met de wizard, de codes beveiligen, per e-mail versturen, met QR-code afdrukken, exporteren en de resultaten van elke campagne volgen.
Inleiding
De module maakt reeksen unieke kortingscodes aan die dezelfde regels delen. Elke code is een native winkelwagenregel van PrestaShop: hij werkt in de winkelwagen, verschijnt op de factuur en blijft geldig als de module wordt verwijderd. De codes worden verspreid per e-mail, als afgedrukte pdf met QR-code, via een directe link of via een CSV-export, en elke reeks heeft eigen statistieken.
Het dashboard vat alle reeksen samen: gegenereerde en gebruikte codes, gevalideerde bestellingen, omzet excl. btw en verleende korting. De lijst kan worden gefilterd op naam, status of kanaal, en een balk toont het gebruikspercentage van elke reeks.

Installatie en update
- Klik in Modules > Modulebeheer op Upload een module en selecteer
dfbulkcoupons-2.0.0.zip. - De installatie maakt het tabblad Catalogus > Kortingen > Kortingscodes in bulk aan. De knop Configureren van de module leidt er ook naartoe.
Compatibiliteit: PrestaShop 1.7.8, 8 en 9, PHP 7.1 tot 8.5, thema’s Classic en Hummingbird.
Update vanaf 1.0 of 1.1: upload de nieuwe ZIP over de oude heen. De reeksen, codes, statistieken en verzendinstellingen blijven behouden. De update voegt een uniciteitsindex op de codes en de beveiliging van de directe link toe.
Een reeks aanmaken
Klik op Nieuwe reeks. Een wizard in zes stappen begeleidt u: Campagne, Codes, Korting, Voorwaarden, Beperkingen en Controle. Er wordt niets aangemaakt vóór de laatste stap. U kunt via de voortgangsbalk naar elke stap terugkeren, en een samenvatting aan de rechterkant toont live een voorbeeldcode, de korting, de geldigheid en het beveiligingsniveau.
1. Campagne
De naam van de reeks wordt gebruikt in de statistieken en exports. Het kanaal geeft aan waar de codes worden verspreid (e-mail, nieuwsbrief, sms, sociale media, influencers, affiliates, drukwerk, fysieke winkel, klantenservice of een vrije naam). Het dient om campagnes te vergelijken. Een interne notitie is optioneel.
2. Codes
- Anonieme codes: 1 tot 200.000 codes om vrij te verspreiden. Snelkeuzeknoppen bieden 100, 500, 1.000, 5.000 en 10.000.
- Klantgroepen: één persoonlijke code per actieve klant van de aangevinkte groepen (gastaccounts uitgezonderd), met de optie “Alleen nieuwsbriefabonnees”. Het aantal klanten per groep wordt weergegeven.
- E-maillijst: één persoonlijke code per klantaccount dat in de geplakte lijst wordt gevonden. Adressen zonder account worden overgeslagen en hun aantal wordt vermeld.
Een persoonlijke code werkt alleen voor het klantaccount waaraan hij is toegewezen.
Het formaat bestaat uit een prefix, een willekeurig deel en een suffix. In het willekeurige deel staat X voor een letter of cijfer, A voor een letter en # voor een cijfer; andere tekens, zoals streepjes, blijven behouden. Kant-en-klare formaten kiest u met één klik. De set “Goed leesbaar” sluit 0, O, 1, I en L uit. Het voorbeeld toont drie voorbeelden, het aantal mogelijke combinaties en een beveiligingsindicator.

3. Korting
Types: percentage, vast bedrag (excl. of incl. btw, in een valuta, met optie voor gedeeltelijk gebruik), gratis verzending of cadeau (standaardcombinatie van het product). Een percentage of bedrag geldt voor de hele bestelling exclusief verzending of voor één specifiek product; een percentage kan ook gelden voor het goedkoopste product of voor de producten van de beperking. De naam die de klant ziet, verschijnt in de winkelwagen en op de factuur, in elke taal.

4. Voorwaarden
Begin- en einddatum (tijdzone van de winkel), gebruik per code en per klant (1 en 1 voor codes voor eenmalig gebruik), minimumbedrag met valuta, btw en verzending, en prioriteit. De optie Exclusieve codes, standaard ingeschakeld, voorkomt dat twee codes van de reeks in dezelfde bestelling worden gebruikt, en ook samen met een andere korting die eveneens exclusief is. Bij persoonlijke codes kan de code in de winkelwagen van de eigenaar worden getoond. De codes kunnen uitgeschakeld worden aangemaakt om ze later in te schakelen.
5. Beperkingen
Beperking tot producten (zoeken op naam, referentie of ID), categorieën of merken (filterbare lijsten), met een minimaal aantal overeenkomende producten. Toegestane klantgroepen, leveringslanden en, bij multistore, winkels. Een leeg gelaten veld legt geen enkele beperking op.
6. Controle
De laatste stap vat de reeks samen (codes, voorbeeld, korting, geldigheid, gebruik en beperkingen) met een bewerkingslink naar elke stap. De knop Aanmaken en codes genereren start het genereren.

Beveiliging van de codes
- De codes worden getrokken met een cryptografisch veilige generator, vergeleken met alle bestaande kortingscodes en beschermd door een unieke index in de database.
- Een formaat moet minstens 6 willekeurige tekens bevatten en minstens 10.000 combinaties per gevraagde code bieden. De indicator toont de kans dat een bezoeker een geldige code vindt door willekeurig te typen: te makkelijk (geweigerd), aanvaardbaar, sterk of zeer sterk.
- De directe link accepteert maximaal 10 onbekende codes per verbinding binnen 15 minuten, zodat hij niet kan worden gebruikt om codes te raden.
- De CSV-exports neutraliseren spreadsheetformules in elke cel.
Codes genereren
De codes worden aangemaakt in blokken van 500, met een voortgangsbalk, de snelheid en de resterende tijd. Met een knop kunt u pauzeren en hervatten. U kunt de pagina verlaten: het genereren gaat verder waar het gestopt was zodra u de reeks opnieuw opent. Elk blok wordt volledig of helemaal niet opgeslagen. Aan het einde worden de eerste codes getoond, met snelkoppelingen naar de CSV-export, verzending per e-mail, afdrukken en statistieken. Elke code is een winkelwagenregel waarvan de beschrijving begint met [DFBC#id], zichtbaar in Catalogus > Kortingen.

Pagina van de reeks
Elke reeks heeft een gemeenschappelijke kop (status, korting, formaat, geldigheid) en tabbladen: Overzicht, Codes, E-mail (persoonlijke codes) en Afdrukken.
Overzicht
Gegenereerde codes, gebruikte codes en gebruikspercentage, gevalideerde bestellingen, bestellingen van nieuwe klanten, omzet excl. btw en gemiddelde bestelling, verleende korting en verhouding omzet/korting. Een samenvatting toont de codes die gegenereerd, nog bruikbaar en minstens één keer gebruikt zijn. Het paneel Verspreiding bundelt e-mail, afdrukken, export en directe link. Daarna volgen de grafiek van bestellingen per dag, de meest gebruikte codes, de exports en de laatste bestellingen. Alleen gevalideerde bestellingen tellen mee voor omzet en korting, omgerekend naar de standaardvaluta.


De reeks beheren
- Gegevens: naam, kanaal en interne notitie. De nieuwe naam wordt overgenomen in de beschrijving van de winkelwagenregels.
- Einde geldigheid: geldt voor alle codes van de reeks.
- Codes toevoegen aan een reeks anonieme codes, met hetzelfde formaat en dezelfde regels.
- De reeks dupliceren, alle codes uitschakelen of inschakelen.
- Gevarenzone: de nooit gebruikte codes verwijderen, of de reeks verwijderen. Er wordt om bevestiging gevraagd; eerdere bestellingen behouden hun korting.
Codelijst
Het tabblad Codes toont de codes in pagina’s van 50, gefilterd op status (beschikbaar, gebruikt, opgebruikt, verlopen, uitgeschakeld) met het aantal codes per status. De zoekfunctie zoekt op het begin van de code of op het e-mailadres van de klant. Per code: de code of de directe link kopiëren, gebruik, resterend gebruik, verzenddatum, laatste bestelling, in- of uitschakelen, en link naar de native winkelwagenregel.

Codes per e-mail versturen
Beschikbaar voor reeksen persoonlijke codes, in het tabblad E-mail.
- Pas voor elke taal het onderwerp en het bericht aan. De variabelen
{firstname},{lastname},{code},{discount},{valid_until},{shop_name}en{link}voegt u met één klik in. Het voorbeeld wordt tijdens het typen bijgewerkt. - Klik op Stuur mij een test-e-mail: deze wordt naar uw medewerkersadres verzonden, in uw taal.
- Kies de ontvangers: nog niet verzonden codes (en mislukte codes), of alle codes voor een herinnering. De optie “Alleen klanten die de nieuwsbrief hebben geaccepteerd” is standaard aangevinkt.
- Stel het aantal e-mails per minuut in om onder de limiet van uw server te blijven en klik daarna op Opslaan en versturen.
Het versturen gebeurt in pakketten van 10, met een voortgangsbalk en een pauzeknop. Elke klant ontvangt de versie in de taal van zijn account. Codes die al gebruikt, uitgeschakeld of verlopen zijn en verwijderde of uitgeschakelde accounts worden overgeslagen. E-mails die door de server zijn geweigerd, worden opgesomd en bij de volgende verzending opnieuw geprobeerd.

De klant ontvangt zijn code in een kader, de korting, de einddatum en een knop die de code in zijn winkelwagen toepast. Er is een tekstversie bijgevoegd voor e-mailprogramma’s die geen HTML weergeven.

De e-mails gebruiken de configuratie van Geavanceerde instellingen > E-mail. Als het versturen daar is uitgeschakeld, verschijnt er bovenaan de pagina een waarschuwing.
Codes afdrukken
Het tabblad Afdrukken genereert een A4-pdf:
- Kaarten: 10 per pagina (95 x 55 mm), met snijlijnen.
- Etiketten: 21 per vel (63,5 x 38,1 mm, gangbare vellen van 3 x 7).
- Flyers: 4 per pagina in A6-formaat, met snijlijnen.
Kies de codes (ongebruikte codes die nooit zijn afgedrukt, alle ongebruikte codes of alle codes), het aantal (maximaal 2.000 per bestand) en het aantal codes dat aan het begin moet worden overgeslagen. Stel de kop, de voorwaarden (variabelen {valid_until}, {shop_name}, {customer}), de accentkleur, de QR-code, de winkelnaam en, bij persoonlijke codes, de naam van de klant in. Een voorbeeld van een kaart wordt live bijgewerkt. De optie “Deze codes als afgedrukt markeren” voorkomt dat dezelfde codes opnieuw worden afgedrukt.


Directe link en QR-code
Elke code heeft een adres in de vorm https://uw-winkel.nl/module/dfbulkcoupons/apply?code=CODE. Dit opent de winkel en past de code toe in de winkelwagen, met een bevestigingsbericht in de taal van de bezoeker (thema’s Classic en Hummingbird). Als de winkelwagen leeg is, wordt de code 30 dagen bewaard en toegepast zodra er een product wordt toegevoegd. Als de winkelwagen nog niet aan de voorwaarden voldoet, wordt de reden getoond en wordt de code automatisch toegepast zodra dat wel het geval is. Bij een persoonlijke code wordt de bezoeker gevraagd in te loggen, waarna de code wordt toegepast. Deze link zit achter de afgedrukte QR-codes, op de knop in de e-mails, in de codelijst en in de CSV-export.

CSV-exports
De bestanden zijn in UTF-8 met puntkomma als scheidingsteken en direct leesbaar in Excel.
- Codes (alle, ongebruikte of gebruikte): code, status, gebruik, resterend gebruik, geldigheidsdata, e-mailadres, voornaam en achternaam van de klant, laatste gebruik, laatste bestelling, verzenddatum, afdrukdatum, directe link.
- Gebruik per bestelling: datum, ID, referentie en status van de bestelling, bestelling gevalideerd of niet, code, klant, korting en totaal excl. en incl. btw, valuta.
Prestaties per kanaal en een code zoeken
Zodra er meerdere kanalen worden gebruikt, toont het dashboard een tabel per kanaal: reeksen, codes, gebruikte codes, percentage, bestellingen, omzet excl. btw en korting excl. btw, gesorteerd op omzet. Het blok Code zoeken vindt de reeks, de eigenaar, de einddatum en de status van een code die een klant aan u doorgeeft.
Verwijderen
Het verwijderen van de module verwijdert de tabellen van de module (reeksen, verzend- en afdrukgeschiedenis). Reeds gegenereerde codes blijven actieve winkelwagenregels in Catalogus > Kortingen.
Probleemoplossing
- Het genereren stopt: open de reeks opnieuw of klik op Hervatten. Als de database het invoegen weigert, verschijnt er een duidelijke melding; er blijft geen onvolledige code achter.
- “Dit formaat is te makkelijk te raden”: voeg willekeurige tekens toe of schakel over naar het volledige alfabet.
- Mislukte e-mails: controleer Geavanceerde instellingen > E-mail met een test-e-mail en start daarna opnieuw de verzending van de niet-verzonden codes.
- De QR-code verlaagt het winkelwagenbedrag niet: het getoonde bericht geeft aan welke voorwaarde ontbreekt. Bij een persoonlijke code moet de klant inloggen op zijn account.
- “Er zijn te veel codes geprobeerd”: de beveiliging van de directe link wordt na 15 minuten vanzelf opgeheven.