Torna al blog
Prodotto

Validazione IVA per le aziende SaaS europee

Josselin Liebe
Josselin Liebe

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 VIES
  • vat_number - formato normalizzato (es. FR40303265045)
  • country_code - codice paese a due lettere
  • company_name - ragione sociale registrata
  • company_address - indirizzo ufficiale registrato

5 casi d'uso

  1. Flusso di checkout - valida il numero IVA in tempo reale prima di applicare il meccanismo dell'inversione contabile sulle fatture B2B.
  2. Automazione delle fatture - compila automaticamente la ragione sociale e l'indirizzo dalla risposta dell'API per ridurre l'inserimento manuale dei dati.
  3. Onboarding fornitori - verifica che il numero IVA di un nuovo fornitore sia attivo prima di firmare un contratto.
  4. Audit di conformità fiscale - valida in batch il tuo database clienti esistente per segnalare numeri IVA scaduti o non validi.
  5. Prezzi multi-paese - usa il country_code per determinare l'aliquota IVA corretta per i clienti B2C nei diversi stati membri UE.

Articoli correlati