VAT-Berechnungs-Endpunkt

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

Erste Schritte

Basis-URL

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

Berechnungs-Endpunkt

Der calculate-Endpunkt benötigt Ihren eindeutigen API-Schlüssel, das Land und den zu prüfenden Betrag:

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

Diese erfolgreiche Anfrage liefert umfassende VAT-Berechnungsergebnisse einschließlich Sätzen, Beträgen und Länderinformationen:

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

Anfrageparameter

String

erforderlich

Ihr eindeutiger API-Schlüssel. Beachten Sie, dass jeder Nutzer für jede Cleariflow-API eigene API-Schlüssel hat — Ihr VAT-Validierungs-API-Schlüssel funktioniert z. B. nicht für die IP-Geolokalisierungs-API.

String

erforderlich

Der Betrag, für den der VAT-Betrag ermittelt oder von dem er abgeleitet werden soll.

String

erforderlich

Der zweistellige ISO-3166-1-alpha-2-Code des Landes, in dem die Transaktion stattfindet.

String

erforderlich

Die für die Berechnung zu verwendende VAT-Kategorie. Verwenden Sie „standard” für den Standardsatz oder spezifische Kategorien wie „e-books”, „audiobooks” usw. für ermäßigte Sätze.

Boolean

Wenn der Betrag bereits VAT enthält und Sie die Umkehrberechnung zur Aufteilung in Nettobetrag und VAT wünschen, setzen Sie diesen Parameter auf true. Wird er nicht explizit angegeben, ist der Standardwert false.

Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen JSON-Format zurückgegeben.

String

Der Betrag ohne VAT.

String

Die Summe aus Grundbetrag und VAT, d. h. amount_excluding_vat + vat_amount.

String

Der berechnete VAT-Betrag.

String

Die Kategorie des Kaufs, anhand derer ermittelt wird, ob ein ermäßigter Satz gilt. Siehe unten für eine Liste unterstützter Kategorien.

String

Der VAT-Satz als Dezimalzeichenkette (z. B. „0.190” für 19 %).

Object

Objekt mit Länderinformationen.

String

Der zweistellige ISO-3166-1-alpha-2-Code des Landes, in dem die Transaktion stattfindet.

String

Der Name des Landes, für das die VAT berechnet wird.

VAT-Berechnungs-Endpunkt

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

Validierung

Abfrage

Erstellung

Erste Schritte

Basis-URL

Berechnungs-Endpunkt

Anfrageparameter

Antwortparameter

​Erste Schritte

​Basis-URL

​Berechnungs-Endpunkt

​Anfrageparameter

​Antwortparameter

Erste Schritte

Basis-URL

Berechnungs-Endpunkt

Anfrageparameter

Antwortparameter