O formato de endereço internacional é uma convenção de escrita, não um padrão único: cada país ordena as linhas de um jeito, usa nomes diferentes para a mesma divisão administrativa e decide se o endereço cabe em três linhas ou em seis. Quem desenvolve formulários precisa separar o que é dado do que é apresentação. Neste texto, mostramos como as ordens variam, quais campos aparecem e como exibir tudo isso sem perder informação.
Por que a ordem das linhas muda tanto
Existem duas famílias de convenção. Em boa parte do Leste Asiático, o endereço começa pelo maior e termina no menor: primeiro o país, depois a província ou o município, em seguida o bairro, a rua e, por último, o número. A leitura segue do geral para o específico.
Na maior parte da Europa e das Américas, o caminho é o oposto. Começa pelo mais específico: número, nome da rua, complemento, cidade, divisão e código postal. A leitura vai do ponto exato até o contexto que localiza esse ponto.
Nenhuma das duas é mais correta. Elas apenas refletem hábitos diferentes de leitura, e um formulário que ignora isso produz um resultado estranho para o leitor local mesmo quando todos os dados estão certos.
Que nomes cada país dá à divisão administrativa?
Este é o ponto que mais causa atrito em projetos internacionais. A divisão de primeiro nível abaixo do país recebe nomes distintos: é província em boa parte da América Latina e do Canadá, estado nos Estados Unidos e no Brasil, prefeitura ou província no Japão, região ou província na Itália, cantão na Suíça, emirado nos Emirados Árabes Unidos, condado em partes da Europa Oriental.
O código que representa essa divisão também é representado por uma norma internacional, o que ajuda a manter os dados consistentes entre sistemas, como explicamos em códigos de país e subdivisão. Mas a norma não decide o rótulo que aparece na tela.
O efeito prático é que o rótulo precisa acompanhar o país selecionado. Um campo chamado província obrigatório para os Estados Unidos, ou um campo chamado estado para o Japão, gera dúvida e erro de preenchimento. Chamar o campo de divisão ou de região quando o país ainda não foi escolhido é uma alternativa neutra.
Endereços em escrita local e romanizados
Outro ponto que costuma ser esquecido: muitos endereços são escritos com caracteres que não são latinos. Chinês, japonês, coreano, russo, tailandês, árabe e grego têm regras próprias de composição, e a versão romanizada é uma transliteração, não o endereço original.
Para envios internacionais, é comum que os dois apareçam, com a versão latinizada acompanhando a versão local para que o serviço postal do país de destino consiga processar. Em software, isso vira uma escolha de modelagem: guardar os dois campos, ou guardar um e gerar o outro na hora de exibir.
A decisão depende do uso. Para exibição em uma interface, um campo único costuma bastar. Para integração com serviços postais, a duplicidade é frequentemente necessária.
Como montar as linhas de um endereço?
A forma mais segura é tratar as linhas como um resultado da montagem, e não como a estrutura do dado. Na hora de exibir, o sistema consulta a convenção do país e ordena os componentes.
Uma montagem típica reúne quatro grupos:
- Identificação do destinatário, quando exigida.
- Linha do logradouro, com número e complemento.
- Linha da localidade, que costuma juntar cidade, divisão e código postal.
- Linha do país, que em envio internacional aparece por último, por convenção postal.
Fora desses grupos, alguns países precisam de linhas adicionais, como o bairro em endereços japoneses ou o distrito em endereços chineses. Um montador rígido, com número fixo de linhas, sempre perde alguma coisa.
Separando dado de apresentação
| Componente | É dado | Depende do país |
|---|---|---|
| Rótulo do campo | Não | Sim, muda de nome |
| Ordem das linhas | Não | Sim, segue a convenção local |
| Valor do logradouro | Sim | Não |
| Divisão administrativa | Sim | Sim, no conteúdo |
| Código postal | Sim | Sim, no formato |
A tabela resume a confusão mais frequente: ordem e rótulo parecem fazer parte do endereço porque aparecem juntos no papel, mas são decisões de exibição. O dado em si é o valor de cada componente.
Montando exemplos no gerador
No gerador de endereços, o resultado já vem diagramado conforme o hábito de escrita do país escolhido: a posição do número em relação ao nome da rua, a linha que carrega o código postal e a presença ou ausência da divisão administrativa são decididas pelo registro daquele país.
Isso é útil quando o objetivo é testar a interface e não apenas o banco de dados. Um formulário que recebe um endereço alemão em que a via e o tipo vêm unidos se comporta de modo diferente de um que recebe um endereço francês com o tipo separado e antes do nome. Comparar com a página da Alemanha e a da França deixa a diferença visível.
Para quem desenvolve: campos com um sentido só
A recomendação central é simples e vale a pena repetir: um campo, um sentido. Não use o mesmo campo de texto para guardar cidade, divisão e código ao mesmo tempo, e não reaproveite o campo de logradouro para instruções de entrega.
Depois disso, três cuidados resolvem a maior parte dos casos:
- Não chame nenhum campo de estado por padrão. O nome do campo deve ser neutro o suficiente para servir a todos os países que você aceita.
- Permita que a obrigatoriedade varie. Há países sem código postal e países em que a divisão não é escrita no endereço.
- Preserve o valor original. Normalizar para exibição é aceitável; sobrescrever o que o usuário digitou apaga evidência de erro e dificulta a correção.
Vale ainda registrar a convenção usada. Se a interface mostra o endereço de determinada forma, guardar essa informação evita que uma mudança futura de layout altere registros antigos.
Próximos passos
Se você está revisando uma tela de cadastro, escolha três países com convenções bem diferentes e verifique como o formulário se comporta em cada um — um do Leste Asiático, um europeu e um das Américas. Se precisa de exemplos prontos, gere um endereço por país no gerador de endereços e compare as linhas antes de escrever as regras de validação.