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

# VAT-Berechnungs-Endpunkt

> Der `calculate`-Endpunkt ermöglicht präzise VAT-Berechnungen für konforme Preisgestaltung unter Berücksichtigung länderspezifischer Vorschriften, Transaktionsbeträge und optionaler Produktkategorien.

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

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

### Anfrageparameter

<ParamField query="api_key" type="String" required>
  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.
</ParamField>

<ParamField query="amount" type="String" required>
  Der Betrag, für den der VAT-Betrag ermittelt oder von dem er abgeleitet werden soll.
</ParamField>

<ParamField query="country_code" type="String" required>
  Der zweistellige ISO-3166-1-alpha-2-Code des Landes, in dem die Transaktion stattfindet.
</ParamField>

<ParamField query="category" type="String" required>
  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.
</ParamField>

<ParamField query="is_vat_incl" type="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`.
</ParamField>

### Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen [JSON-Format](https://www.json.org/json-en.html) zurückgegeben.

<ResponseField name="amount_excluding_vat" type="String">
  Der Betrag ohne VAT.
</ResponseField>

<ResponseField name="amount_including_vat" type="String">
  Die Summe aus Grundbetrag und VAT, d. h. `amount_excluding_vat` + `vat_amount`.
</ResponseField>

<ResponseField name="vat_amount" type="String">
  Der berechnete VAT-Betrag.
</ResponseField>

<ResponseField name="vat_category" type="String">
  Die Kategorie des Kaufs, anhand derer ermittelt wird, ob ein ermäßigter Satz gilt. Siehe unten für eine Liste unterstützter Kategorien.
</ResponseField>

<ResponseField name="vat_rate" type="String">
  Der VAT-Satz als Dezimalzeichenkette (z. B. „0.190" für 19 %).
</ResponseField>

<ResponseField name="country" type="Object">
  Objekt mit Länderinformationen.
</ResponseField>

<ResponseField name="country.code" type="String">
  Der zweistellige ISO-3166-1-alpha-2-Code des Landes, in dem die Transaktion stattfindet.
</ResponseField>

<ResponseField name="country.name" type="String">
  Der Name des Landes, für das die VAT berechnet wird.
</ResponseField>