Pular para conteúdo

Cias Abertas: Documentos: Formulário de Informações Trimestrais (ITR)

Resumo

Informações Trimestrais (ITR) das companhias abertas: balanço patrimonial e demonstrações do trimestre, em versões consolidada e individual.

Ficha técnica

Campo Valor
Dataset cvm/cia-itr
Órgão Comissão de Valores Mobiliários (CVM)
Página oficial https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr
Licença Open Data Commons Open Database License (ODbL), conforme o portal de dados abertos da CVM: https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr
Periodicidade anual (um arquivo por ano; a CVM atualiza todos os dias)
Cobertura 2011 a em-curso
Unidade (uma linha) uma conta de uma demonstração de uma companhia em um trimestre (nas tabelas de demonstrações); um documento entregue (nas tabelas de cadastro)
Granularidade espacial: nacional (sem recorte geográfico); temporal: trimestral
Formato bruto CSV com ponto e vírgula, em arquivo CSV ou ZIP (um CSV por tabela dentro do ZIP) no espelho público da CVM
Estado no lake convertido
Partições ano
Chave —
Colunas 30
Unidades de medida VERSAO: código ou número de identificação (sem unidade); ID_DOC: código ou número de identificação (sem unidade); VL_CONTA: moeda (ver ESCALA_MOEDA, quando houver; senão R$); NUM_ITEM_PARECER_DECL: quantidade; QT_ACAO_ORDIN_CAP_INTEGR: quantidade; QT_ACAO_PREF_CAP_INTEGR: quantidade; QT_ACAO_TOTAL_CAP_INTEGR: quantidade; QT_ACAO_ORDIN_TESOURO: quantidade; QT_ACAO_PREF_TESOURO: quantidade; QT_ACAO_TOTAL_TESOURO: quantidade
Dados pessoais nenhum
Eras nenhuma
Revisado em 2026-11-15
Versão do fetcher 0.4.0

Origem e coleta

  • Fonte: Portal de Dados Abertos da CVM (https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr). Os arquivos ficam no espelho público https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/ITR/DADOS/.
  • O catálogo do fetcher lista 16 arquivo(s): de itr_cia_aberta_2011.zip a itr_cia_aberta_2026.zip. Em 2026-11-15 conferimos 111 arquivos Parquet convertidos de 6 arquivo(s) de origem (amostra: primeiro, intermediários e os dois últimos).
  • No bruto, o arquivo fica em cia-itr/<arquivo>@AAAAMMDD.<csv|zip>; o carimbo é a data da coleta, e a CVM reenvia os arquivos do ano ou mês corrente todos os dias.
  • O dicionário de dados (arquivos META da CVM, em .../META/) não é baixado pelo fetcher; as descrições da seção Variáveis vêm dele, conferidas contra os cabeçalhos dos arquivos.

Conteúdo

  • Unidade de análise: uma conta de uma demonstração de uma companhia em um trimestre (nas tabelas de demonstrações); um documento entregue (nas tabelas de cadastro).
  • Particionado por ano; anos convertidos: 2011 a 2026.
  • Este dataset reúne 19 tabelas (um CSV por tabela em cada ZIP), gravadas como arquivos Parquet separados no mesmo dataset; o nome do arquivo no lake é <zip>__<csv>.parquet:
Tabela (nome do CSV sem o ano) Colunas Linhas no maior arquivo convertido Chave candidata (única no maior arquivo)
itr_cia_aberta 9 2.510 ID_DOC
itr_cia_aberta_bpa_con 14 186.522 não determinada
itr_cia_aberta_bpa_ind 14 285.530 não determinada
itr_cia_aberta_bpp_con 14 318.798 não determinada
itr_cia_aberta_bpp_ind 14 482.472 não determinada
itr_cia_aberta_composicao_capital 10 2.158 CNPJ_CIA, DT_REFER
itr_cia_aberta_dfc_md_con 15 2.140 não determinada
itr_cia_aberta_dfc_md_ind 15 2.640 não determinada
itr_cia_aberta_dfc_mi_con 15 139.644 não determinada
itr_cia_aberta_dfc_mi_ind 15 189.722 não determinada
itr_cia_aberta_dmpl_con 16 643.943 não determinada
itr_cia_aberta_dmpl_ind 16 727.357 não determinada
itr_cia_aberta_dra_con 15 32.562 não determinada
itr_cia_aberta_dra_ind 15 33.210 não determinada
itr_cia_aberta_dre_con 15 163.428 não determinada
itr_cia_aberta_dre_ind 15 236.786 não determinada
itr_cia_aberta_dva_con 15 120.826 não determinada
itr_cia_aberta_dva_ind 15 179.952 não determinada
itr_cia_aberta_parecer 8 7.416 não determinada
  • Não há uma chave única comum às tabelas: cada tabela tem a sua (coluna acima). Os arquivos de uma mesma competência ligam-se por identificador do documento ou do fundo (veja as colunas de cada tabela).

Variáveis

Descrições do dicionário de dados (arquivos META) da CVM. Os nomes de coluna são os do arquivo, sem normalização. Colunas que não existem em todas as tabelas dizem em quais tabelas aparecem.

Coluna no lake Na fonte Tipo Descrição Unidade / códigos Período
CNPJ_CIA CNPJ_CIA texto CNPJ da companhia — todo
DT_REFER DT_REFER texto Data de referência do documento — todo
VERSAO VERSAO inteiro Versão do documento código ou número de identificação (sem unidade) todo
DENOM_CIA DENOM_CIA texto Nome empresarial da companhia — todo
CD_CVM CD_CVM texto Código CVM (só em: itr_cia_aberta, itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con e mais 13) — todo
CATEG_DOC CATEG_DOC texto Categoria do documento (só em: itr_cia_aberta) — todo
ID_DOC ID_DOC inteiro Identificador do documento (só em: itr_cia_aberta) código ou número de identificação (sem unidade) todo
DT_RECEB DT_RECEB texto Data da recebimento do documento (só em: itr_cia_aberta) — todo
LINK_DOC LINK_DOC texto Endereço para download do documento (só em: itr_cia_aberta) — todo
GRUPO_DFP GRUPO_DFP texto Nome e nível de agregação da demonstração (só em: itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con, itr_cia_aberta_bpp_ind e mais 12) — todo
MOEDA MOEDA texto Moeda (só em: itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con, itr_cia_aberta_bpp_ind e mais 12) — todo
ESCALA_MOEDA ESCALA_MOEDA texto Escala monetária (só em: itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con, itr_cia_aberta_bpp_ind e mais 12) — todo
ORDEM_EXERC ORDEM_EXERC texto Ordem do exercício social (só em: itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con, itr_cia_aberta_bpp_ind e mais 12) — todo
DT_FIM_EXERC DT_FIM_EXERC texto Data fim do exercício social (só em: itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con, itr_cia_aberta_bpp_ind e mais 12) — todo
CD_CONTA CD_CONTA texto Código da conta (só em: itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con, itr_cia_aberta_bpp_ind e mais 12) — todo
DS_CONTA DS_CONTA texto Descrição da conta (só em: itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con, itr_cia_aberta_bpp_ind e mais 12) — todo
VL_CONTA VL_CONTA decimal Valor da conta (só em: itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con, itr_cia_aberta_bpp_ind e mais 12) moeda (ver ESCALA_MOEDA, quando houver; senão R$) todo
ST_CONTA_FIXA ST_CONTA_FIXA texto Indica se é conta fixa ou não (só em: itr_cia_aberta_bpa_con, itr_cia_aberta_bpa_ind, itr_cia_aberta_bpp_con, itr_cia_aberta_bpp_ind e mais 12) S/N todo
DT_INI_EXERC DT_INI_EXERC texto Data início do exercício social (só em: itr_cia_aberta_dfc_md_con, itr_cia_aberta_dfc_md_ind, itr_cia_aberta_dfc_mi_con, itr_cia_aberta_dfc_mi_ind e mais 8) — todo
COLUNA_DF COLUNA_DF texto Coluna da demonstração financeira (só em: itr_cia_aberta_dmpl_con, itr_cia_aberta_dmpl_ind) — todo
TP_RELAT_ESP TP_RELAT_ESP texto Tipo Relatório da Revisão Especial (só em: itr_cia_aberta_parecer) — todo
TP_PARECER_DECL TP_PARECER_DECL texto Tipo do Parecer/Declaração (só em: itr_cia_aberta_parecer) — todo
NUM_ITEM_PARECER_DECL NUM_ITEM_PARECER_DECL inteiro Número da linha do texto do Parecer/Declaração (só em: itr_cia_aberta_parecer) quantidade todo
TXT_PARECER_DECL TXT_PARECER_DECL texto Texto do Parecer/Declaração (só em: itr_cia_aberta_parecer) — todo
QT_ACAO_ORDIN_CAP_INTEGR QT_ACAO_ORDIN_CAP_INTEGR inteiro Domínio : (só em: itr_cia_aberta_composicao_capital) quantidade 2023 a 2026
QT_ACAO_PREF_CAP_INTEGR QT_ACAO_PREF_CAP_INTEGR inteiro Domínio : (só em: itr_cia_aberta_composicao_capital) quantidade 2023 a 2026
QT_ACAO_TOTAL_CAP_INTEGR QT_ACAO_TOTAL_CAP_INTEGR inteiro Domínio : (só em: itr_cia_aberta_composicao_capital) quantidade 2023 a 2026
QT_ACAO_ORDIN_TESOURO QT_ACAO_ORDIN_TESOURO inteiro Domínio : (só em: itr_cia_aberta_composicao_capital) quantidade 2023 a 2026
QT_ACAO_PREF_TESOURO QT_ACAO_PREF_TESOURO inteiro Domínio : (só em: itr_cia_aberta_composicao_capital) quantidade 2023 a 2026
QT_ACAO_TOTAL_TESOURO QT_ACAO_TOTAL_TESOURO inteiro Domínio : (só em: itr_cia_aberta_composicao_capital) quantidade 2023 a 2026
ano — (partição) inteiro Ano do arquivo de origem — todo

No lake

  • Dataset cvm/cia-itr, particionado por ano; um arquivo Parquet por CSV (membro do ZIP).
  • O conversor lê o CSV (separador ;, UTF-8 e, se falhar, ISO-8859-1), mantém os nomes de coluna do arquivo, deixa CNPJ, ISIN e códigos CVM como texto e infere os demais tipos (número ou texto): datas ficam como texto AAAA-MM-DD.
  • Linhas com ; dentro de um campo de texto sem aspas (que a CVM publica em alguns arquivos) são reparadas sem descartar a linha.
  • A partição vem do nome do arquivo (..._AAAA).

Cuidados de uso

  • A CVM reenvia os arquivos todo dia. Os arquivos do ano ou mês corrente mudam entre atualizações (reapresentações, correções e novos documentos); reconverta antes de fechar um período.
  • Reapresentações. A mesma companhia e o mesmo trimestre podem ter mais de uma versão do documento (campo VERSAO); escolha a maior VERSAO de cada CNPJ_CIA e DT_REFER antes de somar.
  • Valores em moeda com escala. Os valores (VL_CONTA) vêm na moeda de MOEDA e na escala de ESCALA_MOEDA; aplique a escala antes de somar companhias.
  • Períodos misturados. A demonstração do resultado traz linhas de períodos diferentes (trimestre e acumulado do ano) no mesmo arquivo; confira DT_INI_EXERC e DT_FIM_EXERC antes de somar.

Exemplos

Linhas por ano nos arquivos convertidos.

import duckdb

duckdb.sql("""
    SELECT ano, count(*) AS linhas
    FROM read_parquet('lake/cvm/cia-itr/**/*.parquet', hive_partitioning = true, union_by_name = true, filename = true)
    GROUP BY ALL
    ORDER BY ALL
""").show()

Referências

  • Conjunto no portal de dados abertos da CVM: https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr
  • Dados e dicionário (META): https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/ITR/