Como Validar CEP: Guia Completo de Validação de Código Postal
Aprenda como validar CEP corretamente. Guia completo com formato, regras e ferramentas para verificar códigos postais brasileiros.
CEP (Código de Endereçamento Postal) é o sistema de códigos postais usado no Brasil para identificar logradouros e facilitar a entrega de correspondências. Validar CEPs corretamente é essencial para sistemas de cadastro, e-commerce e logística.
Neste guia completo, você aprenderá como validar CEPs, entender o formato correto, verificar se um CEP existe e usar ferramentas automatizadas para consulta e validação de códigos postais.
O Que é CEP?
CEP significa Código de Endereçamento Postal. É um código de 8 dígitos usado pelos Correios do Brasil para identificar logradouros (ruas, avenidas, praças) e facilitar a triagem e entrega de correspondências.
O formato do CEP é XXXXX-XXX, onde os 5 primeiros dígitos identificam a região, setor, subsetor e divisor de subsetor. Os 3 últimos dígitos identificam o distribuidor (logradouro específico).
Exemplo: 01310-100 é o CEP da Avenida Paulista em São Paulo. Os primeiros dígitos (01) indicam São Paulo capital, e os demais refinam até o logradouro específico.
Formato e Estrutura do CEP
O CEP brasileiro tem 8 dígitos numéricos, geralmente apresentados com hífen após o 5º dígito: XXXXX-XXX. Porém, o hífen é apenas formatação visual, não faz parte do código oficial.
Estrutura: 1º dígito = região (0-9), 2º e 3º dígitos = sub-região, 4º e 5º dígitos = setor, 6º ao 8º dígitos = subsetor e distribuidor.
CEPs especiais: terminados em 000 geralmente indicam localidades, não logradouros específicos. CEPs terminados em 001-899 são logradouros. 900-959 são caixas postais comunitárias.
Como Validar Formato de CEP
Validação básica verifica se o CEP tem exatamente 8 dígitos numéricos. Aceite com ou sem hífen: 01310-100 e 01310100 são válidos.
Use regex para validação: /^\d{5}-?\d{3}$/. Isso aceita 8 dígitos com hífen opcional após o 5º dígito.
Remova caracteres não numéricos antes de validar: CEP digitado como "01.310-100" deve ser limpo para "01310100" antes da validação.
- Deve ter exatamente 8 dígitos
- Apenas números (0-9)
- Hífen opcional após 5º dígito
- Não pode ter letras ou caracteres especiais
- Não pode começar com 0000
- Formato: XXXXX-XXX ou XXXXXXXX
Como Consultar CEP
Consultar CEP significa verificar se ele existe e obter informações do endereço (logradouro, bairro, cidade, estado). Isso vai além da validação de formato.
Use a API ViaCEP (gratuita): https://viacep.com.br/ws/01310100/json/. Retorna JSON com dados completos do endereço ou erro se CEP não existir.
Nossa ferramenta consulta automaticamente. Digite o CEP e receba instantaneamente: logradouro, bairro, cidade, estado e outras informações disponíveis.
Validação em Formulários Web
Implemente validação em duas etapas: 1) Validação de formato no frontend (JavaScript) para feedback imediato. 2) Consulta de existência no backend para confirmar que CEP é real.
Use máscara de input para formatar automaticamente enquanto usuário digita: XXXXX-XXX. Isso melhora UX e reduz erros de digitação.
Preencha campos automaticamente após validação. Quando usuário digita CEP válido, consulte API e preencha automaticamente logradouro, bairro, cidade e estado.
Erros Comuns na Validação
Aceitar apenas formato com hífen: alguns usuários digitam sem hífen. Aceite ambos os formatos (01310-100 e 01310100) para melhor UX.
Não validar existência: CEP pode ter formato correto mas não existir. Sempre consulte API para confirmar que CEP é real.
Não normalizar antes de validar: remova espaços, pontos e outros caracteres antes de validar. Usuários podem copiar CEP formatado de diferentes fontes.
- Aceitar apenas um formato (com ou sem hífen)
- Não consultar se CEP existe
- Não remover caracteres extras
- Não fornecer feedback claro de erro
- Não preencher campos automaticamente
- Validar apenas no frontend
APIs de Consulta de CEP
ViaCEP: API gratuita e popular. Endpoint: viacep.com.br/ws/{CEP}/json/. Retorna JSON com dados completos. Sem limite de requisições para uso razoável.
API dos Correios: oficial mas menos confiável. Pode ficar fora do ar. Requer parsing de XML. Não recomendada para produção.
BrasilAPI: alternativa moderna e gratuita. Endpoint: brasilapi.com.br/api/cep/v1/{CEP}. Retorna JSON. Boa performance e confiabilidade.
Melhores Práticas
Sempre valide no backend: validação frontend pode ser burlada. Backend deve sempre revalidar CEP antes de salvar no banco de dados.
Implemente cache: consultas de CEP podem ser cacheadas por dias ou semanas. CEPs raramente mudam, então cache reduz chamadas à API e melhora performance.
Forneça busca reversa: permita que usuário busque CEP por endereço. Útil quando usuário não sabe o CEP mas conhece o endereço.
Conclusão
Validar CEPs corretamente melhora qualidade dos dados, reduz erros de entrega e proporciona melhor experiência ao usuário. Implemente validação robusta em seus formulários.
Use nossa ferramenta gratuita para validar e consultar CEPs instantaneamente. Obtenha informações completas de endereço com um clique.