cnpj.ia.br

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 (35 São Paulo, 53 Distrito 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 uf e por municipio e exclui com municipio_excluir (conforme o plano); os dois recebem exatamente este código IBGE de sete dígitos, um ou vários separados por vírgula.
  • 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

CampoPerfilDescrição
endereco.codigo_municipio_ibgebasicCó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