O guia que eu gostaria de ter encontrado antes de perder duas tardes
A gente toda vez que precisa montar uma planilha de vendas ou alimentar um sistema que pega cadastros de clientes se depara com a mesma coisa: a coluna do estado fica errada. Não porque o conceito seja difícil, mas porque as siglas são tratadas de formas diferentes em sistemas distintos e isso gera confusão constante. O assunto é estados e siglas do Brasil. Vou direto ao ponto, porque não tem muito o que enrolar. São 26 estados mais o Distrito Federal, cada um com sua sigla de duas letras. São elas:
Estados e siglas completos
Acre (AC), Alagoas (AL), Amapá (AP), Amazonas (AM), Bahia (BA), Ceará (CE), Distrito Federal (DF), Espírito Santo (ES), Goiás (GO), Maranhão (MA), Mato Grosso (MT), Mato Grosso do Sul (MS), Minas Gerais (MG), Pará (PA), Paraíba (PB), Paraná (PR), Pernambuco (PE), Piauí (PI), Rio de Janeiro (RJ), Rio Grande do Norte (RN), Rio Grande do Sul (RS), Rondônia (RO), Roraima (RR), Santa Catarina (SC), São Paulo (SP), Sergipe (SE), Tocantins (TO). Isso é o básico. A parte que as pessoas não sabem e que causa dor de cabeça no dia a dia é que existem múltiplos padrões de codificação coexistindo.
O IBGE mantém a tabela oficial dos códigos dos municípios. A sigla do estado em si é padronizada pelo Denatran para emplacamento e é essa ABNT que todo mundo copia. Mas dentro do setor financeiro e de logística você vai encontrar outras versões. O antigo padrão do Banco Central usava códigos numéricos que ainda aparecem em sistemas legados. A Receita Federal em algumas declarações usa o código geográfico do IBGE que é diferente da sigla. E existem arquivos CSV de importação de ERP que simplesmente esperam MA para Maranhão e não aceitam apenas M, mesmo que M seja logicamente único o suficiente. O problema real começa quando você precisa cruzar dados. Me depari recentemente com um arquivo de notas fiscais de um fornecedor nordestino que vinha com o campo UF preenchido como "NE" em vez de MA. "NE" é a região Nordeste, não o estado. O sistema de importação rejeitou a nota inteira porque a validação só conhecia as duas letras padrão. O que eu fiz foi montar um mapeamento rápido num Excel com as dezesseis combinações problemáticas que encontrei naquela base: regiões substituídas por UF, nomes completos truncados, e alguns casos de AC sendo confundido com SC por erro de digitação. Depois disso, apliquei uma função PROCV para converter tudo. Levei cerca de quarenta minutos para limpar uns doze mil registros.
Se você tem um volume grande de dados pra tratar, esse mapeamento manual não escala. Uma alternativa prática é manter uma tabela de normalização separada do seu banco principal. Crie uma tabela com duas colunas: valor inconsistente e valor normalizado. Popula ela com os erros mais comuns que aparecem nos seus feeds de dados. Antes de inserir qualquer registro novo, faz uma consulta nessa tabela de normalização. Se achar correspondência, substitui. Se não achar, joga pro log de revisão manual. Esse processo cortou meu tempo de limpeza de base de quase uma hora para uns quinze minutos por lote. Outro detalhe que pouca gente leva em conta é a questão da acentuação e do Distrito Federal. O DF não é estado, mas na prática todo sistema pede sigla de UF e o DF entra nessa lista. Se você deixar o campo aceitar texto livre, vai receber "DF", "Distrito Federal", "D. Federal", e por aí vai. O ideal é travar o campo como dropdown forçando a sigla de duas letras. Isso elimina cerca de oitenta por cento dos problemas de inconsistência logo de cara.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Existe ainda a pegadinha do MS e do MT. Eles são visualmente idênticos se alguém copiar e colar sem prestar atenção. Já vi.planilha onde o Mato Grosso do Sul estava registrado como MT em alguns registros e MS em outros, e a validação de duplicidade não pegou porque os códigos diferentes fazia parecer que eram coisas distintas. Se sua chave primária ou seu índice de pesquisa inclui UF, teste sempre os dois casos juntos. Para quem quer um arquivo pronto, a melhor fonte é o site do IBGE. Eles disponibilizam uma cópia atualizada da tabela de unidades federativas em formato CSV e Excel, com código numérico, nome completo e sigla. É grátis e não exige cadastro. Também há a API do SIDRA que permite baixar a mesma tabela via requisição direta, útil pra automação.
O problema de usar tabelas prontas da internet é que elas podem estar desatualizadas. Já vi versão com Acrelândia como município e já vi versão que esquecia de incluir a nova sigla de alguma alteração administrativa menor. Sempre verifique a data do arquivo contra o site oficial do IBGE antes de confiar. Se o seu projeto envolve apenas leitura de dados públicos, usar a tabela do IBGE é suficiente. Se precisa de validação em tempo real e alta confiabilidade, o jeito mais seguro é consultar a API do IBGE ou integrar com um serviço de endereço que já mantém a tabela sincronizada. A desvantagem dessa abordagem é que você fica dependente da disponibilidade do serviço externo, e se a API cair no meio de um lote de importação, você para tudo até resolver.
A parte chata que ninguém conta é que a tabela muda ocasionalmente. Em 1988 o Tocantins foi criado e ganhou TO. Em 2023 houve discussão sobre mudança de nomenclatura de alguns municípios, mas as siglas estaduais permaneceram as mesmas. Mesmo assim, vale a pena checar a cada ano se alguma atualização foi publicada, porque esquecer um detalhe desses pode gerar divergência fiscal em declarações anuais. Se quiser começar agora com algo concreto, a estrutura mais segura é: crie uma tabela temporária com as vinte e sete siglas, importe seu arquivo bruto, faz o join pela coluna de UF, marca os que não encontraram correspondência e revisa manualmente só esses. Em bases normais de e-commerce ou cadastros de clientes, os que falham na maioria das vezes são menos de cinco por cento do total. O resto já entra limpo.
Resumindo o que realmente importa: use sempre a versão oficial do IBGE, normalize antes de validar, monitore os casos de MS versus MT, e mantenha a tabela de normalização do seu ERP separada do banco principal pra evitar bagunça. Feito isso, estados e siglas deixam de ser um pesadelo e viram apenas mais uma coluna na planilha.
