vat.php¶

Модуль проверки EU VAT (налога на добавленную стоимость) с привязкой к клиенту и автоматическим обновлением тегов пользователя.

Методы API¶

Метод	Действие	Описание
`check_vat`	проверка VAT	Проверяет валидность EU VAT ID для указанной страны и обновляет теги клиента в случае успеха.

vat/check_vat¶

Проверяет валидность EU VAT ID для указанной страны и обновляет теги клиента в случае успеха.

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 "token=HOSTKEY_TOKEN" \
--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"
}