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.zipaitr_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
METAda 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 porano; 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 textoAAAA-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 maiorVERSAOde cadaCNPJ_CIAeDT_REFERantes de somar. - Valores em moeda com escala. Os valores (
VL_CONTA) vêm na moeda deMOEDAe na escala deESCALA_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_EXERCeDT_FIM_EXERCantes 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/