ForHosting KIT · Dados e planilhas

Verificar formato de número de IVA da UE

Confira se um número de IVA tem o formato certo para o país da UE: «DE 136-695-976» é lido como DE136695976 e passa no padrão alemão. Espaços, pontos e hífens copiados de notas fiscais são ignorados. Verifica o formato, não o registro. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Texto: DE 136-695-976

Você obtém

Normalizado: DE136695976
Código do país: DE
Nome do país: Germany
Formato esperado: DE123456789

Um número de IVA pode parecer plausível e ainda apresentar uma estrutura incorreta para o país. Este verificador lê o prefixo de duas letras, seleciona o formato correspondente da UE e compara os demais caracteres com o padrão publicado para aquele país. Ele considera os diferentes comprimentos e as letras obrigatórias usados na UE, ignorando espaços, pontos e hífens comuns. O resultado é uma verificação sintática rápida, não uma confirmação de que a empresa existe ou de que seu cadastro de IVA está ativo.

O que a verificação do formato do IVA informa

A verificação de formato responde a uma pergunta específica, mas útil: esta sequência poderia ser um número de IVA emitido conforme a sintaxe adotada pelo país da UE informado? O prefixo do país determina o teste. Números alemães, por exemplo, têm comprimento diferente dos belgas, enquanto formatos austríacos, neerlandeses, irlandeses, espanhóis, cipriotas e franceses podem exigir letras em determinadas posições.

O verificador converte letras em maiúsculas, remove espaços, pontos e hífens comuns e aplica a regra do país correspondente. Ele retorna o valor normalizado, o país reconhecido, um exemplo do formato esperado e um resultado booleano. Isso ajuda você a encontrar dígitos ausentes, letras fora de posição, um cadastro fiscal nacional sem o prefixo internacional ou um número copiado com sufixo incompleto.

A ferramenta não calcula nem valida dígitos de controle específicos de cada país. Portanto, uma sequência pode passar no teste estrutural e ainda conter erro, não ter sido atribuída, estar expirada ou pertencer a outra organização. Use um resultado positivo para prosseguir com a validação, não como prova de cadastro ou identidade.

Como informar prefixos de país e separadores

Informe o número de IVA completo, começando pelo prefixo de IVA de duas letras. A maioria dos prefixos corresponde ao código de país conhecido, mas a Grécia usa EL para fins de IVA na UE; portanto, uma entrada grega deve começar com EL, e não GR. O verificador reconhece os prefixos de IVA dos atuais 27 Estados-Membros da UE e retorna um erro de entrada quando o prefixo é desconhecido.

Essa diferença é importante: um país reconhecido com número malformado gera um resultado normal com valid igual a false, enquanto um prefixo desconhecido indica que não há regra nacional aplicável. Espaços, pontos e hífens são aceitos como separadores visuais e removidos antes da comparação, facilitando o uso de valores copiados de notas fiscais. Outros sinais de pontuação permanecem e normalmente invalidam o formato.

Não inclua rótulos como VAT, TVA ou MwSt ao redor do número. Embora muitos formatos tenham apenas dígitos após o prefixo, alguns países exigem uma ou mais letras. Preserve-as: substituí-las por dígitos altera o formato e deve reprovar a verificação.

O valor normalizado da resposta mostra exatamente qual sequência compacta foi avaliada.

Validação de formato e confirmação de cadastro

A validação sintática deve ficar no início de um fluxo de recebimento de dados. Ela é determinística, imediata e não envia o identificador fornecido a um cadastro externo. Você pode usá-la enquanto alguém preenche um formulário de cobrança, durante a importação de fornecedores ou antes de colocar números de IVA em uma fila para uma consulta oficial mais lenta.

Um resultado false oferece um motivo claro para solicitar uma correção antes de qualquer chamada de rede. Um resultado true informa apenas que os caracteres ocupam posições permitidas para aquele prefixo. A ferramenta não consulta o VIES, uma autoridade tributária nacional ou um registro empresarial e não determina se o número foi emitido, está ativo para operações internacionais ou pertence ao cliente informado.

Para decisões fiscais, aplicação de alíquota zero ou comprovação de conformidade, complemente uma verificação de formato bem-sucedida com a confirmação oficial adequada e guarde as evidências exigidas pelo seu processo. Essa separação também facilita a análise de falhas: erros sintáticos locais podem ser corrigidos na hora, enquanto indisponibilidades de cadastros, serviços nacionais fora do ar e inscrições realmente inativas continuam na etapa posterior, sem serem confundidos com problemas de formatação.

Casos de uso

Validar um formulário de cobrança

Identifique um prefixo incompatível ou um comprimento incorreto para o país antes que o cliente envie o perfil de faturamento.

Organizar dados de fornecedores

Normalize separadores e encontre números de IVA estruturalmente inválidos ao importar fornecedores ou clientes.

Preparar consultas oficiais

Filtre localmente erros sintáticos evidentes antes de enviar números plausíveis a um serviço oficial de confirmação.

Perguntas frequentes

Um resultado válido comprova que o número de IVA está cadastrado?

Não. Ele comprova apenas que o número corresponde ao padrão de caracteres do país reconhecido. Consulte um cadastro oficial para confirmar a situação.

Quais países são reconhecidos?

O verificador reconhece os prefixos de IVA dos atuais 27 Estados-Membros da UE. Para a Grécia, use o prefixo de IVA EL.

A parte depois do prefixo do país pode conter letras?

Sim. Vários formatos oficiais de IVA exigem letras em posições específicas, e o verificador preserva e valida essas letras.

Espaços e hífens são permitidos?

Sim. Espaços, pontos e hífens são removidos antes do teste do padrão nacional, e o valor compacto é retornado como normalizado.

Por que um número de IVA grego precisa começar com EL?

Porque a Grécia usa EL em vez de GR para fins de IVA na União Europeia. Um número grego digitado com GR é tratado como prefixo desconhecido e retorna um erro, já que não existe regra de país para aplicar.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/data/vat-number-format-check

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/data/vat-number-format-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"DE 136 695 976"}'

const res = await fetch("https://api.kit.forhosting.com/data/vat-number-format-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "DE 136 695 976"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/vat-number-format-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "DE 136 695 976"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/vat-number-format-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"DE 136 695 976"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"DE 136 695 976"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/vat-number-format-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "text": "DE 136 695 976"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.vat_number_format_check",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

max_mb 25

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Perguntas técnicas

O que ocorre com um prefixo de país desconhecido?

A solicitação retorna um erro invalid_input porque não existe um padrão nacional de IVA disponível para esse prefixo.

Quanto custa a solicitação da API?

Cada solicitação da API custa US$ 0,002. A versão no navegador funciona localmente, sem consulta à rede.

Ver a documentação completa do KIT →

Executar grátis