OSS IVA UE – Prezzi IVA inclusa (GeoIP MaxMind)

Presentazione

Il modulo adatta i prezzi IVA inclusa al paese del visitatore tramite scelta manuale o rilevamento locale MaxMind. Ogni prodotto conserva il proprio gruppo di regole fiscali. Il selettore mostra l’aliquota ordinaria di riferimento; i prodotti con aliquote ridotte mantengono le proprie aliquote.

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

Verificate aliquote e gruppi fiscali interessati nell’anteprima, quindi confermate le modifiche. Ogni prodotto conserva il proprio gruppo di regole fiscali.

Selettore di paese front-office

Senza un indirizzo reale, il paese scelto serve a stimare i prezzi, anche nella finestra di conferma dell’aggiunta al carrello. Un indirizzo fiscale valido nel carrello ha priorità secondo l’impostazione consegna/fatturazione di PrestaShop. Il cliente autenticato può scegliere un indirizzo salvato e confermarlo per la consegna. Costi e imposte vengono ricalcolati; l’indirizzo di fatturazione già presente viene conservato. Non vengono creati indirizzi fittizi.

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

Attivate l’anteprima, scegliete i paesi disponibili e quello predefinito, quindi controllate i gruppi di clienti autorizzati. L’anteprima può essere disattivata senza perdere le impostazioni.

Scheda Tasse

Nella procedura Imposte, selezionate i gruppi già assegnati ai prodotti o predisponete nuovi gruppi. Controllate aliquote precedenti e nuove, poi confermate. L’anteprima non crea dati. I prodotti non vengono mai riassegnati automaticamente. Gruppi condivisi tra negozi e regole regionali o combinate richiedono una verifica nelle impostazioni native. Le aliquote ridotte dipendono dalla categoria e dal territorio.

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.

Inserite l’ID dell’account e una chiave abilitata al download di GeoLite2 Country. Scaricate il database da Avanzate e verificatene lo stato. PHP richiede cURL, Phar e zlib. Il rilevamento legge il database locale. Se l’aggiornamento fallisce, il precedente database viene conservato. Lasciare la chiave vuota conserva quella salvata. Configurate solo indirizzi o intervalli effettivi dei proxy attendibili; Cloudflare dispone di un’opzione separata.

Riepilogo IVA

Scegliete un periodo e visualizzate l’anteprima o scaricate il CSV. Le vendite seguono la data dell’ordine; le note di credito la data di emissione, anche per vendite precedenti. Gli importi storici sono separati per negozio, valuta, paese, aliquota e componente, trasporto incluso. Le righe ambigue restano segnalate. Il riepilogo non determina l’ammissibilità OSS e non sostituisce una dichiarazione. I rimborsi senza nota di credito non vengono detratti automaticamente.

Aggiornamento

Eseguite un backup e installate il nuovo archivio. Le impostazioni vengono conservate. Verificate prodotti con aliquota ordinaria e ridotta, poi il carrello e gli indirizzi. Cache e CDN devono distinguere paese e sessione.

Prerequisiti

• PrestaShop 1.7.8, 8.2 o successiva, 9.1 o successiva (8.0, 8.1 e 9.0 non supportate); PHP 7.4 minimo, secondo i requisiti della vostra versione di PrestaShop.
• Account MaxMind e chiave di download GeoLite2 Country per GeoIP; estensioni PHP cURL, Phar e zlib per scaricare il database.

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

Senza un indirizzo reale, il paese scelto serve a stimare i prezzi. Un indirizzo fiscale valido nel carrello ha priorità secondo l’impostazione consegna/fatturazione di PrestaShop. Il cliente autenticato può scegliere un indirizzo salvato e confermarlo per la consegna. Costi e imposte vengono ricalcolati; l’indirizzo di fatturazione già presente viene conservato. Non vengono creati indirizzi fittizi.

Il modulo è compatibile con il mio tema?

Usate gli hook standard o quello personalizzato per posizionare il selettore. Verificate visualizzazione e carrello con il vostro tema e le estensioni.

Supporto

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

Changelog

Versione 2.0.1

• Prezzo IVA inclusa del paese scelto mostrato anche nella finestra di conferma dell’aggiunta al carrello
• Prezzo IVA inclusa del paese scelto mantenuto nella scheda di un prodotto già nel carrello

Versione 2.0.0

• Prezzi IVA inclusa più affidabili in base al paese e all’aliquota di ogni prodotto
• Priorità all’indirizzo fiscale del carrello per il calcolo dei prezzi
• Scelta dell’indirizzo di consegna con conferma del cliente
• Anteprima delle aliquote e dei gruppi fiscali prima di applicare le modifiche
• Aggiornamento delle aliquote IVA di riferimento
• Download MaxMind sicuri, con conservazione del database precedente in caso di errore
• Riepilogo IVA ed esportazione CSV basati su vendite e note di credito storiche, trasporto incluso
• Caricamento dei paesi ottimizzato e riepilogo IVA calcolato su richiesta
• Conservazione delle impostazioni esistenti durante l’aggiornamento

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