1. Por Que Formatar Documentos Corretamente
No desenvolvimento de sistemas voltados ao mercado brasileiro, a formatacao correta de documentos e uma necessidade constante. Desde formularios de cadastro ate relatorios financeiros, exibir um CPF como 000.000.000-00 em vez de 00000000000 melhora significativamente a legibilidade e a experiencia do usuario.
Alem da apresentacao visual, a formatacao padronizada facilita a conferencia manual de dados, reduz erros de digitacao e garante consistencia em bases de dados, planilhas exportadas, documentos fiscais e interfaces de usuario.
2. Tipos de Documentos Brasileiros
O Brasil possui uma variedade de documentos e identificadores numericos utilizados em diferentes contextos:
- CPF (Cadastro de Pessoas Fisicas): 11 digitos, principal identificador fiscal de pessoas fisicas.
- CNPJ (Cadastro Nacional de Pessoas Juridicas): 14 digitos, identificador fiscal de empresas.
- RG (Registro Geral): varia por estado; em SP, possui 9 digitos com digito verificador.
- Telefone: 10 digitos (fixo) ou 11 digitos (celular), incluindo DDD.
- CEP (Codigo de Enderecamento Postal): 8 digitos no formato 00000-000.
- PIS/PASEP: 11 digitos, identificador do trabalhador no sistema previdenciario.
- Placa de Veiculo: 7 caracteres no formato antigo (AAA-0000) ou Mercosul (AAA0A00).
- RENAVAM: 11 digitos, identificador do registro de veiculos.
- Titulo de Eleitor: 12 digitos, identificador eleitoral.
- CNAE: 7 digitos no formato 0000-0/00, classifica atividades economicas.
- Inscricao Estadual: varia por estado; em SP, possui 12 digitos.
- Numero de Nota Fiscal: geralmente 6 digitos no formato 000.000.
3. Mascaras e Padroes de Formatacao
Cada tipo de documento segue um padrao especifico de mascara que utiliza pontos, tracos, barras e espacos como separadores. A mascara serve exclusivamente para apresentacao visual -- o armazenamento em banco de dados deve sempre utilizar apenas os digitos numericos (ou alfanumericos, no caso de placas).
Exemplos de conversao:
- CPF: 12345678901 → 123.456.789-01
- CNPJ: 12345678000190 → 12.345.678/0001-90
- Telefone: 11987654321 → (11) 98765-4321
- CEP: 01310100 → 01310-100
"Nossa ferramenta aplica as mascaras padrao de cada documento brasileiro e tambem faz o caminho inverso: remove a formatacao e retorna apenas os digitos, ideal para insercao em bancos de dados e APIs."
4. Validacao vs. Formatacao
E importante distinguir entre formatacao e validacao. A formatacao apenas aplica ou remove a mascara visual, enquanto a validacao verifica se o numero e matematicamente correto usando algoritmos de digitos verificadores (como modulo 11 para CPF e CNPJ).
Nossa ferramenta faz ambas as coisas: alem de formatar, ela exibe badges de validacao informando se o documento possui o numero correto de digitos e se os digitos verificadores estao corretos (quando aplicavel). No entanto, nenhuma validacao matematica confirma a existencia real do documento em bases governamentais.
5. Processamento em Lote
Um diferencial desta ferramenta e a secao de formatacao em lote, que permite colar varios valores (um por linha) e formata-los todos simultaneamente. Isso e especialmente util para:
- Preparar listas de CPFs ou CNPJs para relatorios
- Limpar dados importados de planilhas
- Formatar grandes volumes de CEPs ou telefones
- Remover mascaras antes de inserir dados em bancos de dados
O sistema identifica automaticamente valores invalidos e os marca com [ERRO], facilitando a revisao de dados problematicos.
6. Perguntas Frequentes
Os dados sao enviados a algum servidor?
Nao. Todo o processamento acontece localmente no seu navegador via JavaScript. Nenhum documento e enviado ou armazenado em qualquer servidor.
A ferramenta aceita documentos ja formatados?
Sim. Voce pode digitar o documento com ou sem mascara. Se escolher "Formatar", a ferramenta remove caracteres nao numericos antes de aplicar a mascara. Se escolher "Remover mascara", ela retorna apenas os digitos.
Posso usar a auto-deteccao para nao ter que escolher o tipo?
Sim. O sistema analisa o valor digitado e sugere o tipo de documento automaticamente com base no formato e na quantidade de digitos. Voce pode clicar na sugestao ou usar o botao "Auto-detectar" para aplicar automaticamente.
Quais estados sao suportados para RG e Inscricao Estadual?
Atualmente, o formatador suporta o padrao do estado de Sao Paulo para RG (9 digitos) e Inscricao Estadual (12 digitos). Cada estado brasileiro possui seu proprio formato, e estamos trabalhando para adicionar suporte a mais estados em versoes futuras.