cnpj.ia.br

Glossário

Código SIAFI do município

Código SIAFI do município é o identificador de quatro dígitos que a administração federal usa para municípios e que a Receita Federal adota no layout do CNPJ. É o código que está no arquivo bruto dos dados abertos. Não é o código do IBGE, de sete dígitos, que é o padrão de todo cruzamento estatístico.

Como a Receita define: Lista de municípios SIAFI (Tesouro Nacional)

Existem dois códigos de município convivendo no mesmo endereço, e trocar um pelo outro é um erro silencioso: 9701 e 5300108 apontam para Brasília, mas nenhuma tabela aceita os dois. O SIAFI, de quatro dígitos, é o que a Receita Federal publica no arquivo do CNPJ. O código do IBGE, de sete, é o que o resto do país usa.

Dois códigos, dois mundos

  • SIAFI, quatro dígitos: nasceu no Sistema Integrado de Administração Financeira do governo federal, mantido pelo Tesouro Nacional. Vive dentro da máquina federal — orçamento, empenho, convênio, e o cadastro do CNPJ.
  • IBGE, sete dígitos: a chave estatística e geográfica do país. Censo, PIB municipal, malha territorial, RAIS, bases de saúde e educação, e o filtro municipio da busca de empresas.

Nenhum dos dois é derivado do outro. Não há conta que transforme 9701 em 5300108.

Como converter

A conversão é de tabela, não de fórmula: uma lista de para com os dois códigos e o nome do município. O Tesouro Nacional publica a tabela SIAFI e o IBGE publica a sua; o cruzamento se faz por nome e UF, com atenção aos municípios homônimos e às grafias antigas.

A API já entrega os dois lados prontos. O código do IBGE em endereco.codigo_municipio_ibge é convertido no processamento da Oportunidados justamente porque o layout oficial não o traz; o SIAFI vem como publicado, sem tratamento.

Como a API devolve

"endereco": {
  "municipio": "Brasília",
  "uf": "DF",
  "codigo_municipio_ibge": "5300108",
  "codigo_municipio_siafi": "9701"
}

Perfil basic, os dois como texto, com zeros à esquerda preservados. Na busca de empresas o filtro municipio recebe o código do IBGE de sete dígitos, nunca o SIAFI.

Como usar

  • Reconciliação com o arquivo bruto: quem baixa os dados abertos do CNPJ e compara com a resposta da API precisa do SIAFI, porque é o que está lá.
  • Sistemas federais: convênio, transferência e cadastro que falam com o governo federal costumam pedir o código SIAFI.
  • Qualquer outro cruzamento: use o IBGE. Mapa, censo, indicador municipal e o próprio filtro da busca falam sete dígitos.
  • Cadastro: guarde os dois. Descartar o SIAFI quebra a auditoria contra a origem; descartar o IBGE quebra todo o resto.

Campo completo em Campos da resposta.

Como aparece na resposta

CampoPerfilDescrição
endereco.codigo_municipio_siafibasicCódigo de município usado pela Receita Federal no layout do CNPJ (tabela SIAFI), tal como publicado. Não é o código do IBGE.

Perguntas frequentes

Qual a diferença entre o código SIAFI e o do IBGE?

O SIAFI tem quatro dígitos e é usado pela administração federal, inclusive no layout do CNPJ. O do IBGE tem sete e é o padrão de todo cruzamento estatístico e geográfico.

Dá para calcular um código a partir do outro?

Não. Nenhum dos dois é derivado do outro; a conversão é feita por tabela de para, cruzando nome do município e UF. A API já devolve os dois campos prontos.

Qual código a busca de empresas aceita no filtro de município?

O do IBGE, com sete dígitos. O SIAFI não é aceito como filtro; ele serve para reconciliar a resposta com o arquivo bruto dos dados abertos.

Por que a Receita Federal usa SIAFI e não IBGE?

Porque o cadastro nasceu dentro da administração financeira federal, que já tinha a sua tabela de municípios. O layout oficial do CNPJ não traz o código do IBGE.

Termos relacionados

Leia também

Atualizado em