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

# Endpoint di calcolo IVA

> L'endpoint `calculate` consente un calcolo preciso dell'IVA per prezzi conformi, tenendo conto delle normative specifiche per paese, degli importi delle transazioni e delle categorie di prodotto opzionali per calcoli fiscali accurati.

## Per iniziare

### URL di base

```
https://vat.cleariflow.com/v1/calculate/
```

### Endpoint di calcolo

L'endpoint `calculate` richiede la tua chiave API univoca, il paese e il prezzo da verificare:

```
https://vat.cleariflow.com/v1/calculate/
? api_key = YOUR_UNIQUE_API_KEY
& amount = 175  
& country_code = DE
& category = standard
```

Questa richiesta riuscita restituisce risultati completi del calcolo IVA inclusi aliquote, importi e informazioni sul paese:

<ResponseExample>
  ```json theme={"system"}
  {
      "amount_excluding_vat": "175.00",
      "amount_including_vat": "208.25",
      "country": {
          "code": "DE",
          "name": "Germany"
      },
      "vat_amount": "33.25",
      "vat_category": "standard",
      "vat_rate": "0.190"
  }
  ```
</ResponseExample>

### Parametri della richiesta

<ParamField query="api_key" type="String" required>
  La tua chiave API univoca. Nota che ogni utente ha chiavi API univoche per ciascuna delle API Cleariflow, quindi la chiave dell'API di validazione IVA non funzionerà per l'API di geolocalizzazione IP, ad esempio.
</ParamField>

<ParamField query="amount" type="String" required>
  L'importo per cui desideri ottenere l'IVA o da cui estrarre l'IVA.
</ParamField>

<ParamField query="country_code" type="String" required>
  Il codice ISO 3166-1 alpha-2 a due lettere del paese in cui avviene la transazione.
</ParamField>

<ParamField query="category" type="String" required>
  La categoria IVA da usare per il calcolo. Usa "standard" per l'aliquota IVA standard, o categorie specifiche come "e-books", "audiobooks", ecc. per aliquote ridotte.
</ParamField>

<ParamField query="is_vat_incl" type="Boolean">
  Se l'importo include già l'IVA e desideri eseguire il calcolo inverso separando importo e IVA, imposta questo parametro su true. Se non è esplicitamente incluso, il valore predefinito è false.
</ParamField>

### Parametri della risposta

La risposta API viene restituita in un [formato JSON](https://www.json.org/json-en.html) universale e leggero.

<ResponseField name="amount_excluding_vat" type="String">
  L'importo al netto dell'IVA.
</ResponseField>

<ResponseField name="amount_including_vat" type="String">
  La somma dell'importo base e dell'IVA, cioè `amount_excluding_vat` + `vat_amount`.
</ResponseField>

<ResponseField name="vat_amount" type="String">
  L'importo di IVA calcolato.
</ResponseField>

<ResponseField name="vat_category" type="String">
  La categoria dell'acquisto, usata per determinare se si qualifica per un'aliquota ridotta. Vedi di seguito l'elenco delle categorie supportate.
</ResponseField>

<ResponseField name="vat_rate" type="String">
  L'aliquota IVA come stringa decimale (es. "0.190" per il 19%).
</ResponseField>

<ResponseField name="country" type="Object">
  Oggetto contenente le informazioni sul paese.
</ResponseField>

<ResponseField name="country.code" type="String">
  Il codice ISO 3166-1 alpha-2 a due lettere del paese in cui avviene la transazione.
</ResponseField>

<ResponseField name="country.name" type="String">
  Il nome del paese da cui viene calcolata l'IVA.
</ResponseField>