Validazione IVA per le aziende SaaS europee
Se vendi software alle aziende nell'UE, devi validare i loro numeri IVA. Sbagliare significa addebitare l'IVA quando non dovresti (perdendo competitività) o non addebitar la quando dovresti (responsabilità fiscale). L'API di validazione IVA di Veille (GET /v1/vat) si connette direttamente al database VIES e restituisce il risultato in millisecondi.
Cosa restituisce l'API
Per qualsiasi numero IVA UE, ottieni: valid (booleano), il vat_number normalizzato, country_code, company_name e company_address. L'API gestisce automaticamente la normalizzazione del formato - con o senza prefisso paese, con o senza spazi.
Integrazione rapida
Python
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.veille.io/v1"
response = requests.get(
f"{BASE_URL}/vat",
params={"query": "FR40303265045"},
headers={"x-api-key": API_KEY},
)
data = response.json()
if data["valid"]:
print(f"{data['company_name']} - reverse charge applies")
else:
print("Invalid VAT number - charge local VAT rate")
TypeScript
const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.veille.io/v1";
const headers = { "x-api-key": API_KEY };
const response = await fetch(
`${BASE_URL}/vat?query=FR40303265045`,
{ headers }
);
const data = await response.json();
if (data.valid) {
console.log(`${data.company_name} - reverse charge applies`);
} else {
console.log("Invalid VAT number - charge local VAT rate");
}
Campi principali della risposta
valid- indica se il numero IVA è attualmente attivo nel VIESvat_number- formato normalizzato (es.FR40303265045)country_code- codice paese a due letterecompany_name- ragione sociale registratacompany_address- indirizzo ufficiale registrato
5 casi d'uso
- Flusso di checkout - valida il numero IVA in tempo reale prima di applicare il meccanismo dell'inversione contabile sulle fatture B2B.
- Automazione delle fatture - compila automaticamente la ragione sociale e l'indirizzo dalla risposta dell'API per ridurre l'inserimento manuale dei dati.
- Onboarding fornitori - verifica che il numero IVA di un nuovo fornitore sia attivo prima di firmare un contratto.
- Audit di conformità fiscale - valida in batch il tuo database clienti esistente per segnalare numeri IVA scaduti o non validi.
- Prezzi multi-paese - usa il
country_codeper determinare l'aliquota IVA corretta per i clienti B2C nei diversi stati membri UE.
Articoli correlati
- Validazione IBAN: più di un semplice checksum - validare i conti bancari insieme ai numeri IVA per un onboarding B2B completo
- Costruire una pipeline di rilevamento frodi - combinare segnali di pagamento, email e IP per una prevenzione completa delle frodi
- Usare l'API Veille in un'azienda autonoma Paperclip - validazione IVA e IBAN integrata in un agente di fatturazione autonomo Paperclip