Previsão de Transações Futuras no Beancount

O Beancount pode projetar transações recorrentes futuras usando o plugin fava.plugins.forecast. Isso permite que você visualize o impacto futuro de receitas e despesas regulares, como salários, aluguel e assinaturas, em seus relatórios financeiros.

Passo 1: Habilitar o Plugin de Previsão

Primeiro, você precisa habilitar o plugin adicionando a seguinte linha no topo do seu arquivo ledger do Beancount:

plugin "fava.plugins.forecast"

Passo 2: Criar uma Transação de Previsão

Para prever uma transação recorrente, crie uma única entrada de transação usando o marcador # (em vez de * ou !) e adicione uma tag de previsão especial à narração.

A estrutura básica se parece com isto:

YYYY-MM-DD # "Narração [FREQUÊNCIA CONDIÇÕES]"
  Conta:Um      100.00 USD
  Conta:Dois     -100.00 USD

O plugin de previsão usará esta entrada como um modelo para gerar transações futuras em seus relatórios.

Entendendo a Sintaxe de Previsão

A tag de previsão na narração segue um formato específico: [FREQUÊNCIA CONDIÇÕES].

Frequência

A parte FREQUÊNCIA é obrigatória e define com que frequência a transação se repete. Deve estar em letras maiúsculas.

• DIARIAMENTE
• SEMANALMENTE
• MENSALMENTE
• TRIMESTRALMENTE
• ANUALMENTE

Exemplo: Um Pagamento Mensal de Aluguel Esta transação será projetada para ocorrer no dia 1º de cada mês, a partir de Janeiro de 2024.

2024-01-01 # "Pagamento de aluguel [MENSALMENTE]"
  Despesas:Moradia:Aluguel            2500.00 USD
  Ativos:Conta-Corrente                 -2500.00 USD

Condições (Opcional)

Você pode adicionar CONDIÇÕES opcionais para controlar a duração e o padrão da previsão.

1. Definir uma Data de Término com ATÉ Use ATÉ YYYY-MM-DD para interromper a previsão em uma data específica.

• Exemplo: Uma assinatura de academia que termina este ano.

  2024-01-15 # "Assinatura de academia [MENSALMENTE ATÉ 2024-12-31]"
    Despesas:Saúde:Academia                 80.00 USD
    Ativos:Conta-Corrente                    -80.00 USD

2. Limitar Ocorrências com REPETIR Use REPETIR n VEZES para gerar a transação um número específico de vezes.

• Exemplo: Um financiamento de carro com 36 pagamentos restantes.

  2024-01-25 # "Pagamento do carro [MENSALMENTE REPETIR 36 VEZES]"
    Despesas:Transporte:Pagamento-do-Carro  450.00 USD
    Passivos:Financiamento-Auto              -450.00 USD

3. Criar Padrões Irregulares com PULAR Use PULAR n VEZ/VEZES para pular intervalos. Isso é útil para coisas como salários quinzenais.

• Exemplo: Um salário quinzenal (ocorre a cada duas semanas).

  2024-01-05 # "Salário quinzenal [SEMANALMENTE PULAR 1 VEZ]"
    Ativos:Conta-Corrente                    3000.00 USD
    Receita:Salário                     -3000.00 USD

Exemplo Prático: Um Orçamento Mensal

Você pode combinar várias previsões para projetar todo o seu orçamento, incluindo vários fluxos de receita e despesa.

plugin "fava.plugins.forecast"

; === RECEITAS ===
2024-01-05 # "Salário quinzenal [SEMANALMENTE PULAR 1 VEZ]"
  Ativos:Conta-Corrente                    3000.00 USD
  Receita:Salário                     -3000.00 USD

; === DESPESAS ===
2024-01-01 # "Aluguel [MENSALMENTE]"
  Despesas:Moradia:Aluguel            2500.00 USD
  Ativos:Conta-Corrente                 -2500.00 USD

2024-01-01 # "Mercado [SEMANALMENTE]"
  Despesas:Alimentação:Mercado           150.00 USD
  Ativos:Conta-Corrente                  -150.00 USD

2024-01-15 # "Seguro do Carro [TRIMESTRALMENTE REPETIR 4 VEZES]"
  Despesas:Seguro:Auto           450.00 USD
  Ativos:Conta-Corrente                  -450.00 USD

Depois de adicionar essas entradas, seus relatórios, como a Demonstração de Resultados e o gráfico de Lucro Líquido, incluirão automaticamente os dados projetados, oferecendo uma visão clara do seu futuro financeiro.

Solução de Problemas e Melhores Práticas

• Previsões Não Aparecendo?

  • Garanta que plugin "fava.plugins.forecast" esteja no seu arquivo ledger.
  • Use o marcador # para a transação, não *.
  • Verifique se há erros de digitação na tag de frequência (por exemplo, [MENSALMENTE] não [Mensalmente] ou [MENSLAMENTE]).

• Melhores Práticas

  • Seja Descritivo: Use narrações claras para saber para que serve cada previsão.
  • Revise Regularmente: Atualize suas previsões (por exemplo, para um aumento de salário ou mudança no aluguel) para mantê-las precisas.
  • Use Condições de Término: Para transações que não são permanentes (como financiamentos ou assinaturas), use ATÉ ou REPETIR para evitar que sejam previstas indefinidamente.