Acquisto di Gruppo e Prezzo Scalare Collettivo — Guida completa

Presentazione e prerequisiti

Acquisto di Gruppo introduce un prezzo scalare collettivo: più acquirenti ha un prodotto, più scende il prezzo unitario per tutti. Definite degli scaglioni (una soglia di acquirenti sblocca un prezzo) e il modulo applica automaticamente il prezzo dello scaglione raggiunto tramite i prezzi specifici nativi di PrestaShop. La tariffa corrente appare quindi ovunque senza alcuna modifica del tema: scheda prodotto, listini, carrello ed e-mail.

• Compatibile con PrestaShop 8.0 a 9.x, tema Classic e temi derivati.
• PHP 7.4 a 8.3.
• Multinegozio e multilingua (FR/EN/ES/DE/IT).
• Nessuna attività CRON richiesta: il ricalcolo è guidato dagli eventi d’ordine.
• Architettura conforme a PrestaShop (ModuleAdminController, ObjectModel), senza dipendenza da Composer.

Installazione

Installate il modulo come qualsiasi modulo PrestaShop:

1. Scaricate l’archivio dfgroupbuy-1.0.2.zip dal vostro account cliente.
2. Nel back-office, andate in Moduli > Gestore dei moduli.
3. Cliccate su Carica un modulo e trascinate l’archivio.
4. Una volta installato, cliccate su Configura.

All’installazione, il modulo crea le sue tabelle (campagne, scaglioni, partecipanti), registra i suoi hook e aggiunge la scheda Acquisto di Gruppo sotto Catalogo. Potete creare subito la vostra prima campagna.

Impostazioni generali del modulo

La pagina di configurazione raccoglie le impostazioni globali, comuni a tutte le campagne:

• Colore principale e colore d’accento: applicati al widget della scheda prodotto (barra di avanzamento, badge, prezzo corrente).
• Inviare un’e-mail al rimborso retroattivo: avvisa l’acquirente quando gli viene assegnato un buono.
• Periodo di validità dei buoni: numero di giorni di validità dei buoni retroattivi (30 per impostazione predefinita).
• Intervallo di aggiornamento: frequenza di aggiornamento in diretta del widget, in secondi (30 per impostazione predefinita).

Creare una campagna di acquisto di gruppo

Dalla scheda Catalogo > Acquisto di Gruppo, cliccate su Aggiungi una campagna. Una campagna associa un prodotto a una griglia di scaglioni, su una finestra di date.

• Riferimento: identificatore interno della campagna (testo libero).
• Prodotto: cercate e selezionate il prodotto interessato. Potete puntare a una combinazione specifica o lasciare “tutte le combinazioni”.
• Nome e descrizione: testi traducibili, mostrati nel widget.
• Modalità di conteggio: vedi la sezione dedicata più sotto.
• Solo ordini validi: conta solo gli ordini confermati (consigliato).
• Prezzo di riferimento: il prezzo iniziale (barrato) prima di ogni scaglione.
• Data di inizio / fine: la finestra di attività della campagna.
• Rimborso retroattivo: vedi la sezione dedicata.
• Attiva: attiva o sospende la campagna.

Definire gli scaglioni

Ogni scaglione associa una soglia (numero di acquirenti, unità o clienti secondo la modalità) a un prezzo unitario IVA esclusa. Aggiungete tutti gli scaglioni necessari, per esempio:

10 acquirenti  → 18,00 € IVA esclusa
50 acquirenti  → 15,00 € IVA esclusa
100 acquirenti → 12,00 € IVA esclusa

A ogni salvataggio, il modulo ricalcola lo scaglione corrente e aggiorna il prezzo specifico. I prezzi devono essere decrescenti man mano che la soglia aumenta.

Le modalità di conteggio

La modalità di conteggio determina cosa fa avanzare il contatore collettivo:

• Ordini: numero di ordini distinti che contengono il prodotto.
• Unità vendute: quantità totale di unità del prodotto vendute.
• Clienti distinti: numero di clienti diversi che hanno acquistato il prodotto.

L’opzione Solo ordini validi limita il conteggio agli ordini considerati validi da PrestaShop (pagamento accettato, ecc.), il che evita di contare ordini annullati o in sospeso.

Il prezzo collettivo in tempo reale

Non appena un ordine viene convalidato o cambia stato, il modulo riconta la campagna, determina lo scaglione raggiunto e aggiorna il prezzo specifico applicato a tutti gli acquirenti. Il nuovo prezzo appare immediatamente ovunque, senza intervento. Nessun CRON è necessario: tutto è guidato dagli eventi d’ordine.

Prezzo per scaglione di quantità (acquisto all’ingrosso)

In modalità Unità vendute, un cliente che ordina una grande quantità in una volta supera da solo uno scaglione: ottiene allora subito il prezzo di quello scaglione sul proprio ordine, senza attendere che il collettivo lo raggiunga. Per esempio, con uno scaglione a 10 unità, un cliente che mette 10 esemplari nel carrello paga subito il prezzo dello scaglione 10.

Questa logica resta “miglior prezzo per tutti”: se il prezzo collettivo corrente è già più basso del prezzo dello scaglione di quantità, si applica il prezzo collettivo. Tutto passa per i prezzi specifici nativi (per scaglioni di quantità), quindi la tariffa corretta appare già dal carrello.

Rimborso retroattivo

Quando l’opzione è attivata, si applica il principio “tutti al miglior prezzo”: non appena si sblocca uno scaglione inferiore, gli acquirenti precedenti ricevono automaticamente un buono sconto pari alla differenza tra il prezzo che hanno pagato e il nuovo prezzo, moltiplicata per la quantità acquistata. Un’e-mail di notifica viene inviata se l’opzione di invio è attiva.

• Il buono è un codice sconto (CartRule) nominativo, valido per il numero di giorni configurato.
• Solo gli acquirenti che hanno pagato più del nuovo prezzo ricevono un buono.
• Il prezzo effettivo di ogni partecipante viene aggiornato per evitare qualsiasi doppio rimborso nelle riduzioni successive.

Il widget sulla scheda prodotto

Sulla scheda prodotto, il modulo mostra un widget che mette in scena la dinamica collettiva:

• Un badge e il prezzo di riferimento barrato accanto al prezzo corrente.
• Il contatore collettivo e una barra di avanzamento verso il prossimo scaglione.
• La scala completa degli scaglioni, con lo scaglione corrente in evidenza.
• Un conto alla rovescia fino alla fine della campagna.
• Una nota sul rimborso retroattivo quando l’opzione è attiva.

Tutto si aggiorna in diretta tramite AJAX, all’intervallo definito nelle impostazioni, senza ricaricare la pagina.

FAQ e risoluzione dei problemi

Il widget non appare sul prodotto

Verificate che una campagna attiva punti a questo prodotto, che la data odierna sia compresa tra la data di inizio e quella di fine, e che la campagna appartenga al negozio corrente. Se puntate a una combinazione specifica, il widget appare solo per quella combinazione.

Il prezzo non scende anche se la soglia è raggiunta

Il ricalcolo è attivato dalla convalida degli ordini e dai cambi di stato. Se contate solo gli ordini validi, assicuratevi che gli ordini interessati siano in uno stato valido. Una semplice modifica e salvataggio della campagna forza anch’essa un ricalcolo.

Un acquirente all’ingrosso non ottiene il prezzo della sua quantità

Il prezzo per scaglione di quantità funziona solo in modalità Unità vendute, e per soglie maggiori o uguali a 2. In modalità Ordini o Clienti, la quantità di un ordine non supera uno scaglione da sola.

Funziona con le combinazioni?

Sì. Una campagna può puntare a una combinazione specifica o a tutte le combinazioni di un prodotto. Una campagna che punta a una combinazione specifica prevale su una di “tutte le combinazioni”.

Cosa succede alla disinstallazione?

La disinstallazione rimuove i prezzi specifici creati dal modulo, elimina i suoi hook e la sua scheda, e pulisce le sue tabelle. I buoni sconto già emessi restano validi sul lato clienti.