Integrationsguide · Deutschland · Letzte Aktualisierung: Juli 2026

USt-ID prüfen per API — VIES Konsultationsnummer automatisch erfassen

Wenn Ihr Buchhaltungssystem, Ihr Onlineshop oder Ihre Rechnungssoftware EU-B2B-Rechnungen mit Nullsteuer ausstellt, müssen Sie die Umsatzsteuer-Identifikationsnummer (USt-IdNr.) des Käufers prüfen — und den Nachweis dieser Prüfung aufbewahren. Genau dort liegt die Lücke in den meisten Implementierungen.

Der VIES-Dienst gibt bei einer qualifizierten Abfrage eine Konsultationsnummer aus — einen offiziellen, zeitgestempelten Nachweis, den das Finanzamt bei der Umsatzsteuerprüfung als Beleg für steuerfreie Umsätze nach § 6a UStG / Art. 138 MwStSystRL akzeptiert. Ohne diese Nummer haben Sie bei einer Betriebsprüfung lediglich einen Screenshot — kein anerkanntes Dokument.

Was ist eine VIES-Konsultationsnummer?

Das VIES (VAT Information Exchange System) ist das offizielle EU-Validierungssystem für Umsatzsteuer-Identifikationsnummern. Wenn Sie eine USt-IdNr. mit Ihrer eigenen USt-IdNr. (dem „Anfragenden") abfragen, erstellt VIES eine Konsultationsnummer im Format WAPIAAAAW1234567.

Diese Nummer dokumentiert:

Welche USt-IdNr. geprüft wurde
Von wem (Ihre USt-IdNr. als Anfragender)
Wann genau die Prüfung stattfand
Dass das Ergebnis zum Prüfzeitpunkt „gültig" war

Die Finanzbehörden der EU-Mitgliedstaaten, darunter das Bundeszentralamt für Steuern (BZSt), erkennen diese Nummer als Nachweis für innergemeinschaftliche Lieferungen nach § 6a Abs. 1 UStG an.

Das Problem: Die meisten APIs liefern keine Konsultationsnummer

Handelsübliche VAT-Check-APIs — einschließlich vieler Integrationen in gängige Buchhaltungssoftware — fragen VIES im Hintergrund ab, geben aber nur true oder false zurück. Die Konsultationsnummer geht dabei verloren.

Das bedeutet: Sie wissen, dass eine USt-IdNr. irgendwann gültig war — können es aber nicht belegen. In einer Betriebsprüfung reicht das nicht.

Vatnode: USt-ID prüfen und Konsultationsnummer in einem API-Aufruf

Vatnode gibt bei jeder Anfrage die vollständige Konsultationsnummer zurück — bereit zur Speicherung in Ihrer Datenbank oder Ihrem Buchhaltungssystem:

cURL

curl -X POST https://vatnode.com/v1/validate \
  -H "x-api-key: vnd-ihr-schluessel" \
  -H "Content-Type: application/json" \
  -d '{"vat_number":"DE811907980","requester_vat":"DE123456789"}'

Antwort · JSON

{
  "valid": true,
  "vatNumber": "DE811907980",
  "countryCode": "DE",
  "consultationNumber": "WAPIAAAAW1234567",  ← der Prüfbeleg
  "name": "",  ← DE gibt Name/Adresse über VIES nicht frei
  "address": "",
  "requestDate": "2026-07-06+02:00",
  "timestamp": "2026-07-06T10:14:02.000Z"
}

Speichern Sie consultationNumber und timestamp direkt in Ihrem Rechnungsdatensatz — das ist Ihr rechtskonformer Nachweis.

Ehrlicher Hinweis: Deutschland (wie auch Spanien) gibt über VIES nur die Gültigkeit frei — Name und Adresse bleiben aus Datenschutzgründen leer. Das ist Politik des Mitgliedstaats, kein API-Fehler; Anbieter, die für deutsche USt-IdNrn. trotzdem Firmennamen anzeigen, nutzen zwischengespeicherte Fremddaten. Die Konsultationsnummer — der eigentliche Prüfbeleg — wird für deutsche Nummern immer ausgestellt. Für die meisten anderen Mitgliedstaaten (z. B. IE, NL, IT, PL, BE, FR) liefert die API Name und Adresse mit.

VIES ist oft nicht erreichbar — was dann?

VIES leidet regelmäßig unter länderspezifischen Ausfällen. Wenn die Datenbank des betreffenden Mitgliedstaats nicht erreichbar ist, gibt Vatnode einen klaren, wiederholbaren Fehler zurück statt eines irreführenden valid:false — damit Sie keinen echten Kunden fälschlich ablehnen:

JSON

{ "error": "vies_unavailable", "retryable": true }

Implementieren Sie ein kurzes Retry mit Backoff. Den Live-Status aller 27 Länder sehen Sie auf der VIES-Statusseite.

Anwendungsfall: Rechnungssoftware

JavaScript (Node.js)

// Bei Erstellung einer B2B-Rechnung an einen EU-Kunden
async function pruefenUndSpeichern(ustId, anfragender, rechnungId) {
  const res = await fetch('https://vatnode.com/v1/validate', {
    method: 'POST',
    headers: { 'x-api-key': 'vnd-ihr-schluessel', 'Content-Type': 'application/json' },
    body: JSON.stringify({ vat_number: ustId, requester_vat: anfragender })
  });
  const data = await res.json();
  if (data.error) throw new Error(data.error);      // z. B. vies_unavailable → Retry
  if (!data.valid) throw new Error('USt-IdNr. ungültig');

  await db.rechnungen.update(rechnungId, {
    ust_konsultationsnummer: data.consultationNumber,
    ust_geprueft_am: data.timestamp
  });
}

Rechtlicher Hintergrund: § 6a UStG

Nach § 6a Abs. 1 UStG ist eine innergemeinschaftliche Lieferung steuerfrei, wenn der Abnehmer ein Unternehmer ist und die Lieferung für sein Unternehmen bestimmt ist. Als Lieferer müssen Sie nachweisen, dass Sie die USt-IdNr. des Abnehmers zum Zeitpunkt der Lieferung überprüft haben.

Die Finanzverwaltung erkennt die VIES-Konsultationsnummer als geeigneten Beleg an (vgl. Abschn. 6a.4 UStAE). Eine einfache „gültig"-Meldung ohne Konsultationsnummer ist kein ausreichender Nachweis.

Abdeckung

Vatnode deckt alle 27 EU-Mitgliedstaaten über VIES ab — inklusive Konsultationsnummer und Anreicherung (Firmenname + Adresse, sofern von VIES geliefert). Zusätzlich validiert Vatnode Nicht-VIES-Länder über deren offizielle nationale Register — Norwegen bereits live, Schweiz folgt. Die vollständige Länderliste finden Sie in der API-Dokumentation.

Kostenlos testen

100 Prüfungen pro Monat kostenlos — keine Kreditkarte erforderlich. Early-Access-Preis für Gründungspartner gesichert.

Kein Spam. Preise für frühe Nutzer gesichert.