Premiers pas
Endpoint de validation TVA
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.
Endpoint de calcul TVA
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.
Endpoint des catégories TVA
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.
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 |