Zum Inhalt
API BCEAPI BCEAPI für belgische Unternehmensdaten
AnwendungsfällePreiseDokumentationSandboxAPI-Schlüssel
🇬🇧 English🇫🇷 Français🇳🇱 Nederlands🇩🇪 Deutsch🇪🇸 Español
API-Schlüssel
API BCE / Anwendungsfälle / Eine USt-Nummer (VIES) bei der Erfassung einer Rechnung prüfen

✅ Eine USt-Nummer (VIES) bei der Erfassung einer Rechnung prüfen

Eine falsch eingegebene oder nicht registrierte USt-Nummer auf einer innergemeinschaftlichen Rechnung bedeutet ein anfechtbares Reverse-Charge-Verfahren. Die Prüfung gehört zur Erfassung, nicht zum Abschluss.

Das Problem#

Wenn Sie einem Kunden aus einem anderen Mitgliedstaat im Reverse-Charge-Verfahren eine Rechnung stellen, müssen Sie sicherstellen, dass seine USt-Nummer gültig ist. Der europäische VIES-Dienst ermöglicht diese Prüfung, aber sie von Hand für jeden neuen Kunden durchzuführen und erneut, wenn ein Kunde seine Nummer ändert, ist die Art von Aufgabe, die vergessen wird.

Der richtige Zeitpunkt für die Prüfung ist die Erfassung: im Formular zum Anlegen des Kunden oder beim Vorbereiten der Rechnung. Eine ungültige Nummer wird dann sofort korrigiert, bevor die Rechnung hinausgeht.

Die API-Daten, die antworten#

  • GET /vat/{vatNumber}: Echtzeit-Validierung einer USt-Nummer der Europäischen Union beim VIES-Dienst der Europäischen Kommission.
  • Die Antwort gibt an, ob die Nummer gültig ist, das Land, die normalisierte Nummer, das Datum der Anfrage und, wenn der Mitgliedstaat sie mitteilt, Name und Adresse des Inhabers.
  • Die Eingabe ist tolerant: BE1033022383, BE 1.033.022.383 oder 1033022383 (standardmäßig Belgien) werden akzeptiert.
  • Für einen belgischen Kunden ergänzt GET /enterprise/{num} die Prüfung um den Registerdatensatz (Status, Rechtsform, Sitz).

Beispielanfrage#

curl https://companybelgium.be/api/v2/vat/BE1033022383 \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

Antwort für eine gültige Nummer:

{
  "success": true,
  "data": {
    "isValid": true,
    "countryCode": "BE",
    "vatNumber": "1033022383",
    "requestDate": "...",
    "name": "...",
    "address": "..."
  },
  "timestamp": "...",
  "meta": {
    "responseTime": "..."
  }
}

Empfohlene Umsetzung#

  • Rufen Sie die Validierung von Ihrem Server aus auf, sobald das USt-Feld ausgefüllt ist, und zeigen Sie das Ergebnis im Formular an.
  • Bieten Sie den von VIES gelieferten Namen und die Adresse als Eingabehilfe an, ohne zu überschreiben, was der Nutzer bereits eingegeben hat.
  • Speichern Sie das Datum der Anfrage mit dem Ergebnis: Es dokumentiert die zum Zeitpunkt der Rechnungsstellung durchgeführte Prüfung.
  • Blockieren Sie die Rechnung nicht, wenn VIES nicht antwortet: Markieren Sie die Prüfung als „zu wiederholen“ und versuchen Sie es später erneut.

Grenzen, die Sie kennen sollten#

  • VIES ist ein Dienst der Europäischen Kommission, der die nationalen Verwaltungen abfragt. Ist ein Mitgliedstaat nicht erreichbar, antwortet die API mit einem Fehler 502: Das ist keine ungültige Nummer.
  • Ein unlesbares Format liefert einen Fehler 400, ohne VIES abzufragen.
  • Manche Mitgliedstaaten teilen weder Name noch Adresse mit: Diese Felder bleiben dann leer, auch bei einer gültigen Nummer.
  • Eine in VIES gültige Nummer belegt die USt-Registrierung, nicht die Identität der bestellenden Person. Für eine Kontoeröffnung siehe den KYB-Fall.
  • Die Validierung ersetzt nicht Ihre eigene Analyse der umsatzsteuerlichen Behandlung des Umsatzes.

Häufige Fragen#

Welche Länder deckt die USt-Validierung ab?

Alle Mitgliedstaaten der Europäischen Union, da die Validierung über den VIES-Dienst der Europäischen Kommission läuft.

Was tun, wenn VIES nicht antwortet?

Die API liefert einen Fehler 502. Halten Sie die Rechnung bis zur Prüfung zurück oder versuchen Sie es später erneut; ein nicht erreichbarer Dienst bedeutet nicht, dass die Nummer ungültig ist.

Ist das Länderpräfix nötig?

Nicht für eine belgische Nummer: Ohne Präfix wird standardmäßig Belgien verwendet. Für andere Länder geben Sie das Präfix an (FR, NL, DE…).

In die Praxis umsetzen

Erstellen Sie einen Schlüssel im Entwicklerportal und folgen Sie dann der Referenzdokumentation für jeden genannten Endpunkt.

API-Schlüssel erhaltenDokumentation lesen

Referenzdokumentation

  • USt-Validierung

Weitere Anwendungsfälle

  • Kunden oder Lieferanten vor der Zusammenarbeit prüfen
  • Ein CRM automatisch aus der Unternehmensnummer anreichern
  • KYC/KYB bei der Eröffnung eines Geschäftskontos
  • Unternehmen per Webhook überwachen

Auf dieser Seite

Das ProblemDie API-Daten, die antwortenBeispielanfrageEmpfohlene UmsetzungGrenzen, die Sie kennen solltenHäufige FragenIn die Praxis umsetzen
API BCEAPI BCE

Ein Entwicklerprodukt von Espero-Soft Informatiques auf Basis offizieller BCE/KBO-Opendata.

Produkt

AnwendungsfälleWarum API BCEPreiseFAQ

Entwickler

DokumentationAPI-ReferenzAPI-PlaygroundÄnderungsprotokollAPI-Schlüssel

Unternehmen

Daten, Compliance und Peppol ↗Company Belgium ↗Espero-Soft ↗

Rechtliches

ImpressumAllgemeine Nutzungs- und VerkaufsbedingungenDatenschutzerklärungCookie-Richtlinie
© 2026 Espero-Soft Informatiques SRL · Alle Rechte vorbehalten.Hergestellt in Belgien 🇧🇪