ForHosting KIT · Ferramentas para dev

Dígito verificador CUIT/CUIL Argentina

Digite 20-12345678 e receba o dígito verificador 6, então o CUIT completo é 20-12345678-6; digite 20-12345678-7 e a validação falha. Pega erros de digitação em notas fiscais, cadastros de fornecedores e folhas de pagamento antes que virem problema. 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

CUIT: 20-12345678

Você obtém

Modo de cálculo: Compute
Entrada: 2012345678
Dígito verificador: 6
Com dígito verificador: 20123456786

Os números CUIT e CUIL identificam pessoas e empresas em fluxos fiscais, de folha de pagamento e bancários na Argentina. Cada código de onze dígitos termina com um dígito de controle derivado de uma ponderação fixa dos primeiros dez dígitos segundo a regra da AFIP (Administración Federal de Ingresos Públicos). Um dígito do corpo digitado errado ou um par trocado costuma quebrar essa soma de verificação, de modo que validar o dígito verificador antes de emitir uma fatura, abrir um fornecedor ou aceitar um arquivo de folha captura muitos erros de digitação cedo. Esta capacidade calcula o dígito verificador CUIT/CUIL a partir de uma carga de dez dígitos (com ou sem os hífens habituais), ou valida um número completo de onze dígitos que já inclui o dígito final, e reporta entrada inválida em vez de remover letras ou pontuação em silêncio.

O que é o dígito verificador CUIT/CUIL argentino e como funcionam os pesos

Um CUIT (Clave Única de Identificación Tributaria) ou CUIL (Clave Única de Identificación Laboral) é um identificador de onze dígitos usado em sistemas fiscais, de previdência, bancários e comerciais da Argentina. A forma impressa costuma ser XX-XXXXXXXX-X: um prefixo de tipo de dois dígitos, um corpo de oito dígitos (muitas vezes um número de documento) e um dígito verificador final.

Esse último dígito não é decorativo: é calculado de forma que uma soma ponderada dos primeiros dez dígitos, com os multiplicadores fixos cinco, quatro, três, dois, sete, seis, cinco, quatro, três e dois da esquerda para a direita, produza um valor cujo resto módulo onze determine o controle. Após somar dígito vezes peso em cada posição, o algoritmo toma onze menos (soma módulo onze). Se o resultado for onze o dígito de controle é zero; se for dez o dígito é nove; caso contrário o resultado é o próprio dígito.

Quando alguém digita 20-12345678-6 como 20-12345678-7, a soma deixa de coincidir e a validação falha. A mesma regra detecta muitas substituições de um único dígito em importações ERP, gateways de faturação eletrônica e formulários de admissão de RH em que operadores reescrevem números a partir de papel ou PDF. Esta ferramenta aplica essa ponderação padrão AFIP sobre dígitos puros após remover hífens opcionais.

Não consulta a AFIP, não prova que um contribuinte existe nem atribui um código de tipo: apenas verifica que a cadeia de dígitos é coerente com o algoritmo de controle publicado. Em comparação com o Luhn mod-10 de cartões e contas gerais, o esquema CUIT usa um vetor de pesos fixo da esquerda para a direita e módulo onze, de modo que não se deve reutilizar um validador Luhn em campos CUIT.

Em comparação com auxiliares de CPF brasileiro ou RFC mexicano, a regra argentina é específica deste layout de onze dígitos e destes dez multiplicadores. Saber qual esquema precisa evita falsa confiança quando uma utilidade genérica de dígito de controle aceita uma cadeia que não é um CUIT ou CUIL bem formado.

Onde os dígitos verificadores CUIT se encaixam em fluxos fiscais, de folha e comerciais

Sistemas de faturação eletrônica e cobrança guardam o CUIT do cliente ou fornecedor em cada documento legal; um único dígito digitado errado no cadastro pode enviar XML fiscal à parte errada ou falhar depois a autorização AFIP. Plataformas de folha e RH associam um CUIL a cada empregado; a importação em lote de arquivos de documento nacional costuma gerar erros de um dígito que o controle captura antes da primeira folha.

Bancos e gateways de pagamento que aceitam identificadores fiscais argentinos para KYC ou metadados de transferência podem recomputar o dígito sem chamar um registro externo, filtrando ruído OCR e capturas parciais cedo. Equipes de produto que já expõem ferramentas gerais Luhn ou ISO 7064 ainda devem usar esta capacidade específica de CUIT em campos de ID fiscal argentino para que pesos, limites de comprimento e formato de hífens coincidam com o domínio.

Não trate um dígito verificador CUIT correto como prova de que a pessoa ou empresa está bem identificada, ativa na AFIP, autorizada a faturar ou presente em um registro oficial: apenas demonstra que a cadeia de dígitos é coerente com o algoritmo de controle CUIT/CUIL argentino.

Casos de uso

Auditar colunas CUIT em arquivos de parceiros e folha

Valide em lote cada CUIT/CUIL de uma importação CSV e isole as linhas cujo dígito de controle já não coincida com o valor esperado recomputado.

Perguntas frequentes

O que é o dígito verificador CUIT/CUIL argentino?

É um dígito final único calculado com os pesos AFIP 5,4,3,2,7,6,5,4,3,2 sobre os primeiros dez dígitos e depois módulo 11 (11 mapeia para 0 e 10 para 9), de modo que a maioria dos erros de um único dígito quebra a soma de verificação.

O que acontece com letras, espaços ou comprimento errado?

Forneça apenas dígitos 0-9 (hífens opcionais); compute exige dez dígitos e validate onze. Tarefas de validação com falha não são cobradas.

A ferramenta de dígito verificador CUIT é grátis?

A ferramenta do navegador é grátis e roda localmente.

O que acontece quando o cálculo dá 10 ou 11?

A regra subtrai de 11 o resto da divisão da soma ponderada por 11. Se o resultado for 11, o dígito verificador é 0; se for 10, vira 9; qualquer outro resultado já é o próprio dígito.

Um CUIT válido prova que o contribuinte existe?

Não. A ferramenta não consulta a AFIP nem nenhum cadastro de contribuintes e também não atribui o prefixo de tipo. Um dígito correto só mostra que os números são coerentes com a regra publicada.

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/enc/cuit-argentina

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/enc/cuit-argentina \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cuit":"20-12345678"}'

const res = await fetch("https://api.kit.forhosting.com/enc/cuit-argentina", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "cuit": "20-12345678"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/cuit-argentina",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "cuit": "20-12345678"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/cuit-argentina", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"cuit":"20-12345678"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"cuit":"20-12345678"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/cuit-argentina", 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

{
  "cuit": "20-12345678"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.cuit_argentina",
  "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.

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.

Notas técnicas

Use grátis no navegador ou chame a API do KIT pelo preço publicado; ambos os caminhos executam a mesma aritmética determinística sem consulta de rede e sem registro de contribuintes reais.

Como calcular um dígito verificador ou validar um CUIT/CUIL completo

Envie um campo cuit com dígitos de zero a nove, opcionalmente separados pelos hífens padrão. O modo validate espera um número completo de onze dígitos com o dígito de controle final (por exemplo 20-12345678-6 ou 20123456786). Strings vazias, cuit ausente, valores de mode inválidos e comprimentos errados (não dez dígitos em compute, não onze em validate) falham antes de qualquer soma ponderada e não são cobrados. Prefira compute quando montar um CUIT a partir de um prefixo de tipo e um corpo de documento conhecidos; prefira validate quando um usuário, um arquivo de parceiro ou uma etiqueta digitalizada fornecer um número completo e você precisar de um filtro booleano antes de uma consulta à AFIP ou a dados mestres internos. Espaços ao redor do valor são removidos; letras, outra pontuação, hífens duplos ou hífens no início ou no fim são rejeitados como entrada malformada com invalid_input para que nunca se aceite um valor limpo em silêncio. O modo compute é o padrão: forneça exatamente dez dígitos sem o dígito de controle (por exemplo 20-12345678 ou 2012345678) e o motor devolve check_digit como string de um caractere, with_check como a string completa de onze dígitos incluindo esse dígito, e formatted na forma com hífens XX-XXXXXXXX-X usada em faturas e formulários. A resposta indica valid true quando o dígito recomputado coincide com o último, e inclui sempre check_digit, expected_check_digit, payload sem o último dígito e formatted para exibição consistente. Como o caminho é parse puro, sem relógio, fonte aleatória nem rede, a mesma entrada produz sempre o mesmo JSON na ferramenta gratuita do navegador e na API. A US$ 0,002 por solicitação bem-sucedida você pode filtrar importações em massa de fornecedores, formulários de admissão e jobs ETL sem negociar um nível personalizado.

Onde os dígitos verificadores CUIT se encaixam em fluxos fiscais, de folha e comerciais

O modo validate na entrada bloqueia o salvamento quando valid é false e pode mostrar expected_check_digit para que o operador corrija o formulário antes de gravar o registro. Em todo fluxo o contrato é o mesmo: dígitos com hífens opcionais, compute ou validate, JSON estruturado que pode ser testado com goldens, comportamento idêntico grátis no navegador ou com saldo KIT pré-pago, e falha honesta quando a entrada está malformada.

Casos de integração

Filtrar campos CUIT em formulários de fornecedores e clientes

Quando um usuário enviar um CUIT completo, chame o modo validate e bloqueie o salvamento se valid for false, mostrando expected_check_digit para corrigir um único erro de digitação antes de gravar o registro ERP.

Calcular dígitos de controle ao criar ou completar identificadores

A partir de um prefixo de tipo e um corpo de oito dígitos, chame o modo compute e armazene with_check ou formatted para que cada nova string CUIT/CUIL leve o dígito final correto antes de imprimir ou exportar.

Perguntas técnicas

Como calculo um dígito verificador CUIT com esta API?

Faça POST com cuit igual aos dez dígitos de carga (hífens opcionais) e mode compute (ou omita mode). A resposta inclui check_digit, with_check e formatted como XX-XXXXXXXX-X.

Como valido um CUIT ou CUIL completo?

Faça POST com a string completa de onze dígitos e mode validate. A resposta inclui valid, check_digit, expected_check_digit, payload e formatted.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que é o dígito verificador CUIT/CUIL argentino e como funcionam os pesos

Onde os dígitos verificadores CUIT se encaixam em fluxos fiscais, de folha e comerciais

Casos de uso

Auditar colunas CUIT em arquivos de parceiros e folha

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

Como calcular um dígito verificador ou validar um CUIT/CUIL completo

Onde os dígitos verificadores CUIT se encaixam em fluxos fiscais, de folha e comerciais

Casos de integração

Filtrar campos CUIT em formulários de fornecedores e clientes

Calcular dígitos de controle ao criar ou completar identificadores

Perguntas técnicas

obrigado