キャッシュフローの役割

勘定科目のopenディレクティブにcash-flow-roleメタデータを追加して、キャッシュフロー報告書がその勘定科目をどのように分類するかを宣言します。1つのキーに4つの値があります。メタデータのない勘定科目はデフォルトのヒューリスティックが適用されます。

2000-01-01 open Assets:US:Brokerage
  cash-flow-role: "investing"
 
2000-01-01 open Assets:US:Marcus:Savings
  cash-flow-role: "cash"

キーと値​

マッチングは大文字小文字を区別し、完全一致です。値は引用符で囲まれた文字列である必要があります。同じディレクティブ上の他のメタデータキーはこのレポートでは無視され、このキーは他のすべてのツールでは無視されます。

各値の意味​

宣言された値は、2つの質問に同時に答えます：その勘定科目が現金同等物の一部であるかどうか、そして、そうでない場合にどの活動セクションに属するかです。

• "cash" — この勘定科目は現金および現金同等物の集合に加わります。現金勘定科目は活動項目としては決して表示されません。報告書の最終行である「現金および現金同等物の純変動額」は、それらの期間変動額の合計に等しくなります。2つの現金勘定科目間の振替は相殺されます。名前ヒューリスティックが見逃す勘定科目、例えばマネー・マーケット・ファンドやステーブルコインのウォレットなどに使用します。
• "operating", "investing", "financing" — この勘定科目は現金ではなく、その期間変動額はその活動セクションの項目として表示されます。名前ヒューリスティックが現金として扱うであろう勘定科目、例えばAssets:US:Bank:CDなどにこれらのいずれかを宣言すると、その勘定科目は現金の集合から除外され、宣言されたセクションに分類されます。

宣言は会計上の慣習よりも優先されます。"operating"と宣言されたEquity勘定科目は、その通りに尊重されます。

優先順位​

最も優先されるもの：

1. 勘定科目のopenディレクティブのcash-flow-roleメタデータ。
2. 以下に示す組み込みのデフォルトヒューリスティック。

デフォルトの分類​

宣言された役割のない勘定科目は、そのルートに基づいて分類され、名前チェックによって現金該当性が決定されます：

名前（勘定科目名）にCash、Checking、Savings、またはBankを含む資産勘定科目は、デフォルトで現金および現金同等物として扱われます。宣言された役割は、名前チェックを両方向で上書きします。

無効な値​

認識されない値は、存在しないものとして扱われます。"invsting"のようなタイプミス、非文字列値、または大文字小文字の間違いは、デフォルトのヒューリスティックにフォールバックし、レポートはステータスパネルにその勘定科目について「不明な値」のメモをフラグ付けします。レンダリングは失敗せず、何も黙って受け入れられることはありません。

分類の変更​

分類は日付効力を持ちません。どの期間の報告書でも、宣言はその時点のものとして使用されます。変更するには、openディレクティブを編集します。元帳のバージョン管理が、いつ何が変更されたかを記録します。

宣言の適用範囲​

単一の共有リゾルバが各勘定科目の最終的な役割を生成し、すべてのコンシューマーがそれを読み取ります：

• キャッシュフロー報告書：活動セクション、現金および現金同等物の集合、および最終行の調整。
• CSV、Markdown、および印刷エクスポート：同じ数値。分類が推測されたものであるという開示は、ヒューリスティックによって解決された行にのみ表示されます。
• キャッシュフロー図の概要："cash"は勘定科目をフローノードから除外し、宣言された活動の役割は非現金勘定科目に対して尊重されます。Incomeはソース側に留まり、Equityは宛先側から除外されたままです。宣言はこれら2つのマッピングを再定義することはありません。
• 勘定科目ステータスパネル：宣言された勘定科目は、もはや未分類の資産としては表示されません。

移植性​

openディレクティブのメタデータは、Beancountのコア構文です。bean-check、Fava、およびv2/v3のすべてのツールは、それを解析し、未知のキーを無視します。そのため、元帳はBeancount.ioの外部でも完全に使用可能です。一般的なメタデータ形式については、Beancount構文を参照してください。