# Rols de flux de caixa: classifica comptes a Beancount.io

Afegiu la metadada `cash-flow-role` a la directiva `open` d'un compte per declarar com l'informe de fluxe de caixa classifica aquest compte. Una clau, quatre valors. Els comptes sense la metadada mantenen les heurístiques per defecte.

```beancount
2000-01-01 open Assets:US:Brokerage
  cash-flow-role: "investing"

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

## Clau i valors

| Clau | On | Tipus de valor | Valors acceptats |
| --- | --- | --- | --- |
| `cash-flow-role` | metadada de la directiva `open` | cadena | `"cash"`, `"operating"`, `"investing"`, `"financing"` |

La coincidència és sensible a majúscules i exacta. El valor ha de ser una cadena entre cometes. Altres claus de metadada en la mateixa directiva són ignorades per l'informe, i aquesta clau és ignorada per qualsevol altre eina.

## Què fa cada valor

Una funció declarada respon a dues preguntes alhora: si el compte forma part de la pila de caixa i, si no, a quina secció d'activitat pertany.

- `"cash"` — el compte s'uneix al conjunt de caixa i equivalents. Els comptes de caixa mai apareixen com a elements d'activitat. La línia final de l'estat, canvi net de caixa i equivalents, és igual a la suma dels seus canvis de període. Les transferències entre dos comptes de caixa es cancel·len. Utilitzeu-lo per a comptes que l'heurística de nom no detecti, com ara un fons del mercat monetari o una cartera de stablecoin.
- `"operating"`, `"investing"`, `"financing"` — el compte no és caixa, i el seu canvi de període apareix com una línia sota aquesta secció d'activiti. Declarar un d'aquests valors en un compte que l'heurística de nom tractaria com caixa, com ara `Assets:US:Bank:CD`, tant el retira del conjunt de caixa com el classifica sota la secció declarada.

Es confia més en les declaracions que en les convencions comptables. Un compte`Equity` declarat `"operating"` s'honra verbatim.

## Precedència

La més alta guanya:

1. Metadada `cash-flow-role` a la directiva `open` del compte.
2. Les heurístiques per defecte integrades a continuació.

## Classificacions per defecte

Un compte sense funció declarada es classifica segons la seva arrel, amb una comprovació de nom que decideix la pertinença a caixa:

- **Arrel del compte:** `Income`, `Expenses` — **Activitat per defecte:** Operativa
- **Arrel del compte:** `Assets` (no caixa) — **Activitat per defecte:** Inversions
- **Arrel del compte:** `Liabilities`, `Equity` — **Activitat per defecte:** Finançament

Els comptes de assets amb noms que continguin `Cash`, `Checking`, `Savings` o `Bank` es tracten per defecte com a caixa i equivalents. Una funció declarada anul·la la comprovació de nom en les dues direccions.

## Valors no vàlids

Un valor no reconegut es tracta com a absent. Un error tipogràfic com `"invsting"`, un valor que no sigui una cadena o una caixa incorrecta cauen a la heurística per defecte, i l'informe assenyala el compte al panell d'estat amb una nota de valor desconegut. Res no deixa de mostrar-se i res no s'accepta en silenci.

## Canvi d'un classificació

Les classificacions no tenen efecte sobre la durada pel període. Qualsevol període utilitza les declaracions tal com són avui. Per canviar-ne una, editeu la directiva `open`; el control de versions del llibre comptable registra què va canviar i quan.

## On s'apliquen les declaracions

Un unic resoldor compartit produeix la funció final per a cada compte, i cada consumidor en llegeix:

- L'informe de fluxe de caixa: les seccions d'activit, el conjunt de caixa i equivalents, i la conciliació de la línia final.
- Exportacions CSV, Markdown i d'impremta: els mateixos números. La divulgació de classificació-és-inferida apareix només per a les línies encara resoltes per l'heurística.
- La diagrama de flux de caixa de visió general: `"cash"` exclou el compte dels nodes de flux, i les funcions d'activit declarades s'honren per a comptes no `Income`. `Income` roman al costat de l'origen i `Equity` continua exclòs del diagram; les declaracions mai no les tornen a assignar aquestes dues.
- El panell d'estat d'un compte: un compte declarable ja no apareix com a acte no classificat.

## Portabilitat

La directiva central de Beancount s'interpreta amb sintaxi `open`. `bea check`, Fava i cada eina v2/v3 la analitzen i ignoren la clau desconegada, de manera que el registre queda totalment utilitzable fora de Beancount.io. Consulta [Sintaxi de Beancount](https://beancount.io/ca/docs/Basics/syntax) per al format general de metadata.
