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

# Introduction

> L'API de validation TVA Cleariflow offre des solutions complètes de conformité fiscale via une interface JSON RESTful moderne et rationalisée, permettant la validation et le calcul pour les opérations commerciales nationales et internationales.

## Premiers pas

<Card title="Endpoint de validation TVA" icon="tag" href="vat/validate">
  Vérifiez l'authenticité des numéros de TVA et récupérez des informations complètes sur l'entreprise, notamment le pays, le nom commercial, l'adresse et les détails d'enregistrement.
</Card>

<Card title="Endpoint de calcul TVA" icon="tags" href="vat/calculate">
  Calculez des prix conformes à la TVA en fonction des réglementations spécifiques à chaque pays, du type d'achat et de la valeur de la transaction pour des calculs financiers précis.
</Card>

<Card title="Endpoint des catégories TVA" icon="globe" href="vat/categories">
  Accédez aux taux de TVA actuels et aux catégories fiscales pour des pays spécifiques afin d'assurer la conformité aux réglementations fiscales locales.
</Card>

### Architecture REST

L'API de validation TVA suit les principes REST, en utilisant des URL prévisibles orientées ressources et des codes de statut HTTP standard pour une intégration fluide et la gestion des erreurs. Tous les endpoints de l'API doivent se terminer par une barre oblique (/) et ne prennent en charge que les requêtes GET.

### Sécurité HTTPS

Toutes les communications API sont sécurisées à l'aide de protocoles de chiffrement TLS 1.2 ou supérieur pour garantir l'intégrité et la confidentialité des données.

### Versionnage de l'API

L'API de validation TVA maintient la rétrocompatibilité par le versionnage, fonctionnant actuellement en version 1 avec des améliorations futures prévues.

### Authentification

Votre clé API sert d'identifiant exclusif pour accéder à l'API de validation TVA. Chaque service Cleariflow nécessite une clé unique, garantissant un accès sécurisé et isolé entre les différentes API. L'API applique une limitation de débit pour assurer une utilisation équitable entre tous les utilisateurs.

## Codes de réponse et d'erreur

Lorsque les requêtes échouent, l'API renvoie des réponses d'erreur JSON structurées avec des codes et descriptions spécifiques pour un dépannage efficace.

| Code | Type                  | Détails                                                                                                                                                          |
| ---- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200  | OK                    | Tout a fonctionné comme prévu.                                                                                                                                   |
| 400  | Bad request           | Mauvaise requête.                                                                                                                                                |
| 401  | Unauthorized          | La requête était inacceptable. Généralement due à une clé API manquante ou incorrecte.                                                                           |
| 422  | Quota reached         | La requête a été interrompue en raison de crédits API insuffisants. (Forfaits gratuits)                                                                          |
| 429  | Too many requests     | La requête a été interrompue car le nombre de requêtes autorisées par seconde a été atteint. Cela se produit sur les forfaits gratuits, limités à 1 par seconde. |
| 500  | Internal server error | La requête n'a pas pu être complétée en raison d'une erreur côté serveur.                                                                                        |
| 503  | Service unavailable   | Le serveur était indisponible.                                                                                                                                   |

## Codes pays

Voici la liste des pays pris en charge par les endpoints TVA

| Code pays | Nom du pays        |
| --------- | ------------------ |
| AT        | Autriche           |
| BE        | Belgique           |
| BG        | Bulgarie           |
| CY        | Chypre             |
| CZ        | République tchèque |
| DE        | Allemagne          |
| DK        | Danemark           |
| EE        | Estonie            |
| FI        | Finlande           |
| FR        | France             |
| GB        | Royaume-Uni        |
| GR        | Grèce              |
| HR        | Croatie            |
| HU        | Hongrie            |
| IE        | Irlande            |
| IT        | Italie             |
| LT        | Lituanie           |
| LU        | Luxembourg         |
| LV        | Lettonie           |
| MT        | Malte              |
| NL        | Pays-Bas           |
| PL        | Pologne            |
| PT        | Portugal           |
| RO        | Roumanie           |
| SE        | Suède              |
| SI        | Slovénie           |
| SK        | Slovaquie          |