USt-ID-Validierung für europäische SaaS-Unternehmen

Wenn Sie Software an Unternehmen in der EU verkaufen, müssen Sie deren Umsatzsteuer-Identifikationsnummern validieren. Fehler dabei bedeuten entweder, Mehrwertsteuer zu berechnen, wenn Sie es nicht sollten (Wettbewerbsnachteil), oder keine Mehrwertsteuer zu berechnen, wenn Sie es sollten (Steuerverbindlichkeit). Die Veille USt-Validierungs-API (GET /v1/vat) verbindet sich direkt mit der VIES-Datenbank und gibt das Ergebnis in Millisekunden zurück.

Was die API zurückgibt

Für jede EU-USt-ID erhalten Sie: valid (Boolean), die normalisierte vat_number, country_code, company_name und company_address. Die API übernimmt die Format-Normalisierung automatisch - mit oder ohne Länderpräfix, mit oder ohne Leerzeichen.

Schnelle Integration

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");
}

Wichtige Antwortfelder

• valid - ob die USt-ID derzeit in VIES aktiv ist
• vat_number - normalisiertes Format (z. B. FR40303265045)
• country_code - zweistelliger Ländercode
• company_name - eingetragener Unternehmensname
• company_address - offizielle eingetragene Adresse

5 Anwendungsfälle

1. Checkout-Ablauf - Die USt-ID in Echtzeit validieren, bevor der Reverse-Charge-Mechanismus auf B2B-Rechnungen angewendet wird.
2. Rechnungsautomatisierung - Unternehmensnamen und -adresse automatisch aus der API-Antwort befüllen, um manuelle Dateneingabe zu reduzieren.
3. Lieferanten-Onboarding - Prüfen, ob die USt-ID eines neuen Lieferanten aktiv ist, bevor ein Vertrag unterzeichnet wird.
4. Steuerkonformitätsprüfung - Ihre bestehende Kundendatenbank stapelweise validieren, um abgelaufene oder ungültige USt-IDs zu markieren.
5. Länderübergreifende Preisgestaltung - Den country_code verwenden, um den korrekten Mehrwertsteuersatz für B2C-Kunden in verschiedenen EU-Mitgliedstaaten zu bestimmen.

Verwandte Artikel

• IBAN-Validierung: Mehr als nur eine Prüfsumme - Bankkonten neben Mehrwertsteuernummern validieren für ein vollständiges B2B-Onboarding
• Aufbau einer Betrugserkennungs-Pipeline - Zahlungs-, E-Mail- und IP-Signale für umfassende Betrugsprävention kombinieren
• Die Veille API in einem autonomen Paperclip-Unternehmen nutzen - MwSt- und IBAN-Validierung in einem autonomen Paperclip-Abrechnungsagenten