Ativo Patrimonial

Definição

Ativo Patrimonial é um bem ou direito que compõe o patrimônio de uma pessoa. Na Rica, ativos patrimoniais vão além de investimentos financeiros, incluindo imóveis, veículos, participações empresariais, previdências e seguros.

Aplicação

Um cliente possui um apartamento de R$ 500.000 que gera R$ 2.500 de aluguel mensal. Este imóvel é cadastrado como um ativo patrimonial da classe Imóvel, com valor atual de R$ 500.000 e renda mensal gerada de R$ 2.500.

Um empresário possui 30% de participação em uma empresa que fatura R$ 100.000 mensais. Esta participação é cadastrada como ativo da classe Empresarial, com detalhes de CNPJ, razão social e percentual de participação.

Um profissional possui um VGBL com R$ 80.000 acumulados, contribuindo R$ 1.200 mensalmente. Este plano é cadastrado como ativo da classe Previdência, com detalhes de regime tributário e contribuição mensal.

Estrutura de Dados

Campos Comuns (todas as classes)

Campo	Tipo	Descrição
nome	String	Nome descritivo do ativo
pessoaId	String	Vínculo com pessoa da estrutura familiar
classeAtivo	Enum	Classificação do ativo (ver Classes de Ativos)
moeda	String	Código da moeda (BRL, USD, EUR, etc.)
valorAtual	Decimal	Valor atual do ativo
taxaRendimentoMensalEsperada	Decimal	Taxa mensal esperada para projeções (%)
rendaMensalGerada	Decimal	Receita mensal que o ativo gera
custoMensalManutencao	Decimal	Despesa mensal com manutenção
liquidez	Enum	Velocidade de conversão em dinheiro
tributacao	String	Regime tributário aplicável
dataAquisicao	Data	Data de aquisição do ativo
notas	String	Observações adicionais

Campos de Rastreabilidade

Campo	Tipo	Descrição
importadoViaOpenFinance	Boolean	Se foi importado via Open Finance
itemOpenfinanceId	String	ID do item no Open Finance
origemObjetoBase	Enum	Origem do registro (Manual, Importado, etc.)
procedenciaFerramenta	String	Ferramenta de origem

Classes de Ativos

1. FINANCEIRO

Aplicações financeiras, investimentos, fundos, títulos, ações, etc.

Detalhes específicos:

• investimentoId: Vínculo com investimento já cadastrado
• tipoInvestimento: Tipo (Ações, Fundos, Renda Fixa, etc.)
• instituicao: Instituição financeira
• numero: Número da conta/aplicação
• dataVencimento: Vencimento (se aplicável)
• indexador: Índice de referência (CDI, IPCA, etc.)
• percentualIndexador: Percentual do indexador

Exemplo:

{
  "nome": "CDB Banco XYZ",
  "classeAtivo": "FINANCEIRO",
  "valorAtual": 50000.00,
  "taxaRendimentoMensalEsperada": 0.008,
  "liquidez": "CURTO_PRAZO",
  "detalheFinanceiro": {
    "tipoInvestimento": "RENDA_FIXA",
    "instituicao": "Banco XYZ",
    "indexador": "CDI",
    "percentualIndexador": 100.0
  }
}

2. IMOVEL

Propriedades imobiliárias: casas, apartamentos, terrenos, salas comerciais, etc.

Detalhes específicos:

• endereco: Endereço completo
• cidade: Cidade
• estado: UF
• cep: CEP
• areaM2: Área em metros quadrados
• tipoImovel: Casa, Apartamento, Terreno, Comercial, Rural, Industrial, Outro
• registroImovel: Número de registro
• inscricaoIPTU: Inscrição no IPTU
• alugado: Se está alugado (Boolean)
• dataAquisicao: Data de compra

Tipos de Imóvel:

• CASA: Casa residencial
• APARTAMENTO: Apartamento
• TERRENO: Terreno não edificado
• COMERCIAL: Imóvel comercial (loja, sala, galpão)
• RURAL: Propriedade rural
• INDUSTRIAL: Imóvel industrial
• OUTRO: Outros tipos

Exemplo:

{
  "nome": "Apartamento Ipanema",
  "classeAtivo": "IMOVEL",
  "valorAtual": 800000.00,
  "rendaMensalGerada": 4500.00,
  "custoMensalManutencao": 800.00,
  "liquidez": "LONGO_PRAZO",
  "detalheImovel": {
    "endereco": "Rua Exemplo, 123",
    "cidade": "Rio de Janeiro",
    "estado": "RJ",
    "areaM2": 85.0,
    "tipoImovel": "APARTAMENTO",
    "alugado": true
  }
}

3. VEICULO

Automóveis, motocicletas, embarcações, aeronaves, etc.

Detalhes específicos:

• marca: Marca do veículo
• modelo: Modelo
• ano: Ano de fabricação
• placa: Placa
• tipoVeiculo: Carro, Moto, Caminhão, Embarcação, Aeronave, Outro
• renavam: Número do RENAVAM
• financiado: Se está financiado (Boolean)
• dataAquisicao: Data de compra

Tipos de Veículo:

• CARRO: Automóvel
• MOTO: Motocicleta
• CAMINHAO: Caminhão
• EMBARCACAO: Barco, lancha, jet ski
• AERONAVE: Avião, helicóptero
• OUTRO: Outros veículos

Exemplo:

{
  "nome": "Honda Civic 2022",
  "classeAtivo": "VEICULO",
  "valorAtual": 120000.00,
  "custoMensalManutencao": 800.00,
  "liquidez": "MEDIO_PRAZO",
  "detalheVeiculo": {
    "marca": "Honda",
    "modelo": "Civic EXL",
    "ano": 2022,
    "placa": "ABC1D23",
    "tipoVeiculo": "CARRO",
    "financiado": false
  }
}

4. PREVIDENCIA

Planos de previdência privada (PGBL, VGBL, fundos de pensão).

Detalhes específicos:

• tipoPlano: PGBL, VGBL, Outro
• regimeTributario: Progressivo, Regressivo
• contribuicaoMensal: Valor da contribuição mensal
• instituicao: Instituição financeira
• nomeFundo: Nome do fundo
• dataInicio: Data de início do plano
• investimentoId: Vínculo com investimento (se aplicável)

Tipos de Plano:

• PGBL: Plano Gerador de Benefício Livre
• VGBL: Vida Gerador de Benefício Livre
• OUTRO: Outros tipos (fundos de pensão, etc.)

Regimes Tributários:

• PROGRESSIVO: Tabela progressiva do IR
• REGRESSIVO: Tabela regressiva (quanto maior o tempo, menor o IR)

Exemplo:

{
  "nome": "VGBL Seguradora ABC",
  "classeAtivo": "PREVIDENCIA",
  "valorAtual": 150000.00,
  "taxaRendimentoMensalEsperada": 0.007,
  "liquidez": "LONGO_PRAZO",
  "detalhePrevidencia": {
    "tipoPlano": "VGBL",
    "regimeTributario": "REGRESSIVO",
    "contribuicaoMensal": 2000.00,
    "instituicao": "Seguradora ABC",
    "nomeFundo": "Fundo Previdência Plus"
  }
}

5. EMPRESARIAL

Participações societárias em empresas.

Detalhes específicos:

• cnpj: CNPJ da empresa
• razaoSocial: Razão social
• nomeFantasia: Nome fantasia
• participacaoPercentual: Percentual de participação
• faturamentoMensal: Faturamento mensal da empresa
• setor: Setor de atuação
• dataConstituicao: Data de constituição da empresa

Exemplo:

{
  "nome": "Participação Tech Solutions Ltda",
  "classeAtivo": "EMPRESARIAL",
  "valorAtual": 500000.00,
  "rendaMensalGerada": 15000.00,
  "liquidez": "ILIQUIDO",
  "detalheEmpresarial": {
    "cnpj": "12.345.678/0001-90",
    "razaoSocial": "Tech Solutions Ltda",
    "nomeFantasia": "TechSol",
    "participacaoPercentual": 30.0,
    "faturamentoMensal": 100000.00,
    "setor": "Tecnologia"
  }
}

6. PROTECAO

Seguros e proteções (vida, residencial, saúde, etc.).

Detalhes específicos:

• tipoSeguro: Vida, Residencial, Automóvel, Saúde, Responsabilidade Civil, Empresarial, Outro
• seguradora: Nome da seguradora
• numeroApolice: Número da apólice
• cobertura: Valor da cobertura
• premio: Valor do prêmio (custo mensal/anual)
• dataInicio: Data de início da vigência
• dataFim: Data de fim da vigência
• beneficiarios: Lista de beneficiários

Tipos de Seguro:

• VIDA: Seguro de vida
• RESIDENCIAL: Seguro residencial
• AUTOMOVEL: Seguro de automóvel
• SAUDE: Seguro saúde
• RESPONSABILIDADECIVIL: Seguro de responsabilidade civil
• EMPRESARIAL: Seguro empresarial
• OUTRO: Outros tipos

Exemplo:

{
  "nome": "Seguro de Vida XYZ",
  "classeAtivo": "PROTECAO",
  "valorAtual": 0.00,
  "custoMensalManutencao": 350.00,
  "liquidez": "ILIQUIDO",
  "detalheProtecao": {
    "tipoSeguro": "VIDA",
    "seguradora": "Seguradora XYZ",
    "numeroApolice": "123456789",
    "cobertura": 1000000.00,
    "premio": 350.00,
    "beneficiarios": "Cônjuge e filhos"
  }
}

7. OUTRO

Ativos que não se encaixam nas categorias anteriores (obras de arte, coleções, etc.).

Classificação por Liquidez

A liquidez indica a velocidade com que um ativo pode ser convertido em dinheiro:

Liquidez	Descrição	Exemplos
IMEDIATA	Conversão em até 1 dia	Conta corrente, poupança
CURTO_PRAZO	Conversão em até 90 dias	CDBs de liquidez diária, fundos DI
MEDIO_PRAZO	Conversão entre 90 dias e 2 anos	Títulos públicos, alguns fundos
LONGO_PRAZO	Conversão acima de 2 anos	Previdências, imóveis líquidos
ILIQUIDO	Difícil conversão rápida	Participações societárias, obras de arte

Relacionamentos

• Um ativo patrimonial pertence a uma Pessoa da estrutura familiar
• Um ativo patrimonial pode estar vinculado a um Investimento (classe Financeiro)
• Um ativo patrimonial pode ter Passivos vinculados (ex: imóvel financiado)
• Um ativo patrimonial pode ser importado via Open Finance

Projeções e Curvas de Vida

Os campos taxaRendimentoMensalEsperada, rendaMensalGerada e custoMensalManutencao alimentam cálculos de projeção patrimonial:

Fórmula de Evolução Mensal:

ValorFuturo = ValorAtual × (1 + taxaRendimentoMensal) + rendaMensal - custoMensal

Essas projeções permitem construir curvas de vida patrimonial, considerando:

• Fase de acumulação (até aposentadoria)
• Fase de usufruto (após aposentadoria)
• Impacto de eventos programados (compra de imóvel, venda de ativo, etc.)

Dica para Projeções

Configure a taxaRendimentoMensalEsperada de forma conservadora. Para imóveis, considere apenas a inflação (0.3% a 0.5% ao mês). Para veículos, use taxas negativas (depreciação de -0.5% a -1% ao mês).

Melhores Práticas

1. Atualize regularmente: Revise os valores dos ativos pelo menos trimestralmente
2. Documente a origem: Use o campo notas para registrar informações importantes
3. Configure taxas realistas: Evite otimismo excessivo nas projeções
4. Vincule corretamente: Associe ativos financeiros aos investimentos correspondentes
5. Classifique adequadamente: Use a classe correta para facilitar análises por categoria

Exemplos Práticos

Cenário: Família com Patrimônio Diversificado

Ativos do Pai:

• Apartamento próprio (IMOVEL): R$ 600.000
• Carro (VEICULO): R$ 80.000
• VGBL (PREVIDENCIA): R$ 200.000
• Participação em empresa (EMPRESARIAL): R$ 350.000
• Seguro de vida (PROTECAO): Cobertura R$ 1.000.000

Ativos da Mãe:

• Apartamento para locação (IMOVEL): R$ 450.000 (gera R$ 3.000/mês)
• CDBs e fundos (FINANCEIRO): R$ 150.000

Patrimônio Total: R$ 1.830.000

Essa estrutura permite análises como:

• Concentração patrimonial por classe
• Geração de renda por ativo
• Liquidez total do patrimônio
• Divisão patrimonial entre membros da família