# Vini e distillati su PrestaShop: documentazione DataFirefly Wine & Spirits > Installazione Installa il modulo da Moduli > Gestione moduli > Carica un modulo con il file ZIP. Il modulo crea le sue tabelle, registra i suoi hook e aggiunge il… - Pagina: - Lingua: it - Aggiornato il: 2026-09-24 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfwinespirits/index.md), [en](https://www.datafirefly.com/en/documentation/dfwinespirits/index.md), [es](https://www.datafirefly.com/es/documentation/dfwinespirits/index.md), [de](https://www.datafirefly.com/de/documentation/dfwinespirits/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfwinespirits/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfwinespirits/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfwinespirits/index.md) - Indice: ## Installazione Installa il modulo da **Moduli > Gestione moduli > Carica un modulo** con il file ZIP. Il modulo crea le sue tabelle, registra i suoi hook e aggiunge il menu **Catalogo > Vini e distillati**. All'installazione crea anche otto caratteristiche native: Annata, Vitigno, Denominazione, Gradazione alcolica, Colore, Regione, Paese di origine e Certificazione. Configura la Francia (età legale 18 anni, casella dell'età al pagamento, avvertenza sanitaria francese obbligatoria) e le aliquote di accisa francesi 2026. Per aggiornare da una versione precedente, installa il nuovo ZIP: gli script di aggiornamento aggiungono colonne, tabelle e caratteristiche mancanti senza toccare i tuoi dati. ## Dashboard Prima scheda del menu. Mostra il numero di prodotti gestiti, i pezzi venduti, l'alcol puro e le accise del mese in corso, una checklist della configurazione, la completezza dei dati (gradazione, colore, annata, vitigni, denominazione) e gli ultimi 30 prodotti da completare con un link alla loro scheda. Colore, annata e vitigni sono controllati solo per i vini. ## Impostazioni ### Modalità di calcolo delle accise - **Incluse nel prezzo** (predefinita): i tuoi prezzi contengono già le accise. L'importo è mostrato nella scheda prodotto («Di cui accise») e nel carrello, poi registrato nel registro. - **Aggiunte al checkout**: al carrello viene aggiunta una riga «Accise» con le accise del paese di consegna. È portata da un prodotto tecnico nascosto dal catalogo, creato all'attivazione di questa modalità. Non eliminare questo prodotto. - **Disattivata**: nessun importo viene calcolato, il registro memorizza solo volumi e alcol puro. **Regola fiscale della riga accise**: nell'UE le accise fanno parte della base imponibile IVA. Scegli l'aliquota ordinaria. ### Visualizzazione Ogni elemento si attiva separatamente: riepilogo del vino nella scheda prodotto, importo delle accise nella scheda, avvertenza legale nella scheda, avvertenza e totale accise nel carrello, avvertenza nel footer, accise e avvertenza nella fattura PDF, scheda di degustazione, badge negli elenchi prodotti. ### Popup di verifica dell'età - **Verifica**: pulsanti Sì / No, oppure data di nascita con calcolo dell'età. - **Ricorda per**: numero di giorni in cui al visitatore non viene chiesto di nuovo. 0 chiede di nuovo a ogni sessione del browser. - **URL di uscita**: pagina aperta quando il visitatore risponde no o non ha l'età richiesta. - **Colore dei pulsanti**, **titolo e testo** per lingua. Nel testo, `{age}` è sostituito dall'età legale del paese del visitatore. Il popup non viene mostrato ai robot dei motori di ricerca, nelle pagine CMS né ai clienti connessi la cui data di nascita dimostra l'età. Il contenuto della pagina resta nell'HTML. ### Cassa mista Imposta il numero di bottiglie richieste (6 per impostazione predefinita), lo sconto in percentuale e i prodotti idonei: tutti i prodotti alcolici gestiti dal modulo, oppure solo quelli contrassegnati nella loro scheda. Appena il carrello raggiunge il numero richiesto, ogni bottiglia idonea riceve lo sconto. Un prodotto il cui sconto a cassa si applica già mantiene il proprio sconto. ### Paesi senza regola specifica Valori usati per i paesi non configurati: consegna di alcolici consentita o no, casella dell'età al pagamento, età legale. ### Valori predefiniti dei prodotti Volume (75 cl) e dimensione della cassa (6) proposti per un nuovo prodotto. ### Caratteristiche filtrabili La tabella indica lo stato delle otto caratteristiche. **Ricrea le caratteristiche mancanti** ricrea quelle eliminate. Perché i clienti possano filtrarle, aggiungile al tuo modello di filtri in **ps_facetedsearch** (pulsante **Apri la navigazione a faccette**). ## Compilare un prodotto Apri la pagina prodotto, scheda **Moduli**, blocco Wine & Spirits. Seleziona **Questo prodotto è una bevanda alcolica**. Il blocco si salva con il proprio pulsante, indipendentemente dal modulo prodotto. ### Dati di vini e distillati - **Categoria**: categoria fiscale usata per le accise (vino fermo, spumante, vino liquoroso, altro prodotto intermedio, distillati, birra, sidro). - **Annata** o casella **Senza annata**. - **Gradazione alcolica** in % vol e **volume per pezzo** in cl. - **Vitigni** separati da virgole: ognuno diventa un valore di filtro. **Denominazione** con suggerimenti dai valori esistenti per evitare doppioni. ### Profilo e degustazione Colore, regione, paese di origine, temperatura di servizio (min. e max.), potenziale di invecchiamento, marchi (biologico, biodinamico, vino naturale, vegano, HVE), riconoscimenti e punteggi (uno per riga). Le note di degustazione e gli abbinamenti si inseriscono per lingua con le schede di lingua. ### Vendita a cassa - **Solo al pezzo**: comportamento standard. - **Al pezzo o a cassa**: la scheda prodotto propone la scelta tra bottiglia e cassa, con il prezzo della cassa e il risparmio. - **Solo a cassa**: la quantità minima diventa la dimensione della cassa e le quantità nel carrello sono arrotondate alla cassa completa superiore (inferiore se manca lo stock). Lo **sconto a cassa**, in % o come importo per cassa, è creato come sconto quantità nativo a partire da una cassa completa. La casella **Idoneo alla cassa mista** compare quando la cassa mista è attivata. ### Volume per combinazione Per un prodotto con combinazioni (mezza bottiglia, bottiglia, magnum), indica il volume di ogni combinazione. Se vuoto, la combinazione usa il volume del prodotto. Accise, alcol puro del registro e scheda di degustazione seguono la combinazione. Al salvataggio, il modulo riscrive le otto caratteristiche del prodotto. Non modificarle a mano nella scheda Caratteristiche: le modifiche verrebbero sostituite al successivo salvataggio del blocco. ## Paesi e avvertenze legali La scheda elenca i paesi attivi, con una ricerca. Per ogni paese, **Modifica** permette di impostare: - **L'alcol può essere consegnato in questo paese**: se deselezionata, il cliente con alcolici nel carrello si ferma alla fase di spedizione con un messaggio, e un avviso compare nella scheda prodotto. - **Casella età legale al checkout** ed **età legale**: la casella «Confermo di avere almeno N anni» viene aggiunta alle condizioni da accettare nella fase di pagamento. - **Avvertenza legale** per lingua. Una lingua vuota usa la lingua predefinita del negozio. Il paese di consegna viene letto dall'indirizzo di consegna del carrello, altrimenti dal primo indirizzo del cliente connesso, poi dal paese del visitatore, poi dal paese predefinito del negozio. ## Aliquote di accisa Un'aliquota si definisce per paese, categoria, intervallo di gradazione (limiti inclusi, 0 come massimo per nessun limite), base di calcolo e importo nella valuta predefinita, IVA esclusa. Più aliquote possono applicarsi allo stesso prodotto e si sommano. - **per ettolitro di prodotto**: vini, spumanti, prodotti intermedi, sidri. - **per ettolitro di alcol puro**: distillati. Esempio: 70 cl al 40% = 0,0028 hl di alcol puro. - **per ettolitro e per grado**: birre. - **per litro di prodotto** e **per pezzo venduto** per gli altri casi. Aliquote francesi 2026 incluse: vini fermi 4,19 €/hl, spumanti 10,38 €/hl, sidri 1,46 €/hl, VDN e VDL 52,39 €/hl, altri prodotti intermedi 209,53 €/hl più 52,39 €/hl di contributo oltre il 18% vol, alcolici 1.932,42 €/hl di alcol puro più 620,47 € di contributo previdenziale oltre il 18% vol, birre 4,12 €/hl/grado fino a 2,8% vol poi 8,24 €. Una bottiglia da 70 cl al 40% sostiene quindi 7,15 €. Le aliquote cambiano ogni 1° gennaio. Verificale presso l'amministrazione doganale e aggiornale. **Carica le aliquote francesi 2026** sostituisce tutte le aliquote della Francia con quelle fornite con il modulo. ## Registro accise Ogni ordine convalidato registra, per ciascun prodotto alcolico, il paese di consegna, la categoria, la combinazione, i pezzi, il volume, la gradazione, l'alcol puro e l'importo delle accise all'aliquota del giorno. La scheda Registro filtra per periodo, paese e ordini convalidati, con due esportazioni CSV: il riepilogo per paese e categoria, e le righe d'ordine. Ogni pagina ordine mostra anche un pannello Accise. ## Importazione ed esportazione CSV **Esporta i prodotti alcolici** o **Esporta tutto il catalogo** genera un file nel formato dell'importazione. Completalo con un foglio di calcolo e reimportalo. - Separatore `;` o `,` rilevato automaticamente. Prodotto trovato tramite `id_product`, altrimenti tramite `reference`. - Una colonna assente o una cella vuota mantiene il valore attuale. `-` svuota annata, vitigni, denominazione e campi di testo. - `vintage`: anno o `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, separati da virgole. `origin_country`: codice ISO (IT, FR...). `awards`: un riconoscimento per valore, separati da `|`. - Colonne per lingua: `tasting_notes_it`, `food_pairing_it`, `tasting_notes_en`... Lascia selezionato **Solo simulazione** per un primo passaggio: il rapporto indica le righe lette, i prodotti che verrebbero aggiornati e gli errori con il numero di riga, senza salvare nulla. ## Cosa vede il cliente - **Scheda prodotto**: riepilogo del vino, scelta bottiglia o cassa, offerta di cassa mista, importo delle accise, età legale e avvertenza legale, avviso se il paese di consegna è bloccato. - **Scheda di degustazione**: schede delle caratteristiche, marchi, note di degustazione, abbinamenti e riconoscimenti. - **Elenchi prodotti**: badge di colore, annata, marchi, riconoscimenti e cassa mista. - **Carrello**: «2 x cassa da 6» sotto le righe, avanzamento della cassa mista, totale accise e avvertenza legale. - **Pagamento**: casella dell'età legale, riga accise in modalità aggiunta. - **Fattura PDF**: importo delle accise, alcol puro e avvertenza legale. ## Risoluzione dei problemi ### I filtri non compaiono Aggiungi le caratteristiche al modello di filtri di ps_facetedsearch e associa il modello alle categorie interessate. I valori compaiono solo quando almeno un prodotto è stato salvato con i suoi dati. ### La scheda di degustazione o i badge non vengono mostrati Verifica le opzioni di visualizzazione e che il prodotto sia contrassegnato come bevanda alcolica. I badge usano l'hook `displayProductListReviews` e la scheda `displayProductExtraContent`: un tema che non li richiama non li mostrerà. ### La riga accise non compare nel carrello Verifica la modalità Aggiunte al checkout, che il paese di consegna abbia aliquote per la categoria del prodotto e che esista il prodotto tecnico della riga accise (il suo ID è indicato nelle impostazioni). ### Il popup dell'età ricompare a ogni pagina Il browser blocca il cookie `dfws_age_ok`. Verifica che un gestore di cookie non lo elimini: è un cookie funzionale. ## Compatibilità - PrestaShop da 8.0 a 9.x, lo stesso ZIP copre entrambe le versioni. - Filtri tramite caratteristiche native, compatibili con ps_facetedsearch. - Architettura ModuleAdminController, senza dipendenze Composer, PHP 7.2 o superiore. - Interfaccia in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.