> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Einführung

> Die Cleariflow VAT-Validierungs-API bietet umfassende Steuer-Compliance-Lösungen über eine schlanke, moderne RESTful JSON-Schnittstelle — für nahtlose Validierung und Berechnung im Inlands- und Auslandsgeschäft.

## Erste Schritte

<Card title="VAT-Validierungs-Endpunkt" icon="tag" href="vat/validate">
  Prüfen Sie die Echtheit von VAT-Nummern und erhalten Sie umfassende Unternehmensinformationen einschließlich Land, Firmenname, Adresse und Registrierungsdetails.
</Card>

<Card title="VAT-Berechnungs-Endpunkt" icon="tags" href="vat/calculate">
  Berechnen Sie VAT-konforme Preise auf Basis länderspezifischer Vorschriften, Kaufart und Transaktionswert für präzise Finanzberechnungen.
</Card>

<Card title="VAT-Kategorien-Endpunkt" icon="globe" href="vat/categories">
  Greifen Sie auf aktuelle VAT-Sätze und Steuerkategorien für bestimmte Länder zu, um die Einhaltung lokaler Steuervorschriften sicherzustellen.
</Card>

### 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        |