Dados de teste: CEP e endereços brasileiros
Como o CEP brasileiro é estruturado, por que dados fictícios são essenciais em testes de software, como gerar endereços válidos e consistentes para QA e automação.
Sistemas brasileiros que lidam com e-commerce, logística, cadastros e pagamentos quase sempre precisam de endereços válidos. Em ambientes de desenvolvimento e teste, usar endereços reais de pessoas levanta questões de privacidade (LGPD) e pode gerar efeitos colaterais indesejados em integrações com Correios, transportadoras e gateways.
Como o CEP é estruturado
O CEP (Código de Endereçamento Postal) tem 8 dígitos no formato NNNNN-NNN. Os primeiros 5 dígitos identificam a localidade (faixa de CEPs por região/cidade), e os 3 últimos identificam o logradouro ou setor dentro da localidade. A distribuição é feita pelos Correios e não segue uma fórmula matemática — um CEP só pode ser validado consultando a base dos Correios.
- 01000-000 a 09999-999: São Paulo (SP)
- 20000-000 a 28999-999: Rio de Janeiro (RJ)
- 30000-000 a 39999-999: Minas Gerais (MG)
- 40000-000 a 48999-999: Bahia (BA)
- 60000-000 a 63999-999: Ceará (CE)
- 70000-000 a 73699-999: Distrito Federal (DF)
Por que dados fictícios em testes
- LGPD: dados de endereço são dados pessoais — não podem estar em logs, dumps ou ambientes sem controle de acesso
- Segurança: endereços reais em código-fonte, arquivos de seed ou repositórios representam vazamento de dados
- Reprodutibilidade: dados controlados permitem testes determinísticos
- Volume: é fácil gerar 10.000 endereços fictícios para testes de carga — impossível com dados reais
Componentes de um endereço brasileiro completo
- CEP: código de 8 dígitos
- Logradouro: tipo (Rua, Avenida, Travessa) + nome da via
- Número: número da edificação (pode ser "s/n" sem número)
- Complemento: apartamento, bloco, sala (opcional)
- Bairro: nome do bairro
- Município: nome da cidade
- UF: sigla do estado (2 letras)
- País: Brasil (em formulários internacionais: Brazil / BRA)
Consistência nos dados de teste
O maior desafio com endereços fictícios é a consistência: o CEP deve corresponder ao estado/cidade, o bairro deve existir naquela cidade, e o logradouro deve ser plausível para a região. Geradores de dados bem feitos como o do UtilDev garantem essa consistência interna.
Use o Gerador de Endereço Fake do UtilDev para criar endereços brasileiros fictícios e consistentes com CEP, logradouro, bairro, cidade e UF — prontos para popular seus ambientes de teste.