Eenheidsprijs en verkoop per gewicht: documentatie DataFirefly Unit Price

Installatie

Installeer de module via Modules > Modulebeheer > Een module uploaden met het ZIP-bestand, of plaats de map dfunitprice in de map /modules/ van de winkel en klik op Installeren.

Bij de installatie maakt de module drie tabellen aan (inhouden, verkoopmodi, wegingen van bestellingen) en registreert ze haar hooks. Ze voegt geen menu-item toe: alles stelt u in op de configuratiepagina van de module, het tabblad Modules van de productpagina en de bestelpagina.

Module-instellingen

De configuratiepagina bevat van boven naar beneden de bulkeditor, de instellingen, de lijst met te wegen stukken, de hulpmiddelen en het nalevingsrapport.

Eenheidsprijs voor gewichten en volumes

Kies de standaardweergave: per 1 kg of per 100 g, per 1 liter of per 100 ml. Lengtes worden altijd per meter weergegeven, oppervlaktes per m², bulkvolumes per m³. Elk product kan deze keuze overschrijven.

Landen die 1 kg en 1 liter verplichten

ISO-codes gescheiden door komma’s, standaard DE. Voor bezoekers uit deze landen wordt de eenheidsprijs altijd per 1 kg, 1 l, 1 m, 1 m² of 1 m³ getoond, zoals de Duitse PAngV vereist, ook als u elders 100 g koos.

Weergave en posities

• Tonen op de productpagina en Positie op de productpagina: de eenheidsprijs loopt via de standaard hook displayProductPriceBlock. De positie after_price (onder de prijs) past bij Classic en afgeleide thema’s. Wijzig ze alleen als uw thema die positie niet aanroept.
• Tonen in productlijsten en Positie in productlijsten: categorieën, zoeken, merken, carrousels. Standaard positie unit_price.
• Tonen in de winkelwagen: onder de prijs van elke regel.
• Opmaak: „€ 12,90 / kg” of tussen haakjes.
• Tekst voor de eenheidsprijs: optioneel en vertaalbaar, bijvoorbeeld „Prijs per kilo”.

Verbergen als gelijk aan de verkoopprijs

Een pak van 1 kg verkocht per kilo herhaalt hetzelfde bedrag. Sommige landen staan toe het dan niet te tonen: controleer de regel in uw land voordat u de optie inschakelt.

Standaard eenheidsprijs van het thema verbergen

Voorkomt een dubbele weergave op de productpagina als het thema ook het standaardveld toont.

Schrijven naar de standaardvelden van PrestaShop

De module werkt de standaard eenheidsprijs, het eenheidslabel (bijvoorbeeld „/ kg”) en de impact per combinatie bij. Feedmodules voor Google Shopping of marketplaces die deze velden uitlezen, krijgen zo de juiste waarde.

Minimale terugbetaling voor stukken op werkelijk gewicht

Onder dit verschil incl. btw op een bestelling wordt geen creditnota aangemaakt. Laat 0 staan om elk verschil terug te betalen.

Categorieën waar de eenheidsprijs verplicht is

Alleen gebruikt door het nalevingsrapport, dat actieve producten van deze categorieën zonder inhoud toont.

De inhoud van een product invullen

Open de productpagina, tabblad Modules, blok Eenheidsprijs en verkoopmodus. Het blok slaat op met een eigen knop Eenheidsprijs opslaan, los van het productformulier.

• Netto-inhoud en Eenheid: 750 g, 1,5 l, 2,5 m, 12 m² of één stuk. Laat leeg om geen eenheidsprijs te tonen.
• Eenheidsprijs uitgedrukt per: voor gewichten en volumes vervangt dit de module-instelling voor dit product.

Onder de velden toont een groene regel tijdens het typen de eenheidsprijs met de huidige prijs. Na het opslaan herhaalt een voorbeeld de prijs incl. btw zonder korting, de inhoud en de berekende eenheidsprijs.

Combinaties

Vul alleen combinaties in waarvan de inhoud afwijkt van het product, bijvoorbeeld 250 g, 500 g en 1 kg. Een combinatie zonder waarde neemt die van het product over. De eenheid „Zelfde als product” neemt de producteenheid over. Combinaties die na het openen van de pagina zijn aangemaakt, verschijnen na herladen.

De berekening

De eenheidsprijs is de prijs die de klant ziet, gedeeld door de inhoud en omgerekend naar de gekozen referentie. Ze volgt de weergave incl. of excl. btw van de klantgroep, specifieke prijzen en kortingen. In de winkelwagen gebruikt ze de prijs van de regel.

Verkoop per gewicht dat de klant kiest

Kies de modus Klant kiest de hoeveelheid. De inhoud wordt de grootte van één stap en de productprijs wordt de prijs van één stap. Voorbeeld: stap van 100 g voor € 2,50, een klant die 700 g kiest, legt 7 stappen in de winkelwagen voor € 17,50.

• Minimum en Maximum in de basiseenheid (g, ml, cm, m², m³): elke waarde moet een veelvoud van de stap zijn. Het maximum is optioneel.
• Vaste hoeveelheden: waarden gescheiden door puntkomma’s, bijvoorbeeld 250; 500; 1000, elk een veelvoud van de stap en tussen minimum en maximum.
• Vrije hoeveelheid toestaan: toont de +/- keuze met directe invoer. Zonder vaste hoeveelheden is vrije invoer altijd zichtbaar.

Op de productpagina vervangt deze keuze het aantalveld van het thema, met de grenzen en het totaal direct zichtbaar. De keuze werkt ook in de snelle weergave van productlijsten en behoudt het gekozen gewicht als de klant van combinatie wisselt.

Wat de module voor u regelt

• De standaard minimumhoeveelheid van het product en zijn combinaties wordt in aantal stappen gesynchroniseerd.
• Het maximum wordt op de server afgedwongen: een hogere hoeveelheid in de winkelwagen wordt teruggebracht tot het maximum.
• De bestelregel wordt „Koffie (700 g)” in de back-office, op de factuur en in de bevestigingsmail.

Stuk op werkelijk gewicht

Kies de modus Stuk op werkelijk gewicht voor producten waarvan het exacte gewicht pas bij het klaarmaken bekend is: vlees, kaas aan het stuk, vis.

• Gemiddeld gewicht van een stuk: dit is de inhoud, bijvoorbeeld 1,2 kg. De productprijs is de prijs van een stuk van dat gewicht.
• Lichtste stuk en Zwaarste stuk: optioneel, aan de klant getoond als bereik. Het bereik moet het gemiddelde gewicht bevatten.

Op de productpagina legt een blok „Verkocht op werkelijk gewicht” de regel uit: een lichter stuk krijgt het verschil terug, een zwaarder stuk kost niets extra. De bestelregel wordt „Ribstuk (ongeveer 1,2 kg)” of „(2 × ongeveer 1,2 kg)”.

Een bestelling wegen

Op de bestelpagina toont het paneel Werkelijke gewichten elke betrokken regel met het geschatte gewicht en het betaalde bedrag.

1. Vul het totale werkelijke gewicht van elke regel in, alle stukken samen, in kg (in l voor een volume, in m voor een lengte).
2. De terugbetaling per regel en het totaal worden berekend tijdens het typen. Een gewicht dat meer dan 50 % van de schatting afwijkt, geeft een waarschuwing, vaak een eenheidsfout (1200 in plaats van 1,2).
3. Kies of de klant een e-mail en een waardebon krijgt, klik op Gewichten bevestigen en bevestig.

De terugbetaling van een lichtere regel is naar verhouding: betaald bedrag × (1 − werkelijk gewicht / geschat gewicht). Een zwaardere regel geeft geen terugbetaling en wordt nooit extra aangerekend.

Wat wordt aangemaakt

• Een PrestaShop-creditnota voor het totale verschil, zichtbaar in de documenten van de bestelling. De PDF toont de regels en een tabel „Verrekening op werkelijk gewicht”.
• Een waardebon van hetzelfde bedrag als het vakje is aangevinkt, alleen voor deze klant en een jaar geldig.
• Een e-mail aan de klant in zijn taal met de geschatte gewichten, de werkelijke gewichten en het terugbetaalde bedrag.

De factuur van de bestelling vermeldt de verkoop op geschat gewicht en de verrekening met creditnota. De klant ziet de werkelijke gewichten ook in de bestelgegevens van zijn account.

Te wegen bestellingen

De configuratiepagina toont de bestellingen met nog te wegen stukken, oudste eerst, met een directe link naar elke bestelling. Geannuleerde, mislukte of terugbetaalde bestellingen staan er niet bij.

Bulkeditor

Bovenaan de configuratiepagina toont de bulkeditor uw producten per 50, te filteren op categorie, op naam, referentie of ID, en standaard beperkt tot producten zonder inhoud.

• Inhouden in de naam of referentie worden herkend en vooraf ingevuld, met de vermelding „Gedetecteerd”. Verpakkingen worden vermenigvuldigd („6 x 33 cl” geeft 198 cl), afmetingen zoals „40×60 cm” worden genegeerd.
• Een waarde wijzigen vinkt de regel aan. De eenheidsprijs wordt direct berekend.
• Gedetecteerde inhouden selecteren vinkt in één keer alle vooraf ingevulde regels van de pagina aan.
• Ook combinaties vullen waarvan de naam een inhoud bevat: een combinatie „Gewicht – 500 g” krijgt 500 g, zonder een al ingevulde waarde te overschrijven.

De inhoud van een aangevinkte regel leegmaken verwijdert de inhoud van het product. Producten in verkoop per gewicht of op werkelijk gewicht zijn alleen-lezen in de tabel: bewerk ze via hun productpagina.

CSV-import en -export

Het blok CSV exporteren maakt één regel per product en per combinatie, voor de hele catalogus of één categorie. Kolommen: id_product, id_product_attribute, reference, name, net_quantity, unit, reference_unit.

De import accepteert het scheidingsteken ; of ,. De kolommen net_quantity en unit zijn verplicht, samen met id_product of reference (referentie van het product of de combinatie). Eenheden: g, kg, ml, cl, l, mm, cm, m, m2, m3, unit. reference_unit accepteert 1kg, 100g, 1l of 100ml. Een lege net_quantity verwijdert de regel. Fouten worden met hun regelnummer getoond en blokkeren de andere regels niet.

Hulpmiddelen en nalevingsrapport

Nu opnieuw synchroniseren berekent de standaardvelden en minimumhoeveelheden van alle ingestelde producten opnieuw. Gebruik het na een bulkimport van prijzen, of als medewerkers zonder toegang tot de module producten bewerken: PrestaShop voert de hooks van een module niet uit voor een profiel dat haar niet mag zien.

Het nalevingsrapport toont het aantal ingestelde producten en tot 300 actieve producten zonder inhoud in de verplichte categorieën, met een link naar hun productpagina.

Probleemoplossing

De eenheidsprijs verschijnt niet op de productpagina

Controleer of het product een inhoud heeft en of de weergave op de productpagina is ingeschakeld. Roept het thema de positie after_price niet aan, kies dan price of weight in de instellingen.

De eenheidsprijs verschijnt twee keer

Schakel Standaard eenheidsprijs van het thema verbergen in. Blijft de dubbele weergave, dan gebruikt uw thema een andere CSS-klasse voor dat blok: neem contact op met de naam van het thema.

Het aantalveld blijft zichtbaar bij een product per gewicht

Het thema gebruikt niet-standaard opmaak voor de hoeveelheid. Het gekozen gewicht wordt op de server toch gerespecteerd (minimum en maximum). Neem contact op met de naam van het thema voor een aanpassing.

De standaardprijs is niet bijgewerkt na een prijsimport

Klik op Nu opnieuw synchroniseren.

Compatibiliteit

• PrestaShop 8.0 tot 9.x, dezelfde ZIP dekt beide versies.
• Weergave via de standaard hook displayProductPriceBlock, getest met het Classic-thema.
• Architectuur ModuleAdminController, zonder Composer-afhankelijkheid, PHP 7.2 en hoger.
• Interface en e-mails in het Nederlands, Frans, Engels, Spaans, Duits, Italiaans, Pools en Portugees.