Pular para o conteúdo principal

FinancialAccount (Conta Financeira)

A FinancialAccount representa uma conta bancaria ou caixa usado para movimentacoes financeiras.

Descricao​

Contas financeiras sao onde o dinheiro e armazenado e movimentado. Podem ser contas bancarias reais, carteiras digitais ou caixas internos.

Dados​

Informacoes da Conta​

CampoTipoObrigatorioDescricao
nameTextoSimNome da conta
typeSelecaoSimTipo da conta
initial_balanceMonetarioNaoSaldo inicial
current_balanceMonetarioCalculadoSaldo atual
activeBooleanoSimSe conta esta ativa

Dados Bancarios​

CampoTipoObrigatorioDescricao
bank_idReferenciaCondicionalBanco
agencyTextoNaoNumero da agencia
account_numberTextoNaoNumero da conta
account_digitTextoNaoDigito da conta

Relacionamentos​

Pertence a​

EntidadeObrigatorioDescricao
AccountSimConta do petshop
StoreNaoFilial especifica
BankCondicionalBanco (se conta bancaria)

Possui​

EntidadeDescricao
FinancialTransactionsTransacoes da conta
BankReconciliationsConciliacoes bancarias

Tipos de Conta​

TipoDescricao
checkingConta corrente
savingsConta poupanca
cashCaixa/Dinheiro
digital_walletCarteira digital
investmentInvestimento

Calculo de Saldo​

Formula​

current_balance = initial_balance + sum(transacoes.signal_value)

Atualizacao​

O saldo e recalculado automaticamente quando:

  • Transacao e criada
  • Transacao e atualizada
  • Transacao e excluida
  • Transacao e paga

Metodo​

calculate_balance!
- Busca todas as transacoes paid
- Soma signal_values
- Adiciona initial_balance
- Atualiza current_balance

Saldo Inicial​

Criacao​

Ao definir initial_balance:

  1. Cria FinancialTransaction com initial_balance = true
  2. Type = "revenue"
  3. Status = "paid"
  4. Valor = initial_balance

Restricao​

  • Transacao de saldo inicial nao pode ser editada
  • Transacao de saldo inicial nao pode ser excluida

Conciliacao Bancaria​

Processo​

  1. Importar arquivo OFX do banco
  2. Sistema cria BankReconciliation
  3. Para cada lancamento do extrato:
    • Busca transacao correspondente
    • Ou cria nova transacao
  4. Marca transacoes como reconciliadas

Integracao​

Visualizacao de Saldo​

Saldo por Periodo​

MetricaCalculo
Saldo inicial do periodoTransacoes ate data inicial
Entradas no periodoReceitas no periodo
Saidas no periodoDespesas no periodo
Saldo finalInicial + Entradas - Saidas

Fluxo de Caixa​

Projecao de saldo considerando transacoes futuras pendentes.

Validacoes​

CampoRegra
nameObrigatorio, unico por conta
typeObrigatorio
bankObrigatorio se type = "checking" ou "savings"

Regras de Negocio​

  1. Saldo atualizado automaticamente: Nao e necessario calcular manualmente
  2. Nao pode excluir com transacoes: Conta com movimentacoes nao pode ser excluida
  3. Desativacao: Contas podem ser desativadas (nao aparecem em selecoes)

Permissoes​

AcaoDescricao
CriarCriar nova conta
EditarAlterar dados da conta
DesativarMarcar como inativa
ConciliarImportar e conciliar extrato
Ver saldoVisualizar saldo e movimentacoes

Integracao com Transacoes​

Ao Selecionar Conta​

Quando payment_account = "financial_account":

  • Transacao vinculada a esta conta
  • Saldo e afetado quando transacao e paga
  • Pode ser conciliada com extrato