> ## 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-коды статуса для интеграции и обработки ошибок. Все эндпоинты должны заканчиваться слэшем (/) и поддерживают только GET-запросы.

### Безопасность HTTPS

Все соединения с API защищены TLS 1.2 или выше для целостности и конфиденциальности данных.

### Версионирование API

API проверки VAT сохраняет обратную совместимость через версионирование; сейчас работает версия 1 с запланированными улучшениями.

### Аутентификация

API-ключ — единственные учётные данные для доступа к API проверки VAT. Каждый сервис Cleariflow требует уникальный ключ для изолированного и безопасного доступа. 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           | Словакия       |