Zum Hauptinhalt springen
GET
/
v1
/
calculate
VAT-Berechnungs-Endpunkt
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"
}

​
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

​
api_key
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.
​
amount
String
erforderlich
Der Betrag, für den der VAT-Betrag ermittelt oder von dem er abgeleitet werden soll.
​
country_code
String
erforderlich
Der zweistellige ISO-3166-1-alpha-2-Code des Landes, in dem die Transaktion stattfindet.
​
category
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.
​
is_vat_incl
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.
​
amount_excluding_vat
String
Der Betrag ohne VAT.
​
amount_including_vat
String
Die Summe aus Grundbetrag und VAT, d. h. amount_excluding_vat + vat_amount.
​
vat_amount
String
Der berechnete VAT-Betrag.
​
vat_category
String
Die Kategorie des Kaufs, anhand derer ermittelt wird, ob ein ermäßigter Satz gilt. Siehe unten für eine Liste unterstützter Kategorien.
​
vat_rate
String
Der VAT-Satz als Dezimalzeichenkette (z. B. „0.190” für 19 %).
​
country
Object
Objekt mit Länderinformationen.
​
country.code
String
Der zweistellige ISO-3166-1-alpha-2-Code des Landes, in dem die Transaktion stattfindet.
​
country.name
String
Der Name des Landes, für das die VAT berechnet wird.