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

> Ендпоінт `calculate` забезпечує точний розрахунок VAT для відповідного ціноутворення з урахуванням національних правил, сум транзакцій і необов'язкових категорій товарів.

## Початок роботи

### Базовий URL

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

### Ендпоінт розрахунку

Ендпоінт `calculate` потребує вашого унікального API-ключа, країни та ціни, яку потрібно перевірити:

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

Цей успішний запит повертає повні результати розрахунку VAT, включаючи ставки, суми та інформацію про країну:

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

### Параметри запиту

<ParamField query="api_key" type="String" required>
  Ваш унікальний API-ключ. Зверніть увагу: у кожного користувача є унікальні API-ключі для кожного API Cleariflow, тому ключ API перевірки VAT не працюватиме для API геолокації IP, наприклад.
</ParamField>

<ParamField query="amount" type="String" required>
  Сума, для якої потрібно розрахувати VAT або з якої його виділити.
</ParamField>

<ParamField query="country_code" type="String" required>
  Дволітерний ISO 3166-1 alpha-2 код країни, в якій відбувається транзакція.
</ParamField>

<ParamField query="category" type="String" required>
  Категорія VAT для розрахунку. Використовуйте «standard» для стандартної ставки VAT або конкретні категорії, як-от «e-books», «audiobooks» тощо, для знижених ставок.
</ParamField>

<ParamField query="is_vat_incl" type="Boolean">
  Якщо сума вже містить VAT і потрібно виконати зворотний розрахунок, розділивши суму та VAT, встановіть цей параметр у true. Якщо параметр явно не вказано, за замовчуванням буде false.
</ParamField>

### Параметри відповіді

Відповідь API повертається у універсальному та легкому форматі [JSON](https://www.json.org/json-en.html).

<ResponseField name="amount_excluding_vat" type="String">
  Сума без VAT.
</ResponseField>

<ResponseField name="amount_including_vat" type="String">
  Сума базової величини та VAT, тобто `amount_excluding_vat` + `vat_amount`.
</ResponseField>

<ResponseField name="vat_amount" type="String">
  Розрахована сума VAT.
</ResponseField>

<ResponseField name="vat_category" type="String">
  Категорія покупки, що використовується для визначення права на знижену ставку. Див. нижче список підтримуваних категорій.
</ResponseField>

<ResponseField name="vat_rate" type="String">
  Ставка VAT у вигляді десяткового рядка (наприклад, «0.190» для 19%).
</ResponseField>

<ResponseField name="country" type="Object">
  Об'єкт із інформацією про країну.
</ResponseField>

<ResponseField name="country.code" type="String">
  Дволітерний ISO 3166-1 alpha-2 код країни, в якій відбувається транзакція.
</ResponseField>

<ResponseField name="country.name" type="String">
  Назва країни, для якої розраховується VAT.
</ResponseField>