POST AI agent ready /v1/validate/vat

API проверки номера плательщика НДС — бесплатная проверка НДС в ЕС

Отправьте номер плательщика НДС и получите ответ, соответствует ли он ожидаемому формату для своей страны. Поддерживает все страны-члены ЕС. Полезно для выставления счетов B2B, операций по освобождению от налогов и проверок соответствия. Номер НДС обрабатывается на стороне сервера и никогда не сохраняется.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/validate/vat \
  -H "Content-Type: application/json" \
  -d '{"vat_number":"DE123456789"}'

When to use this API

Проверьте идентификаторы НДС клиента во время оформления заказа B2B

Прежде чем применять освобождение от НДС по нулевой ставке при оформлении заказа, подтвердите идентификатор НДС покупателя. Это защитит вас от выставления неверных счетов-фактур и от возможных штрафов при налоговых проверках.

Автоматическое заполнение страны и налоговых правил по номеру плательщика НДС

Извлеките код страны из идентификатора НДС, чтобы автоматически применить правильную ставку НДС, язык счета и требования к отчетности для каждого государства-члена ЕС.

Пакетная проверка номеров НДС в вашей CRM

Периодически запускайте базу данных клиентов через конечную точку. Помечайте учетные записи с недействительными или просроченными идентификаторами НДС, чтобы ваш финансовый отдел мог запросить обновленные документы до следующего цикла выставления счетов.

Frequently asked questions

Какие страны поддерживаются?

Все 27 стран-членов ЕС. Каждая страна имеет свой собственный формат номера НДС (например, DE + 9 цифр для Германии, FR + 11 символов для Франции). API проверяет соответствие шаблону обнаруженной страны.

Сверяет ли этот API номер плательщика НДС по базе данных VIES?

Эта конечная точка проверяет формат и структуру номера НДС. Для поиска VIES (Комиссия ЕС) в режиме реального времени для подтверждения статуса регистрации соедините его с официальной службой VIES SOAP.

Сохраняется ли номер НДС после проверки?

Нет. Число обрабатывается в памяти и отбрасывается после ответа. Никакие данные не записываются на диск или любую внешнюю систему.

Могу ли я подтвердить номера НДС в Великобритании?

Номера НДС в Великобритании (префикс GB) имеют известный формат и могут быть проверены структурно. Поскольку Великобритания вышла из ЕС, они больше не являются частью VIES, но проверка формата все еще работает.

Что произойдет, если я отправлю номер без префикса страны?

Для API требуется двухбуквенный префикс страны (например, «DE», «FR», «NL»). Без него ответ возвращает valid: false с причиной, объясняющей отсутствие кода страны.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.