Vai al contenuto principale
GET
/
v1
/
calculate
Endpoint di calcolo IVA
curl --request GET \
  --url https://vat.cleariflow.com/v1/calculate/
{
    "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"
}

​
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: 
{
    "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"
}

​
Parametri della richiesta

​
api_key
String
obbligatorio
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.
​
amount
String
obbligatorio
L’importo per cui desideri ottenere l’IVA o da cui estrarre l’IVA.
​
country_code
String
obbligatorio
Il codice ISO 3166-1 alpha-2 a due lettere del paese in cui avviene la transazione.
​
category
String
obbligatorio
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.
​
is_vat_incl
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.

​
Parametri della risposta

La risposta API viene restituita in un formato JSON universale e leggero.
​
amount_excluding_vat
String
L’importo al netto dell’IVA.
​
amount_including_vat
String
La somma dell’importo base e dell’IVA, cioè amount_excluding_vat + vat_amount.
​
vat_amount
String
L’importo di IVA calcolato.
​
vat_category
String
La categoria dell’acquisto, usata per determinare se si qualifica per un’aliquota ridotta. Vedi di seguito l’elenco delle categorie supportate.
​
vat_rate
String
L’aliquota IVA come stringa decimale (es. “0.190” per il 19%).
​
country
Object
Oggetto contenente le informazioni sul paese.
​
country.code
String
Il codice ISO 3166-1 alpha-2 a due lettere del paese in cui avviene la transazione.
​
country.name
String
Il nome del paese da cui viene calcolata l’IVA.