Початок роботи
Ендпоінт перевірки VAT
Перевіряйте автентичність номера VAT і отримуйте повну інформацію про компанію, включаючи країну, назву, адресу та реєстраційні дані.
Ендпоінт розрахунку VAT
Розраховуйте ціни з урахуванням VAT відповідно до національних правил, типу покупки та суми транзакції для точних фінансових розрахунків.
Ендпоінт категорій VAT
Отримуйте актуальні ставки VAT і податкові категорії для конкретних країн, щоб дотримуватися місцевих податкових правил.
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 | Словаччина |