Casos de teste do formulário de endereço de entrega

O formulário de endereço de entrega é a etapa em que mais gente desiste de uma compra, e quase sempre por um motivo que o time não testou: um campo que não aceita o formato local, uma validação rígida demais ou um país que muda a tela e apaga o que já estava preenchido. Neste texto, reunimos os casos que valem a pena cobrir, explicamos o que cada um protege e mostramos como deixar a bateria enxuta o bastante para ser executada de verdade.

Quais campos devem ser obrigatórios?

A resposta depende do país, e é aí que a maioria dos formulários erra. Existe um núcleo que costuma ser obrigatório em qualquer lugar: nome do destinatário e alguma forma de localizar o endereço, com logradouro e cidade. O resto varia.

Código postal é obrigatório em muitos países e não existe em outros. Divisão administrativa é exigida em alguns sistemas e dispensada em outros. Complemento de unidade, referência e ponto de referência são opcionais por natureza.

O caso de teste que costuma revelar problemas é justamente o do país sem código postal. Se o formulário marca o campo como obrigatório de forma fixa, o cliente não consegue concluir a compra e a mensagem de erro não faz sentido no contexto dele.

O que acontece quando o país muda?

Esse é o teste que mais encontra defeito, porque a troca de país dispara toda a lógica específica de uma vez. As perguntas a responder são concretas: os campos aparecem e desaparecem corretamente? O rótulo da divisão muda para o nome que o país usa? O que já estava preenchido é preservado, ou o formulário limpa tudo?

Teste a troca nos dois sentidos e com dados já digitados. Um comportamento aceitável é manter o que continua válido e limpar apenas o que deixou de fazer sentido. Apagar o formulário inteiro é hostil com quem trocou o país por engano.

Vale também verificar se a obrigatoriedade é reavaliada. Um formulário que exige código postal porque o país inicial exigia, e continua exigindo depois da troca, produz o pior resultado possível: um erro que o cliente não consegue corrigir porque o campo está oculto.

Como testar limites de linha e de caracteres?

Endereços longos existem e são comuns. Teste com logradouro acima do esperado, com palavras longas sem espaço, com acentuação e com caracteres não latinos. Em interfaces com largura fixa, corte o teste em dois: um caso para o limite do campo e outro para o limite visual, porque um campo pode aceitar mais do que a etiqueta consegue imprimir.

Inclua pelo menos um caso de colagem. Quando alguém copia um endereço de um aplicativo de mensagens, o texto costuma vir com quebras de linha no meio, espaços duplos e pontuação variada. Um campo que rejeita a colagem por causa de um caractere invisível gera frustração imediata.

O preenchimento automático do navegador merece um caso próprio. Ele insere os componentes em campos específicos, e um mapeamento trocado coloca o número da casa no complemento ou a cidade no campo de divisão sem que ninguém perceba.

O que verificar no código postal?

Três grupos de verificação cobrem o essencial. O primeiro é o formato: o campo aceita o padrão do país, incluindo letras quando existem, e preserva zeros à esquerda. O segundo é a coerência: o código informado combina com a divisão ou a cidade escolhida. O terceiro é a mensagem de erro, que precisa dizer o que está errado sem culpar o cliente.

O caso que mais aparece em relatos é o zero à esquerda perdido. Se o formulário transforma o valor em número em algum ponto do caminho, o dado sai errado e sem aviso. Teste com um código que comece por zero e compare o que chegou ao servidor com o que foi digitado.

Vale ainda testar o preenchimento parcial: muitas pessoas conhecem o código postal, mas não o restante do endereço, ou o contrário. Permitir que a busca ajude a completar os outros campos reduz erro de digitação e melhora a taxa de conversão.

Cobrança igual à entrega

Um caso simples que muita gente esquece é a caixa que copia o endereço de cobrança para o de entrega. Teste o estado inicial dessa opção, a cópia efetiva e o que acontece quando o cliente desmarca depois de já ter editado o endereço de entrega. Editar os dois separadamente e voltar a marcar a caixa deve ter um comportamento definido, e não um que apague as edições sem aviso.

Teste também o caminho oposto: cobrança em um país e entrega em outro. É uma situação real, comum em compras internacionais, e formulários que assumem países iguais quebram nesse ponto.

No gerador e no restante do guia

Para executar esses casos sem inventar dados, o gerador de endereços monta exemplos coerentes por país: a cidade pertence à divisão escolhida, o código postal segue o padrão da região e o telefone usa o plano local. Isso permite criar o cenário de endereço alemão, japonês ou canadense com um clique, em vez de pesquisar um exemplo manualmente.

Vale combinar essas verificações com o texto sobre validação e normalização, que explica a ordem correta das etapas, e com a lista de verificação de testes de endereço e telefone internacionais, que cobre outros pontos do mesmo fluxo.

Para quem desenvolve: montando a matriz de casos

A matriz fica grande com facilidade, então vale estruturá-la em três eixos: país, cenário de preenchimento e ação do usuário. País define as regras; cenário define o que foi digitado; ação define a interação, como colar, apagar, trocar de país ou usar o preenchimento automático.

Na prática, não é preciso cruzar todos os valores. Escolha de quatro a seis países que representem formatos distintos, três cenários de preenchimento (mínimo, completo, inválido) e as ações mais usadas. Isso já cobre a maior parte dos defeitos com uma bateria executável.

Dois cuidados de interface merecem caso próprio. No celular, cada campo deve abrir o teclado adequado, e o formulário não deve reposicionar a tela de forma que o cliente perca de vista o campo que está editando. Para leitores de tela, cada campo precisa de rótulo associado, e o erro precisa ser anunciado, não apenas colorido de vermelho.

Próximos passos

Comece pelos dois casos que mais aparecem em reclamação: país sem código postal obrigatório e perda de dados ao trocar o país. Depois, gere uma massa de exemplos no gerador de endereços e transforme a matriz em um teste automatizado que rode a cada alteração no formulário.