Wijn en gedistilleerd in PrestaShop: documentatie DataFirefly Wine & Spirits

Installatie

Installeer de module via Modules > Modulebeheer > Een module uploaden met het ZIP-bestand. De module maakt zijn tabellen aan, registreert zijn hooks en voegt het menu Catalogus > Wijnen & gedistilleerd toe.

Bij de installatie maakt hij ook acht standaard kenmerken aan: Oogstjaar, Druivenras, Herkomstbenaming, Alcoholpercentage, Kleur, Regio, Land van herkomst en Keurmerk. Frankrijk wordt vooraf ingesteld (leeftijd 18 jaar, leeftijdsvakje bij het afrekenen, verplichte Franse gezondheidswaarschuwing), net als de Franse accijnstarieven 2026.

Om bij te werken vanaf een eerdere versie installeert u gewoon het nieuwe ZIP-bestand: de updatescripts voegen ontbrekende kolommen, tabellen en kenmerken toe zonder uw gegevens aan te raken.

Dashboard

Eerste tabblad van het menu. Het toont het aantal beheerde producten, de verkochte stuks, de zuivere alcohol en de accijnzen van de lopende maand, een checklist van de configuratie, de volledigheid van de gegevens (alcoholpercentage, kleur, oogstjaar, druivenrassen, herkomstbenaming) en de laatste 30 aan te vullen producten met een link naar hun pagina. Kleur, oogstjaar en druivenrassen worden alleen voor wijnen gecontroleerd.

Instellingen

Berekeningsmodus van de accijnzen

• Inbegrepen in de prijs (standaard): uw prijzen bevatten de accijnzen al. Het bedrag wordt getoond op de productpagina („Waarvan accijnzen”) en in de winkelwagen, en daarna vastgelegd in het register.
• Toegevoegd bij het afrekenen: aan de winkelwagen wordt een regel „Accijnzen” toegevoegd met de accijnzen van het leverland. Die regel wordt gedragen door een technisch product dat verborgen is in de catalogus en wordt aangemaakt bij het activeren van deze modus. Verwijder dit product niet.
• Uitgeschakeld: er wordt geen bedrag berekend, het register legt alleen volumes en zuivere alcohol vast.

Belastingregel van de accijnsregel: in de EU maken accijnzen deel uit van de btw-grondslag. Kies uw standaardtarief.

Weergave

Elk onderdeel wordt apart ingeschakeld: wijnoverzicht op de productpagina, accijnsbedrag op de productpagina, wettelijke vermelding op de productpagina, vermelding en totaal accijnzen in de winkelwagen, vermelding in de footer, accijnzen en vermelding op pdf-facturen, tabblad Proefnotitie, badges in productlijsten.

Leeftijdscontrole-popup

• Controle: knoppen Ja / Nee, of geboortedatum met berekening van de leeftijd.
• Onthouden gedurende: aantal dagen waarin de bezoeker niet opnieuw wordt gevraagd. 0 vraagt het bij elke browsersessie opnieuw.
• Uitgangs-URL: pagina die wordt geopend als de bezoeker nee antwoordt of te jong is.
• Kleur van de knoppen, titel en tekst per taal. In de tekst wordt {age} vervangen door de wettelijke leeftijd van het land van de bezoeker.

De popup wordt niet getoond aan zoekmachinerobots, op CMS-pagina’s en aan ingelogde klanten van wie de geboortedatum de leeftijd aantoont. De inhoud van de pagina blijft in de HTML.

Gemengde doos

Stel het vereiste aantal flessen in (standaard 6), de korting in procent en de geschikte producten: alle alcoholische producten die de module beheert, of alleen de producten die in hun tabblad zijn aangevinkt. Zodra de winkelwagen het vereiste aantal bereikt, krijgt elke geschikte fles de korting. Een product waarvan de eigen doskorting al geldt, houdt zijn korting.

Landen zonder eigen regel

Waarden voor de landen die u niet hebt ingesteld: levering van alcohol toegestaan of niet, leeftijdsvakje bij het afrekenen, wettelijke leeftijd.

Standaardwaarden producten

Volume (75 cl) en doosgrootte (6) die voor een nieuw product worden voorgesteld.

Filterbare kenmerken

De tabel toont de status van de acht kenmerken. Ontbrekende kenmerken opnieuw aanmaken maakt een verwijderd kenmerk opnieuw aan. Om klanten erop te laten filteren, voegt u ze toe aan uw filtersjabloon in ps_facetedsearch (knop Gelaagde navigatie openen).

Een product invullen

Open de productpagina, tabblad Modules, blok Wine & Spirits. Vink Dit product is een alcoholische drank aan. Het blok wordt met een eigen knop opgeslagen, los van het productformulier.

Wijn- en gedistilleerdgegevens

• Categorie: fiscale categorie voor de accijns (stille wijn, mousserende wijn, versterkte wijn, ander tussenproduct, gedistilleerd, bier, cider).
• Oogstjaar of vakje Zonder oogstjaar.
• Alcoholpercentage in % vol en volume per stuk in cl.
• Druivenrassen gescheiden door komma’s: elk wordt een filterwaarde. Herkomstbenaming met suggesties uit bestaande waarden om dubbele waarden te vermijden.

Profiel en proeven

Kleur, regio, land van herkomst, serveertemperatuur (min. en max.), bewaarpotentieel, keurmerken (biologisch, biodynamisch, natuurwijn, veganistisch, HVE), onderscheidingen en scores (één per regel). Proefnotities en spijscombinaties worden per taal ingevuld via de taaltabbladen.

Verkoop per doos

• Alleen per stuk: standaardgedrag.
• Per stuk of per doos: de productpagina biedt de keuze tussen fles en doos, met de prijs van de doos en de besparing.
• Alleen per doos: de minimale hoeveelheid wordt de doosgrootte en hoeveelheden in de winkelwagen worden naar boven afgerond op een volle doos (naar beneden als de voorraad ontbreekt).

De korting per doos, in % of als bedrag per doos, wordt aangemaakt als standaard staffelkorting vanaf één volle doos. Het vakje Geschikt voor de gemengde doos verschijnt wanneer de gemengde doos is ingeschakeld.

Volume per combinatie

Voor een product met combinaties (halve fles, fles, magnum) vult u het volume van elke combinatie in. Leeg gebruikt de combinatie het volume van het product. Accijnzen, de zuivere alcohol in het register en de proefnotitie volgen de combinatie.

Landen en wettelijke vermeldingen

Het tabblad toont de actieve landen, met een zoekveld. Per land kunt u via Bewerken instellen:

• Alcohol mag naar dit land geleverd worden: niet aangevinkt wordt een klant met alcohol in de winkelwagen bij de leverstap tegengehouden met een melding, en op de productpagina verschijnt een waarschuwing.
• Vakje wettelijke leeftijd bij het afrekenen en wettelijke leeftijd: het vakje „Ik bevestig dat ik minstens N jaar oud ben” wordt toegevoegd aan de voorwaarden die bij de betaalstap moeten worden geaccepteerd.
• Wettelijke vermelding per taal. Een lege taal valt terug op de standaardtaal van de winkel.

Het leverland wordt gelezen uit het leveradres van de winkelwagen, anders uit het eerste adres van de ingelogde klant, daarna uit het land van de bezoeker en daarna uit het standaardland van de winkel.

Accijnstarieven

Een tarief wordt bepaald door land, categorie, bereik van het alcoholpercentage (grenzen inbegrepen, 0 als maximum voor geen limiet), berekeningsgrondslag en bedrag in de standaardvaluta, exclusief btw. Meerdere tarieven kunnen voor hetzelfde product gelden en worden opgeteld.

• per hectoliter product: wijnen, mousserende wijnen, tussenproducten, ciders.
• per hectoliter zuivere alcohol: gedistilleerd. Voorbeeld: 70 cl met 40% = 0,0028 hl zuivere alcohol.
• per hectoliter en per graad: bieren.
• per liter product en per verkocht stuk voor andere gevallen.

Meegeleverde Franse tarieven 2026: stille wijnen € 4,19/hl, mousserend € 10,38/hl, ciders € 1,46/hl, VDN en VDL € 52,39/hl, andere tussenproducten € 209,53/hl plus € 52,39/hl bijdrage boven 18% vol, gedistilleerd € 1.932,42/hl zuivere alcohol plus € 620,47 sociale bijdrage boven 18% vol, bieren € 4,12/hl/graad tot 2,8% vol, daarboven € 8,24. Een fles van 70 cl met 40% draagt dus € 7,15.

Accijnsregister

Elke gevalideerde bestelling legt per alcoholisch product het leverland, de categorie, de combinatie, de stuks, het volume, het alcoholpercentage, de zuivere alcohol en het accijnsbedrag tegen het tarief van de dag vast. Het tabblad Register filtert op periode, land en gevalideerde bestellingen, met twee CSV-exports: de samenvatting per land en categorie, en de orderregels. Elke bestelpagina toont ook een paneel Accijnzen.

CSV-import en -export

Alcoholische producten exporteren of Volledige catalogus exporteren maakt een bestand in het importformaat. Vul het aan in een spreadsheet en importeer het opnieuw.

• Scheidingsteken ; of , wordt automatisch herkend. Product gevonden via id_product, anders via reference.
• Een ontbrekende kolom of lege cel behoudt de huidige waarde. - wist oogstjaar, druivenrassen, herkomstbenaming en tekstvelden.
• vintage: jaar of NV. product_type: still_wine, sparkling_wine, vdn_vdl, intermediate, spirits, beer, cider. sale_mode: unit, both, case_only. color: red, white, rose, orange, amber, clear. labels: organic, biodynamic, natural, vegan, hve, gescheiden door komma’s. origin_country: ISO-code (NL, FR…). awards: één onderscheiding per waarde, gescheiden door |.
• Kolommen per taal: tasting_notes_nl, food_pairing_nl, tasting_notes_en…

Laat Alleen simulatie aangevinkt voor een eerste doorloop: het rapport toont de gelezen regels, de producten die bijgewerkt zouden worden en de fouten met hun regelnummer, zonder iets op te slaan.

Wat de klant ziet

• Productpagina: wijnoverzicht, keuze fles of doos, aanbod gemengde doos, accijnsbedrag, wettelijke leeftijd en vermelding, waarschuwing als het leverland geblokkeerd is.
• Tabblad Proefnotitie: kenmerkkaarten, keurmerken, proefnotities, spijscombinaties en onderscheidingen.
• Productlijsten: badges voor kleur, oogstjaar, keurmerken, onderscheidingen en gemengde doos.
• Winkelwagen: „2 x doos van 6” onder de regels, voortgang van de gemengde doos, totaal accijnzen en wettelijke vermelding.
• Afrekenen: leeftijdsvakje, accijnsregel in de modus toegevoegd.
• Pdf-factuur: accijnsbedrag, zuivere alcohol en wettelijke vermelding.

Probleemoplossing

De filters verschijnen niet

Voeg de kenmerken toe aan het filtersjabloon van ps_facetedsearch en koppel het sjabloon aan de betreffende categorieën. Waarden verschijnen pas zodra minstens één product met zijn gegevens is opgeslagen.

Het tabblad Proefnotitie of de badges worden niet getoond

Controleer de weergaveopties en of het product als alcoholische drank is aangevinkt. De badges gebruiken de hook displayProductListReviews en het tabblad displayProductExtraContent: een thema dat ze niet aanroept, toont ze niet.

De accijnsregel verschijnt niet in de winkelwagen

Controleer de modus Toegevoegd bij het afrekenen, of het leverland tarieven heeft voor de productcategorie en of het technische product van de accijnsregel bestaat (zijn ID staat in de instellingen).

De leeftijdspopup verschijnt op elke pagina opnieuw

De browser blokkeert de cookie dfws_age_ok. Controleer of een cookiebeheerder hem niet verwijdert: het is een functionele cookie.

Compatibiliteit

• PrestaShop 8.0 tot 9.x, hetzelfde ZIP-bestand dekt beide versies.
• Filters via standaard kenmerken, compatibel met ps_facetedsearch.
• Architectuur ModuleAdminController, zonder Composer-afhankelijkheid, PHP 7.2 of hoger.
• Interface in het Frans, Engels, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.