POST AI agent ready /v1/validate/vat

API de validação de número de IVA - verificação gratuita de IVA da UE

Envie um número de IVA e receba de volta se ele corresponde ao formato esperado para seu país. Apoia todos os estados membros da UE. Útil para faturamento B2B, fluxos de checkout isentos de impostos e verificações de conformidade. O número de IVA é processado no servidor e nunca armazenado.

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

Verifique os IDs de IVA do cliente durante a finalização da compra B2B

Antes de aplicar uma isenção de IVA com taxa zero na finalização da compra, valide o ID de IVA do comprador. Isso protege você contra a emissão de faturas incorretas e possíveis penalidades durante auditorias fiscais.

Preencher automaticamente as regras fiscais e do país a partir de um número de IVA

Extraia o código do país do ID do IVA para aplicar automaticamente a taxa de IVA, o idioma da fatura e os requisitos de relatório corretos para cada estado membro da UE.

Valide números de IVA em lote no seu CRM

Execute seu banco de dados de clientes através do endpoint periodicamente. Sinalize contas com IDs de IVA inválidos ou expirados para que sua equipe financeira possa solicitar documentos atualizados antes do próximo ciclo de fatura.

Frequently asked questions

Quais países são suportados?

Todos os 27 estados membros da UE. Cada país tem o seu próprio formato de número de IVA (por exemplo, DE + 9 dígitos para a Alemanha, FR + 11 caracteres para a França). A API valida o padrão correto para o país detectado.

Esta API verifica o número de IVA na base de dados VIES?

Este endpoint valida o formato e a estrutura do número de IVA. Para consulta VIES (Comissão da UE) em tempo real para confirmar o status do registro, emparelhe-o com o serviço VIES SOAP oficial.

O número de IVA é armazenado após validação?

Não. O número é processado na memória e descartado após a resposta. Nenhum dado é gravado no disco ou em qualquer sistema externo.

Posso validar os números de IVA do Reino Unido?

Os números de IVA do Reino Unido (prefixo GB) seguem um formato conhecido e podem ser validados estruturalmente. Desde que o Reino Unido saiu da UE, já não fazem parte do VIES, mas a verificação do formato ainda funciona.

O que acontece se eu enviar um número sem o prefixo do país?

A API exige o prefixo do país com duas letras (por exemplo, "DE", "FR", "NL"). Sem ele, a resposta retorna válido: falso com um motivo explicando que falta o código do país.

Get your API key

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