Gerador de Endereço Fictício com CEP por Estado

Como o gerador de endereço monta cada linha

O gerador de endereço sorteia sete partes e as encaixa na ordem que todo formulário brasileiro espera: tipo e nome do logradouro, número, complemento, bairro, cidade, UF e CEP. O tipo vem de uma lista curta (Rua, Avenida, Travessa, Alameda, Praça), o nome sai de um repertório que existe em quase toda cidade do país, como Rua Sete de Setembro ou Avenida Getúlio Vargas, e o número fica entre 1 e 4.999. O complemento alterna entre apartamento, bloco, casa, sala e loja, porque cadastro real recebe esses formatos e o seu teste precisa vê-los.

A parte que mais gente erra ao inventar endereço na mão é o CEP. Aqui ele nasce dentro do intervalo que os Correios reservam para a UF escolhida e, se você pedir só a capital, dentro do intervalo da capital. É a mesma lógica do gerador de CEP por estado, aplicada ao endereço inteiro.

Esta página é uma extensão do gerador de pessoas fictícias com CPF e endereço. Lá o endereço é um dos 22 campos de um perfil completo; aqui ele é o protagonista, com controle de estado, capital, complemento e formato de exportação, para quem precisa de dezenas de linhas sem carregar nome, CPF e telefone junto.

Para que serve um gerador de endereço fictício

Quem trabalha com cadastro sabe que a tela de endereço é a que mais quebra: máscara de CEP, busca automática de logradouro, validação de UF, complemento que aceita vazio. Um gerador de endereço fictício entrega material de teste para cada um desses pontos sem que ninguém digite a própria casa na homologação, o que a LGPD desaconselha e a boa prática de QA proíbe.

O uso mais frequente é em e-commerce em homologação: o checkout pede endereço de entrega e de cobrança, calcula frete pelo CEP e recusa combinações incoerentes. Gerar dez endereços de Santa Catarina e dez do Pará permite comparar o cálculo de frete entre regiões. O segundo uso é seed de banco: 50 endereços em CSV ou JSON sobem em segundos para a tabela de clientes de desenvolvimento. O terceiro é o formulário de exemplo, em documentação, tutorial ou protótipo apresentado ao cliente, onde um endereço plausível convence mais que "Rua Teste, 123". Fora da tecnologia, professores usam endereços inventados em exercício de planilha e equipes de atendimento treinam o sistema novo com fichas de mentira antes de tocar em dado verdadeiro.

Gerador de endereço com CEP na faixa certa de cada estado

O CEP brasileiro tem oito dígitos e o primeiro marca a região postal. Quando você escolhe "Somente a capital", a cidade é fixada na capital e o CEP sai do intervalo dela; com "Qualquer cidade do estado", a cidade é sorteada entre municípios da UF e o CEP cai no restante da faixa estadual.

Pelas faixas postais, São Paulo fica entre 01000 e 19999 (capital de 01000 a 05999), Rio de Janeiro e Espírito Santo na região 2, Minas Gerais na 3, Bahia e Sergipe na 4, Pernambuco, Alagoas, Paraíba e Rio Grande do Norte na 5, Ceará, Piauí, Maranhão, Pará, Amapá, Amazonas, Roraima e Acre na 6, Distrito Federal, Goiás, Rondônia, Tocantins e os dois Mato Grossos na 7, Paraná e Santa Catarina na 8 e Rio Grande do Sul na 9.

Essa coerência importa porque muitos sistemas deduzem a UF a partir do CEP e comparam com o estado digitado. Um CEP de Curitiba num endereço de Recife faz a validação falhar por culpa do dado. Com a faixa respeitada, o único motivo de falha passa a ser a consulta externa aos Correios ou ao ViaCEP, que não encontra o CEP fictício, comportamento esperado e que também precisa ser testado.

Endereço fake não é endereço real: o limite de uso

O termo endereço fake assusta, mas descreve um dado de teste, não uma fraude. A diferença está no destino do que foi gerado. Preencher o formulário de um sistema em homologação, popular um banco de desenvolvimento, ilustrar um manual ou testar cálculo de frete são usos legítimos. Informar esse endereço em cadastro verdadeiro, compra real, contrato ou documento oficial é outra coisa: pode configurar falsidade ideológica, além de simplesmente não funcionar, porque a entrega nunca chegaria.

Um sinal claro de uso correto: se o ambiente pudesse ser apagado amanhã sem prejuízo para ninguém, o dado fictício está no lugar certo. Se ali existe pedido, cobrança ou pessoa real esperando alguma coisa, não use.

Como usar o lote em linhas, CSV e JSON

Depois de gerar, a caixa de exportação abaixo dos cartões reescreve o lote no formato escolhido, e o botão de copiar leva tudo para a área de transferência. Em linhas, cada endereço ocupa uma linha no padrão de correspondência, separada por vírgula, bom para colar em documento ou mensagem. Em CSV, a primeira linha traz o cabeçalho com as sete colunas e as demais trazem os valores entre aspas, prontos para planilha ou importação em banco. Em JSON, o lote vira um array de objetos com as chaves logradouro, numero, complemento, bairro, cidade, uf e cep, que qualquer fixture consome direto.

A quantidade vai de 1 a 50; para bases maiores, gere em rodadas. A opção "CEP com hífen" define se o CEP sai como 01310-100 ou 01310100, o que importa quando o sistema aceita só um dos formatos. Cada cartão também tem cópia por campo, para formulário preenchido à mão.

Termos relacionados que esta ferramenta cobre

Quem chega aqui digitou coisas diferentes no Google e quer a mesma coisa. Gerador de endereço fictício, gerador de endereço fake e gerador de endereço falso são o mesmo pedido: um endereço que pareça verdadeiro para um teste, sem ser de ninguém. Gerador de endereço válido costuma significar validade de formato, ou seja, CEP com oito dígitos, UF com duas letras e logradouro com tipo e nome. Gerador de endereço com CEP pede que os dois venham coerentes entre si, e as faixas postais acima mostram como isso é garantido.

Também aparecem buscas por cidade, como gerador de endereço São Paulo ou endereço fictício de Curitiba: basta escolher a UF e marcar "Somente a capital". Quem procura gerador de endereço aleatório, endereço para cadastro de teste ou gerador de endereço em lote resolve com a saída em CSV e JSON.