Начало работы
Эндпоинт проверки VAT
Проверяйте подлинность номеров VAT и получайте полную информацию о компании: страна, название, адрес и регистрационные данные.
Эндпоинт расчёта VAT
Рассчитывайте цены с учётом VAT по правилам конкретной страны, типу покупки и сумме транзакции для точных финансовых расчётов.
Эндпоинт категорий VAT
Получайте актуальные ставки VAT и налоговые категории для конкретных стран для соблюдения местного налогового законодательства.
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 | Словакия |