Cashflow-Rollen: Konten in Beancount.io klassifizieren

Fügen Sie die Metadaten cash-flow-role zur open-Direktive eines Kontos hinzu, um festzulegen, wie der Cashflow-Bericht dieses Konto klassifiziert. Ein Schlüssel, vier Werte. Konten ohne diese Metadaten behalten die Standard-Heuristik bei.

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

Schlüssel und Werte​

Der Abgleich erfolgt case-sensitiv und exakt. Der Wert muss eine in Anführungszeichen gesetzte Zeichenkette sein. Andere Metadaten-Schlüssel auf derselben Direktive werden vom Bericht ignoriert, und dieser Schlüssel wird von jedem anderen Tool ignoriert.

Was jeder Wert bewirkt​

Eine erklärte Rolle beantwortet gleichzeitig zwei Fragen: ob das Konto Teil der Zahlungsmittelbestände ist und welchem Aktivitätsabschnitt es andernfalls zugeordnet wird.

• "cash" – Das Konto wird Teil der Zahlungsmittel und Zahlungsmitteläquivalente. Cash-Konten erscheinen nie als Zeile in den Aktivitätsabschnitten. Die Endsumme der Aufstellung, die Nettoveränderung der Zahlungsmittel und Zahlungsmitteläquivalente, entspricht der Summe ihrer Periodenveränderungen. Übertragungen zwischen zwei Cash-Konten heben sich gegenseitig auf. Verwenden Sie dies für Konten, die die Namens-Heuristik übersieht, wie z. B. ein Geldmarktfonds oder eine Stablecoin-Wallet.
• "operating", "investing", "financing" – Das Konto ist kein Cash-Konto und seine Periodenveränderung erscheint als Zeile unter diesem Aktivitätsabschnitt. Wenn Sie dies für ein Konto deklarieren, das die Namens-Heuristik als Cash behandeln würde, wie z. B. Assets:US:Bank:CD, wird es sowohl aus der Cash-Menge entfernt als auch unter dem deklarierten Abschnitt einsortiert.

Deklarationen haben Vorrang vor Buchhaltungskonventionen. Ein Equity-Konto, das als "operating" deklariert ist, wird wörtlich befolgt.

Rangfolge​

Höchste Priorität gewinnt:

1. cash-flow-role-Metadaten auf der open-Direktive des Kontos.
2. Die eingebauten Standard-Heuristiken unten.

Standardklassifizierungen​

Ein Konto ohne deklarierte Rolle wird anhand seiner Wurzel klassifiziert, wobei eine Namensprüfung über die Cash-Mitgliedschaft entscheidet:

Asset-Konten, deren Namen Cash, Checking, Savings oder Bank enthalten, werden standardmäßig als Zahlungsmittel und Zahlungsmitteläquivalente behandelt. Eine deklarierte Rolle überschreibt die Namensprüfung in beide Richtungen.

Ungültige Werte​

Ein nicht erkannter Wert wird als abwesend behandelt. Ein Tippfehler wie "invsting", ein Nicht-Zeichenkettenwert oder eine falsche Groß-/Kleinschreibung führen dazu, dass auf die Standard-Heuristik zurückgegriffen wird, und der Bericht kennzeichnet das Konto im Statusbereich mit einem Hinweis auf einen unbekannten Wert. Es wird nichts gerendert, und nichts wird stillschweigend akzeptiert.

Änderung einer Klassifizierung​

Klassifizierungen sind nicht datumsabhängig. Eine Aufstellung für einen beliebigen Zeitraum verwendet die Deklarationen, wie sie heute bestehen. Um eine zu ändern, bearbeiten Sie die open-Direktive; die Versionskontrolle des Hauptbuchs protokolliert, was sich wann geändert hat.

Wo Deklarationen gelten​

Eine gemeinsame Auflösungsinstanz erzeugt die endgültige Rolle für jedes Konto, und jeder Konsument liest daraus:

• Der Cashflow-Bericht: Aktivitätsabschnitte, die Zahlungsmittel und Zahlungsmitteläquivalente sowie die Überleitungs-Endsumme.
• CSV-, Markdown- und PDF-Exporte: dieselben Zahlen. Die Klassifizierungs-Inferenz wird nur für Zeilen offengelegt, die noch durch die Heuristik aufgelöst werden.
• Das Cashflow-Diagramm auf der Übersichtsseite: "cash" schließt das Konto von den Flussknoten aus, und deklarierte Aktivitätsrollen werden für Nicht-Cash-Konten übernommen. Income bleibt die Quelle und Equity bleibt auf der Finanzierungsseite; Deklarationen ordnen diese beiden nie neu zu.
• Das Konto-Statusfeld: Ein deklariertes Konto erscheint nicht mehr als nicht klassifiziertes Asset.

Portabilität​

Metadaten auf open-Direktiven sind zentraler Bestandteil der Beancount-Syntax. bea check, Fava und jedes v2/v3-Tool parsen sie und ignorieren den unbekannten Schlüssel, sodass das Hauptbuch außerhalb von Beancount.io vollständig nutzbar bleibt. Siehe Beancount-Syntax für das allgemeine Metadatenformat.