vat¶

В этой статье

Методы API

vat/check_vat

(описание будет добавлено при генерации)

Методы API¶

| Метод | Действие | Описание | |-------|----------|----------|| check_vat | проверка VAT | Проверяет валидность налогового номера (VAT) в системе VIES. Если проверка успешна, клиенту присваивается тег верификации. |

vat/check_vat¶

Проверяет валидность налогового номера (VAT) в системе VIES. Если проверка успешна, клиенту присваивается тег верификации.

HTTP-метод: POST

Параметры:

action	✅	string	Идентификатор метода: `check_vat`
token	❌	integer	Токен авторизации для проверки прав доступа.
CC	✅	string	Код страны (Country Code) для проверки VAT.
VAT	✅	string	Налоговый номер (VAT ID).
location	✅	string	Код страны для проверки налогового номера (CountryCode).

Пример запроса

curl -s "https://invapi.hostkey.ru/vat.php" -X POST \
--data "action=check_vat" \
--data "CC=DE" \
--data "VAT=123456789" \
--data "location=DE"

Пример успешного ответа

{
"result": "OK",
"vat_data": {
"isValid": true,
"countryCode": "DE",
"vatNumber": "DE123456789"
}
}

Примеры ошибок

{
"code": -1,
"message": "EU VAT check failed, invalid country code DE for 123456789"
}