Gerador de CEP
Gere CEPs (Códigos de Endereçamento Postal) por estado para testes de software. Números dentro das faixas reais dos Correios por UF.
Para que serve um gerador de CEP?
O CEP, sigla de Código de Endereçamento Postal, são 8 dígitos que os Correios usam para identificar regiões do Brasil, e cada estado ocupa uma faixa específica desses números.
Vem a calhar quando você precisa testar formulários de endereço, conferir cálculos de frete ou validar integrações com as APIs dos Correios durante o desenvolvimento.
Os CEPs gerados estão dentro das faixas reais por estado mas podem não corresponder a um logradouro real.
Como o CEP funciona
O CEP — Código de Endereçamento Postal é o código de oito dígitos criado pelos Correios em 1971 pela Norma DEPLAN nº 1/71. Originalmente tinha cinco dígitos; em maio de 1992 o formato foi ampliado para oito para suportar roteamento mais fino nas grandes cidades. A notação canônica é XXXXX-XXX, em que os cinco primeiros dígitos codificam a geografia (região, sub-região, setor, subsetor e divisor de subsetor) e os três dígitos após o hífen formam o sufixo — apontando para um trecho de logradouro, uma quadra, um edifício ou uma faixa de caixas postais.
Estrutura geográfica
O primeiro dígito divide o Brasil em dez regiões postais:
- 0 — São Paulo (capital e Grande SP)
- 1 — São Paulo, interior
- 2 — Rio de Janeiro e Espírito Santo
- 3 — Minas Gerais
- 4 — Bahia e Sergipe
- 5 — Pernambuco, Alagoas, Paraíba, Rio Grande do Norte, Ceará, Piauí, Maranhão
- 6 — Pará, Amazonas, Acre, Amapá, Rondônia, Roraima, Tocantins
- 7 — Distrito Federal, Goiás, Mato Grosso, Mato Grosso do Sul
- 8 — Paraná e Santa Catarina
- 9 — Rio Grande do Sul
Os dígitos seguintes vão refinando a localização: o segundo é a sub-região, o terceiro o setor, o quarto o subsetor e o quinto o divisor de subsetor. Esses cinco dígitos identificam uma cidade, um bairro ou uma quadra grande em região metropolitana. Os três dígitos após o hífen — o sufixo — apontam um logradouro, um lado de rua, um prédio ou uma faixa de caixas postais.
Sufixos especiais
-000— CEP único para municípios pequenos (sem resolução por rua)-899— caixas postais comunitárias-900a-959— grandes usuários (bancos, ministérios, universidades com CEP próprio)-970a-989— unidades operacionais dos Correios
Consulta de endereços reais
Os Correios mantêm a base oficial através do SIGEP e licenciam-na pelo DNE (Diretório Nacional de Endereços). Front-ends comunitários gratuitos como ViaCEP e BrasilAPI reembalam os mesmos dados em uma API REST amigável, hoje padrão em checkouts de e-commerce para autocomplete de endereço.
Perguntas frequentes
Como descobrir o CEP correto de um endereço? Use a busca dos Correios (buscacepinter.correios.com.br) ou qualquer widget baseado em ViaCEP — informe rua e cidade e o CEP retorna. Não chute: uma mesma rua pode ter vários CEPs se cruzar setores.
Por que meu bairro tem um único CEP e outro tem CEP por rua? Cidades menores e bairros de baixa densidade usam um CEP genérico terminado em -000. Capitais e metrópoles recebem CEPs mais granulares — às vezes um por lado de quadra — para acelerar a triagem.
Os CEPs mudam com o tempo? Sim. Os Correios revisam o diretório continuamente conforme novas ruas são abertas, bairros são redesenhados ou grandes usuários recebem código próprio. Valide sempre pela consulta oficial antes de imprimir etiquetas em lote.
Posso usar esses CEPs gerados em produção? Não. Os números seguem o prefixo geográfico correto, mas não constam no DNE. Use-os apenas para testes, mocks e desenvolvimento de validação de formulário — nunca em formulários ligados a entregas reais.
Gere CEPs por estado para testes
Ao testar um formulário de endereço, uma integração de frete ou um sistema de logística, pegar um CEP real qualquer costuma dar resultado estranho. O que falta é um CEP que faça sentido para o teste. Este gerador cria CEPs por estado, dentro das faixas oficiais de cada UF, pensando em quem valida software.
Você escolhe o estado e a ferramenta devolve CEPs nas faixas numéricas corretas daquela região. Como respeitam a relação entre CEP e UF, eles se comportam bem em testes que checam essa correspondência. Serve para popular um banco de dados de desenvolvimento, conferir cálculos de frete por região ou homologar formulários de endereço.
Nada é consultado em base externa, tudo sai do próprio navegador. Vale lembrar que são CEPs fictícios, voltados a teste, e não correspondem necessariamente a um endereço real existente.
Ferramentas Relacionadas
Gerador de Código Postal de Portugal (fake)
Gera códigos postais portugueses no formato ####-### com prefixos válidos (1000–9999). Para testes de fixtures, não correspondem a endereços reais.
Gerador de CNH
Gere números de CNH (Carteira Nacional de Habilitação) matematicamente válidos para testes. Segue o algoritmo do DETRAN. Apenas para uso em testes.
Gerador de CPF
Gere CPFs matematicamente válidos para testes de software e desenvolvimento. Com ou sem pontuação. Apenas para uso em ambiente de testes.