API zur Validierung der Umsatzsteuer-Identifikationsnummer: Überprüfen Sie EU-Steuer-IDs in einem POST

Sie verkaufen Software an Unternehmen in Europa. Nach dem EU-Steuerrecht müssen Sie die Mehrwertsteuer des Käufers bestätigen ID vor Anwendung der Umkehrung der Steuerschuldnerschaft (0 % Mehrwertsteuer). Der offizielle VIES-Dienst weist eine unzuverlässige Betriebszeit auf und gibt SOAP XML zurück. Sie benötigen eine schnellere, RESTful-Alternative.

Die Botoi /v1/validate/vat Endpoint validiert Umsatzsteuer-Identifikationsnummern für alle 27 EU-Mitgliedstaaten Staaten und Großbritannien. Senden Sie einen POST und erhalten Sie eine JSON-Antwort mit Gültigkeit, Ländercode und dem formatierte Zahl. Kein XML-Parsing. Keine WSDL-Dateien. Keine Auszeiten durch überlastete Behörden Server.

Der API-Aufruf

Senden Sie eine Umsatzsteuer-Identifikationsnummer mit dem aus zwei Buchstaben bestehenden Länderpräfix:

Antwort:

Der valid Feld ist true wenn die Zahl dem erwarteten Format entspricht für sein Land. Der country_code Und country Felder sagen es dir zu welcher Gerichtsbarkeit die Nummer gehört.

Wenn eine Nummer die Validierung nicht besteht

Wenn die Zahl nicht dem erwarteten Muster entspricht, valid kommt zurück false. Die Antwort enthält weiterhin das erkannte Land:

Deutsche Umsatzsteuer-Identifikationsnummern erfordern genau 9 Ziffern nach dem DE Präfix. Dieser hat 5. Ihr Frontend kann den Ländernamen und das erwartete Format anzeigen, um dem Benutzer bei der Korrektur zu helfen Eingabe.

Stripe-Checkout-Integration

Überprüfen Sie vor dem Erstellen einer Stripe-Checkout-Sitzung die Umsatzsteuer-Identifikationsnummer des Käufers. Wenn es gültig ist, legen Sie es fest der Kunde zu tax_exempt: "reverse" Daher berechnet Stripe 0 % Mehrwertsteuer. Wenn ja ungültig ist, lehnen Sie das Formular ab und bitten Sie den Käufer, es zu korrigieren.

Dies verhindert zwei häufige Probleme: die Erhebung der Mehrwertsteuer an ein Unternehmen, das steuerbefreit sein sollte (was Kopfschmerzen bei der Erstattung verursacht) und die Gewährung einer Steuerbefreiung für jemanden mit einer gefälschten Umsatzsteuer-Identifikationsnummer (was zu einem Prüfungsproblem führt).

Rechnungserstellung mit bedingter Mehrwertsteuer

Beim Erstellen einer Rechnung müssen Sie den Mehrwertsteuersatz festlegen. Die Regeln:

• B2B-Verkauf im selben Land: Berechnen Sie Ihren inländischen Mehrwertsteuersatz.
• Grenzüberschreitender B2B-Verkauf mit gültiger Umsatzsteuer-Identifikationsnummer: Umkehrung der Steuerschuldnerschaft (0 %).
• Ungültige oder fehlende Umsatzsteuer-ID: Berechnen Sie den lokalen Tarif des Käufers.

Der country_code aus der API-Antwort steuert diese Logik:

Validierung des SaaS-B2B-Anmeldeformulars

Fügen Sie Ihrem Anmeldeformular ein Feld mit der Umsatzsteuer-Identifikationsnummer hinzu und validieren Sie es beim Absenden. Wenn gültig, füllen Sie das Feld automatisch aus Länder-Dropdown. Wenn es ungültig ist, wird eine Fehlermeldung angezeigt, bevor das Formular Ihr Backend erreicht.

Dadurch werden fehlerhafte Daten aus Ihrem Abrechnungssystem ferngehalten. Es erspart Ihrem Finanzteam außerdem die manuelle Arbeit Überprüfung der Umsatzsteuer-Identifikationsnummer, nachdem sich der Kunde bereits registriert und mit der Nutzung des Produkts begonnen hat.

Mehrwertsteuerformat nach Land

Jedes EU-Land hat ein anderes Format für Umsatzsteuer-Identifikationsnummern. Die API validiert gegen all diese Muster:

Die vollständige Liste umfasst alle 27 EU-Mitgliedstaaten sowie das Vereinigte Königreich. Die Formate reichen von 8 Ziffern (Dänemark, Luxemburg) bis 12 Ziffern (Schweden). In einigen Ländern sind Buchstaben im Hauptteil enthalten Nummer (Frankreich, Spanien, Irland).

Formatvalidierung vs. VIES-Suche

Diese API validiert die Struktur einer Umsatzsteuer-Identifikationsnummer. Es bestätigt das Präfix, die Länge, und Zeichenmuster den Regeln dieses Landes entsprechen. Sie stellt die der EU-Kommission nicht in Frage VIES-Datenbank zur Bestätigung, dass die Nummer aktiv registriert ist.

Für die meisten Checkout-Abläufe ist die Formatvalidierung der richtige erste Schritt. Es erkennt fehlende Tippfehler Präfixe und erfundene Nummern sofort, ohne auf einen externen Dienst angewiesen zu sein häufig nach unten. Wenn Sie auch den Registrierungsstatus benötigen, rufen Sie VIES an, nachdem die Formatprüfung erfolgreich war. Dieser zweistufige Ansatz reduziert VIES-Aufrufe um 15–30 % (alle ungültigen Formate treffen nie auf). langsamer Service).

Wichtige Punkte

Das kostenlose Kontingent deckt die Entwicklung und die Nutzung in Kleinserien ab. Für stark frequentierte Kassen Flows, fügen Sie Ihren API-Schlüssel hinzu Authorization: Bearer Kopfzeile. Überprüfen Sie die API-Dokumente für die vollständige Endpunktreferenz und die interaktiver Spielplatz um Umsatzsteuer-Identifikationsnummern in Ihrem Browser zu testen.