Glossário
Código do município (IBGE)
Código do município IBGE é o identificador de sete dígitos que o IBGE atribui a cada município: dois da unidade da federação, quatro do município e um verificador. É a chave padrão para cruzar o endereço de um CNPJ com censo, PIB e qualquer base pública; a Receita Federal publica outro código, o SIAFI, que a API também devolve.
Como a Receita define: Tabela de códigos dos municípios (IBGE)
Todo mundo que cruza empresa com território esbarra no mesmo problema: o cadastro do CNPJ não traz o código do IBGE. A Receita Federal usa a tabela de municípios do SIAFI, de quatro dígitos, própria da administração federal; o resto do país (IBGE, Correios, prefeituras, bases de saúde e educação, mapas) usa os sete dígitos do IBGE. A API do cnpj.ia.br devolve os dois, e a conversão é feita pela Oportunidados no processamento da base.
Os dois códigos
- IBGE, 7 dígitos (
endereco.codigo_municipio_ibge):UU+MMMM+D. Os dois primeiros são a UF (35São Paulo,53Distrito Federal), os quatro seguintes identificam o município dentro dela, o último é dígito verificador. É a chave para censo, PIB municipal, malha geográfica, RAIS, CNES e praticamente qualquer dado público por município. - SIAFI, 4 dígitos (
endereco.codigo_municipio_siafi): a tabela que a Receita Federal usa no layout do CNPJ, tal como publicada. Serve para bater com o arquivo bruto dos dados abertos e com sistemas do governo federal; fora deles, quase ninguém fala SIAFI.
O nome do município (endereco.municipio) e a UF (endereco.uf) vêm junto, para leitura humana; a chave de cruzamento é o código, porque nome de cidade repete entre estados e muda de grafia.
Como a API devolve
"endereco": {
"municipio": "BRASILIA",
"uf": "DF",
"codigo_municipio_ibge": "5300108",
"codigo_municipio_siafi": "9701"
}
Perfil basic, os dois como texto, com zeros à esquerda preservados. O código IBGE pode vir null quando a conversão não encontra correspondência (município novo ou registro incompleto na origem); o SIAFI vem como publicado. Detalhe em Campos da resposta.
Como usar
- Cruzamento com dados públicos: use sempre o IBGE de 7 dígitos como chave; nunca o nome.
- Filtros territoriais: a busca de empresas filtra por
ufe pormunicipio, e o filtro de município recebe exatamente este código IBGE de sete dígitos. - Mapas: os dois primeiros dígitos do IBGE dão a UF sem consulta extra; os sete dão o polígono do município em qualquer malha do IBGE.
- Reconciliação com o arquivo bruto da Receita: use o SIAFI, que é o que está lá.
Como aparece na resposta
| Campo | Perfil | Descrição |
|---|---|---|
endereco.codigo_municipio_ibge | basic | Código IBGE do município, 7 dígitos. Derivado: convertido pela Oportunidados a partir do código da Receita, porque o layout oficial não traz o código do IBGE. |
Perguntas frequentes
Por que a API devolve dois códigos de município?
Porque a Receita Federal publica o código da tabela SIAFI e o resto do país usa o do IBGE. A API devolve o SIAFI como veio e o IBGE convertido pela Oportunidados, para cruzar com bases públicas sem tabela intermediária.
O código IBGE pode vir vazio?
Pode vir null quando a conversão não encontra correspondência, por município novo ou registro incompleto na origem. O código SIAFI e o nome do município continuam vindo.
Qual código uso para cruzar com dados do censo, PIB ou saúde?
O do IBGE, com sete dígitos e zeros à esquerda preservados. É a chave de praticamente toda base pública municipal brasileira.
Os dois primeiros dígitos do código IBGE são a UF?
Sim. Eles identificam a unidade da federação, então dá para agrupar por estado sem consultar tabela; a API também devolve a sigla em endereco.uf.
Termos relacionados
Leia também
Atualizado em