Endpoint di calcolo IVA

GET

calculate

curl --request GET \
  --url https://vat.cleariflow.com/v1/calculate/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://vat.cleariflow.com/v1/calculate/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://vat.cleariflow.com/v1/calculate/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://vat.cleariflow.com/v1/calculate/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
    "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

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.

String

obbligatorio

L’importo per cui desideri ottenere l’IVA o da cui estrarre l’IVA.

String

obbligatorio

Il codice ISO 3166-1 alpha-2 a due lettere del paese in cui avviene la transazione.

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.

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.

String

L’importo al netto dell’IVA.

String

La somma dell’importo base e dell’IVA, cioè amount_excluding_vat + vat_amount.

String

L’importo di IVA calcolato.

String

La categoria dell’acquisto, usata per determinare se si qualifica per un’aliquota ridotta. Vedi di seguito l’elenco delle categorie supportate.

String

L’aliquota IVA come stringa decimale (es. “0.190” per il 19%).

Object

Oggetto contenente le informazioni sul paese.

String

Il codice ISO 3166-1 alpha-2 a due lettere del paese in cui avviene la transazione.

String

Il nome del paese da cui viene calcolata l’IVA.

Endpoint di calcolo IVA

curl --request GET \
  --url https://vat.cleariflow.com/v1/calculate/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://vat.cleariflow.com/v1/calculate/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://vat.cleariflow.com/v1/calculate/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://vat.cleariflow.com/v1/calculate/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

Validazione

Lookup

Creazione

Per iniziare

URL di base

Endpoint di calcolo

Parametri della richiesta

Parametri della risposta

​Per iniziare

​URL di base

​Endpoint di calcolo

​Parametri della richiesta

​Parametri della risposta

Per iniziare

URL di base

Endpoint di calcolo

Parametri della richiesta

Parametri della risposta