O formato de endereço nos EUA é um dos mais previsíveis do mundo: uma linha com número e nome da via, um complemento opcional, a cidade, a sigla de duas letras do estado e o código postal. Essa previsibilidade faz dele um excelente campo de testes, porque quase todo desvio é um erro de verdade. Neste texto, percorremos cada componente, mostramos onde as pessoas escorregam e explicamos o que vale conferir antes de publicar um formulário.
A linha do logradouro
A primeira linha começa pelo número do imóvel, seguido do nome da via e do tipo de via (rua, avenida, estrada, alameda). O número vem antes do nome, ao contrário do que acontece em boa parte da Europa. Depois do nome, podem aparecer o sentido das vias numeradas (norte, sul, leste, oeste) e um sufixo de quadra, que faz parte do endereço oficial e não é enfeite.
É comum que a mesma rua tenha nome longo, e que o formulário não tenha largura suficiente para ele. Truncar é pior do que parecer feio: a parte cortada pode ser justamente o sentido, e o endereço deixa de apontar para o lugar certo.
Como escrever o número da unidade?
Quando o endereço corresponde a um apartamento, uma sala ou uma loja dentro de um edifício, entra a linha da unidade, identificada por uma palavra abreviada mais um valor. A parte que confunde é a variedade: dependendo do imóvel, o identificador pode ser um número, uma letra ou uma combinação dos dois.
Três decisões resolvem isso na maioria dos formulários:
- A unidade tem campo próprio, separado do logradouro. Misturar as duas coisas quebra a correspondência de registros e atrapalha a exibição em etiquetas.
- O campo é opcional, porque a maior parte dos endereços residenciais não tem unidade.
- O identificador é texto, não número. Uma unidade igual a uma letra é perfeitamente válida.
Há ainda a linha secundária, usada para caixas postais e para rotas rurais, que têm formato próprio e não devem ser forçadas no mesmo campo do logradouro.
A sigla do estado e o código postal
A divisão de primeiro nível é identificada por uma sigla de duas letras. As siglas são padronizadas e mantidas por meio de uma publicação oficial do serviço postal americano, e é por isso que inventar uma abreviação é um erro difícil de detectar: o valor é curto, plausível e só falha quando alguém tenta usar.
O código postal tem cinco dígitos e pode receber um sufixo de quatro posições, escrito após um hífen, que aponta para uma faixa menor de entrega. O sufixo é opcional e não deve ser exigido de quem digita, mas precisa ser aceito e preservado quando vier.
Uma verificação que costuma valer a pena é a coerência entre estado e código: os códigos são distribuídos por área geográfica, e um par que não combina é um indício forte de erro de digitação. Não é uma prova, porque faixas podem se sobrepor a estados vizinhos, mas é um filtro barato.
Valores que podem aparecer além dos cinquenta estados?
Um formulário que só aceita as siglas dos cinquenta estados vai recusar endereços válidos. Existem territórios que usam o mesmo sistema de siglas, e existem endereços de instalações militares, que seguem um formato próprio de duas letras seguido de uma identificação numérica, com o país indicado de uma forma específica.
Para a maior parte dos sistemas, a decisão prática é aceitar o conjunto completo em vez do subconjunto mais conhecido. Uma lista de validação restrita a cinquenta unidades é uma fonte silenciosa de recusas, e o erro aparece na forma de cliente insatisfeito, não de mensagem de erro.
Comparando as partes do endereço
| Componente | Obrigatório | Formato | Erro típico |
|---|---|---|---|
| Número e nome da via | Sim | número antes do nome | truncar o nome |
| Unidade | Não | texto livre | obrigar quando não existe |
| Cidade | Sim | texto | abreviar de forma livre |
| Sigla do estado | Sim | duas letras padronizadas | aceitar sigla inventada |
| Código postal | Sim | cinco dígitos, com sufixo opcional | recusar o sufixo ou cortar o zero |
A última linha da tabela resume um problema que aparece em quase todo projeto: um formulário que aceita cinco dígitos e nada mais fica correto até o primeiro endereço com sufixo chegar.
Testando a estrutura no gerador
No gerador de endereços, os dados de um endereço americano saem coerentes: a cidade pertence à divisão escolhida, e o código postal segue o padrão daquela área. Isso é útil porque o erro mais comum em teste não é o formato, e sim a combinação — cidade de um estado com código de outro.
Se o seu caso de teste envolve uma lista de endereços, vale gerar vários exemplos em vez de repetir o mesmo. Para entender como o formulário deve tratar o país, a página de dados de endereço nos Estados Unidos ajuda a ver o conjunto de divisões e cidades disponíveis, e o texto sobre casos de teste do formulário de entrega mostra como transformar isso em uma bateria de verificações.
Para quem desenvolve: validação sem excesso de rigor
Algumas regras envelhecem bem, outras não. Estas costumam dar bom resultado:
- Valide a sigla do estado contra uma lista mantida, e não contra um padrão de duas letras quaisquer.
- Trate o código postal como texto, com cinco dígitos e sufixo opcional, e preserve o que o usuário digitou.
- Aplique como aviso, e não como bloqueio, a checagem de coerência entre estado e código. Bloquear impede casos legítimos de fronteira.
- Mantenha o endereço de cobrança e o de entrega como estruturas independentes, mesmo quando são iguais. Copiar o objeto inteiro cria acoplamento difícil de desfazer.
- Prepare casos com unidade alfabética, nome de via muito longo e código postal com sufixo. São os três que mais quebram formulários.
Próximos passos
Se você mantém um formulário de cadastro para esse país, revise hoje se o campo do estado aceita o conjunto completo e se o código postal com sufixo passa. Se o objetivo é montar dados de teste, gere exemplos no gerador de endereços e mantenha no repositório um caso por situação-limite em vez de um endereço único reutilizado.