Guias sobre documentos e dados brasileiros

Uma conta só, repetida com pesos diferentes, sustenta o dígito verificador de quase todo documento brasileiro. Aqui ela aparece resolvida no papel, posição por posição, incluindo o caso do resto 10 — o ponto em que CPF, PIS e título de eleitor deixam de se comportar igual.

Mudanças de formato que já valem e obrigam alteração de código. O CNPJ alfanumérico passou a sair em novas inscrições desde julho de 2026 e convive com o numérico: o que muda no cálculo do dígito, no tamanho da coluna e nas validações que assumiam apenas algarismos.

Antes de gerar qualquer massa, vale entender por que copiar a base de produção para homologação é um problema jurídico, e não só um mau hábito. Dado pessoal, anonimização e pseudonimização na LGPD, e como documentos fictícios cumprem o mesmo papel em teste sem expor ninguém.

Leitura de número documento a documento: o que cada posição significa, o que dá para inferir dela e o que é palpite. Útil para quem precisa explicar um campo em tela, escrever uma mensagem de erro precisa ou decidir se aquele trecho do número vira regra de negócio.

Placa e emplacamento, do padrão de três letras e quatro algarismos ao Mercosul. Cobre a conversão posição a posição, por que os dois padrões convivem na mesma frota e o que isso exige de quem valida placa em formulário, relatório ou integração de rastreamento.

A parte executável do acervo: validadores comentados em JavaScript, TypeScript, Python, Java, C# e SQL, mais a tabela de expressões regulares para os formatos com e sem máscara. Todos partem da mesma regra e da mesma bateria de casos, para o resultado não divergir entre tela, API e banco.

O RG é o documento que mais quebra validação genérica: cada estado numera do seu jeito e nem todos usam a mesma regra de dígito. Como modelar o campo sem inventar regra, e o que a Carteira de Identidade Nacional muda ao adotar o CPF como número único.

PIS, PASEP, NIS e NIT são quatro nomes para o mesmo número de onze dígitos, e a confusão reaparece em folha, eSocial e integração previdenciária. Quem atribui cada sigla, onde ela aparece na prática e o dígito verificador resolvido com os pesos corretos.

O título de eleitor carrega o código da unidade federativa nos dígitos 9 e 10, e é aí que a maioria dos validadores erra: São Paulo e Minas Gerais seguem uma exceção no cálculo. Tabela dos códigos por estado e a conta resolvida até os dois dígitos finais.

CEP não é um número opaco: região, sub-região, setor, subsetor e sufixo estão codificados nas oito posições. Exemplos reais decompostos, as faixas por unidade federativa e o que dá para verificar sem depender de uma API de consulta de endereço.

Como montar massa brasileira que aguenta um pipeline inteiro: fixtures pequenas no teste unitário, seeds reproduzíveis no ambiente de desenvolvimento, factories para os casos-limite. Inclui a coerência entre UF, CPF, CEP e DDD, detalhe que costuma faltar quando a massa vem de gerador genérico.

Cadastro é diferente de formato. Estes textos separam os três níveis de verificação — formato, dígito verificador e existência no cadastro — e arrumam a confusão entre CPF, CNPJ, inscrição estadual, inscrição municipal e MEI, que decide como o sistema modela cliente pessoa física e jurídica.

Catálogo de defeitos reais em validadores brasileiros, cada um com sintoma, causa, teste que reproduz o problema e correção comentada. Se um documento válido está sendo recusado em produção, ou um inválido passou pela tela e chegou ao banco, comece por aqui antes de reescrever a validação inteira.