Erste Schritte
VAT-Validierungs-Endpunkt
Prüfen Sie die Echtheit von VAT-Nummern und erhalten Sie umfassende Unternehmensinformationen einschließlich Land, Firmenname, Adresse und Registrierungsdetails.
VAT-Berechnungs-Endpunkt
Berechnen Sie VAT-konforme Preise auf Basis länderspezifischer Vorschriften, Kaufart und Transaktionswert für präzise Finanzberechnungen.
VAT-Kategorien-Endpunkt
Greifen Sie auf aktuelle VAT-Sätze und Steuerkategorien für bestimmte Länder zu, um die Einhaltung lokaler Steuervorschriften sicherzustellen.
REST-Architektur
Die VAT-Validierungs-API folgt REST-Prinzipien mit vorhersehbaren, ressourcenorientierten URLs und standardmäßigen HTTP-Statuscodes für nahtlose Integration und Fehlerbehandlung. Alle API-Endpunkte müssen mit einem nachgestellten Schrägstrich (/) enden und unterstützen nur GET-Anfragen.HTTPS-Sicherheit
Alle API-Kommunikation wird mit TLS 1.2 oder höher verschlüsselt, um Datenintegrität und Datenschutz zu gewährleisten.API-Versionierung
Die VAT-Validierungs-API bleibt durch Versionierung abwärtskompatibel und befindet sich derzeit in Version 1 mit geplanten zukünftigen Erweiterungen.Authentifizierung
Ihr API-Schlüssel ist die ausschließliche Berechtigung für den Zugriff auf die VAT-Validierungs-API. Jeder Cleariflow-Dienst erfordert einen eigenen Schlüssel für sicheren und isolierten Zugriff. Die API implementiert Ratenbegrenzung für faire Nutzung.Antwort- und Fehlercodes
Bei fehlgeschlagenen Anfragen liefert die API strukturierte JSON-Fehlerantworten mit spezifischen Codes und Beschreibungen zur effektiven Fehlerbehebung.| Code | Typ | Beschreibung |
|---|---|---|
| 200 | OK | Alles funktionierte wie erwartet. |
| 400 | Bad request | Fehlerhafte Anfrage. |
| 401 | Unauthorized | Die Anfrage war nicht zulässig — in der Regel fehlt der API-Schlüssel oder er ist ungültig. |
| 422 | Quota reached | Die Anfrage wurde abgebrochen, da nicht genügend API-Guthaben vorhanden ist (kostenlose Tarife). |
| 429 | Too many requests | Das Anfragenlimit pro Sekunde wurde erreicht. Bei kostenlosen Tarifen gilt ein Limit von 1 Anfrage pro Sekunde. |
| 500 | Internal server error | Die Anfrage konnte aufgrund eines Serverfehlers nicht abgeschlossen werden. |
| 503 | Service unavailable | Der Server war nicht verfügbar. |
Ländercodes
Nachfolgend die von den VAT-Endpunkten unterstützten Länder:| Ländercode | Ländername |
|---|---|
| AT | Austria |
| BE | Belgium |
| BG | Bulgaria |
| CY | Cyprus |
| CZ | Czech Republic |
| DE | Germany |
| DK | Denmark |
| EE | Estonia |
| FI | Finland |
| FR | France |
| GB | United Kingdom |
| GR | Greece |
| HR | Croatia |
| HU | Hungary |
| IE | Ireland |
| IT | Italy |
| LT | Lithuania |
| LU | Luxembourg |
| LV | Latvia |
| MT | Malta |
| NL | The Netherlands |
| PL | Poland |
| PT | Portugal |
| RO | Romania |
| SE | Sweden |
| SI | Slovenia |
| SK | Slovakia |