将来の取引の予測

Beancountはfava.plugins.forecastプラグインを使用して将来の定期的な取引を予測できます。これにより、給与、家賃、サブスクリプションなどの定期的な収入と支出が財務レポートに与える将来の影響を可視化できます。

ステップ1: Forecastプラグインを有効にする​

まず、Beancount元帳ファイルの先頭に次の行を追加して、プラグインを有効にする必要があります。

plugin "fava.plugins.forecast"

ステップ2: 予測取引を作成する​

定期的な取引を予測するには、*や!の代わりに#フラグを使用して単一の取引入力を作成し、説明に特別な予測タグを追加します。

基本的な構造は次のようになります。

YYYY-MM-DD # "説明 [頻度 条件]"
  Account:One      100.00 USD
  Account:Two     -100.00 USD

予測プラグインはこの入力をテンプレートとして使用し、レポートに将来の取引を生成します。

予測構文の理解​

説明内の予測タグは、[頻度 条件]という特定の形式に従います。

頻度​

頻度の部分は必須であり、取引がどのくらいの頻度で繰り返されるかを定義します。すべて大文字で指定する必要があります。

• DAILY（毎日）
• WEEKLY（毎週）
• MONTHLY（毎月）
• QUARTERLY（四半期ごと）
• YEARLY（毎年）

例: 毎月の家賃支払い この取引は、2024年1月から毎月1日に発生すると予測されます。

2024-01-01 # "家賃支払い [MONTHLY]"
  Expenses:Housing:Rent            2500.00 USD
  Assets:Checking                 -2500.00 USD

条件（オプション）​

予測の期間やパターンを制御するために、オプションの条件を追加できます。

1. UNTILで終了日を設定する UNTIL YYYY-MM-DDを使用して、特定の日付で予測を停止します。

• 例: 今年で終了するジムの会費。

  2024-01-15 # "ジム会費 [MONTHLY UNTIL 2024-12-31]"
    Expenses:Health:Gym                 80.00 USD
    Assets:Checking                    -80.00 USD

2. REPEATで発生回数を制限する REPEAT n TIMESを使用して、取引を特定の回数だけ生成します。

• 例: 残り36回の支払いがある自動車ローン。

  2024-01-25 # "自動車ローン支払い [MONTHLY REPEAT 36 TIMES]"
    Expenses:Transportation:CarPayment  450.00 USD
    Liabilities:Auto-Loan              -450.00 USD

3. SKIPで不規則なパターンを作成する SKIP n TIME/TIMESを使用して間隔をスキップします。これは隔週の給与などに便利です。

• 例: 隔週の給与（2週間ごとに発生）。

  2024-01-05 # "隔週給与 [WEEKLY SKIP 1 TIME]"
    Assets:Checking                    3000.00 USD
    Income:Salary                     -3000.00 USD

実践例: 毎月の予算​

複数の予測を組み合わせて、さまざまな収入と支出の流れを含む予算全体を予測できます。

plugin "fava.plugins.forecast"
 
; === 収入 ===
2024-01-05 # "隔週給与 [WEEKLY SKIP 1 TIME]"
  Assets:Checking                    3000.00 USD
  Income:Salary                     -3000.00 USD
 
; === 支出 ===
2024-01-01 # "家賃 [MONTHLY]"
  Expenses:Housing:Rent            2500.00 USD
  Assets:Checking                 -2500.00 USD
 
2024-01-01 # "食料品 [WEEKLY]"
  Expenses:Food:Groceries           150.00 USD
  Assets:Checking                  -150.00 USD
 
2024-01-15 # "自動車保険 [QUARTERLY REPEAT 4 TIMES]"
  Expenses:Insurance:Auto           450.00 USD
  Assets:Checking                  -450.00 USD

これらの入力を追加すると、損益計算書や純利益チャートなどのレポートに予測データが自動的に含まれ、財務の将来像を明確に把握できます。

トラブルシューティングとベストプラクティス​

• 予測が表示されない場合？

  • 元帳ファイルにplugin "fava.plugins.forecast"があることを確認してください。
  • 取引に*ではなく#フラグを使用してください。
  • 頻度タグのスペルミスを確認してください（例：[MONTHLY]は正しく、[Monthly]や[MONTLY]は誤りです）。

• ベストプラクティス

  • 説明を明確に: 各予測の目的がわかるように、わかりやすい説明を使用してください。
  • 定期的に見直す: 精度を保つために、予測を更新してください（例：給与の増加や家賃の変更）。
  • 終了条件を使用する: ローンやサブスクリプションなど、永続的でない取引にはUNTILやREPEATを使用して、無期限に予測されるのを防いでください。