Tabela de conteúdos

Despesa do Orçamento Federal (LOA) em CSV e Parquet: dicionário de dados

Esta página descreve os arquivos loaANO.csv.gz e loaANO.parquet publicados na página de Dados Abertos. Eles trazem a despesa dos Orçamentos Fiscal e da Seguridade Social de um exercício: projeto de lei (PLOA), autógrafo, dotação inicial, dotação atualizada e execução (empenhado, liquidado e pago), com todas as classificações da programação.

Os dois arquivos têm as mesmas linhas e as mesmas colunas. Escolha pelo uso:

Arquivo Para quem Formato
loaANO.csv.gz Planilhas e qualquer programa que leia texto CSV conforme a RFC 4180: separador vírgula, ponto como separador decimal, aspas só quando o campo tem vírgula, aspas ou quebra de linha, codificação UTF-8, primeira linha com os nomes das colunas. Compactado com gzip
loaANO.parquet Python, R, bancos de dados e ferramentas de análise Apache Parquet, com os tipos de cada coluna (texto, inteiro e decimal), compressão zstd

São gerados junto com o arquivo RDF (loaANO.zip) e com os dados do endpoint SPARQL, na mesma execução e a partir da mesma base. Os valores são os mesmos nos quatro formatos.

O que é cada linha

Cada linha é uma combinação de classificações da despesa no exercício: esfera, unidade orçamentária, função, subfunção, programa, ação, subtítulo, plano orçamentário, categoria econômica, grupo de natureza de despesa, modalidade de aplicação, elemento de despesa, fonte de recursos, identificador de uso e resultado primário. Não há duas linhas com a mesma combinação.

Os valores de uma linha são a soma dos itens de despesa (loa:ItemDespesa) do RDF com essas mesmas classificações. Por isso, a soma de uma coluna de valor no arquivo é igual à soma da mesma propriedade no RDF e no endpoint.

Para obter totais, some os valores e agrupe pelas classificações desejadas. Uma programação costuma ocupar várias linhas.

Colunas

Os códigos são texto e mantêm os zeros à esquerda (01, 0001). Ao abrir o CSV, leia as colunas de código como texto, senão 01000 vira 1000.

As descrições são as do próprio exercício. Um código cuja descrição mudou ao longo dos anos aparece em cada arquivo com a descrição daquele ano.

Coluna Tipo no Parquet Descrição Exemplo (2025)
exercicio inteiro (SMALLINT) Ano do exercício financeiro 2025
esfera_codigo texto Esfera orçamentária: 10 = Fiscal, 20 = Seguridade Social 10
esfera_descricao texto Orçamento Fiscal
orgao_codigo texto Órgão orçamentário da unidade orçamentária 01000
orgao_descricao texto Camara dos Deputados
unidade_orcamentaria_codigo texto Unidade orçamentária (UO) 01101
unidade_orcamentaria_descricao texto Câmara dos Deputados
funcao_codigo texto Função 01
funcao_descricao texto Legislativa
subfuncao_codigo texto Subfunção 031
subfuncao_descricao texto Ação Legislativa
programa_codigo texto Programa 0034
programa_descricao texto Programa de Gestão e Manutenção do Poder Legislativo
acao_codigo texto Ação orçamentária 4061
acao_descricao texto Processo Legislativo, Fiscalização e Representação Política
subtitulo_codigo texto Subtítulo (localizador do gasto). O código só identifica o subtítulo dentro da UO e da ação 5664
subtitulo_descricao texto Em Brasília - DF
subtitulo_identificador texto Identificador único do subtítulo no exercício (o mesmo do RDF) 0110140615664
plano_orcamentario_codigo texto Plano orçamentário (PO). Até 2012 não havia PO: o código é @ 0001
plano_orcamentario_descricao texto Administração Legislativa
plano_orcamentario_identificador texto Identificador único do PO no exercício (o mesmo do RDF). Até 2012, termina em @ 011010034406156640001
categoria_economica_codigo texto Categoria econômica: 3 = Despesas Correntes, 4 = Despesas de Capital, 9 = Reserva de Contingência 3
categoria_economica_descricao texto Despesas Correntes
grupo_natureza_despesa_codigo texto Grupo de natureza de despesa (GND) 3
grupo_natureza_despesa_descricao texto Outras Despesas Correntes
modalidade_aplicacao_codigo texto Modalidade de aplicação 90
modalidade_aplicacao_descricao texto Aplicações Diretas
elemento_despesa_codigo texto Elemento de despesa. 00 nas linhas de autógrafo e dotação (veja abaixo) 00
elemento_despesa_descricao texto A Definir
fonte_recursos_codigo texto Fonte de recursos: 3 dígitos até 2022 (ex.: 100), 4 dígitos a partir de 2023 (ex.: 1000) 1000
fonte_recursos_descricao texto Recursos Livres da União
identificador_uso_codigo texto Identificador de uso (IDUSO) 0
identificador_uso_descricao texto Recursos não destinados à contrapartida ou à identificação de despesas com ações e serviços públicos de saúde, ou referentes à manutenção e ao desenvolvimento do ensino
resultado_primario_codigo texto Resultado primário (RP): classificação atual da programação 2
resultado_primario_descricao texto Primária discricionária, considerada no cálculo do RP
valor_projeto_lei decimal (18,2) Projeto de Lei Orçamentária (PLOA) enviado pelo Poder Executivo 0.00
valor_dotacao_inicial decimal (18,2) Dotação inicial: valor da Lei Orçamentária Anual (LOA) sancionada. 909662640.00
valor_lei_mais_creditos decimal (18,2) Dotação atualizada: LOA mais créditos adicionais 894584460.00
valor_empenhado decimal (18,2) Empenhado no exercício 0.00
valor_liquidado decimal (18,2) Liquidado no exercício. De 2007 em diante, não inclui as despesas liquidadas por inscrição em restos a pagar não processados no encerramento do exercício (veja os cuidados na análise) 0.00
valor_pago decimal (18,2) Pago no exercício 0.00
valor_autografo decimal (18,2) Autógrafo: valor aprovado pelo Congresso Nacional e enviado à sanção presidencial. Vazio de 2000 a 2009, anos para os quais não há registro do autógrafo 909662640.00

Todos os valores estão em reais (R$), com duas casas decimais. Os valores, exceto o autógrafo de 2000 a 2009, nunca são vazios: a ausência de valor é publicada como 0.00.

Cuidados na análise

Dotação e execução ficam em linhas diferentes

O autógrafo, a dotação inicial e a dotação atualizada são registrados no elemento de despesa 00. O PLOA e a execução (empenhado, liquidado e pago) ficam no elemento detalhado (14, 30, 39 etc.).

Por isso, quem agrupa ou filtra pelo elemento de despesa vê a dotação e a execução em linhas diferentes. Para comparar dotação com execução, some sem o elemento de despesa.

Exercícios de 2000 a 2012

Liquidado e restos a pagar não processados

De 2007 em diante, o liquidado não inclui as despesas liquidadas por inscrição em restos a pagar não processados no encerramento do exercício. Assim, o empenhado menos o liquidado de um exercício encerrado é o valor inscrito em restos a pagar não processados. No exercício corrente, essa diferença é o empenhado ainda a liquidar.

De 2000 a 2006, a base de origem não separa a liquidação por inscrição em restos a pagar: o liquidado desses anos é praticamente igual ao empenhado, e a diferença entre os dois não mostra o valor inscrito.

Descrições vazias

Algumas descrições não existem na base de origem e vêm vazias. O código está sempre preenchido.

Como abrir os arquivos

Planilha (Excel, LibreOffice): descompacte o .csv.gz (7-Zip, WinRAR ou o próprio sistema) e importe o CSV pela opção de importar texto (no Excel: Dados > De Texto/CSV), com origem UTF-8, delimitador vírgula e as colunas de código como texto. Abrir o arquivo com dois cliques costuma usar o ponto e vírgula como separador e perder os zeros à esquerda.

Python (pandas):

import pandas as pd
 
df = pd.read_parquet("loa2025.parquet")                    # tipos já definidos (precisa do pyarrow)
# ou, pelo CSV, com os códigos como texto:
df = pd.read_csv("loa2025.csv.gz", dtype=str, keep_default_na=False)

R:

library(arrow)
df <- read_parquet("loa2025.parquet")

SQL (DuckDB):

SELECT funcao_codigo, funcao_descricao, SUM(valor_dotacao_inicial) AS dotacao_inicial, SUM(valor_pago) AS pago
FROM 'loa2025.parquet'
GROUP BY ALL
ORDER BY dotacao_inicial DESC;

Como conferir os arquivos baixados

O arquivo loaANO.sha256 traz o código SHA-256 de cada arquivo do exercício. Baixe-o junto com os arquivos e, na pasta em que estão, confira o arquivo desejado:

grep loa2025.parquet loa2025.sha256 | sha256sum -c        # Linux
grep loa2025.parquet loa2025.sha256 | shasum -a 256 -c    # macOS

O resultado deve ser loa2025.parquet: OK. Troque o nome para conferir o .csv.gz ou o .zip. No Windows (PowerShell), calcule o código com Get-FileHash loa2025.parquet -Algorithm SHA256 e compare com a linha do arquivo no loa2025.sha256.

O .sha256 também lista o loaANO.nt.gz, o mesmo RDF do .zip compactado em gzip, disponível no mesmo endereço, para ferramentas que leem o RDF sem descompactar.

O exercício corrente é gerado novamente todos os dias. Use sempre o .sha256 baixado no mesmo dia dos arquivos.

Correspondência com o RDF

Coluna Propriedade do item no RDF
esfera_codigo … resultado_primario_codigo loa:codigo da classificação ligada ao item por loa:temEsfera, loa:temUnidadeOrcamentaria, loa:temFuncao, loa:temSubfuncao, loa:temPrograma, loa:temAcao, loa:temSubtitulo, loa:temPlanoOrcamentario, loa:temCategoriaEconomica, loa:temGND, loa:temModalidadeAplicacao, loa:temElementoDespesa, loa:temFonteRecursos, loa:temIdentificadorUso e loa:temResultadoPrimario; o órgão, pela UO (loa:temOrgao)
colunas _descricao rdfs:label da classificação
subtitulo_identificador, plano_orcamentario_identificador loa:identificador do subtítulo e do PO
valor_projeto_lei loa:valorProjetoLei
valor_autografo loa:valorAutografo
valor_dotacao_inicial loa:valorDotacaoInicial
valor_lei_mais_creditos loa:valorLeiMaisCredito
valor_empenhado loa:valorEmpenhado
valor_liquidado loa:valorLiquidado
valor_pago loa:valorPago

Mais detalhes sobre o RDF e exemplos de consulta estão em Scripts SPARQL de exemplo.

Atualização

O exercício corrente é atualizado de segunda a sábado, com a última carga dos dados de execução. Os demais exercícios só mudam quando há correção ou mudança de regra, registrada no histórico abaixo.

Histórico de alterações

17/11/2026: todos os exercícios de 2000 a 2025 foram gerados novamente, com as mesmas regras do exercício corrente, e passaram a ser publicados também em CSV e Parquet, com o arquivo SHA-256. O que mudou em relação aos arquivos e ao endpoint anteriores:

16/11/2026: início da publicação do exercício de 2026 em CSV e Parquet, com o arquivo SHA-256.