Validação de IVA para Empresas SaaS Europeias

Se você vende software para empresas na UE, precisa validar seus números de IVA. Errar nisso significa ou cobrar IVA quando não deveria (perdendo competitividade) ou não cobrá-lo quando deveria (responsabilidade fiscal). A API de Validação de IVA da Veille (GET /v1/vat) conecta-se diretamente ao banco de dados VIES e retorna o resultado em milissegundos.

O que a API retorna

Para qualquer número de IVA da UE, você obtém: valid (booleano), o vat_number normalizado, country_code, company_name e company_address. A API trata a normalização de formato automaticamente - com ou sem prefixo de país, com ou sem espaços.

Integração rápida

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.veille.io/v1"

response = requests.get(
    f"{BASE_URL}/vat",
    params={"query": "FR40303265045"},
    headers={"x-api-key": API_KEY},
)
data = response.json()

if data["valid"]:
    print(f"{data['company_name']} - reverse charge applies")
else:
    print("Invalid VAT number - charge local VAT rate")

TypeScript

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.veille.io/v1";
const headers = { "x-api-key": API_KEY };

const response = await fetch(
  `${BASE_URL}/vat?query=FR40303265045`,
  { headers }
);
const data = await response.json();

if (data.valid) {
  console.log(`${data.company_name} - reverse charge applies`);
} else {
  console.log("Invalid VAT number - charge local VAT rate");
}

Campos principais da resposta

• valid - se o número de IVA está atualmente ativo no VIES
• vat_number - formato normalizado (ex.: FR40303265045)
• country_code - código do país de duas letras
• company_name - nome empresarial registrado
• company_address - endereço registrado oficial

5 casos de uso

1. Fluxo de checkout - valide o número de IVA em tempo real antes de aplicar o mecanismo de cobrança revertida em faturas B2B.
2. Automação de faturas - preencha automaticamente o nome e o endereço da empresa a partir da resposta da API para reduzir a entrada manual de dados.
3. Onboarding de fornecedores - verifique se o número de IVA de um novo fornecedor está ativo antes de assinar um contrato.
4. Auditoria de conformidade fiscal - valide em lote seu banco de dados de clientes existente para sinalizar números de IVA expirados ou inválidos.
5. Precificação em múltiplos países - use o country_code para determinar a alíquota de IVA correta para clientes B2C nos estados-membros da UE.

Artigos relacionados

• Validação de IBAN: mais do que um simples checksum - validar contas bancárias junto com números de IVA para onboarding B2B completo
• Construindo um pipeline de detecção de fraudes - combinar sinais de pagamento, email e IP para prevenção completa de fraudes
• Usar a API Veille em uma empresa autônoma Paperclip - validação de IVA e IBAN integrada em um agente de faturamento autônomo do Paperclip