O que é CEP e como funciona o sistema de endereçamento postal
Entenda como o CEP organiza o Brasil em regiões, subseções e logradouros. Como consultar CEP via API e como gerar CEPs fictícios para testes.
O CEP — Código de Endereçamento Postal — é o sistema criado pelos Correios em 1972 para organizar a entrega de correspondências no Brasil. Composto por oito dígitos no formato NNNNN-NNN, ele identifica com precisão crescente a região, o estado, o município, o bairro e, em muitos casos, o logradouro específico onde um endereço se encontra.
Como ler um CEP
O primeiro dígito identifica a grande região do país. Os dois primeiros dígitos identificam o estado ou parte dele. Os cinco primeiros dígitos identificam a localidade (município ou área urbana). Os três dígitos finais (após o hífen) identificam o setor postal, o quarteirão ou o logradouro específico.
Por exemplo: 01310-100 é o CEP da Avenida Paulista em São Paulo. O '01' indica a capital paulista, e os dígitos seguintes refinam até o logradouro específico. CEPs terminados em -000 geralmente indicam municípios inteiros com volume baixo de correspondências.
Faixas de CEP por região
- 01000-000 a 19999-999: São Paulo (capital e interior)
- 20000-000 a 28999-999: Rio de Janeiro
- 29000-000 a 29999-999: Espírito Santo
- 30000-000 a 39999-999: Minas Gerais
- 40000-000 a 48999-999: Bahia
- 49000-000 a 49999-999: Sergipe
- 60000-000 a 63999-999: Ceará
- 70000-000 a 73699-999: Distrito Federal
- 80000-000 a 87999-999: Paraná
- 90000-000 a 99999-999: Rio Grande do Sul
Consultando CEP via API
A consulta de CEP é uma das integrações mais comuns em sistemas brasileiros — preenchimento automático de endereço, cálculo de frete, geolocalização. Existem várias APIs gratuitas e confiáveis para isso: ViaCEP (viacep.com.br), BrasilAPI e a própria API dos Correios.
A ViaCEP é a mais popular entre desenvolvedores por ser gratuita, não exigir autenticação e retornar JSON com logradouro, bairro, cidade, estado e complemento. Uma chamada simples a https://viacep.com.br/ws/01310100/json/ retorna todos os dados do CEP 01310-100.
Por que usar CEPs fictícios em testes
Ao desenvolver e testar sistemas de cadastro de endereços, usar CEPs reais em volume pode sobrecarregar as APIs de consulta e gerar dados de pessoas reais no ambiente de desenvolvimento. Geradores de CEP fictício criam números no formato correto que podem ser usados para testar máscaras de input, validações e fluxos de formulário sem depender de chamadas externas.
CEP e o problema da precisão
Uma limitação importante do CEP é que ele não garante precisão de entrega. Dois imóveis no mesmo logradouro podem ter o mesmo CEP mas endereços completamente distintos — é o número e o complemento que fazem a diferença final. Sistemas de entrega modernos complementam o CEP com coordenadas geográficas (latitude/longitude) para roteamento preciso.