A tabela que todo mundo usa e poucos entendem de verdade
A tabela estados do brasil parece coisa simples no primeiro olhar, mas na prática ela é mais complicada do que a maioria das pessoas admite. Eu já perdi tempo demais tentando validar CNPJs e CPFs contra uma tabela que não estava atualizada, então vou explicar como isso funciona de fato, sem enrolação. O que a maioria das pessoas chama de tabela de estados é, na realidade, um conjunto de códigos usados em sistemas fiscais, logísticos e de cadastro. O IBGE mantém a versão oficial com os 27 Unidade Federativas — 26 estados mais o Distrito Federal — e cada um tem um código numérico de dois dígitos. São esses números que aparecem em notas fiscais, planilhas de frete, sistemas de CRM e praticamente qualquer software que lide com dados geográficos brasileiros.
como usar a tabela estados do brasil na prática
No dia a dia, você vai encontrar isso principalmente em três contextos. O primeiro é o cadastro de clientes e fornecedores. Aqui o erro mais comum é confundir a sigla do estado com o código numérico do IBGE. AC é Acre, sim, mas o código que realmente importa nos sistemas é 01. Se você está construindo um banco de dados ou migrando informações de uma planilha, use sempre o código numérico. Siglas geram ambiguidade, especialmente com campos que aceitam texto livre. O segundo contexto é a emissão de notas fiscais eletrônicas. O campo UF na NF-e exige o código do IBGE, não a sigla. Já vi gente tentando enviar AC e o sistema rejeitando porque o padrão é 01. A SEFAZ não aceita variação. Se estiver usando uma API de emissão, certifique-se de que o mapeamento entre estado e código está correto antes de subir para homologação.
👉 Clique no botão abaixo para saber mais sobre o assunto!
O terceiro contexto, e aqui está o problema que mais causa dor de cabeça, é a tabela de ICMS interestadual. Os alíquotas variam dependendo do estado de origem e de destino, e essa tabela mudou várias vezes nos últimos anos. Em 2021 teve uma regramentação importante com a EC 154 que alterou bastante a dinâmica. Se você está configurando uma tabela de imposto num sistema ERP, não confie em planilhas que circulam na internet. Sempre consulte o site da Receita Federal ou do fazenda estadual do seu estado para a versão mais recente. Um problema específico que eu enfrentei foi quando precisei crossreferenciar uma base de clientes com mais de 40 mil registros contra a tabela de estados para calcular frete. O sistema usava siglas em vez de códigos numéricos, e havia cerca de 12% dos registros com estados mal preenchidos — "SP" vs "Sao Paulo" vs "sul de minas" que o cliente digitou sem criterio. A solução foi criar um dicionário de normalização com mapeamento de variantes para os códigos IBGE corretos e rodar um script de limpeza antes de processar. Isso cortou o tempo de processamento de quatro horas para onze minutos, e eliminou os erros de frete que estavam custando dinheiro real.
Outro detalhe que pouca gente leva em conta é que o código do IBGE não é fixo no sentido de que novos territórios podem ser criados. O último caso recente foi a criação do Território de Fernando de Noronha como distrito de Pernambuco, mas os códigos dos estados em si não mudaram. O que muda são os limites municipais e a quantidade de municípios por estado, o que afeta tabelas que dependem dessa desagregação menor. Se você precisa da tabela completa para consultar ou integrar num sistema, o formato mais limpo é o CSV disponibilizado pelo IBGE no site deles. Tem código numérico, código de two dígitos, nome do estado e sigla. Também existem versões em JSON e XML distribuídas por APIs de dados abertos, mas a fonte primária continua sendo o IBGE. Evite tabelas de terceiros que não citam a fonte, porque elas frequentemente estão desatualizadas e você vai ter problemas de compliance depois.
O problema principal dessa abordagem manual é que a manutenção é constante. Mudanças nas regras de ICMS, ajustes nos códigos de CFOP, e a inclusão de novos municípios exigem que você revise a tabela periodicamente. Sistemas que não fazem atualização automática acabam gerando notas fiscais com dados incorretos, e isso pode gerar autuação fiscal. Um caminho mais seguro é usar uma API confiável que atualiza automaticamente, como as disponíveis no portal de dados abertos do governo ou provedores especializados em dados fiscais, mesmo que isso implique um custo mensal. A versão mais comum que as pessoas procuram tem exatamente 27 linhas. Cada linha contém o código numérico de um dígito ou dois dígitos, a sigla e o nome completo. Começa com 11 e termina com 53. Se alguém te vender uma tabela com mais ou menos linhas, verifique a fonte antes de confiar nela.
