Validazione IVA Intracomunitaria VIES e Inversione Contabile B2B

Questo modulo verifica le partite IVA intracomunitarie sulla banca dati VIES della Commissione europea, applica automaticamente l’inversione contabile (fattura allo 0 % di IVA) per i tuoi clienti professionali stabiliti in un altro Paese UE e conserva un registro delle prove con marca temporale — il documento che l’amministrazione fiscale richiede in caso di verifica.

Requisiti

• PrestaShop 8.0 fino a 9.x, singolo negozio o multi-negozio.
• PHP 7.4 a 8.3. Si consiglia l’estensione SOAP; in mancanza, il modulo ripiega automaticamente sull’API REST di VIES.
• Accesso in uscita HTTPS a ec.europa.eu dal tuo server.

Installazione

1. Nel back-office, vai su Moduli > Gestore dei moduli > Carica un modulo.
2. Seleziona il file ZIP del modulo e avvia l’installazione.
3. Fai clic su Configura al termine dell’installazione.

L’installazione crea la tabella del registro delle consultazioni e una scheda Registro VIES nel menu Ordini.

Configurazione

La tua partita IVA di commerciante

Inserisci la partita IVA della tua azienda nell’apposito campo. Non appena è presente, ogni verifica interroga VIES con un identificativo del richiedente: la banca dati restituisce allora un numero di consultazione ufficiale con marca temporale, opponibile all’amministrazione. È l’impostazione più importante della pagina.

Paese di stabilimento

Indica il Paese dal quale fatturi. L’inversione contabile si applica solo ai clienti stabiliti in un altro Paese UE: un ordine verso il tuo stesso Paese è tassato normalmente.

Attivare l’esenzione (inversione contabile)

Attiva o disattiva il passaggio automatico allo 0 % di IVA. Disattivata, la verifica e il registro continuano a funzionare, ma l’imposta non viene mai modificata — utile per una fase di osservazione.

Verifica in tempo reale

Attiva il badge di convalida istantaneo sul modulo di indirizzo e, se lo attivi, sul campo di registrazione. Il controllo scatta durante la digitazione, con un breve ritardo anti-rimbalzo.

Comportamento se VIES non è disponibile

Due opzioni:

• Accettare (predefinito): l’ordine prosegue senza applicare l’esenzione. È l’opzione più prudente commercialmente — non perdi la vendita.
• Bloccare: la convalida fallisce finché VIES non conferma il numero.

In entrambi i casi l’indisponibilità viene registrata e può essere riverificata più tardi dal cron.

Finestre di validità, cache e riconvalida

• Validità: per quanto tempo una prova valida nel registro consente l’esenzione senza una nuova chiamata.
• Cache: per quanto tempo una verifica recente viene riutilizzata anziché richiamare VIES.
• Riconvalida: l’età oltre la quale il cron riverifica un numero.

Gruppo clienti B2B (opzionale)

Se scegli un gruppo, ogni cliente la cui partita IVA viene convalidata vi è aggiunto automaticamente — comodo per applicare tariffe o regole B2B.

Testo della menzione legale in fattura

La menzione di inversione contabile stampata sulle fatture allo 0 % è personalizzabile in tutte e cinque le lingue. Puoi usare le variabili %vat% (partita IVA del cliente), %date% (data di verifica), %consultation% (numero di consultazione) e %name% (ragione sociale).

La verifica lato cliente

Quando un cliente inserisce la propria partita IVA al checkout o alla registrazione, appare un badge: valido (con la ragione sociale restituita da VIES), non valido, formato errato o VIES non disponibile. Se il numero è valido e il cliente è stabilito in un altro Paese UE, il suo ordine viene fatturato senza imposta.

Il registro delle prove

Ogni consultazione viene registrata in Ordini > Registro VIES: data e ora, Paese, partita IVA, esito, ragione sociale, numero di consultazione ufficiale, canale (indirizzo, registrazione, ordine, cron, manuale) e indirizzo IP.

Alla convalida di un ordine, viene registrato uno snapshot di prova collegato al numero d’ordine, che lega ogni fattura senza imposta alla sua prova. Il pannello VIES nella scheda dell’ordine mostra questo stato a colpo d’occhio.

Esportazione CSV

Dalla schermata del registro, il pulsante di esportazione genera un file CSV di tutte le consultazioni, pronto da consegnare al tuo commercialista o all’amministrazione.

Riconvalida automatica (cron)

La pagina di configurazione mostra un URL cron protetto da token. Chiamalo una volta al giorno per riverificare le partite IVA la cui ultima consultazione sta diventando vecchia. Ogni esecuzione elabora fino a 25 numeri.

Esempio di voce crontab:

0 4 * * * curl -s "https://il-tuo-negozio/index.php?fc=module&module=dfviesb2b&controller=cron&token=IL_TUO_TOKEN" > /dev/null

La menzione legale in fattura

La menzione di inversione contabile viene stampata automaticamente sulla fattura PDF, nella lingua del cliente, solo quando la fattura è realmente emessa allo 0 % di IVA ed esiste una prova valida nel registro. Nessuna menzione viene aggiunta su una fattura tassata normalmente.

Risoluzione dei problemi

Non appare alcun numero di consultazione

Verifica che la tua partita IVA di commerciante sia inserita: senza di essa, VIES risponde ma non rilascia un numero di consultazione ufficiale.

Il badge resta su «VIES non disponibile»

Il servizio VIES ha interruzioni periodiche lato Commissione europea. Verifica anche che il tuo server possa raggiungere ec.europa.eu via HTTPS. Il cron recupererà i numeri non verificati.

L’esenzione non viene applicata

Assicurati che il cliente sia stabilito in un Paese UE diverso dal tuo, che il suo numero sia valido e recente nel registro, e che l’esenzione sia attivata nella configurazione.