VAT OSS Autopilot — Guida completa

Panoramica

VAT OSS Autopilot automatizza la gestione dell’IVA intracomunitaria del tuo negozio WooCommerce: calcolo in tempo reale dell’aliquota del paese di consumo, validazione VIES delle partite IVA B2B con inversione contabile, generazione della dichiarazione OSS trimestrale (CSV riepilogo, CSV dettagliato, XML DGFiP) e monitoraggio di soglie di fatturato interamente configurabili.

Requisiti

• WordPress 6.2 o superiore
• WooCommerce 7.0 o superiore (testato fino a 9.4)
• PHP 7.4 minimo (compatibile 8.0 fino a 8.3)
• Estensioni PHP: SOAP (validazione VIES), DOM (esportazione XML), ZipArchive (pacchetto ZIP)
• Le imposte WooCommerce devono essere attivate (WooCommerce → Impostazioni → Generale → Attiva le imposte)

Installazione

1. Scarica vat-oss-autopilot.zip dal tuo account DataFirefly.
2. Nell’admin di WordPress, vai su Plugin → Aggiungi nuovo → Carica plugin.
3. Seleziona lo ZIP, clicca Installa ora, poi Attiva.
4. Un nuovo menu VAT OSS appare nella barra laterale dell’admin.

All’attivazione, il plugin crea la tabella wp_vat_oss_sales (registro vendite OSS) e precarica tre soglie di esempio francesi, liberamente modificabili o eliminabili.

Configurazione iniziale

1. Identificazione fiscale

Vai su VAT OSS → Impostazioni e compila:

• Paese di stabilimento — il paese in cui sei registrato OSS. Le vendite verso questo paese restano gestite dalla tua configurazione WooCommerce abituale (fuori dall’ambito OSS).
• Partita IVA — il tuo numero intracomunitario (es.: IT12345678901). Compare nell’intestazione dell’XML di dichiarazione.
• Ragione sociale, email, telefono, IBAN, BIC — informazioni usate nel blocco Operator dell’XML.

2. Validazione VIES

• Attiva la validazione VIES — interroga il servizio della Commissione Europea a ogni inserimento di partita IVA al checkout (timeout 8 secondi).
• Applica inversione contabile B2B — porta l’IVA allo 0% per i clienti professionali intracomunitari con numero validato.
• Durata cache VIES — in secondi, 30 giorni per impostazione predefinita (2592000). Ogni numero validato viene messo in cache per non sovraccaricare VIES.

3. Tipo di attività predefinito

Scegli Merci o Servizi. Questo tipo serve a ripartire il fatturato nelle soglie e nella dichiarazione OSS. Puoi sovrascriverlo prodotto per prodotto: in ogni scheda prodotto WooCommerce, scheda Imposte, campo Tipo OSS.

Aliquote IVA UE

La pagina VAT OSS → Aliquote IVA elenca i 27 Stati membri con tre colonne: aliquota ordinaria, ridotta e super ridotta. I valori predefiniti sono aggiornati alla data di pubblicazione del plugin.

L’aliquota applicata al checkout dipende dalla classe di imposta WooCommerce del prodotto: la classe standard usa l’aliquota ordinaria, una classe contenente «reduced» usa la ridotta, una classe contenente «super» usa la super ridotta.

Funzionamento al checkout

1. Il cliente indica il suo paese di fatturazione; il plugin applica automaticamente l’aliquota del paese se la vendita è intracomunitaria e idonea OSS.
2. Un campo opzionale Partita IVA intracomunitaria appare nei campi di fatturazione.
3. Alla digitazione (debounce 600 ms), una validazione AJAX interroga VIES e mostra il risultato: spunta verde con la ragione sociale, o croce rossa.
4. Se il numero è valido e l’inversione è attivata, l’IVA passa allo 0% con l’etichetta «IVA (inversione contabile)» e i totali si ricalcolano.
5. Il numero, lo stato di validazione e la ragione sociale vengono salvati nei metadati dell’ordine.

Registro vendite OSS

Ogni ordine che raggiunge lo stato Completato o In lavorazione viene registrato nella tabella di monitoraggio, ripartito per aliquota IVA e tipo di prodotto. Le spese di spedizione vengono associate all’aliquota dominante dell’ordine. I rimborsi generano automaticamente righe negative.

Escluse dalla dichiarazione OSS: le vendite domestiche (paese di stabilimento) e le vendite B2B con numero VIES validato (inversione contabile).

Pannello di controllo

La pagina VAT OSS → Pannello di controllo mostra, per il trimestre in corso: la base imponibile OSS, l’IVA da versare, il confronto con il trimestre precedente, il numero di paesi coinvolti, la ripartizione dettagliata per paese e aliquota, e il progresso di ogni soglia configurata.

Generare la dichiarazione OSS

In VAT OSS → Dichiarazione OSS, scegli l’anno e il trimestre (il trimestre precedente è preselezionato) e clicca sul formato desiderato:

• CSV riepilogo — aggregato per paese e aliquota, UTF-8 con BOM e separatore punto e virgola. È il file da usare per l’inserimento manuale nel portale.
• CSV dettagliato — una riga per ordine e aliquota, con numero d’ordine, tipo di cliente e partita IVA. Serve da audit trail contabile.
• XML formato FR — conforme allo schema OSS-Union della DGFiP (namespace urn:dgfip:oss:union:v1), con blocchi Header, Operator, Supplies per paese di consumo e Totals. Pronto da caricare su impots.gouv.fr.
• Tutto in ZIP — i tre file in un unico archivio.

Soglie configurabili

La pagina VAT OSS → Soglie permette di definire tutte le soglie necessarie. Ogni riga comprende:

• Etichetta — testo libero (es.: «Vendita di merci»)
• Importo e valuta — il tetto annuale da monitorare
• Tipo — Merci, Servizi, o Tutto (fatturato globale)
• Avvisi (%) — livelli separati da virgole (es.: 80,90,100)

A ogni ordine, il plugin ricalcola il fatturato annuale del tipo interessato. Quando un livello viene superato, un’email parte verso l’indirizzo admin del sito e un avviso persistente appare nell’amministrazione. Ogni livello scatta una sola volta per anno fiscale.

Tre soglie di esempio (regime micro francese) sono precaricate all’installazione: 85.000 € merci, 37.500 € servizi, 25.000 € franchigia IVA. Adattale alla tua situazione o eliminale.

Manutenzione

• Svuota la cache VIES — pulsante in VAT OSS → Impostazioni, forza la rivalidazione di tutti i numeri al prossimo checkout.
• Disattivazione — conserva tutti i dati (tabella, opzioni, storico).
• Disinstallazione — rimuove la tabella wp_vat_oss_sales, tutte le opzioni, la cache VIES e i metadati degli ordini (compresa la tabella HPOS wc_orders_meta).

Risoluzione dei problemi

La validazione VIES non si attiva

• Verifica che l’estensione PHP SOAP sia installata sul server.
• Verifica che la validazione sia attivata in VAT OSS → Impostazioni.
• VIES subisce manutenzioni regolari da parte della Commissione Europea — riprova più tardi; il fallback con IVA applicata protegge i tuoi ordini.

L’aliquota applicata non è quella attesa

• Le vendite verso il tuo paese di stabilimento usano la tua configurazione WooCommerce nativa, non il registro del plugin.
• Verifica la classe di imposta del prodotto: determina se viene usata l’aliquota ordinaria, ridotta o super ridotta.
• Verifica l’aliquota del paese di destinazione in VAT OSS → Aliquote IVA.

Un ordine non compare nella dichiarazione

• Solo gli ordini in stato Completato o In lavorazione vengono registrati.
• Le vendite B2B con numero VIES validato sono deliberatamente escluse (inversione contabile, fuori OSS).
• Le vendite domestiche sono fuori dall’ambito OSS.

FAQ

Posso usare il plugin fuori dalla Francia?

Sì. Il paese di stabilimento è configurabile, le soglie sono interamente personalizzabili e l’interfaccia esiste in 5 lingue. Solo l’esportazione XML segue lo schema francese DGFiP; per gli altri portali nazionali, usa il CSV riepilogo.

Il plugin gestisce il regime IOSS (importazioni)?

No, questa versione copre il regime OSS-Union (vendite intracomunitarie). Il regime IOSS per le importazioni sotto i 150 € non è incluso.

I dati sono conformi al GDPR?

Il plugin memorizza solo i dati necessari alla dichiarazione fiscale: paese, importi, aliquote e partita IVA (dato professionale). Nessun dato viene trasmesso a terzi al di fuori della chiamata VIES ufficiale della Commissione Europea.