Uma guide prática para quem precisa lidar com nomes de países no dia a dia
Trabalhando com localização de dados, já processei milhares de listagens de países em formatos diferentes. O problema é mais comum do que parece. Você baixa uma planilha de um fornecedor na Ásia e descobre que o campo "país" tem três grafias para Japão, duas para Estados Unidos e um monte de abreviações aleatórias. A solução não é tão complicada, mas exige saber onde procurar e o que evitar.
Aprender nomes dos países: o que realmente funciona
O primeiro passo é definir qual padrão você vai usar. ISO 3166-1 é o padrão mais usado no mercado, com códigos de duas letras (BR para Brasil), três letras (BRA) e números (076). Se o seu sistema só aceita um formato, converter o resto entra nessa rotina. A maioria das vezes, um banco de dados bem montado com as equivalências resolve o problema em minutos, não em horas. Já me deparei com um caso específico onde uma empresa europeia enviava "République du Congo" e "Congo" como se fossem países diferentes, quando na verdade um era Congo-Brazzaville e o outro Congo-Kinshasa (República Democrática do Congo). A confusão gerou duplicações na base de clientes que levaram semanas para serem corrigidas. A solução foi cruzar com os códigos numéricos do ISO: 180 para Congo-Brazzaville e 189 para RD Congo. Códigos numéricos são imunes a variações de ortografia, o que evita esse tipo de dor de cabeça.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Para quem precisa de uma base pronta, existem downloads gratuitos em formatos CSV, JSON e SQL. O site da Iso.codes traz a tabela completa atualizada, incluindo territórios dependentes e regiões especiais. Se você prefere algo já formatado para importação em sistemas, a UN Data oferece dumps semanais com nomes oficiais em inglês, francês e espanhol. Para desenvolvimento, a biblioteca do JavaScript chamada "countries-list" ou o pacote Python "pycountry" economizam tempo considerável comparado a construir a lista manualmente. Um detalhe que muita gente esquece: alguns países têm mudanças de nome recentes. Em 2018, a Tailândia passou a ser oficialmente Thailand também em documentos da ONU, e a Macedonia do Norte foi renomeada em 2019. Listas desatualizadas ainda circulam pela internet e podem causar inconsistência se você baixar algo sem verificar a data de atualização. Sempre cheque a data da última modificação antes de confiar na fonte.
Outro ponto que passa despercebido: a diferença entre nome comum e nome oficial. "EUA" é o uso corrente, mas o nome oficial é United States of America. Se o seu sistema usa match por string, essa distinção importa. Uma vez configurei um validador que aceitava apenas o nome oficial e perdi quase dois dias debugging porque os usuários inseriam "USA", "America", "EUA" e até "Estados" em campos que pareciam triviais. A correção foi adicionar uma tabela de sinônimos mapeados, não confiar em normalização simples de texto. Se você está começando agora, recomendo seguir esta ordem: baixe a tabela ISO completa, escolha o formato compatível com seu sistema, crie uma tabela de sinônimos e faça testes de integração com dados reais antes de colocar em produção. Isso evita retrabalho depois. Dados sujos sempre aparecem eventualmente, o que adianta estar preparado para isso antes do primeiro ticket de suporte chegar.
