Prévision des transactions futures dans Beancount

Beancount peut projeter les transactions récurrentes futures à l'aide du plugin fava.plugins.forecast. Cela vous permet de visualiser l'impact futur des revenus et des dépenses réguliers, tels que les salaires, les loyers et les abonnements, sur vos rapports financiers.

Étape 1 : Activer le plugin Forecast

Tout d'abord, vous devez activer le plugin en ajoutant la ligne suivante en haut de votre fichier ledger Beancount :

plugin "fava.plugins.forecast"

Étape 2 : Créer une transaction de prévision

Pour prévoir une transaction récurrente, créez une seule entrée de transaction en utilisant le drapeau # (au lieu de * ou !) et ajoutez une étiquette de prévision spéciale à la narration.

La structure de base ressemble à ceci :

YYYY-MM-DD # "Narration [FREQUENCE CONDITIONS]"
  Account:One      100.00 USD
  Account:Two     -100.00 USD

Le plugin de prévision utilisera cette entrée comme modèle pour générer des transactions futures dans vos rapports.

Comprendre la syntaxe de prévision

L'étiquette de prévision dans la narration suit un format spécifique : [FREQUENCE CONDITIONS].

Fréquence

La partie FREQUENCE est obligatoire et définit la fréquence à laquelle la transaction se reproduit. Elle doit être en majuscules.

• DAILY
• WEEKLY
• MONTHLY
• QUARTERLY
• YEARLY

Exemple : Un paiement de loyer mensuel Cette transaction sera projetée pour se produire le 1er de chaque mois, à partir de janvier 2024.

2024-01-01 # "Paiement du loyer [MONTHLY]"
  Expenses:Housing:Rent            2500.00 USD
  Assets:Checking                 -2500.00 USD

Conditions (facultatif)

Vous pouvez ajouter des CONDITIONS facultatives pour contrôler la durée et le modèle de la prévision.

1. Définir une date de fin avec UNTIL Utilisez UNTIL YYYY-MM-DD pour arrêter la prévision à une date spécifique.

• Exemple : Un abonnement à une salle de sport qui se termine cette année.

  2024-01-15 # "Abonnement à la salle de sport [MONTHLY UNTIL 2024-12-31]"
    Expenses:Health:Gym                 80.00 USD
    Assets:Checking                    -80.00 USD

2. Limiter les occurrences avec REPEAT Utilisez REPEAT n TIMES pour générer la transaction un nombre de fois spécifique.

• Exemple : Un prêt automobile avec 36 paiements restants.

  2024-01-25 # "Paiement automobile [MONTHLY REPEAT 36 TIMES]"
    Expenses:Transportation:CarPayment  450.00 USD
    Liabilities:Auto-Loan              -450.00 USD

3. Créer des modèles irréguliers avec SKIP Utilisez SKIP n TIME/TIMES pour ignorer des intervalles. Ceci est utile pour des choses comme les chèques de paie bimensuels.

• Exemple : Un salaire bimensuel (se produit toutes les deux semaines).

  2024-01-05 # "Salaire bimensuel [WEEKLY SKIP 1 TIME]"
    Assets:Checking                    3000.00 USD
    Income:Salary                     -3000.00 USD

Exemple pratique : Un budget mensuel

Vous pouvez combiner plusieurs prévisions pour projeter l'ensemble de votre budget, y compris divers flux de revenus et de dépenses.

plugin "fava.plugins.forecast"

; === REVENUS ===
2024-01-05 # "Salaire bimensuel [WEEKLY SKIP 1 TIME]"
  Assets:Checking                    3000.00 USD
  Income:Salary                     -3000.00 USD

; === DÉPENSES ===
2024-01-01 # "Loyer [MONTHLY]"
  Expenses:Housing:Rent            2500.00 USD
  Assets:Checking                 -2500.00 USD

2024-01-01 # "Épicerie [WEEKLY]"
  Expenses:Food:Groceries           150.00 USD
  Assets:Checking                  -150.00 USD

2024-01-15 # "Assurance automobile [QUARTERLY REPEAT 4 TIMES]"
  Expenses:Insurance:Auto           450.00 USD
  Assets:Checking                  -450.00 USD

Une fois que vous avez ajouté ces entrées, vos rapports, tels que le Compte de résultat et le graphique Bénéfice net, incluront automatiquement les données projetées, vous donnant une vue claire de votre avenir financier.

Dépannage et bonnes pratiques

• Les prévisions n'apparaissent pas ?

  • Assurez-vous que plugin "fava.plugins.forecast" se trouve dans votre fichier ledger.
  • Utilisez le drapeau # pour la transaction, pas *.
  • Vérifiez qu'il n'y a pas de fautes de frappe dans l'étiquette de fréquence (par exemple, [MONTHLY] et non [Monthly] ou [MONTLY]).

• Bonnes pratiques

  • Soyez descriptif : Utilisez des narrations claires pour savoir à quoi sert chaque prévision.
  • Vérifiez régulièrement : Mettez à jour vos prévisions (par exemple, pour une augmentation de salaire ou un changement de loyer) pour qu'elles restent exactes.
  • Utilisez des conditions de fin : Pour les transactions qui ne sont pas permanentes (comme les prêts ou les abonnements), utilisez UNTIL ou REPEAT pour éviter qu'elles ne soient prévues indéfiniment.