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

# Introduzione

> L'API di validazione IVA di Cleariflow offre soluzioni complete per la conformità fiscale tramite un'interfaccia RESTful JSON snella e moderna, consentendo validazione e calcolo senza interruzioni per operazioni commerciali nazionali e internazionali.

## Per iniziare

<Card title="Endpoint di validazione IVA" icon="tag" href="vat/validate">
  Verifica l'autenticità delle partite IVA e recupera informazioni aziendali complete inclusi paese, ragione sociale, indirizzo e dettagli di registrazione.
</Card>

<Card title="Endpoint di calcolo IVA" icon="tags" href="vat/calculate">
  Calcola prezzi conformi all'IVA in base alle normative specifiche per paese, al tipo di acquisto e al valore della transazione per calcoli finanziari accurati.
</Card>

<Card title="Endpoint categorie IVA" icon="globe" href="vat/categories">
  Accedi alle aliquote IVA attuali e alle categorie fiscali per paesi specifici per garantire la conformità alle normative fiscali locali.
</Card>

### Architettura REST

L'API di validazione IVA segue i principi REST, utilizzando URL prevedibili e orientati alle risorse e codici di stato HTTP standard per un'integrazione fluida e una gestione degli errori efficace. Tutti gli endpoint API devono terminare con una barra finale (/) e supportano solo richieste GET.

### Sicurezza HTTPS

Tutte le comunicazioni API sono protette con protocolli di crittografia TLS 1.2 o superiore per garantire integrità e privacy dei dati.

### Versionamento API

L'API di validazione IVA mantiene la retrocompatibilità tramite il versionamento, operando attualmente sulla versione 1 con miglioramenti futuri pianificati.

### Autenticazione

La tua chiave API funge da credenziale esclusiva per accedere all'API di validazione IVA. Ogni servizio Cleariflow richiede una chiave univoca, garantendo accesso sicuro e isolato tra le diverse API. L'API implementa limiti di frequenza per garantire un uso equo tra tutti gli utenti.

## Codici di risposta ed errore

Quando le richieste falliscono, l'API restituisce risposte di errore JSON strutturate con codici e descrizioni specifici per una risoluzione efficace dei problemi.

| Code | Type                  | Details                                                                                                                                                                             |
| ---- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200  | OK                    | Tutto ha funzionato come previsto.                                                                                                                                                  |
| 400  | Bad request           | Richiesta non valida.                                                                                                                                                               |
| 401  | Unauthorized          | La richiesta non è stata accettata. Di solito a causa di una chiave API mancante o errata.                                                                                          |
| 422  | Quota reached         | La richiesta è stata interrotta per crediti API insufficienti. (Piani gratuiti)                                                                                                     |
| 429  | Too many requests     | La richiesta è stata interrotta perché è stato raggiunto il numero di richieste consentite al secondo. Succede sui piani gratuiti poiché le richieste sono limitate a 1 al secondo. |
| 500  | Internal server error | La richiesta non è stata completata a causa di un errore lato server.                                                                                                               |
| 503  | Service unavailable   | Il server non era disponibile.                                                                                                                                                      |

## Codici paese

Di seguito l'elenco dei paesi supportati dagli endpoint IVA

| Country code | Country name    |
| ------------ | --------------- |
| 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        |