# 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.

```beancount
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

| Schlüssel | Wo | Wertetyp | Akzeptierte Werte |
| --- | --- | --- | --- |
| `cash-flow-role` | `open`-Direktive-Metadaten | Zeichenkette | `"cash"`, `"operating"`, `"investing"`, `"financing"` |

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:

| Kontowurzel | Standard-Aktivität |
| --- | --- |
| `Income`, `Expenses` | Operating |
| `Assets` (nicht Cash) | Investing |
| `Liabilities`, `Equity` | Financing |

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](https://beancount.io/de/docs/Basics/syntax) für das allgemeine Metadatenformat.
