ForHosting KIT · Verifiche e controlli

Verifica una partita IVA

Questo strumento controlla una partita IVA europea interrogando il VIES, l’archivio ufficiale della Commissione UE. Ti dice se il numero è attivo e, quando l’ufficio del paese lo rende disponibile, a quale ragione sociale corrisponde. Serve prima di fatturare o registrare un fornitore intracomunitario.

● Stabileper richiesta + per elemento$0.002

Esegui — $0.002 Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Esegui online

Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.

Cos’è il VIES e perché conta

Il VIES (VAT Information Exchange System) è il sistema con cui la Commissione UE collega gli archivi delle partite IVA di tutti gli Stati membri. Una partita IVA presente nel VIES è attiva ai fini delle operazioni intracomunitarie: è quello che serve controllare prima di emettere una fattura senza IVA verso un cliente di un altro paese UE, o prima di registrare un nuovo fornitore estero in anagrafica.

Cosa restituisce il controllo

Incolli il numero con il prefisso del paese — per esempio IT01234567890 — ed esegui. Il risultato dice se il numero è valido nel VIES in questo momento; quando l’ufficio nazionale lo pubblica, arrivano anche ragione sociale e indirizzo registrati. Non tutti i paesi restituiscono questi dati aggiuntivi: alcuni uffici confermano solo la validità del numero, per scelta propria, e lo strumento lo segnala con chiarezza.

Partita IVA italiana ed estera

Per l’Italia il formato è IT seguito da undici cifre. Lo strumento riconosce anche i formati degli altri paesi UE — tedesco, francese, spagnolo e così via — e li interroga con la stessa richiesta, senza bisogno di indicare il paese a parte. Utile prima di una fornitura intracomunitaria, quando devi sapere se il cliente o il fornitore estero ha una partita IVA valida per l’operazione senza IVA.

Quando il VIES non risponde

Il VIES a volte è lento o temporaneamente irraggiungibile, specie per certi paesi in certe fasce orarie: è un limite noto del sistema europeo, non di questo strumento. In quel caso il controllo lo segnala chiaramente invece di inventare una risposta o di dare per valido un numero che non ha potuto verificare, e la cosa più semplice è riprovare qualche minuto dopo.

Casi d'uso

Fatturare senza IVA a un cliente UE

Rossi & Figli S.r.l. deve emettere una fattura a un cliente spagnolo senza applicare l’IVA italiana. Prima verifica che la partita IVA spagnola sia attiva nel VIES: solo così l’operazione è corretta.

Registrare un nuovo fornitore estero

Lo Studio Commercialista Bianchi riceve i dati di un fornitore tedesco da inserire in anagrafica. Un controllo sul VIES conferma il numero prima di registrarlo e di ricevere la prima fattura.

Prima di firmare un contratto

Prima di firmare un accordo di fornitura con un’azienda francese, confermi che la partita IVA indicata corrisponde davvero a un’attività registrata nel VIES, non solo a un numero scritto bene.

Domande frequenti

È gratis o si paga?

Si paga a consumo: $0.002 a verifica, senza abbonamento. Interroga il VIES in tempo reale, quindi non può girare gratis nel browser come i controlli di solo formato.

Conferma anche la ragione sociale?

Quando l’ufficio nazionale la pubblica, sì. Non tutti i paesi UE restituiscono ragione sociale e indirizzo nel VIES: alcuni confermano solo che il numero è attivo.

Funziona anche per la partita IVA italiana?

Sì, il VIES copre tutti gli Stati membri, Italia inclusa. Per un controllo puramente formale del formato italiano, senza interrogare l’archivio europeo, esiste anche il controllo dedicato al codice fiscale.

Cosa succede se il VIES è irraggiungibile?

Capita, soprattutto per certi paesi in certe fasce orarie: è un limite del sistema europeo. Lo strumento te lo segnala invece di darti un risultato inventato; riprova dopo qualche minuto.

Il numero che verifico resta privato?

La richiesta serve solo a interrogare il VIES al momento del controllo e non viene conservata sui nostri archivi.

Vale anche per operazioni extra-UE?

No, il VIES copre solo le partite IVA degli Stati membri dell’Unione. Per un fornitore extra-UE serve un altro tipo di verifica fiscale, gestita dal paese di origine.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/verify/vat

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/verify/vat \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/verify/vat", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/verify/vat",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/vat", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/vat", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "verify.vat",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →