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

# Вступ

> API перевірки VAT Cleariflow надає комплексні рішення для податкової відповідності через сучасний RESTful JSON-інтерфейс — для безперебійної перевірки та розрахунку внутрішніх і міжнародних операцій.

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

<Card title="Ендпоінт перевірки VAT" icon="tag" href="vat/validate">
  Перевіряйте автентичність номера VAT і отримуйте повну інформацію про компанію, включаючи країну, назву, адресу та реєстраційні дані.
</Card>

<Card title="Ендпоінт розрахунку VAT" icon="tags" href="vat/calculate">
  Розраховуйте ціни з урахуванням VAT відповідно до національних правил, типу покупки та суми транзакції для точних фінансових розрахунків.
</Card>

<Card title="Ендпоінт категорій VAT" icon="globe" href="vat/categories">
  Отримуйте актуальні ставки VAT і податкові категорії для конкретних країн, щоб дотримуватися місцевих податкових правил.
</Card>

### REST-архітектура

API перевірки VAT дотримується принципів REST, використовуючи передбачувані URL, орієнтовані на ресурси, та стандартні HTTP-коди статусу для безперебійної інтеграції та обробки помилок. Усі ендпоінти API мають закінчуватися скісною рискою (/) і підтримують лише GET-запити.

### Безпека HTTPS

Усі API-з'єднання захищені протоколами шифрування TLS 1.2 або вище для забезпечення цілісності та конфіденційності даних.

### Версіонування API

API перевірки VAT підтримує зворотну сумісність через версіонування, наразі працює у версії 1 з запланованими майбутніми покращеннями.

### Автентифікація

API-ключ є єдиним обліковим даним для доступу до API перевірки VAT. Кожен сервіс Cleariflow потребує унікального ключа, що забезпечує безпечний та ізольований доступ між різними API. API застосовує обмеження частоти запитів для справедливого використання всіма користувачами.

## Коди відповідей і помилок

Якщо запити не вдаються, API повертає структуровані JSON-відповіді з помилками, що містять конкретні коди та описи для ефективного усунення несправностей.

| Code | Type                  | Details                                                                                                           |
| ---- | --------------------- | ----------------------------------------------------------------------------------------------------------------- |
| 200  | OK                    | Усе працювало як очікувалося.                                                                                     |
| 400  | Bad request           | Некоректний запит.                                                                                                |
| 401  | Unauthorized          | Запит неприйнятний. Зазвичай через відсутній або неправильний API-ключ.                                           |
| 422  | Quota reached         | Запит перервано через недостатню кількість API-кредитів. (Безкоштовні тарифи)                                     |
| 429  | Too many requests     | Запит перервано через досягнення ліміту запитів на секунду. На безкоштовних тарифах запити обмежені 1 на секунду. |
| 500  | Internal server error | Запит не може бути виконаний через помилку на сервері.                                                            |
| 503  | Service unavailable   | Сервер був недоступний.                                                                                           |

## Коди країн

Нижче наведено список країн, підтримуваних ендпоінтами VAT

| Country code | Country name    |
| ------------ | --------------- |
| AT           | Австрія         |
| BE           | Бельгія         |
| BG           | Болгарія        |
| CY           | Кіпр            |
| CZ           | Чехія           |
| DE           | Німеччина       |
| DK           | Данія           |
| EE           | Естонія         |
| FI           | Фінляндія       |
| FR           | Франція         |
| GB           | Велика Британія |
| GR           | Греція          |
| HR           | Хорватія        |
| HU           | Угорщина        |
| IE           | Ірландія        |
| IT           | Італія          |
| LT           | Литва           |
| LU           | Люксембург      |
| LV           | Латвія          |
| MT           | Мальта          |
| NL           | Нідерланди      |
| PL           | Польща          |
| PT           | Португалія      |
| RO           | Румунія         |
| SE           | Швеція          |
| SI           | Словенія        |
| SK           | Словаччина      |