Validador de Código IBGE de Cidade

Codigo IBGE de municipio: o identificador de 7 digitos de toda cidade brasileira

O codigo IBGE de municipio e o identificador numerico de 7 digitos que o Instituto Brasileiro de Geografia e Estatistica atribui a cada um dos 5.570 municipios brasileiros (contagem do Censo 2022), mais o Distrito Federal. E a chave canonica usada por praticamente todo dataset publico, layout fiscal e programa federal que precisa diferenciar uma cidade brasileira de outra com mesmo nome — e ha dezenas dessas colisoes, como Santa Cruz (RN, MG, PB), Nova Esperanca ou Sao Jose.

Diferente do CEP, que agrupa quadras de ruas e muda com frequencia, o codigo IBGE e geopolitico: so muda quando uma cidade e criada, fundida ou desmembrada. Uma vez emitido, o codigo nunca e reatribuido a outro municipio, mesmo que o original deixe de existir. Essa estabilidade o torna a chave preferida para juntar dados do censo, eleicoes (TSE), saude (DATASUS), educacao (INEP) e tributacao (RFB).

Anatomia dos 7 digitos

O codigo segue layout fixo que permite validacao parcial por inspecao:

• Digitos 1 e 2: codigo da unidade federativa (UF), de 11 (Rondonia) a 53 (Distrito Federal), igual a tabela UF do SIAFI/RFB.
• Digitos 3 a 6: microcodigo sequencial atribuido pelo IBGE quando o municipio e reconhecido.
• Digito 7: digito verificador historico calculado originalmente pelo IBGE; hoje a maioria dos validadores exige apenas comprimento 7 e prefixo UF correto.

Exemplos reais da tabela canonica: 3550308 Sao Paulo capital (SP), 3304557 Rio de Janeiro capital (RJ), 5300108 Brasilia (DF), 3106200 Belo Horizonte (MG), 4205407 Florianopolis (SC), 4314902 Porto Alegre (RS), 2304400 Fortaleza (CE), 2611606 Recife (PE), 2927408 Salvador (BA), 1302603 Manaus (AM), 1501402 Belem (PA), 5208707 Goiania (GO), 5103403 Cuiaba (MT), 5002704 Campo Grande (MS).

Tabela de prefixos UF

O codigo UF de 2 digitos e o mesmo em todos os layouts federais (NF-e, eSocial, IRRF). Use como sanity check rapido:

• 11 RO, 12 AC, 13 AM, 14 RR, 15 PA, 16 AP, 17 TO
• 21 MA, 22 PI, 23 CE, 24 RN, 25 PB, 26 PE, 27 AL, 28 SE, 29 BA
• 31 MG, 32 ES, 33 RJ, 35 SP
• 41 PR, 42 SC, 43 RS
• 50 MS, 51 MT, 52 GO, 53 DF

Note as lacunas intencionais (34, 44, 54 nao existem). A numeracao foi fixada nos anos 1970 e preserva a hierarquia original da federacao.

Usos obrigatorios em layouts do governo eletronico

O codigo IBGE e requerido em dezenas de envios obrigatorios:

• NF-e — campos cMun (municipio da operacao), cMunFG (fato gerador) e cMunDescarga.
• NFS-e — o ISS sobre servico e recolhido para o municipio identificado pelo codigo IBGE, nao pelo CEP.
• eSocial — layouts S-1010 (Estabelecimento) e S-2200 (Admissao) exigem codMunic do local de trabalho.
• RAIS, CAGED, DIRF, IRRF — segmentacao geografica sempre por codigo IBGE.
• SUS DATASUS — bases de hospitais e procedimentos chaveadas por codigo.
• SIOPS, FINBRA — relatorios de financas publicas.
• Registro civil, MapBiomas, alertas de desmatamento INPE — crosswalks geograficos.

APIs publicas gratuitas e o stack BR

O IBGE publica uma API REST publica e gratuita em servicodados.ibge.gov.br/api/v1/localidades/municipios. Suporta filtros por UF (/estados/SP/municipios), regiao e mesorregiao. O endpoint nao exige chave de API e limita a algumas milhares de requisicoes por hora por IP. A resposta e JSON com campos id (codigo de 7 digitos), nome, microrregiao, mesorregiao, UF.

A BrasilAPI mantida pela comunidade (brasilapi.com.br/api/ibge/municipios/v1/{UF}) embrulha os mesmos dados com cache extra e CORS aberto por padrao — util para checkouts de e-commerce que precisam popular um dropdown de cidade depois que o cliente escolhe a UF. Juntas, IBGE e BrasilAPI cobrem ~99% das necessidades de geo-lookup de uma fintech, marketplace ou logistica brasileira.

Curiosidades e casos de borda

Fatos uteis ao construir features geograficas brasileiras:

• Maior municipio em area: Altamira (PA), codigo 1502400, cobrindo 159.696 km² — maior que todo o estado do Acre e muitos paises europeus.
• Menor em area: Santa Cruz de Minas (MG), codigo 3158300, apenas 3,565 km².
• Mais populoso: Sao Paulo capital com ~11,5 milhoes de habitantes.
• Menos populoso: Serra da Saudade (MG), com ~770 habitantes (Censo 2022).
• O Distrito Federal e um caso especial: codigo unico 5300108 para todo o DF, ainda que administrativamente dividido em Regioes Administrativas (RAs) que nao sao municipios.
• CNEFE (Cadastro Nacional de Enderecos para Fins Estatisticos) faz o cruzamento entre cada codigo IBGE e todo endereco da pesquisa censitaria.
• Codigos de municipios extintos permanecem na tabela historica do IBGE para sempre — nunca sao reciclados.

FAQ

A API do IBGE e realmente gratuita?

Sim. servicodados.ibge.gov.br e um servico publico mantido com recursos do contribuinte e nao exige cadastro nem chave de API. Tem rate limit para evitar abuso, mas e generosa para uso em producao.

O codigo pode mudar para uma cidade existente?

Nao. Uma vez emitido, o codigo de 7 digitos e vitalicio. Se uma cidade e fundida ou desmembrada, um codigo novo e criado para a nova entidade, mas o original e preservado em tabelas historicas. Isso e critico para analises longitudinais do censo.

Quantos municipios existem hoje?

5.570, conforme a tabela de referencia do Censo IBGE 2022. O numero esta estavel desde 2013 porque a maioria das constituicoes estaduais apertou as regras de criacao de novos municipios apos a CF/1988 ter permitido divisao quase livre.

O codigo IBGE e o mesmo que o codigo SIAFI ou TSE?

Nao, sao distintos. O SIAFI usa codigo de 4 digitos para centros de custo fiscais; o TSE usa codigo proprio de 5 digitos para zonas eleitorais. O codigo IBGE de 7 digitos e o mais amplamente adotado, mas layouts federais podem exigir tabelas de conversao ao integrar dados do TSE ou SIAFI.

Duas cidades podem ter o mesmo nome?

Sim, com muita frequencia. Santa Cruz, Nova Esperanca, Sao Jose e Cruzeiro aparecem dezenas de vezes na federacao. O codigo IBGE e a unica forma de diferencia-las com confianca em software.