Fundamental CopilotBR
Documentação

Metodologia

Como o Fundamental Copilot BR organiza, trata e apresenta dados fundamentalistas e informativos para diferentes tipos de ativos.

A · Visão geral
Como a plataforma funciona

O Fundamental Copilot BR não aplica o mesmo modelo a todos os ativos. O primeiro passo é sempre classificar o tipo do ativo — empresa operacional, banco, FII, seguradora, ETF, BDR ou ativo descontinuado. Depois, o ticker é roteado para a camada de análise adequada ao seu tipo.

Esse roteamento evita forçar métricas industriais sobre ativos que não publicam demonstrações financeiras corporativas comparáveis — como bancos, FIIs, ETFs e BDRs. Cada camada usa os dados disponíveis para aquele tipo específico.

A plataforma não fornece recomendação de investimento, preço-alvo, valor justo ou linguagem de compra/venda/manutenção para nenhum tipo de ativo.
B · Classificação do ativo
Roteamento por tipo de ativo

Cada ativo do universo B3 é classificado por tipo antes de ser exibido no dashboard. O roteamento determina qual camada de análise é aplicada:

  1. 1Empresas operacionais (ações ON/PN/units de companhias industriais, de energia, etc.) → análise fundamentalista CVM com DFP anual.
  2. 2Bancos → modelo bancário específico com ativos, patrimônio, ROE e ROA extraídos da DFP CVM.
  3. 3FIIs → modelo de fundos imobiliários com Informe Mensal CVM — patrimônio, P/VP e DY 12m.
  4. 4Seguradoras → modelo específico com ativos, patrimônio, lucro e campos de seguro da DFP CVM.
  5. 5ETFs e BDRs → camada informativa — sem análise fundamentalista corporativa.
  6. 6Ativos descontinuados ou sem cobertura → estado indisponível, sem dados exibidos.
Resumo dos modelos
Empresas operacionais
  • ·DFP anual consolidada (CVM)
  • ·Indicadores: margem, crescimento, caixa, dívida
  • ·Diagnóstico baseado em regras
  • ·Sem preço-alvo ou recomendação
Bancos
  • ·Modelo específico para instituições financeiras
  • ·Ativos, patrimônio, lucro, ROE, ROA
  • ·Sem receita industrial, EBIT ou FCL
  • ·Dados CVM — DFP anual
FIIs
  • ·Informe Mensal CVM
  • ·Patrimônio, P/VP, DY 12m quando confiável
  • ·Distribuições ausentes não tratadas como zero
  • ·Sem classificação barato/caro
Seguradoras
  • ·Modelo específico para seguradoras
  • ·Ativos, patrimônio, lucro, ROE, ROA
  • ·Campos específicos de seguro quando disponíveis
  • ·Sem comparação com empresas industriais
ETFs e BDRs
  • ·Camada informativa — sem análise fundamentalista
  • ·Contexto de mercado e instrumento
  • ·Sem modelo de projeção ou valuation
  • ·Cotação via brapi quando disponível
Projeções
  • ·Modelos quantitativos simples (baseline)
  • ·Projeção de fundamentos, não de preço
  • ·Diagnóstico de qualidade: Alta/Média/Baixa/Insuficiente
  • ·Não é recomendação de investimento
Tabela · Roteamento por tipo
Tipo de ativoCamada aplicadaPrincipais dadosO que não é aplicado
Empresa operacionalAnálise fundamentalista CVMDFP anual — receita, EBIT, lucro, CFO, capex, dívidaMétricas bancárias, NAV, indicadores de seguro
BancoModelo bancárioAtivos, patrimônio, lucro, ROE, ROA, relação equity/ativosReceita industrial, EBIT, FCL, múltiplos setoriais
FIIModelo de fundos imobiliáriosPatrimônio, NAV por cota, P/VP, DY 12m (quando confiável)Receita industrial, indicadores bancários
SeguradoraModelo de seguradorasAtivos, patrimônio, lucro, ROE, ROA e campos específicosReceita industrial, FCL, múltiplos de EBITDA
ETF / BDRCamada informativaCotação de mercado, tipo do instrumento, descriçãoQualquer análise fundamentalista corporativa, projeção
Ativo descontinuadoEstado indisponívelNenhumQualquer análise ou cotação
C · Empresas operacionais
Análise fundamentalista CVM

Para empresas operacionais com mapeamento CVM, a plataforma usa dados da Demonstração Financeira Padronizada (DFP) anual consolidada, obtida de dados.cvm.gov.br. Os dados são pré-processados e armazenados em cache local — o dashboard não executa pipelines pesados em tempo real.

Pipeline de dados
  1. 1Download do arquivo ZIP da DFP por ano fiscal (dados.cvm.gov.br).
  2. 2Parsing e filtragem pelo código CVM da empresa-alvo.
  3. 3Extração das contas-chave: Receita (3.01), EBIT (3.05), Lucro (3.11), CFO (6.01), Capex (6.02), Caixa (1.01.01), Dívida CP (2.01.04), Dívida LP (2.02.01).
  4. 4Normalização em BRL bilhões e montagem do histórico de até 5 anos.
  5. 5Armazenamento em cache pré-computado — servido diretamente nas requisições do dashboard.
Indicadores calculados
CAGR Receita (3a)
(Receita_ano3 / Receita_ano1) ^ (1/2) − 1

Crescimento anual composto da receita nos últimos 3 anos disponíveis. Requer ao menos 3 anos com receita positiva.

Margem EBIT
EBIT / Receita Líquida

Percentual da receita convertido em resultado operacional antes de juros e impostos.

Margem Líquida
Lucro Líquido / Receita Líquida

Percentual da receita convertido em lucro após todos os custos, impostos e despesas financeiras.

Margem FCL
FCL / Receita Líquida • FCL = CFO − Capex

Percentual da receita convertido em fluxo de caixa livre. FCL negativo indica que o investimento supera o caixa gerado.

Dívida Líquida / EBIT
(Dívida Total − Caixa) / EBIT

Anos de resultado operacional necessários para quitar a dívida líquida. Indicador de alavancagem financeira.

Diagnóstico baseado em regras: a plataforma aplica regras determinísticas ao histórico normalizado para emitir observações objetivas sobre crescimento, margens, qualidade do lucro e endividamento. Não há modelo de linguagem ou aprendizado de máquina. Nenhuma observação constitui recomendação.
D · Bancos
Modelo bancário

Bancos possuem estrutura contábil distinta de empresas industriais. A plataforma aplica um modelo específico que usa as demonstrações anuais CVM (DFP) e extrai métricas adequadas ao segmento financeiro.

  • —Ativos totais e patrimônio líquido como base da análise.
  • —Lucro líquido, ROE (Retorno sobre Patrimônio) e ROA (Retorno sobre Ativos).
  • —Relação patrimônio/ativos como indicador de solidez de capital.
  • —Dados anuais — versão atual conservadora, com histórico de até 5 anos.
Receita industrial, EBIT, FCL e múltiplos de EBITDA não são calculados nem exibidos para bancos. O modelo industrial padrão não se aplica a instituições financeiras.
E · Fundos de Investimento Imobiliário (FIIs)
Modelo de FII

FIIs utilizam o Informe Mensal CVM como fonte primária, quando disponível. O modelo extrai indicadores específicos do segmento imobiliário.

  • —Patrimônio Líquido (NAV) e NAV por cota.
  • —P/VP (Preço sobre Valor Patrimonial) como referência relativa — sem classificação barato/caro.
  • —DY 12m (Dividend Yield dos últimos 12 meses) calculado apenas quando há distribuições suficientes para cobertura confiável.
  • —Distribuições ausentes não são tratadas como zero — o sistema distingue dado ausente de distribuição zero.
  • —Indicadores industriais (receita, EBIT, FCL, dívida corporativa) não são aplicados.
F · Seguradoras
Modelo de seguradora

Seguradoras têm estrutura de receita e contabilidade própria. A plataforma aplica um modelo específico extraído da DFP anual CVM.

  • —Ativos totais, patrimônio líquido e lucro líquido como base.
  • —ROE e ROA calculados a partir dos dados CVM.
  • —Campos específicos de seguro extraídos quando disponíveis nas demonstrações.
  • —Sem comparação direta com empresas industriais ou bancos.
  • —Sem múltiplos de EBITDA ou FCL — métricas industriais não se aplicam.
G · ETFs e BDRs
Camada informativa

ETFs (fundos de índice listados em bolsa) e BDRs (recibos de ativos estrangeiros) não publicam demonstrações financeiras corporativas comparáveis às de empresas operacionais brasileiras. Por isso, recebem uma camada informativa — e não um modelo de análise fundamentalista.

  • —ETFs: a tela exibe o tipo do fundo, o índice ou estratégia replicada, e a cotação de mercado quando disponível.
  • —BDRs: a tela exibe o ativo subjacente estrangeiro, a bolsa de origem e a cotação quando disponível.
  • —Nenhum indicador fundamentalista (receita, EBIT, FCL, ROE, margens) é calculado.
  • —Nenhum modelo de projeção ou forecast é aplicado.
  • —A empresa subjacente do BDR não reporta pela estrutura CVM de companhia brasileira.
A tela de ETF/BDR é informativa e não constitui recomendação de investimento. A plataforma não calcula preço-alvo, valor justo, upside ou downside para nenhum desses instrumentos.
H · Projeções de fundamentos
Baseline quantitativo de fundamentos

A plataforma inclui um painel de projeções de fundamentos para empresas operacionais com histórico CVM suficiente. As projeções são estimativas quantitativas de métricas contábeis — não previsões de preço de ação.

  • —Modelos de baseline simples: ingênuo (naive), média móvel, tendência linear e sazonalidade quando aplicável.
  • —As projeções são pré-computadas a partir do histórico de demonstrações normalizadas e armazenadas em cache.
  • —O painel exibe o histórico observado, a projeção e uma banda de incerteza heurística.
  • —Diagnóstico de qualidade classifica a confiabilidade como Alta, Média, Baixa ou Insuficiente com score 0–100.
  • —O diagnóstico considera cobertura histórica, consistência dos dados e desempenho no retroteste walk-forward.
  • —ETFs, BDRs, bancos, FIIs e seguradoras não recebem painel de projeções.
As projeções são estimativas quantitativas de fundamentos. Não são recomendações, previsões de preço, nem indicativos de resultado futuro garantido.
I · Fontes de dados e arquitetura de cache
Cache-first — sem pipelines pesados em tempo real
  • —Dados CVM (DFP anual, Informe Mensal) são pré-processados offline e armazenados em cache local (src/data/*-cache/).
  • —As requisições do dashboard servem dados do cache — sem download ou parsing de arquivos CVM em tempo real.
  • —Cotações de mercado são obtidas via brapi e usadas apenas para contexto de preço, não para análise fundamentalista.
  • —Documentos CVM (DFP, ITR, FRE, fatos relevantes) são buscados no sistema ENET/CVM, com cache temporário para melhorar desempenho.
  • —Nenhum documento CVM é fabricado ou inventado — links apontam para o visualizador oficial da CVM (rad.cvm.gov.br).
J · Limitações
O que a plataforma não cobre ou garante
  • —Dados podem estar incompletos ou ausentes para alguns ativos — a cobertura depende da disponibilidade e padronização dos dados CVM.
  • —Algumas contas contábeis não são perfeitamente padronizadas entre companhias ou fundos — divergências são esperadas.
  • —EBITDA usa EBIT como proxy quando D&A não está disponível como linha separada na DFP.
  • —Dívida total captura apenas as linhas 2.01.04 (CP) e 2.02.01 (LP) — debêntures em contas não padronizadas podem não ser incluídas.
  • —Tickers históricos ou descontinuados não são tratados como cobertura ativa.
  • —A plataforma processa apenas demonstrações consolidadas. ITR trimestral está disponível em beta para alguns ativos.
  • —A plataforma tem finalidade educacional e informacional — não é registrada como serviço de consultoria de valores mobiliários.
Aviso legal e limitações
  • ⚠A plataforma não fornece recomendação de investimento.
  • ⚠As projeções são estimativas quantitativas de fundamentos, não previsões de preço de ação.
  • ⚠A cobertura depende da disponibilidade e padronização dos dados.
  • ⚠Nenhum preço-alvo, valor justo, upside, downside ou linguagem de compra/venda/manutenção é calculado ou exibido.
  • ⚠Os dados têm finalidade educacional e demonstrativa — consulte um profissional certificado antes de tomar decisões de investimento.