Gerador de Pessoas LogoGeradordePessoas

Gerador de Endereços e CEP Brasileiro

Endereços fictícios com coerência geográfica por estado. Valide formulários de checkout, APIs de frete e integrações com Correios sem expor dados reais.

Compatível com LGPD Coerência Geográfica

Geradores por cidade - Otimizados para testes localizados

São Paulo →Rio de Janeiro →Belo Horizonte →Curitiba →Salvador →

Conceito de Coerência Geográfica

O Gerador de Endereços Brasileiros é um sistema de mapeamento sintético que vincula CEPs reais a logradouros fictícios, garantindo que testes de logística e frete operem com dados geograficamente corretos.

Endereços fictícios: o campo mais complexo do e-commerce sob a perspectiva do Dr. M. Mobeen

Um guia técnico completo para testar formulários de entrega no Brasil.

Do ponto de vista de QA, o campo de endereço é o mais perigoso de testar inadequadamente. Ele envolve múltiplos campos interdependentes (logradouro, número, complemento, bairro, cidade, estado, CEP), regras de negócio complexas (zonas de entrega, cálculo de frete por região), integração com APIs externas (Correios, Google Maps) e restrições fiscais (ICMS por estado). Uma string genérica como "Rua Teste, 1" não vai descobrir nem 10% dos bugs reais.

Passo a Passo para Testes de Entrega

  1. 01Acesse a plataforma supervisionada pelo Dr. Mobeen.
  2. 02Filtre por estado para garantir a alíquota correta de ICMS.
  3. 03Gere o endereço e valide a correspondência do CEP.
  4. 04Mocke a API de Correios/ViaCEP usando o payload gerado.

"Endereço é o campo que mais gera atrito em checkouts. Testar com coerência geográfica via Dr. Mobeen garante que seu sistema de logística não falhe em edge-cases interestaduais."

Um endereço brasileiro completo para um sistema de e-commerce precisa de pelo menos 6 campos funcionando em harmonia:

CampoExemploO que testar
LogradouroRua das FloresTipo: Rua / Av / Travessa / Alameda
Número1247Sem número (s/n), número muito grande (99999)
ComplementoApto 42, Bloco BCampo optional - null não deve quebrar
BairroPinheirosBairros com acentos e nomes compostos
CEP05422-030Com e sem hífen, CEP inexistente, CEP de outro estado
Cidade + UFSão Paulo, SPCoerência: cidade ≠ estado do CEP

Testando zonas de entrega e cálculo de frete

Um dos maiores desafios de QA em e-commerces brasileiros é garantir que as regras de frete funcionam corretamente para diferentes regiões. O Brasil tem uma disparidade enorme de frete entre capitais e interior, entre Sul+Sudeste e Norte+Nordeste. Um bug de cálculo de frete pode custar caro - literalmente.

Teste de capital vs. interior

Gere um endereço de São Paulo (capital) e um de interior (Sorocaba, SP) e verifique se o frete e prazo diferenciam corretamente.

Teste de zona de restrição

Gere endereços de AC, RR, AM - estados de acesso difícil. Verifique se o sistema rejeita ou oferece opções alternativas adequadas.

Teste de cálculo de ICMS

CEPs de RS, SP e AM têm alíquotas de ICMS diferentes para e-commerce. Confirme que o imposto no pedido muda conforme o estado de destino.

Teste de formato de CEP

CEP com hífen '01310-100' e sem hífen '01310100' devem ambos funcionar. Teste que a sanitização ocorre antes da consulta à API dos Correios.

Mockando a API ViaCEP no Cypress

Em vez de deixar seus testes E2E dependerem de uma API externa instável, intercepte a chamada e retorne nosso payload. Isso torna seus testes determinísticos e 10x mais rápidos:

// cypress/e2e/checkout.cy.ts

cy.intercept("GET", "https://viacep.com.br/ws/*/json/", {
  statusCode: 200,
  body: {
    cep: "04538-133",
    logradouro: "Avenida Brigadeiro Faria Lima",
    bairro: "Itaim Bibi",
    localidade: "São Paulo",
    uf: "SP",
    ibge: "3550308"
  }
}).as("viaCep");

cy.get("[data-testid='cep-input']").type("04538133");
cy.wait("@viaCep");
cy.get("[data-testid='cidade']").should("have.value", "São Paulo");

Dica de Senior QA

Sempre que possível, crie dois cenários: um com intercept (para o happy path determinístico) e um sem intercept (para o teste de integração real que roda apenas no CI com acesso à internet). Você terá velocidade nos testes locais e garantia de integração real no pipeline.

Perguntas Frequentes - Endereços para QA

Os CEPs gerados são sintéticos - eles seguem o padrão numérico por estado (ex: CEPs de SP começam com dígitos na faixa de 01000 a 19999), mas não correspondem a endereços físicos reais. Para testes que dependem da API ViaCEP, a melhor prática é interceptar a requisição no Cypress (cy.intercept) ou Playwright (page.route) e retornar nosso payload como resposta mockada - isso garante que seus testes não dependem de serviços externos.

No gerador acima, selecione o estado desejado no filtro lateral antes de clicar em GERAR. A engine automaticamente vincula a cidade e o CEP ao estado selecionado, garantindo coerência geográfica. Para gerar centenas de endereços de um estado específico via API, envie o parâmetro 'estado': 'SP' no body do POST a /api/generate.

Consistência geográfica significa que a cidade, o estado e o CEP gerados fazem sentido juntos - São Paulo (SP) nunca aparece com o CEP de Salvador (BA). Isso importa porque sistemas de logística, calcúlo de ICMS e restrições de entrega usam a combinação de CEP + Estado para tomar decisões. Dados inconsistentes causam falsos positivos nos testes e mascaram bugs reais.

Gere endereços dos estados que você quer testar, use-of como input no formulário de checkout simulado, e verifique se o sistema responde corretamente (permite ou nega entrega, calcula frete corretamente, mostra prazo correto). Para sistemas que só entregam em SP, teste com endereços de SP (aprovado) e de MA (negado) e certifique que ambos os casos têm o comportamento esperado.

Não. Os endereços são estritamente para testes em ambientes de desenvolvimento, homologação e QA. Usar dados fictícios em formulários reais para completar compras, criar contas ou obter vantagens configura falsidade ideológica. Use exclusivamente em ambientes controlados de desenvolvimento.

Use nossa ferramenta de Perfil Completo na página inicial - ela gera nome, CPF, RG, endereço e telefone em um único payload JSON coerente. Se prefere a API, chame POST /api/generate com o estado desejado e o retorno inclui todos os campos de identidade já vinculados geograficamente.

A consistência entre CEP e cidade é garantida através do mapeamento sintético das faixas de CEP oficiais de cada estado brasileiro. O algoritmo do Dr. Mobeen assegura que, ao selecionar uma UF, o CEP gerado obrigatoriamente respeite a numeração regional dos Correios, mantendo a integridade necessária para que seus validadores geográficos não rejeitem o dado.

Sim, nossos endereços são ideais para o teste de cálculo de frete interestadual devido à manutenção rigorosa da coerência entre UF e CEP. Você pode validar se o seu motor de logística (como Intelipost ou Frenet) identifica corretamente as zonas de origem e destino, aplicando as tabelas de preço e prazos reais para cada região.

O teste de checkout para zonas de risco é realizado através da geração de endereços em capitais e interiores com restrições logísticas conhecidas. Use nossas ferramentas por cidade para validar se as suas regras de negócio respondem adequadamente a diferentes zonas de CEP, aplicando taxas de risco ou bloqueios de entrega conforme a política da loja.

A consistência geográfica é vital para o cálculo do ICMS (DIFAL) porque o imposto é determinado pela UF de destino vinculada ao CEP. O Dr. Mobeen garante que a tríade Cidade, Estado e CEP esteja sempre correta para evitar falhas tributárias ou geração de guias de imposto errôneas durante os seus testes fiscais.

Complete sua base de dados de teste

Endereço é só o começo. Monte fixtures completas com identidade, documentos e contato.

Perfil CompletoEndereço + CPF + Nome + Telefone juntosAcessar Gerador de CPFVincule documento ao endereçoAcessar API RESTGere centenas via código Python/JSAcessar