OSS IVA UE – Prezzi IVA inclusa (GeoIP MaxMind)

Presentazione

OSS IVA UE – Prezzi IVA inclusa (GeoIP MaxMind) è un modulo PrestaShop che mostra automaticamente i prezzi con l'aliquota IVA del paese di ogni visitatore, senza alcuna configurazione multi-negozio. Grazie al rilevamento GeoIP, i tuoi clienti vedono immediatamente l'aliquota IVA corretta non appena arrivano sul tuo sito, garantendo un'esperienza di acquisto trasparente e conforme al regime OSS europeo.

Senza questo modulo, PrestaShop mostra per impostazione predefinita l'IVA del tuo paese a tutti i visitatori. Il prezzo cambia solo al momento del checkout, quando il cliente inserisce il proprio indirizzo di consegna — una fonte frequente di confusione e abbandono del carrello. Con OSS IVA UE – Prezzi IVA inclusa (GeoIP MaxMind), un visitatore francese vede i prezzi con il 20% di IVA, un visitatore tedesco con il 19%, un visitatore belga con il 21%, e così via per tutti i paesi europei.

Punti di forza:

• Visualizzazione istantanea dell'IVA locale per ogni visitatore europeo
• Creazione automatica di tutte le tasse EU in pochi clic
• Nessuna configurazione multi-negozio necessaria
• Selettore di paese personalizzabile con anteprima in tempo reale
• Compatibile con PrestaShop 8 e 9

Funzionalità

Rilevamento automatico del paese tramite GeoIP

Il modulo identifica il paese del visitatore tramite il suo indirizzo IP grazie al database MaxMind GeoLite2. I prezzi vengono visualizzati immediatamente con l'aliquota IVA corrispondente, senza alcuna azione da parte del visitatore. Se il rilevamento fallisce, viene utilizzato il paese predefinito configurato nel modulo.

Creazione automatica delle tasse europee

Una procedura guidata in 3 passaggi accompagna la configurazione completa delle tasse per tutti i paesi dell'Unione Europea. Seleziona i tuoi gruppi di regole fiscali, scegli i paesi interessati, e il modulo crea automaticamente tutte le tasse e le regole necessarie nel tuo database PrestaShop. Ogni paese mostra il proprio stato: configurato (verde), parziale (arancione) o non configurato (rosso).

Selettore di paese front-office

Un selettore integrato permette ai visitatori di cambiare manualmente il paese in qualsiasi momento. I prezzi si aggiornano automaticamente. Per i clienti connessi con più indirizzi in paesi diversi, il selettore mostra solo i loro paesi e permette di passare da un indirizzo all'altro.

Template e personalizzazione della visualizzazione

Cinque template predefiniti sono disponibili: Minimale (solo nome del paese), Con bandiera (bandiera + nome), Completo (bandiera + paese + IVA), Compatto (bandiera + codice ISO) e Personalizzato. La scelta di un template precompila le opzioni, ma ogni dettaglio resta completamente personalizzabile. Un'anteprima in tempo reale permette di visualizzare le modifiche istantaneamente.

Funzionalità aggiuntive

• Restrizione per gruppo clienti: Limita la funzionalità a gruppi specifici (Visitatore, Ospite, Cliente) o applicala a tutti lasciando la selezione vuota
• Hook personalizzato: Posiziona il selettore ovunque nel tuo tema tramite Smarty ({hook h='displayWeprestaOSS'}) o Twig ({{ renderhook('displayWeprestaOSS') }})
• Gestione avanzata dei paesi: Attiva solo i paesi in cui effettui spedizioni, con indicatori di stato delle tasse
• Cookie configurabile: Imposta la durata di memorizzazione della scelta del visitatore (valore 0 per cookie di sessione)
• Responsive: Funziona perfettamente su mobile e desktop

Installazione

1. Scarica il modulo dalla tua area clienti WePresta
2. Nel back office di PrestaShop, vai su Moduli > Gestione moduli
3. Clicca su Carica un modulo e seleziona il file ZIP
4. Accedi alla configurazione del modulo per impostare le tue tasse

Configurazione

Scheda Generale

Imposta il paese predefinito utilizzato quando il rilevamento GeoIP fallisce o non è stata effettuata alcuna selezione manuale. Per impostazione predefinita, viene utilizzato il paese del negozio PrestaShop — scegli il paese in cui si trova la maggior parte dei tuoi clienti. Puoi anche limitare la funzionalità a specifici gruppi di clienti: lascia vuoto per applicarla a tutti, o seleziona gruppi specifici.

Scheda Tasse

Un workflow in 3 passaggi per creare automaticamente tutte le tasse europee:

1. Gruppi di regole fiscali: Seleziona gruppi esistenti o lascia che il modulo ne crei di nuovi. Se i tuoi prodotti sono già associati a gruppi fiscali, selezionali per aggiungere le regole europee. Le aliquote contrassegnate come "Opzionale" possono essere saltate se non ne hai bisogno.
2. Selezione dei paesi: Visualizza tutti i paesi con le loro aliquote IVA (standard, ridotta, ridotta 2, super ridotta) e il loro stato di configurazione. Seleziona solo i paesi in cui effettui spedizioni.
3. Conferma: Verifica il riepilogo delle azioni (numero di tasse e regole fiscali da creare) prima di confermare. Clicca su Esegui per avviare la creazione. Puoi poi verificare in Internazionale → Tasse che tutto sia stato creato correttamente.

Scheda Paesi

Gestisci quali paesi appaiono nel selettore front-office. Un paese viene mostrato ai visitatori solo se soddisfa 3 condizioni: attivo nel modulo (scheda Paesi), tasse configurate (scheda Tasse) e paese abilitato per la consegna in PrestaShop (Internazionale → Localizzazione → Paesi).

Scheda Visualizzazione

Personalizza completamente l'aspetto del selettore di paese. Scegli la posizione tramite un hook PrestaShop standard (displayNav1, displayNav2, displayTop…) o un hook personalizzato. Seleziona un template di base tra le 5 opzioni disponibili, poi regola ogni dettaglio secondo le tue esigenze. L'anteprima in tempo reale sul lato destro dello schermo riflette immediatamente le tue modifiche.

Scheda Avanzato

Configura la durata del cookie (in giorni) per memorizzare la scelta del visitatore. Il valore 0 crea un cookie di sola sessione, eliminato alla chiusura del browser.

Configura la geolocalizzazione GeoIP creando un account gratuito su maxmind.com e generando una chiave di licenza. Il modulo scarica automaticamente il database GeoLite2.

Prerequisiti

• PrestaShop 8.x o 9.x
• PHP 8.1 o superiore
• Account MaxMind gratuito (per il rilevamento GeoIP)

FAQ

Le tasse non vengono create

Assicurati di aver cliccato su "Esegui" al passaggio 3 del workflow di creazione. Controlla i log di PrestaShop per identificare eventuali errori.

Il rilevamento GeoIP non funziona

Verifica che GeoIP sia attivato nella scheda Avanzato e che il database GeoIP sia stato scaricato (stato "OK"). Il rilevamento non funziona in ambiente localhost (IP locale).

Il selettore di paese non appare

Controlla 3 punti: il selettore è attivato nella scheda Visualizzazione, almeno un paese è attivo nella scheda Paesi e l'hook è configurato correttamente nel tuo tema.

I prezzi non cambiano quando cambio paese

Assicurati che le tasse siano configurate per entrambi i paesi, che i tuoi prodotti siano associati ai gruppi di regole fiscali corretti e svuota la cache di PrestaShop.

Un paese non appare nel selettore

Un paese appare solo se è attivo nel modulo (scheda Paesi), le sue tasse sono configurate (scheda Tasse) ed è attivo in PrestaShop (Internazionale → Localizzazione → Paesi).

Il cliente vede un prezzo diverso tra la navigazione e il checkout

Per i clienti connessi, il modulo utilizza i loro indirizzi reali. Un cambio di prezzo può verificarsi se il cliente modifica il proprio indirizzo di consegna al checkout. Per i visitatori, verifica la configurazione GeoIP.

Il modulo è compatibile con il mio tema?

Sì, il modulo è compatibile con tutti i temi PrestaShop. Puoi utilizzare gli hook standard o un hook personalizzato per posizionare il selettore esattamente dove desideri.

Supporto

Contattaci tramite la tua area clienti WePresta o via email per qualsiasi domanda o assistenza tecnica.

Changelog

Versione 1.0.0

• Versione iniziale
• Rilevamento automatico del paese tramite GeoIP (MaxMind GeoLite2)
• Creazione automatica delle tasse europee in 3 passaggi
• Selettore di paese front-office con 5 template
• Restrizione per gruppo clienti
• Supporto hook standard e personalizzati
• Gestione clienti connessi con indirizzi multipli
• Cookie configurabile per la memorizzazione della scelta del visitatore