Controllo VIES — NIF registrato nel sistema IVA UE

Cos'è VIES

VIES (VAT Information Exchange System) è il servizio ufficiale di consultazione delle registrazioni IVA della UE, gestito dalla Commissione Europea. Ogni autorità tributaria degli Stati membri alimenta VIES con i numeri di IVA registrati e qualsiasi soggetto — incluso SAFTCheck — può chiamare l'endpoint REST pubblico per confermare se un dato paese + numero IVA è attualmente registrato.

Cosa controlla SAFTCheck

Per ogni convalida incrociamo un NIF contro VIES: il Header.TaxRegistrationNumber del file (il tuo NIF aziendale, preceduto dal codice paese PT). I NIF di cliente e fornitore non vengono controllati su VIES — possono essere centinaia per file, VIES ha rate limit ed è lento, e il segnale più prezioso è capire se l'entità proprietaria del file è chi dichiara di essere.

Cosa vedrai

Risultato	Output di SAFTCheck
NIF registrato, nome corrisponde	info: "NIF incrociato con VIES — registrato IVA" con il nome legale registrato visibile
NIF registrato, nome non corrisponde	warning: "CompanyName non corrisponde a VIES" con sia il valore SAF-T sia quello VIES visibili
NIF è Mod-11 valido ma non in VIES	info: "NIF Mod-11 valido ma non registrato IVA in VIES" — legittimo per ditte individuali e altre entità non IVA
VIES irraggiungibile / timeout	silenzioso — nessuna anomalia (non blocchiamo mai la convalida per un disservizio di terzi)
NIF fallisce Mod-11	silenzioso per VIES — il controllo Mod-11 lo ha già segnalato
NIF è la sentinella "Consumidor final" 999999990	silenzioso — per design, non è una registrazione reale

Come funziona il confronto dei nomi

VIES restituisce a volte un nome legale leggermente diverso da quello esportato dall'ERP — spazi in più, una sigla di forma giuridica in coda (LDA, SA, Unipessoal), capitalizzazione diversa. Normalizziamo entrambi i lati ad alfanumerici minuscoli e accettiamo che un lato sia prefisso dell'altro prima di segnalare un disallineamento. Questo evita warning rumorosi su differenze cosmetiche e intercetta comunque i casi reali di "NIF sbagliato sull'azienda sbagliata".

Performance e affidabilità

• Timeout: 3 secondi per chiamata a VIES. Se il servizio UE è lento, andiamo avanti senza bloccare il resto della convalida.
• Cache: i risultati VIES positivi vengono memorizzati in cache per 24 ore per NIF. Riconvalidare lo stesso file (o un altro file con lo stesso NIF di Header) non richiama l'endpoint UE.
• Modalità di fallimento: quando VIES è down o restituisce errore non memorizziamo nulla in cache e la convalida successiva riprova. La convalida non fallisce mai per un disservizio di VIES.

Cosa VIES non dice

• Non certifica che il NIF sia valido ai fini della compliance fiscale. L'AT può avere restrizioni aggiuntive che VIES non espone.
• Non controlla i NIF di cliente o fornitore nel file (intenzionale — vedi ambito sopra).
• Non rileva modifiche di registrazione infragiornaliere; la cache può avere fino a 24h.

Correlato

• NIF Mod-11 — il controllo offline che viene prima di VIES.
• Editor inline — correggi il NIF dell'Header sul posto se VIES dice che è quello sbagliato.