Skip to content

Contexto semântico (YAML-fonte)

Conteúdo bruto do arquivo-fonte para referência — a documentação curada está nas páginas de conjuntos de dados e tabelas.

# Curated semantic orientation for the visual catalog.
#
# This file answers the analyst's first questions in Portuguese. It is kept
# separate from catalogo/*.yml: the technical catalog remains the ingestion
# and quality contract, while this registry explains the subject and use of
# each dataset/table. Every statement has an evidence trail; the publisher
# validates that all catalog identities are covered exactly once.

version: 1

datasets:
  - dataset_id: cad_cia_aberta
    display_name: "Cadastro de companhias abertas"
    what_it_contains: >
      Cadastro de companhias abertas registradas na CVM, com identificadores
      de companhia e de negociação, denominação, situação e atributos usados
      para localizar e relacionar os documentos financeiros da companhia.
    why_consult: >
      Use como tabela de referência para descobrir companhias, resolver
      códigos CVM e CNPJ e preparar joins com DFP, ITR e outros documentos de
      companhias abertas.
    scope_and_limits: >
      É um retrato cadastral diário, não uma série de demonstrações
      financeiras nem uma tabela de preços. A situação e os atributos podem
      mudar; use a competência/snapshot correspondente ao estudo.
    evidence:
      - "catalogo/cvm.yml — entrada cad_cia_aberta"
      - "https://dados.cvm.gov.br/dataset/cia_aberta-cad"

  - dataset_id: cad_fi
    display_name: "Cadastro de fundos de investimento e classes"
    what_it_contains: >
      Cadastro de fundos/classes de investimento e seus participantes
      cadastrais, incluindo identificadores, denominação, administrador,
      gestor, datas e situação do registro.
    why_consult: >
      Use para identificar fundos, resolver CNPJ e classe, acompanhar
      atributos cadastrais e preparar o relacionamento com carteira CDA,
      informes diários e outros dados de fundos.
    scope_and_limits: >
      O bronze preserva uma linha por fundo por atribuição de gestor e eventos
      de re-registro; não é uma linha única por fundo. Para joins por
      cnpj_fundo sozinho, use a visão corrente em silver, conforme a regra de
      fan-out documentada.
    evidence:
      - "catalogo/cvm.yml — entrada cad_fi e decisão de grain"
      - "ciano_lake/silver/fundos/cad_fi.py — visão corrente de fundo"
      - "https://dados.cvm.gov.br/dataset/fi-cad"

  - dataset_id: cda_fi
    display_name: "Composição da carteira de fundos de investimento (CDA)"
    what_it_contains: >
      Posições e movimentações mensais dos ativos que compõem as carteiras de
      fundos de investimento, organizadas por classe de ativo nos blocos BLC_1
      a BLC_8, além de patrimônio líquido, aplicações confidenciais e posições
      de FIIM/FIE quando publicadas.
    why_consult: >
      Use para investigar exposição, alocação, concentração, emissores,
      vencimentos, ativos no exterior e evolução do patrimônio das carteiras
      de fundos.
    scope_and_limits: >
      O significado do bloco depende do layout e da era histórica. Parte das
      aplicações pode estar sob confidencialidade, a série recente é
      atualizada/restatada e FIIM/FIE pode ter granularidade de lote. Não
      interprete o identificador técnico isoladamente: consulte o nome
      semântico da tabela e a evidência oficial.
    evidence:
      - "catalogo/cvm.yml — entrada cda_fi e eras de layout"
      - "https://dados.cvm.gov.br/dataset/fi-doc-cda"
      - "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"

  - dataset_id: inf_diario_fi
    display_name: "Informe diário de fundos de investimento"
    what_it_contains: >
      Indicadores reportados diariamente pelos fundos, identificados por fundo
      e data, incluindo medidas de patrimônio líquido, valor da cota e
      movimentações/quantidades quando presentes no layout da competência.
    why_consult: >
      Use para acompanhar a evolução diária de fundos, construir séries de
      patrimônio e cota e comparar o comportamento de fundos ao longo do
      tempo.
    scope_and_limits: >
      É uma tabela de informe diário, não a composição detalhada de ativos da
      carteira. As colunas e a disponibilidade podem variar por período;
      confirme a declaração técnica antes de agregar indicadores.
    evidence:
      - "catalogo/cvm.yml — entrada inf_diario_fi"
      - "https://dados.cvm.gov.br/dataset/fi-doc-inf_diario"

  - dataset_id: fidc_inf_mensal
    display_name: "Informe mensal de FIDC"
    what_it_contains: >
      Informe mensal de fundos de investimento em direitos creditórios,
      cobrindo características do fundo, ativos e passivos, composição e
      qualidade dos direitos creditórios, aquisições/alienações, cotistas,
      rentabilidade, liquidez, garantias e informações de risco.
    why_consult: >
      Use para analisar lastro e perfil da carteira de direitos creditórios,
      inadimplência e vencimentos, fluxo de operações, estrutura de cotas,
      liquidez e indicadores de risco de FIDC/FIAGRO reportados à CVM.
    scope_and_limits: >
      É um informe mensal com mudanças de layout ao longo da série histórica;
      tabelas X.1 a X.7 e a tabela X podem ter vigências distintas. A série
      recente é atualizada e pode ser restatada, portanto compare versões e
      competências com cautela.
    evidence:
      - "catalogo/cvm.yml — entrada fidc_inf_mensal e vigências das tabelas"
      - "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal"
      - "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"

  - dataset_id: cia_aberta_dfp
    display_name: "Demonstrações Financeiras Padronizadas (DFP)"
    what_it_contains: >
      Demonstrações financeiras anuais padronizadas de companhias abertas,
      com balanços individual e consolidado, resultado, fluxos de caixa,
      mutações do patrimônio líquido, resultado abrangente, valor adicionado,
      composição de capital, metadados do documento e pareceres.
    why_consult: >
      Use para analisar posição patrimonial, desempenho, geração de caixa,
      distribuição de valor e estrutura de capital de companhias abertas, com
      distinção explícita entre visões individual e consolidada.
    scope_and_limits: >
      É uma divulgação anual e os valores são os reportados pelas companhias.
      A mesma conta pode aparecer em período atual/prior e em diferentes
      dimensões do formulário; use a chave completa, dt_refer, ordem_exerc e
      o tipo de visão antes de comparar ou agregar.
    evidence:
      - "catalogo/cvm.yml — entrada cia_aberta_dfp"
      - "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"

  - dataset_id: cia_aberta_itr
    display_name: "Informações Trimestrais (ITR)"
    what_it_contains: >
      Informações financeiras trimestrais de companhias abertas, com balanços
      individual e consolidado, resultado, fluxos de caixa, mutações do
      patrimônio líquido, resultado abrangente, valor adicionado, composição
      de capital, metadados e pareceres/declarações.
    why_consult: >
      Use para acompanhar a evolução trimestral de posição financeira,
      resultado e caixa entre divulgações anuais e para construir análises
      intra-ano por companhia.
    scope_and_limits: >
      Um arquivo trimestral pode conter o trimestre corrente e comparativos;
      dt_ini_exerc, dt_refer, ordem_exerc e a visão individual/consolidada
      precisam ser respeitados. Restatements e atualizações da CVM podem
      alterar competências já publicadas.
    evidence:
      - "catalogo/cvm.yml — entrada cia_aberta_itr"
      - "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"

  - dataset_id: ifdata_valores
    display_name: "Valores financeiros das instituições no IF.DATA"
    what_it_contains: >
      Valores reportados por instituições no IF.DATA do Banco Central em formato
      longo: instituição, período, tipo de instituição, relatório e nome da
      coluna, com o valor correspondente.
    why_consult: >
      Use para comparar indicadores de balanço, resultado e outros relatórios
      regulatórios entre instituições e períodos, mantendo o escopo do
      relatório que define a unidade e o significado de cada coluna.
    scope_and_limits: >
      A unidade varia por relatório/coluna e não deve ser inferida somente pelo
      nome do campo. Valores-sentinela do BCB permanecem nulos; consulte o
      catálogo de ativos para interpretar cada report_type e col_name.
    evidence:
      - "catalogo/bacen.yml — entrada ifdata_valores"
      - "ciano_lake/silver/instituicoes/valores.py"
      - "https://www3.bcb.gov.br/ifdata/"

  - dataset_id: ifdata_cadastro
    display_name: "Cadastro de instituições no IF.DATA"
    what_it_contains: >
      Cadastro e classificação das instituições presentes no IF.DATA por
      código, tipo de instituição, período e atributos cadastrais publicados
      pelo Banco Central.
    why_consult: >
      Use para resolver códigos de instituição, obter nomes e classificações e
      enriquecer ou filtrar os valores financeiros antes de uma análise
      comparativa.
    scope_and_limits: >
      O cadastro é temporal: o mesmo código deve ser associado ao período e ao
      tipo de instituição correspondentes. Não substitui o catálogo de
      relatórios, que explica as unidades e colunas dos valores.
    evidence:
      - "catalogo/bacen.yml — entrada ifdata_cadastro"
      - "ciano_lake/silver/instituicoes/cadastro.py"
      - "https://www3.bcb.gov.br/ifdata/"

  - dataset_id: ifdata_catalogo
    display_name: "Catálogo de relatórios e ativos do IF.DATA"
    what_it_contains: >
      Metadados dos ativos e relatórios disponíveis no IF.DATA, incluindo as
      chaves usadas para localizar payloads e a descrição operacional do
      conteúdo financeiro.
    why_consult: >
      Consulte antes de interpretar ifdata_valores: ele indica qual relatório
      e qual coluna devem ser lidos para responder a uma pergunta e evita
      comparar valores de unidades ou escopos diferentes.
    scope_and_limits: >
      É um snapshot de metadados, não uma série financeira. A disponibilidade
      e os nomes dos ativos podem mudar; use o catálogo correspondente à
      extração.
    evidence:
      - "catalogo/bacen.yml — entrada ifdata_catalogo"
      - "ciano_lake/ingest/bacen/raw_store.py"
      - "https://www3.bcb.gov.br/ifdata/"

tables:
  - tabela_id: cvm.cia_aberta.cad_cia_aberta/cad_cia_aberta
    display_name: "Registro cadastral da companhia aberta"
    what_it_contains: >
      Identificadores e atributos de registro da companhia aberta, inclusive
      CNPJ, código CVM, denominação e segmento/tipo de mercado.
    why_consult: "Use para resolver a identidade da companhia antes de consultar DFP ou ITR."
    aliases: ["cad_cia_aberta"]
    scope_and_limits: "Snapshot cadastral diário; não contém os valores das demonstrações."
    evidence: ["catalogo/cvm.yml — cad_cia_aberta", "https://dados.cvm.gov.br/dataset/cia_aberta-cad"]

  - tabela_id: cvm.fundos.cad_fi/cad_fi
    display_name: "Registro cadastral de fundos e classes"
    what_it_contains: >
      Registro de fundos/classes, administradores, gestores, situação e datas
      cadastrais, com eventos históricos de registro/re-registro.
    why_consult: "Use para identificar fundos e enriquecer CDA ou informes diários com atributos cadastrais."
    aliases: ["cad_fi"]
    scope_and_limits: >
      O bronze tem fan-out por atribuição de gestor e re-registro; para uma
      linha corrente por fundo, use a visão silver documentada.
    evidence: ["catalogo/cvm.yml — cad_fi", "ciano_lake/silver/fundos/cad_fi.py"]

  - tabela_id: cvm.fundos.inf_diario_fi/inf_diario_fi
    display_name: "Indicadores diários do fundo"
    what_it_contains: >
      Observações diárias do fundo, incluindo os indicadores de patrimônio,
      cota e movimentação previstos no informe diário da competência.
    why_consult: "Use para séries temporais diárias de patrimônio e valor da cota."
    aliases: ["inf_diario_fi"]
    scope_and_limits: "Confira as colunas e a competência antes de comparar indicadores entre eras."
    evidence: ["catalogo/cvm.yml — inf_diario_fi", "https://dados.cvm.gov.br/dataset/fi-doc-inf_diario"]

  - tabela_id: cvm.fundos.cda_fi/blc_1
    display_name: "CDA BLC_1 — Títulos públicos do SELIC"
    what_it_contains: >
      Posições e movimentações de títulos públicos do SELIC mantidos na
      carteira do fundo, com ativo, emissor, quantidade, custo, mercado e
      datas relevantes.
    why_consult: "Use para medir exposição da carteira a títulos públicos e acompanhar vencimento e valor de mercado."
    aliases: ["BLC_1", "blc_1", "Títulos públicos do SELIC"]
    scope_and_limits: "Granularidade de posição por fundo, competência e título; respeite o layout da era."
    evidence: ["catalogo/cvm.yml — cda_fi/blc_1", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.cda_fi/blc_2
    display_name: "CDA BLC_2 — Cotas de fundos de investimento"
    what_it_contains: >
      Aplicações do fundo em cotas de outros fundos, com identificação da
      cota/subclasse, quantidades, custo e valores de mercado.
    why_consult: "Use para estudar exposição a fundos investidos, fundos de fundos e concentração por cota/subclasse."
    aliases: ["BLC_2", "blc_2", "Cotas de fundos"]
    scope_and_limits: "A subclasse pode ser parte da identificação; não trate cnpj_fundo sozinho como chave universal."
    evidence: ["catalogo/cvm.yml — cda_fi/blc_2", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.cda_fi/blc_3
    display_name: "CDA BLC_3 — Operações de swap"
    what_it_contains: >
      Operações de swap declaradas na carteira, com código e descrição do
      swap, tipo de aplicação/negociação e valores de custo e mercado.
    why_consult: "Use para identificar exposição a derivativos de swap e acompanhar sua avaliação na carteira."
    aliases: ["BLC_3", "blc_3", "Swap"]
    scope_and_limits: "A tabela descreve posições/movimentações reportadas, não uma reconstrução completa dos contratos."
    evidence: ["catalogo/cvm.yml — cda_fi/blc_3", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.cda_fi/blc_4
    display_name: "CDA BLC_4 — Demais ativos codificados"
    what_it_contains: >
      Demais ativos codificados da carteira, identificados por código/ISIN e
      descrição, com posição, movimentações, vigência e valores.
    why_consult: "Use para analisar ativos financeiros codificados que não pertencem aos blocos mais específicos."
    aliases: ["BLC_4", "blc_4", "Demais ativos codificados"]
    scope_and_limits: "A classificação do ativo é a publicada pela CVM; valide códigos e vigência antes de consolidar."
    evidence: ["catalogo/cvm.yml — cda_fi/blc_4", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.cda_fi/blc_5
    display_name: "CDA BLC_5 — Depósitos a prazo e outros títulos de IF"
    what_it_contains: >
      Depósitos a prazo e outros títulos emitidos por instituições financeiras,
      com emissor, risco, indexador, taxas, vencimento e posição financeira.
    why_consult: "Use para estudar exposição a crédito bancário, remuneração/indexação e concentração por emissor."
    aliases: ["BLC_5", "blc_5", "Depósitos a prazo e outros títulos de IF"]
    scope_and_limits: "Taxas e unidades dependem do tipo de ativo e indexador; não compare percentuais sem esse contexto."
    evidence: ["catalogo/cvm.yml — cda_fi/blc_5", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.cda_fi/blc_6
    display_name: "CDA BLC_6 — Títulos do agronegócio e de crédito privado"
    what_it_contains: >
      Títulos do agronegócio e instrumentos de crédito privado, com emissor,
      coobrigação, indexador, taxas, vencimento e posição da carteira.
    why_consult: "Use para analisar crédito privado, agronegócio, risco de emissor e exposição por vencimento."
    aliases: ["BLC_6", "blc_6", "Títulos do agronegócio e crédito privado"]
    scope_and_limits: "Emissor pessoa física/jurídica, coobrigação e indexador devem permanecer separados na análise."
    evidence: ["catalogo/cvm.yml — cda_fi/blc_6", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.cda_fi/blc_7
    display_name: "CDA BLC_7 — Investimentos no exterior"
    what_it_contains: >
      Ativos e investimentos no exterior, com país, mercado, emissor, ativo,
      risco, vencimento e valores/quantidades reportados.
    why_consult: "Use para medir exposição internacional, concentração geográfica e risco de ativos no exterior."
    aliases: ["BLC_7", "blc_7", "Investimentos no exterior"]
    scope_and_limits: "Campos de identificação podem ser nulos para determinados ativos; isso é parte do layout e não prova ausência da posição."
    evidence: ["catalogo/cvm.yml — cda_fi/blc_7", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.cda_fi/blc_8
    display_name: "CDA BLC_8 — Demais ativos não codificados"
    what_it_contains: >
      Ativos da carteira sem código padronizado, descritos por texto e emissor,
      com quantidades, custos e valores de mercado.
    why_consult: "Use para encontrar exposições que não aparecem nos blocos de ativos codificados."
    aliases: ["BLC_8", "blc_8", "Demais ativos não codificados"]
    scope_and_limits: "A identificação textual é menos padronizada; agregações por emissor/ativo exigem normalização adicional."
    evidence: ["catalogo/cvm.yml — cda_fi/blc_8", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.cda_fi/pl
    display_name: "CDA PL — Patrimônio líquido do fundo"
    what_it_contains: "Patrimônio líquido reportado por fundo/classe e competência."
    why_consult: "Use como referência de tamanho da carteira e para validar somas/ratios de exposição por fundo."
    aliases: ["PL", "pl", "Patrimônio líquido"]
    scope_and_limits: "Uma linha por fundo/classe e competência na semântica declarada, com exceções de republicação documentadas."
    evidence: ["catalogo/cvm.yml — cda_fi/pl", "docs/catalog/deep_docs.yml — cda_fi/pl", "https://dados.cvm.gov.br/dataset/fi-doc-cda"]

  - tabela_id: cvm.fundos.cda_fi/fiim
    display_name: "CDA FIIM/FIE — Posições por lote e aplicações em fundos de índice"
    what_it_contains: >
      Posições de lotes de ativos e aplicações do fundo em instrumentos de
      investimento vinculados ao layout FIIM/FIE, com quantidade, custo e
      valor de mercado por lote quando publicados.
    why_consult: "Use para investigar posições de FIIM/FIE e exposições cuja unidade analítica é o lote, não apenas o ativo agregado."
    aliases: ["FIIM", "FIE", "fiim", "lotes de posição"]
    scope_and_limits: "A granularidade por lote é esperada; somas sem as dimensões do lote podem duplicar ou ocultar posições contraditórias."
    evidence: ["catalogo/cvm.yml — cda_fi/fiim", "docs/catalog/deep_docs.yml — cda_fi/fiim", "https://dados.cvm.gov.br/dataset/fi-doc-cda"]

  - tabela_id: cvm.fundos.cda_fi/confid
    display_name: "CDA CONFID — Aplicações sob confidencialidade"
    what_it_contains: >
      Valores agregados de aplicações cuja identificação detalhada está sob
      prazo de confidencialidade, mantendo fundo, competência, tipo de
      aplicação e valores financeiros publicados.
    why_consult: "Use para não perder a parcela confidencial da carteira ao reconciliar exposição e patrimônio líquido."
    aliases: ["CONFID", "confid", "CDA confidencial"]
    scope_and_limits: "Não é possível recuperar o ativo/emissor detalhado antes do fim da confidencialidade; não trate ausência nos blocos públicos como ausência econômica."
    evidence: ["catalogo/cvm.yml — cda_fi/confid", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.cda_fi/fie_confid
    display_name: "CDA FIE_CONFID — Aplicações no exterior sob confidencialidade"
    what_it_contains: >
      Aplicações no exterior mantidas em registro confidencial, com valores
      financeiros, fundo, competência, tipo de aplicação e identificador do
      documento quando publicados.
    why_consult: "Use para reconciliar a exposição internacional total quando a identificação detalhada do ativo não está pública."
    aliases: ["FIE_CONFID", "fie_confid", "confidencial no exterior"]
    scope_and_limits: "O ativo e o emissor podem permanecer não identificáveis durante o prazo de confidencialidade."
    evidence: ["catalogo/cvm.yml — cda_fi/fie_confid", "https://dados.cvm.gov.br/dataset/fi-doc-cda", "https://dados.cvm.gov.br/dados/FI/DOC/CDA/META/meta_cda_fi_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_i
    display_name: "FIDC Tabela I — Ativo e características do fundo"
    what_it_contains: "Características cadastrais do FIDC e composição resumida do ativo, incluindo disponibilidades, carteira e provisões."
    why_consult: "Use como visão inicial da estrutura do fundo e do tamanho/composição de seus ativos."
    aliases: ["Tabela I", "tab_I", "tab_i"]
    scope_and_limits: "Quadro mensal agregado; detalhes por prazo, operação e risco estão em outras tabelas."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_i", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_ii
    display_name: "FIDC Tabela II — Direitos creditórios por segmento econômico"
    what_it_contains: "Valores dos direitos creditórios distribuídos por segmentos como indústria, imobiliário, comércio, serviços, agronegócio e financeiro."
    why_consult: "Use para analisar a concentração setorial da carteira de crédito."
    aliases: ["Tabela II", "tab_II", "tab_ii"]
    scope_and_limits: "São valores agregados por segmento; não é uma relação de cada contrato ou devedor."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_ii", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_iii
    display_name: "FIDC Tabela III — Passivo e derivativos"
    what_it_contains: "Valores a pagar, passivo e posições mantidas em derivativos, separando prazos e tipos de operação quando publicados."
    why_consult: "Use para examinar obrigações do fundo e exposição a posições derivativas."
    aliases: ["Tabela III", "tab_III", "tab_iii"]
    scope_and_limits: "Não confunda passivo contábil com o estoque de direitos creditórios da Tabela II."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_iii", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_iv
    display_name: "FIDC Tabela IV — Patrimônio líquido e patrimônio líquido médio"
    what_it_contains: "Patrimônio líquido do fundo e patrimônio líquido médio dos últimos três meses."
    why_consult: "Use para acompanhar tamanho do FIDC e comparar o valor corrente com sua referência média recente."
    aliases: ["Tabela IV", "tab_IV", "tab_iv"]
    scope_and_limits: "É um resumo mensal; a composição do PL está distribuída em outras tabelas."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_iv", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_v
    display_name: "FIDC Tabela V — Direitos creditórios por vencimento, inadimplência e antecipação"
    what_it_contains: "Valores de direitos creditórios a vencer, vencidos e não pagos e pagos antecipadamente, distribuídos por faixas de prazo."
    why_consult: "Use para analisar duration operacional, concentração de vencimentos, inadimplência e pagamentos antecipados."
    aliases: ["Tabela V", "tab_V", "tab_v"]
    scope_and_limits: "As faixas são agregadas e expressas em valores; não representam contratos individuais."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_v", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_vi
    display_name: "FIDC Tabela VI — Direitos creditórios por vencimento, inadimplência e antecipação (layout VI)"
    what_it_contains: "Quadro VI de valores a vencer, vencidos/não pagos e pagos antecipadamente por faixa de prazo, conforme o layout mensal da CVM."
    why_consult: "Use para acompanhar a distribuição temporal e a qualidade de recebimento reportada no quadro VI."
    aliases: ["Tabela VI", "tab_VI", "tab_vi"]
    scope_and_limits: "O quadro é específico do layout/era; valide a vigência antes de comparar com a Tabela V."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_vi", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_vii
    display_name: "FIDC Tabela VII — Aquisições, alienações, substituições e recompras"
    what_it_contains: "Quantidade, valor e valor contábil de aquisições e alienações de direitos creditórios, substituições e recompras."
    why_consult: "Use para estudar o fluxo de operações da carteira e a relação com cedentes, prestadores e terceiros."
    aliases: ["Tabela VII", "tab_VII", "tab_vii"]
    scope_and_limits: "São totais reportados por categoria de operação; não substituem a conciliação transacional."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_vii", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_viii
    display_name: "FIDC Tabela VIII — Registro do quadro adicional do informe mensal"
    what_it_contains: "Registros do quadro VIII no layout em que ele é publicado, identificados pelo valor e sequencial informados pela CVM."
    why_consult: "Use quando a competência possuir o quadro VIII e a pergunta depender desse bloco adicional do informe."
    aliases: ["Tabela VIII", "tab_VIII", "tab_viii"]
    scope_and_limits: >
      A tabela não existe em todas as eras históricas e seus metadados expõem
      campos genéricos; não atribua significado econômico adicional sem
      conferir a vigência e o dicionário da competência.
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_viii", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_ix
    display_name: "FIDC Tabela IX — Taxas de desconto e juros por tipo de ativo"
    what_it_contains: "Mínimo, média ponderada e máximo de taxas de desconto e juros na compra/venda de direitos creditórios e outros ativos."
    why_consult: "Use para analisar condições de aquisição/alienação e custo implícito por categoria de ativo."
    aliases: ["Tabela IX", "tab_IX", "tab_ix"]
    scope_and_limits: "As estatísticas são separadas por compra/venda e categoria; não trate média como taxa de cada contrato."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_ix", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_x
    display_name: "FIDC Tabela X — Risco de crédito no SCR e débitos tributários de cedentes"
    what_it_contains: "Valores de direitos creditórios reportados ao SCR por classificação de risco de devedores/operações e valor associado a cedentes com débitos tributários inscritos."
    why_consult: "Use para estudar qualidade de crédito regulatória e concentração de risco por faixa do SCR."
    aliases: ["Tabela X", "tab_X", "tab_x", "X.8/X.9"]
    scope_and_limits: "As classificações são faixas do SCR e não um score próprio; respeite as vigências de X.8 e X.9."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_x", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_x_1
    display_name: "FIDC Tabela X.1 — Número de cotistas por classe/série"
    what_it_contains: "Número de cotistas de cada classe/série do FIDC."
    why_consult: "Use para analisar a distribuição da base de investidores entre classes e séries."
    aliases: ["Tabela X.1", "tab_X_1", "tab_x_1"]
    scope_and_limits: "A unidade é classe/série quando presente; não agregue classes sem preservar essa dimensão."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_x_1", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_x_1_1
    display_name: "FIDC Tabela X.1.1 — Cotistas da classe sênior por categoria"
    what_it_contains: "Número de cotistas da classe sênior distribuído por categoria de investidor, como pessoa física, pessoa jurídica, bancos e fundos."
    why_consult: "Use para estudar o perfil institucional e a concentração da base de cotistas sênior."
    aliases: ["Tabela X.1.1", "tab_X_1_1", "tab_x_1_1"]
    scope_and_limits: "Categorias de investidor são as publicadas no formulário; não representam identificação individual dos cotistas."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_x_1_1", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_x_2
    display_name: "FIDC Tabela X.2 — Quantidade e valor da cota por classe/série"
    what_it_contains: "Quantidade de cotas e valor da cota por classe/série."
    why_consult: "Use para acompanhar a evolução da cota e do número de cotas emitidas por classe/série."
    aliases: ["Tabela X.2", "tab_X_2", "tab_x_2"]
    scope_and_limits: "Compare somente classes/séries equivalentes e preserve a competência mensal."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_x_2", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_x_3
    display_name: "FIDC Tabela X.3 — Rentabilidade mensal por classe/série"
    what_it_contains: "Rentabilidade apurada no mês por classe/série."
    why_consult: "Use para comparar o desempenho mensal entre classes/séries do mesmo FIDC."
    aliases: ["Tabela X.3", "tab_X_3", "tab_x_3"]
    scope_and_limits: "É retorno mensal reportado; não o transforme em retorno anual sem considerar composição e períodos faltantes."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_x_3", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_x_4
    display_name: "FIDC Tabela X.4 — Operações de cotas por classe/série"
    what_it_contains: "Quantidade de cotas, tipo de operação e valor total das operações reportadas por classe/série."
    why_consult: "Use para acompanhar emissão, resgate ou outras movimentações de cotas dentro do informe."
    aliases: ["Tabela X.4", "tab_X_4", "tab_x_4"]
    scope_and_limits: "Interprete o tipo de operação conforme o domínio oficial; não infira compra/venda apenas pela quantidade."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_x_4", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_x_5
    display_name: "FIDC Tabela X.5 — Liquidez dos ativos"
    what_it_contains: "Valores de ativos por prazo de liquidação: imediata, até 30/60/90/180/360 dias e acima de 360 dias."
    why_consult: "Use para avaliar o perfil de liquidez da carteira e sua capacidade de atender obrigações."
    aliases: ["Tabela X.5", "tab_X_5", "tab_x_5"]
    scope_and_limits: "As faixas são buckets de liquidez reportados, não uma previsão independente de caixa."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_x_5", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_x_6
    display_name: "FIDC Tabela X.6 — Desempenho real e esperado da classe/série"
    what_it_contains: "Percentuais de desempenho real e desempenho esperado reportados para cada classe/série."
    why_consult: "Use para comparar resultado observado com a expectativa declarada no informe."
    aliases: ["Tabela X.6", "tab_X_6", "tab_x_6"]
    scope_and_limits: "Os campos dependem do layout/era; preserve a distinção entre real e esperado."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_x_6", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.fundos.fidc_inf_mensal/tab_x_7
    display_name: "FIDC Tabela X.7 — Garantias de direitos creditórios"
    what_it_contains: "Percentual e valor de direitos creditórios cobertos por garantia, no escopo reportado para o fundo/classe."
    why_consult: "Use para analisar a parcela garantida da carteira e comparar fundos ou competências."
    aliases: ["Tabela X.7", "tab_X_7", "tab_x_7"]
    scope_and_limits: "A tabela informa a garantia declarada, não sua qualidade, liquidez ou execução efetiva."
    evidence: ["catalogo/cvm.yml — fidc_inf_mensal/tab_x_7", "https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal", "https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/base
    display_name: "DFP — Identificação e metadados do documento"
    what_it_contains: "Identificação da companhia, do documento, período de referência, versão e atributos de apresentação."
    why_consult: "Use para selecionar a divulgação correta e contextualizar as demais tabelas anuais."
    aliases: ["BASE", "base"]
    scope_and_limits: "É metadado/documentação; não substitui as linhas de conta das demonstrações."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/base", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/bpa_con
    display_name: "DFP — Balanço patrimonial: ativo consolidado"
    what_it_contains: "Contas de ativo do balanço patrimonial em apresentação consolidada."
    why_consult: "Use para analisar recursos e composição patrimonial do grupo econômico."
    aliases: ["BPA_CON", "bpa_con", "Ativo consolidado"]
    scope_and_limits: "Valores por conta, período e exercício; preserve ds_conta, ordem_exerc e dt_refer."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/bpa_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/bpa_ind
    display_name: "DFP — Balanço patrimonial: ativo individual"
    what_it_contains: "Contas de ativo do balanço patrimonial da companhia em apresentação individual."
    why_consult: "Use para analisar a posição patrimonial da própria companhia, sem a consolidação do grupo."
    aliases: ["BPA_IND", "bpa_ind", "Ativo individual"]
    scope_and_limits: "Não misture com bpa_con; a visão individual e consolidada respondem a perguntas diferentes."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/bpa_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/bpp_con
    display_name: "DFP — Balanço patrimonial: passivo e patrimônio líquido consolidado"
    what_it_contains: "Contas de passivo e patrimônio líquido do balanço consolidado."
    why_consult: "Use para analisar endividamento, obrigações e capital próprio do grupo."
    aliases: ["BPP_CON", "bpp_con", "Passivo consolidado"]
    scope_and_limits: "Contas podem ser atuais/prioritárias e ter dimensões do formulário; use a chave completa."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/bpp_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/bpp_ind
    display_name: "DFP — Balanço patrimonial: passivo e patrimônio líquido individual"
    what_it_contains: "Contas de passivo e patrimônio líquido do balanço individual da companhia."
    why_consult: "Use para analisar obrigações e capital próprio da companhia isolada."
    aliases: ["BPP_IND", "bpp_ind", "Passivo individual"]
    scope_and_limits: "Não agregue com bpp_con; preserve a dimensão individual/consolidada."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/bpp_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/composicao_capital
    display_name: "DFP — Composição do capital social"
    what_it_contains: "Composição e características do capital social reportadas pela companhia."
    why_consult: "Use para estudar estrutura acionária/capital e relacionar mudanças de capital com demonstrações financeiras."
    aliases: ["COMPOSICAO_CAPITAL", "composicao_capital"]
    scope_and_limits: "É uma declaração de composição, não uma tabela de cotação ou de acionistas negociados em bolsa."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/composicao_capital", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dfc_md_con
    display_name: "DFP — Fluxos de caixa pelo método direto, consolidado"
    what_it_contains: "Entradas e saídas de caixa da companhia pelo método direto em apresentação consolidada."
    why_consult: "Use para analisar a origem e o uso do caixa operacional, de investimento e de financiamento do grupo."
    aliases: ["DFC_MD_CON", "dfc_md_con", "Fluxo de caixa direto consolidado"]
    scope_and_limits: "Valores são fluxos do exercício/período; não os trate como saldos patrimoniais."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dfc_md_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dfc_md_ind
    display_name: "DFP — Fluxos de caixa pelo método direto, individual"
    what_it_contains: "Entradas e saídas de caixa da companhia pelo método direto em apresentação individual."
    why_consult: "Use para analisar a geração de caixa da entidade isolada."
    aliases: ["DFC_MD_IND", "dfc_md_ind", "Fluxo de caixa direto individual"]
    scope_and_limits: "Compare apenas com séries individuais equivalentes e respeite o exercício reportado."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dfc_md_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dfc_mi_con
    display_name: "DFP — Fluxos de caixa pelo método indireto, consolidado"
    what_it_contains: "Reconciliação do resultado com os fluxos de caixa pelo método indireto em apresentação consolidada."
    why_consult: "Use para entender a ponte entre lucro/prejuízo e caixa gerado pelo grupo."
    aliases: ["DFC_MI_CON", "dfc_mi_con", "Fluxo de caixa indireto consolidado"]
    scope_and_limits: "As linhas são ajustes e fluxos; não some contas de métodos direto e indireto como se fossem medidas independentes."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dfc_mi_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dfc_mi_ind
    display_name: "DFP — Fluxos de caixa pelo método indireto, individual"
    what_it_contains: "Reconciliação do resultado com os fluxos de caixa pelo método indireto em apresentação individual."
    why_consult: "Use para estudar geração de caixa da entidade isolada a partir do resultado reportado."
    aliases: ["DFC_MI_IND", "dfc_mi_ind", "Fluxo de caixa indireto individual"]
    scope_and_limits: "Preserve o método e a visão da demonstração ao comparar períodos."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dfc_mi_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dmpl_con
    display_name: "DFP — Mutações do patrimônio líquido consolidado"
    what_it_contains: "Movimentações das contas de patrimônio líquido do grupo, incluindo a dimensão de coluna patrimonial do formulário."
    why_consult: "Use para investigar alterações no patrimônio líquido, lucros, dividendos, reservas e outros movimentos do grupo."
    aliases: ["DMPL_CON", "dmpl_con", "Mutações do PL consolidado"]
    scope_and_limits: "A coluna patrimonial (`coluna_df`) é parte da identidade; não remova essa dimensão ao agregar."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dmpl_con", "docs/catalog/deep_docs.yml — dmpl_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dmpl_ind
    display_name: "DFP — Mutações do patrimônio líquido individual"
    what_it_contains: "Movimentações das contas de patrimônio líquido da companhia em apresentação individual."
    why_consult: "Use para acompanhar reservas, resultados distribuídos e demais mudanças no capital próprio da entidade."
    aliases: ["DMPL_IND", "dmpl_ind", "Mutações do PL individual"]
    scope_and_limits: "Preserve coluna patrimonial, conta e ordem do exercício na leitura da demonstração."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dmpl_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dra_con
    display_name: "DFP — Resultado abrangente consolidado"
    what_it_contains: "Linhas do resultado abrangente em apresentação consolidada."
    why_consult: "Use para complementar o lucro/prejuízo com efeitos reconhecidos no resultado abrangente do grupo."
    aliases: ["DRA_CON", "dra_con", "Resultado abrangente consolidado"]
    scope_and_limits: "Não substitui DRE; representa uma demonstração diferente e pode ter contas de apresentação própria."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dra_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dra_ind
    display_name: "DFP — Resultado abrangente individual"
    what_it_contains: "Linhas do resultado abrangente em apresentação individual."
    why_consult: "Use para avaliar efeitos abrangentes da companhia isolada além do lucro/prejuízo."
    aliases: ["DRA_IND", "dra_ind", "Resultado abrangente individual"]
    scope_and_limits: "Compare com DRA individual de outros períodos, sem misturar a visão consolidada."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dra_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dre_con
    display_name: "DFP — Demonstração do resultado consolidado"
    what_it_contains: "Receitas, custos, despesas, resultado e demais contas da demonstração de resultado consolidada."
    why_consult: "Use para analisar desempenho, margens e formação do resultado do grupo econômico."
    aliases: ["DRE_CON", "dre_con", "Resultado consolidado"]
    scope_and_limits: "Contas atuais/prioritárias e versões da divulgação precisam ser filtradas antes de calcular indicadores."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dre_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dre_ind
    display_name: "DFP — Demonstração do resultado individual"
    what_it_contains: "Receitas, custos, despesas, resultado e demais contas da demonstração de resultado individual."
    why_consult: "Use para analisar a rentabilidade da companhia isolada."
    aliases: ["DRE_IND", "dre_ind", "Resultado individual"]
    scope_and_limits: "Não agregue com DRE consolidada; a entidade econômica observada é diferente."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dre_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dva_con
    display_name: "DFP — Demonstração do valor adicionado consolidada"
    what_it_contains: "Valor gerado pelo grupo e sua distribuição entre empregados, governo, financiadores, acionistas e retenção."
    why_consult: "Use para analisar criação e distribuição de valor econômico pelo grupo."
    aliases: ["DVA_CON", "dva_con", "Valor adicionado consolidado"]
    scope_and_limits: "É uma demonstração de distribuição de valor, não um substituto da DRE ou do fluxo de caixa."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dva_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/dva_ind
    display_name: "DFP — Demonstração do valor adicionado individual"
    what_it_contains: "Valor gerado e distribuído pela companhia em apresentação individual."
    why_consult: "Use para estudar a distribuição de valor da entidade isolada."
    aliases: ["DVA_IND", "dva_ind", "Valor adicionado individual"]
    scope_and_limits: "Preserve a visão individual e a ordem do exercício nas comparações."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/dva_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_dfp/parecer
    display_name: "DFP — Pareceres e declarações da divulgação"
    what_it_contains: "Pareceres, declarações e textos associados à divulgação financeira anual."
    why_consult: "Use para contextualizar a demonstração com os pareceres/declarações que acompanham o documento."
    aliases: ["PARECER", "parecer", "Pareceres"]
    scope_and_limits: "Conteúdo textual/documental; não transforme parecer em indicador numérico sem leitura do texto."
    evidence: ["catalogo/cvm.yml — cia_aberta_dfp/parecer", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-dfp"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/base
    display_name: "ITR — Identificação e metadados do documento"
    what_it_contains: "Identificação da companhia, do ITR, período trimestral, versão e atributos de apresentação."
    why_consult: "Use para selecionar a divulgação trimestral correta e contextualizar as tabelas do ITR."
    aliases: ["BASE", "base"]
    scope_and_limits: "É metadado/documentação; os valores financeiros estão nas demonstrações específicas."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/base", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/bpa_con
    display_name: "ITR — Balanço patrimonial: ativo consolidado"
    what_it_contains: "Contas de ativo do balanço patrimonial trimestral em apresentação consolidada."
    why_consult: "Use para acompanhar a posição patrimonial consolidada entre os ITRs."
    aliases: ["BPA_CON", "bpa_con", "Ativo consolidado"]
    scope_and_limits: "Separe período corrente e comparativo e preserve a competência trimestral."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/bpa_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/bpa_ind
    display_name: "ITR — Balanço patrimonial: ativo individual"
    what_it_contains: "Contas de ativo do balanço patrimonial trimestral em apresentação individual."
    why_consult: "Use para acompanhar a posição da companhia isolada entre divulgações trimestrais."
    aliases: ["BPA_IND", "bpa_ind", "Ativo individual"]
    scope_and_limits: "Não misture com o balanço consolidado; preserve a visão da demonstração."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/bpa_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/bpp_con
    display_name: "ITR — Balanço patrimonial: passivo e patrimônio líquido consolidado"
    what_it_contains: "Passivo e patrimônio líquido do balanço trimestral consolidado."
    why_consult: "Use para acompanhar endividamento e capital próprio do grupo ao longo do ano."
    aliases: ["BPP_CON", "bpp_con", "Passivo consolidado"]
    scope_and_limits: "Use a chave completa para separar conta, exercício e período comparativo."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/bpp_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/bpp_ind
    display_name: "ITR — Balanço patrimonial: passivo e patrimônio líquido individual"
    what_it_contains: "Passivo e patrimônio líquido do balanço trimestral individual."
    why_consult: "Use para acompanhar as obrigações e o capital próprio da companhia isolada."
    aliases: ["BPP_IND", "bpp_ind", "Passivo individual"]
    scope_and_limits: "Preserve visão individual, período e ordem do exercício."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/bpp_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/composicao_capital
    display_name: "ITR — Composição do capital social"
    what_it_contains: "Composição do capital social reportada no informe trimestral."
    why_consult: "Use para acompanhar alterações de capital durante o ano."
    aliases: ["COMPOSICAO_CAPITAL", "composicao_capital"]
    scope_and_limits: "É informação declaratória de capital, não um histórico de negociações de ações."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/composicao_capital", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dfc_md_con
    display_name: "ITR — Fluxos de caixa pelo método direto, consolidado"
    what_it_contains: "Fluxos de caixa trimestrais pelo método direto em apresentação consolidada."
    why_consult: "Use para acompanhar geração e consumo de caixa do grupo entre os ITRs."
    aliases: ["DFC_MD_CON", "dfc_md_con", "Fluxo de caixa direto consolidado"]
    scope_and_limits: "Observe o período do fluxo e não o confunda com saldos do balanço."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dfc_md_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dfc_md_ind
    display_name: "ITR — Fluxos de caixa pelo método direto, individual"
    what_it_contains: "Fluxos de caixa trimestrais pelo método direto em apresentação individual."
    why_consult: "Use para acompanhar a geração de caixa da companhia isolada."
    aliases: ["DFC_MD_IND", "dfc_md_ind", "Fluxo de caixa direto individual"]
    scope_and_limits: "Compare entidades e períodos equivalentes; o ITR pode incluir comparativos no mesmo arquivo."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dfc_md_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dfc_mi_con
    display_name: "ITR — Fluxos de caixa pelo método indireto, consolidado"
    what_it_contains: "Reconciliação trimestral do resultado com os fluxos de caixa pelo método indireto em apresentação consolidada."
    why_consult: "Use para acompanhar a ponte entre resultado e caixa do grupo."
    aliases: ["DFC_MI_CON", "dfc_mi_con", "Fluxo de caixa indireto consolidado"]
    scope_and_limits: "Não some com o método direto; são apresentações alternativas da mesma demonstração."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dfc_mi_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dfc_mi_ind
    display_name: "ITR — Fluxos de caixa pelo método indireto, individual"
    what_it_contains: "Reconciliação trimestral do resultado com os fluxos de caixa pelo método indireto em apresentação individual."
    why_consult: "Use para acompanhar a geração de caixa da companhia isolada."
    aliases: ["DFC_MI_IND", "dfc_mi_ind", "Fluxo de caixa indireto individual"]
    scope_and_limits: "Preserve o método, a visão e a ordem do exercício."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dfc_mi_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dmpl_con
    display_name: "ITR — Mutações do patrimônio líquido consolidado"
    what_it_contains: "Movimentações trimestrais do patrimônio líquido do grupo, incluindo a coluna patrimonial do formulário."
    why_consult: "Use para acompanhar mudanças de reservas, resultados e distribuições no grupo."
    aliases: ["DMPL_CON", "dmpl_con", "Mutações do PL consolidado"]
    scope_and_limits: "A dimensão coluna_df e ordem_exerc são parte da leitura; não agregue removendo-as."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dmpl_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dmpl_ind
    display_name: "ITR — Mutações do patrimônio líquido individual"
    what_it_contains: "Movimentações trimestrais do patrimônio líquido da companhia em apresentação individual."
    why_consult: "Use para acompanhar mudanças no capital próprio da entidade durante o ano."
    aliases: ["DMPL_IND", "dmpl_ind", "Mutações do PL individual"]
    scope_and_limits: "Preserve coluna patrimonial, conta e ordem do exercício."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dmpl_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dra_con
    display_name: "ITR — Resultado abrangente consolidado"
    what_it_contains: "Linhas trimestrais do resultado abrangente em apresentação consolidada."
    why_consult: "Use para acompanhar efeitos abrangentes além do resultado do grupo."
    aliases: ["DRA_CON", "dra_con", "Resultado abrangente consolidado"]
    scope_and_limits: "Não substitui a DRE consolidada."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dra_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dra_ind
    display_name: "ITR — Resultado abrangente individual"
    what_it_contains: "Linhas trimestrais do resultado abrangente em apresentação individual."
    why_consult: "Use para acompanhar efeitos abrangentes da companhia isolada."
    aliases: ["DRA_IND", "dra_ind", "Resultado abrangente individual"]
    scope_and_limits: "Compare apenas com períodos e visão individual equivalentes."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dra_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dre_con
    display_name: "ITR — Demonstração do resultado consolidado"
    what_it_contains: "Receitas, custos, despesas e resultado trimestral do grupo econômico."
    why_consult: "Use para analisar desempenho e margens consolidadas ao longo do ano."
    aliases: ["DRE_CON", "dre_con", "Resultado consolidado"]
    scope_and_limits: "Separe trimestre corrente de comparativo e preserve a versão da divulgação."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dre_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dre_ind
    display_name: "ITR — Demonstração do resultado individual"
    what_it_contains: "Receitas, custos, despesas e resultado trimestral da companhia isolada."
    why_consult: "Use para analisar a rentabilidade da entidade entre os ITRs."
    aliases: ["DRE_IND", "dre_ind", "Resultado individual"]
    scope_and_limits: "Não misture com DRE consolidada e filtre a ordem do exercício."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dre_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dva_con
    display_name: "ITR — Demonstração do valor adicionado consolidada"
    what_it_contains: "Valor gerado e distribuído pelo grupo na divulgação trimestral."
    why_consult: "Use para acompanhar distribuição de valor econômico entre os ITRs."
    aliases: ["DVA_CON", "dva_con", "Valor adicionado consolidado"]
    scope_and_limits: "É uma demonstração própria; não equivale a lucro ou caixa."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dva_con", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/dva_ind
    display_name: "ITR — Demonstração do valor adicionado individual"
    what_it_contains: "Valor gerado e distribuído pela companhia na divulgação trimestral individual."
    why_consult: "Use para acompanhar a distribuição de valor da entidade isolada."
    aliases: ["DVA_IND", "dva_ind", "Valor adicionado individual"]
    scope_and_limits: "Preserve a visão individual e a competência trimestral."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/dva_ind", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: cvm.cia_aberta.cia_aberta_itr/parecer
    display_name: "ITR — Pareceres e declarações da divulgação"
    what_it_contains: "Pareceres, declarações e textos associados ao documento trimestral."
    why_consult: "Use para ler o contexto documental que acompanha as informações trimestrais."
    aliases: ["PARECER", "parecer", "Pareceres"]
    scope_and_limits: "Conteúdo textual; não é um indicador financeiro numérico."
    evidence: ["catalogo/cvm.yml — cia_aberta_itr/parecer", "https://dados.cvm.gov.br/dataset/cia_aberta-doc-itr"]

  - tabela_id: bacen.instituicoes.ifdata_cadastro/cadastro
    display_name: "IF.DATA — Cadastro da instituição"
    what_it_contains: "Código, tipo, nome e atributos cadastrais da instituição no período."
    why_consult: "Use para resolver a instituição e enriquecer os fatos financeiros."
    aliases: ["cadastro", "ifdata_cadastro"]
    scope_and_limits: "A chave é temporal e inclui período e tipo de instituição."
    evidence: ["catalogo/bacen.yml — ifdata_cadastro/cadastro", "docs/catalog/deep_docs.yml — ifdata_cadastro"]

  - tabela_id: bacen.instituicoes.ifdata_valores/valores
    display_name: "IF.DATA — Valores por relatório e coluna"
    what_it_contains: "Valor longo por instituição, trimestre, tipo de instituição, relatório e coluna do relatório."
    why_consult: "Use para construir análises comparáveis somente dentro do mesmo escopo de relatório/coluna."
    aliases: ["valores", "ifdata_valores"]
    scope_and_limits: "Unidade e significado variam por report_type/col_name; consulte ifdata_catalogo antes de agregar."
    evidence: ["catalogo/bacen.yml — ifdata_valores/valores", "docs/catalog/deep_docs.yml — ifdata_valores", "https://www3.bcb.gov.br/ifdata/"]

  - tabela_id: bacen.instituicoes.ifdata_catalogo/catalogo
    display_name: "IF.DATA — Catálogo de ativos e relatórios"
    what_it_contains: "Chaves e metadados dos relatórios/ativos disponibilizados pela API IF.DATA."
    why_consult: "Use como dicionário para descobrir o ativo correto e interpretar valores financeiros."
    aliases: ["catalogo", "ifdata_catalogo"]
    scope_and_limits: "Snapshot de metadados; não contém as séries de valores."
    evidence: ["catalogo/bacen.yml — ifdata_catalogo/catalogo", "https://www3.bcb.gov.br/ifdata/"]