Quantità minima e vendita a multipli: documentazione DataFirefly Minimums

Installazione

Installa il modulo da Moduli > Gestione moduli > Carica un modulo con il file ZIP, oppure copia la cartella dfminimums nella directory /modules/ del negozio e clicca su Installa.

All’installazione, il modulo crea due tabelle (regole di quantità e minimi d’ordine), registra i suoi hook e aggiunge due schede nel menu Catalogo: Minimi e multipli e Ordine minimo.

Impostazioni del modulo

La pagina di configurazione del modulo riunisce sei impostazioni.

Attiva le regole d’acquisto

Interruttore generale. Se disattivato, nessuna regola viene mostrata o applicata nel negozio. Le regole restano salvate.

Regola le quantità automaticamente

Quando un cliente aggiunge al carrello una quantità che non rispetta una regola, il modulo la sostituisce con la quantità consentita più vicina: per eccesso in aggiunta, per difetto in rimozione. Aggiungere 7 pezzi di un prodotto venduto a 6 dà 12, passare da 12 a 11 dà 6. Le righe personalizzate non vengono mai modificate. Se disattivato, la quantità resta invariata e il carrello è bloccato finché il cliente non la corregge.

Mostra le condizioni nella scheda prodotto

Mostra un riquadro sotto il pulsante di aggiunta al carrello con minimo, multiplo e massimo validi per il cliente connesso. Il riquadro compare anche nell’anteprima rapida.

Mostra un badge negli elenchi prodotti

Aggiunge un badge breve sotto il prezzo delle miniature prodotto, per esempio «Venduto a 6» o «Min. 12».

Mostra le condizioni sotto ogni riga del carrello

Ricorda la condizione di ogni riga e mostra l’errore in rosso quando la quantità non è consentita.

Cliente in più gruppi

Stabilisce quale minimo d’ordine vale quando un cliente appartiene a più gruppi che hanno ciascuno un minimo: quello del suo gruppo predefinito, il più alto o il più basso.

Creare una regola di quantità

Apri Catalogo > Minimi e multipli e clicca su Aggiungi una regola.

Si applica a

• Un prodotto: cerca il prodotto per nome, riferimento, EAN o ID, poi scegli eventualmente una combinazione. Una regola su una combinazione ha la precedenza su una regola sull’intero prodotto.
• Una categoria: scegli la categoria e indica se includere le sottocategorie. Sono inclusi tutti i prodotti associati alla categoria, qualunque sia la loro categoria predefinita.
• Tutti i prodotti: la regola riguarda l’intero catalogo.

Gruppo clienti

Lascia «Tutti i gruppi clienti» o scegli un gruppo. Una regola di gruppo vale per ogni cliente che appartiene a quel gruppo, anche se non è il suo gruppo predefinito.

Minimo, multiplo e massimo

• Quantità minima: 0 o 1 significa nessun minimo. Se è impostato un multiplo e il minimo non lo è, viene arrotondato al multiplo superiore: minimo 10 a 6 dà 12.
• Venduto in multipli di: 1 lascia la quantità libera, 6 accetta solo 6, 12, 18 e così via.
• Quantità massima: 0 significa nessun massimo. Il massimo deve essere un multiplo del multiplo scelto e maggiore o uguale al minimo.

Una regola deve impostare almeno un minimo maggiore di 1, un multiplo maggiore di 1 o un massimo.

Quale regola si applica

Per ogni prodotto del carrello si applica una sola regola «per prodotto». Il modulo la sceglie in questo ordine:

1. la priorità più alta;
2. a parità di priorità, la regola più specifica: combinazione, poi prodotto, poi categoria (la più profonda per prima), poi tutti i prodotti;
3. a parità di specificità, una regola per gruppo clienti prima di una regola per tutti i gruppi.

Esempio: una regola «Vini, venduto a 6» per tutti i clienti e una regola «Vini, venduto a 12» per il gruppo Professionisti. Un professionista ordina a 12, un privato a 6.

Il pannello del modulo nella scheda Moduli della pagina prodotto elenca le regole che riguardano direttamente il prodotto e quelle di categoria o di catalogo che possono applicarsi anche.

Assortimento libero per categoria

In una regola di categoria, il campo Modalità di conteggio offre due valori.

• Ogni prodotto separatamente: la regola vale per ogni prodotto della categoria, come una regola prodotto.
• Tutti i prodotti della categoria insieme (assortimento libero): minimo, multiplo e massimo si applicano alla somma delle quantità di tutti i prodotti della categoria presenti nel carrello.

Esempio: minimo 12 e multiplo 6 in assortimento libero sulla categoria Vini. Il cliente può prendere 4 rossi, 4 bianchi e 4 rosati. Con 13 bottiglie in totale, il carrello è bloccato.

Le regole in assortimento libero si verificano in aggiunta alla regola di ogni prodotto. Un vino venduto a pezzo resta acquistabile a pezzo, purché il totale della categoria rispetti la regola di assortimento libero.

Minimi d’ordine per gruppo

Apri Catalogo > Ordine minimo e clicca su Aggiungi un minimo d’ordine.

• Gruppo clienti: un minimo per gruppo. La voce «Tutti i clienti (predefinito)» vale per i clienti i cui gruppi non hanno un minimo dedicato.
• Importo minimo: espresso nella valuta predefinita del negozio, convertito automaticamente per i carrelli in un’altra valuta. Le spese di spedizione non sono mai incluse.
• Importo IVA inclusa: No confronta l’importo con il totale prodotti IVA esclusa, come d’uso nel B2B.
• Detrai i buoni sconto: Sì usa il totale dopo le regole carrello e i buoni sconto.

Cosa vede il cliente

Quando il carrello non rispetta una regola, il modulo compila la chiave minimalPurchaseRequired del carrello, quella che PrestaShop usa per il proprio importo minimo. Il pulsante di ordine viene disattivato e l’avviso nativo del carrello mostra «Il tuo carrello non soddisfa ancora le condizioni d’acquisto.» seguito dal dettaglio di ogni problema: quantità non consentita con le quantità possibili, totale di una categoria in assortimento libero, importo mancante per raggiungere il minimo d’ordine.

Il controllo viene ripetuto all’apertura della pagina di ordine: un cliente che prova ad accedervi direttamente torna al carrello.

Nel front, i campi quantità seguono la regola. Sul tema Classic, i pulsanti TouchSpin avanzano del multiplo. Su Hummingbird, i pulsanti +/- passano direttamente alla quantità consentita successiva o precedente.

Import ed export CSV

L’import si trova in cima all’elenco delle regole. Il file accetta il separatore ; o , e richiede una riga di intestazione con almeno la colonna scope. Colonne riconosciute:

• name: nome interno, generato se vuoto;
• scope: product, category o all;
• product_id o product_reference;
• combination_reference: riferimento della combinazione;
• category_id e include_subcategories (0 o 1);
• apply_mode: per_product o cumulative (assortimento libero);
• group_id: 0 per tutti i gruppi;
• min_qty, multiple, max_qty, priority, active.

La casella «Elimina prima tutte le regole esistenti di questo negozio» sostituisce l’intero insieme di regole. Le righe in errore sono elencate con il loro numero e non bloccano le altre. Il pulsante Esporta CSV produce lo stesso formato, utile per copiare le regole da un negozio all’altro. Un file di esempio si scarica dal blocco di import.

Buone pratiche

• Parti da una regola ampia (categoria o catalogo) e aggiungi poi le eccezioni per prodotto: la regola più specifica vince senza toccare la priorità.
• Usa la priorità solo quando una regola meno specifica deve vincere, per esempio una regola di categoria che deve imporsi a tutti i suoi prodotti.
• Prova con un account cliente di ogni gruppo interessato: le regole di gruppo non sono visibili a un visitatore non connesso.
• Dopo una modifica, svuota la cache se il negozio usa un modulo di cache a pagina intera.

Risoluzione dei problemi

Il cliente non riesce a scendere sotto una quantità anche se nessuna regola lo impone

Controlla la quantità minima nativa della scheda prodotto (scheda Magazzino o Quantità a seconda della versione) e riportala a 1.

Il carrello è bloccato con il messaggio nativo di importo minimo

È il minimo nativo di Parametri negozio > Impostazioni ordini. Impostalo a 0 se devono contare solo i minimi per gruppo.

I pulsanti +/- avanzano di 1

Il tema non usa i selettori standard di Classic o Hummingbird. La regola resta applicata lato server: il carrello viene corretto o bloccato. Contattaci con il nome del tema per un adattamento.

Un modulo di checkout in una pagina lascia passare l’ordine

Il modulo di terze parti ignora minimalPurchaseRequired. Provalo su un negozio di staging e contattaci indicando il suo nome.

Compatibilità

• PrestaShop da 8.0 a 9.x, lo stesso ZIP copre entrambi i rami.
• Temi Classic e Hummingbird.
• Multinegozio: regole e minimi sono salvati per negozio.
• Architettura ModuleAdminController, senza dipendenze Composer, PHP 7.2 e superiore.
• Interfaccia disponibile in inglese, francese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.