Sobre o bateCarimbo

O bateCarimbo é uma suíte gratuita de geradores de documentos e dados brasileiros fictícios para uso em testes de software. Com ele, desenvolvedores e equipes de QA conseguem criar números de CNPJ, CPF, CNH, RG, Título de Eleitor, PIS/PASEP e RENAVAM com os dígitos verificadores corretos, além de placas veiculares e CEPs no formato e na faixa certos — esses dois não têm dígito verificador, então o que há para conferir neles é o padrão. Nenhum corresponde a registro real.

A ferramenta também gera fichas completas de pessoas e empresas fictícias, com dados coerentes por estado: CPF com o 9º dígito da região fiscal correta, CEP dentro da faixa oficial, cidade e DDD compatíveis com a UF escolhida.

Quem desenvolve sistemas brasileiros frequentemente precisa popular bancos de dados de teste, preencher formulários em ambiente de homologação ou validar máscaras e regras de dígito verificador. Usar documentos reais para isso é um risco de privacidade e, em muitos contextos, viola a LGPD. Inventar números arbitrários não funciona porque os sistemas rejeitam documentos com dígitos verificadores incorretos.

O bateCarimbo resolve esse problema: gera números que passam em validadores sem pertencer a nenhuma pessoa ou empresa real. O resultado sai instantaneamente, sem cadastro e sem limite de uso.

A ferramenta foi criada para profissionais de tecnologia que trabalham com sistemas brasileiros:

• Desenvolvedores de software que precisam de dados fictícios para seeds, fixtures e ambientes de desenvolvimento.
• Engenheiros de QA e testadores que precisam preencher formulários em pipelines de testes automatizados ou testes manuais de homologação.
• Designers e UX researchers que precisam de dados realistas para protótipos e mockups, sem expor informações de pessoas reais.
• Estudantes e instrutores que ensinam ou aprendem sobre sistemas que lidam com documentos brasileiros.

Todo o processamento acontece no seu navegador, em JavaScript. Os documentos e dados que você gera, valida ou cola nas ferramentas não são enviados a nenhum servidor e não ficam salvos depois que a página é fechada. Não há cadastro, login nem histórico de uso.

As páginas são estáticas e servidas por CDN, então carregam rápido e continuam funcionando em conexões instáveis — mas não há service worker instalado, ou seja, uma aba nova não abre sem rede. O que é local é o cálculo, não a distribuição do site.

Cada gerador implementa a regra do documento que ele produz:

• Módulo 11 do CPF e do CNPJ, incluindo o formato alfanumérico em vigor desde julho de 2026, em que cada caractere entra na conta pelo código ASCII menos 48.
• Módulo 11 com pesos próprios para RG no padrão SSP-SP, CNH, PIS/PASEP e Título de Eleitor — cada um com sua ordem de pesos e seu tratamento de resto 10.
• RENAVAM, que multiplica a soma ponderada por 10 antes de tirar o resto.
• Tabelas de referência sem dígito verificador: regiões fiscais do CPF, códigos de UF do título de eleitor, faixas de CEP por estado e a conversão de placa antiga para o padrão Mercosul.

O detalhamento de cada conta, com tabela de dígito × peso resolvida, fica nas páginas das ferramentas e nos guias.

É um projeto individual: a implementação dos algoritmos, o critério editorial, a escolha das fontes e as respostas ao e-mail de contato são meus. Os textos das ferramentas e dos guias são redigidos com apoio de ferramentas de geração de texto e revisados por mim antes de publicar — as contas, os exemplos e cada afirmação sobre norma são conferidos contra a fonte oficial e contra o próprio código. O repositório está em github.com/GuiHeinrichs, onde o histórico de commits mostra cada alteração descrita aqui.

Os algoritmos não são deduzidos de código encontrado por aí: cada um vem da especificação publicada pelo órgão responsável — o manual de cálculo do DV do CNPJ, da Receita Federal e do SERPRO, é o exemplo mais direto. Quando duas implementações populares divergem, como no resto 10 da CNH ou na exceção de São Paulo e Minas Gerais no título de eleitor, a divergência é descrita no texto em vez de escondida, e o gerador evita emitir os números ambíguos.

Todo guia termina com a seção Fontes e referências listando os documentos consultados, com link direto. Afirmação sobre norma, prazo ou tabela oficial que não tenha fonte citada não entra no texto; nos casos em que a informação circula sem respaldo público, o guia diz que a regra varia e explica por quê.

Cada artigo exibe a data de publicação e a da última revisão. Elas são diferentes quando o texto foi corrigido ou atualizado depois de publicado — a data de revisão só muda quando o conteúdo muda, não a cada deploy.

Os textos são redigidos com apoio de ferramentas de geração de texto e passam por revisão humana antes de ir ao ar. Isso não dispensa verificação: toda conta publicada é refeita, todo exemplo numérico é validado contra a implementação que roda no site e toda afirmação sobre norma precisa de fonte com link. Quando um dado não pôde ser confirmado em fonte oficial, o texto diz que a regra varia em vez de arriscar um número. Se ainda assim escapar um erro, ele é corrigido e a data de revisão do artigo acompanha.

Encontrou um erro de conta, um link quebrado ou uma explicação desatualizada? Mande para guiheinrichs.dev@gmail.com ou abra uma issue no GitHub, de preferência com o endereço da página e o trecho. A correção entra na próxima revisão e a data de atualização do artigo acompanha.

O bateCarimbo é um projeto de código aberto licenciado sob a Licença MIT. Você pode inspecionar o código, reportar problemas, sugerir melhorias ou contribuir diretamente no repositório do GitHub:

github.com/GuiHeinrichs/brasil-cnpj

A licença MIT permite uso, cópia, modificação e distribuição livres — inclusive para projetos comerciais — desde que o aviso de direitos autorais seja mantido.

Os documentos e dados gerados pelo bateCarimbo são estritamente fictícios e destinados apenas a ambientes de teste e desenvolvimento de software. Não devem ser utilizados em sistemas em produção, para preenchimento de formulários fiscais, para identificação perante órgãos públicos ou para qualquer finalidade que exija documentos reais. O uso indevido é de responsabilidade exclusiva do usuário.

O bateCarimbo é um projeto independente, sem qualquer vínculo, convênio, patrocínio ou autorização da Receita Federal, do SERPRO, do SENATRAN, do TSE, dos Correios, do INSS, da Caixa Econômica Federal ou de qualquer outro órgão público. As especificações dos documentos são públicas e estão citadas nos guias; a implementação e os textos deste site não são oficiais nem representam posição desses órgãos.

Esta página não consulta nem conecta a ferramenta a nenhum cadastro governamental. Nada do que é gerado aqui existe em base oficial alguma.

Dúvidas, sugestões, relatos de erro e pedidos relacionados à LGPD têm uma página só deles, com os canais e o que incluir em cada caso: falar com o bateCarimbo.

Se preferir ir direto, escreva para guiheinrichs.dev@gmail.com ou abra uma issue no GitHub.

O tratamento de dados no site, os cookies usados e os seus direitos estão descritos na Política de Privacidade.