# Ruoli di cash-flow: classificare i conti in Beancount.io

Aggiungi i metadati `cash-flow-role` alla direttiva `open` di un conto per dichiarare come il report del flusso di cassa classifica quel conto. Una chiave, quattro valori. I conti senza i metadati mantengono le euristiche predefinite.

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

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

## Chiave e valori

| Chiave | Dove | Tipo di valore | Valori accettati |
| --- | --- | --- | --- |
| `cash-flow-role` | metadati della direttiva `open` | stringa | `"cash"`, `"operating"`, `"investing"`, `"financing"` |

La corrispondenza è sensibile alle maiuscole e esatta. Il valore deve essere una stringa tra virgolette. Altre chiavi di metadati sulla stessa direttiva vengono ignorate dal report, e questa chiave viene ignorata da ogni altro strumento.

## Cosa fa ciascun valore

Un ruolo dichiarato risponde a due domande contemporaneamente: se il conto fa parte della riserva di cassa e, in caso contrario, a quale sezione di attività appartiene.

- `"cash"` — il conto si unisce all'insieme di cassa ed equivalenti. I conti di cassa non appaiono mai come voci di attività. La riga finale del prospetto, variazione netta di cassa ed equivalenti, è uguale alla somma delle loro variazioni di periodo. I trasferimenti tra due conti di cassa si annullano a vicenda. Usalo per conti che l'euristica del nome non rileva, come un fondo monetario o un portafoglio di stablecoin.
- `"operating"`, `"investing"`, `"financing"` — il conto non è cassa e la sua variazione di periodo appare come una voce sotto quella sezione di attività. Dichiarare uno di questi su un conto che l'euristica del nome tratterebbe come cassa, come `Assets:US:Bank:CD`, sia lo rimuove dall'insieme di cassa sia lo archivia sotto la sezione dichiarata.

Le dichiarazioni sono considerate attendibili rispetto alle convenzioni contabili. Un conto di Patrimonio Netto dichiarato `"operating"` viene onorato alla lettera.

## Precedenza

Vince il più alto:

1. Metadati `cash-flow-role` sulla direttiva `open` del conto.
2. Le euristiche predefinite integrate di seguito.

## Classificazioni predefinite

Un conto senza un ruolo dichiarato viene classificato in base alla sua radice, con un controllo del nome che determina l'appartenenza alla cassa:

| Radice del conto | Attività predefinita |
| --- | --- |
| `Income`, `Expenses` | Operativa |
| `Assets` (non cassa) | Investimento |
| `Liabilities`, `Equity` | Finanziamento |

I conti patrimoniali i cui nomi contengono `Cash`, `Checking`, `Savings` o `Bank` vengono trattati come cassa ed equivalenti per impostazione predefinita. Un ruolo dichiarato sostituisce il controllo del nome in entrambe le direzioni.

## Valori non validi

Un valore non riconosciuto viene trattato come assente. Un errore di battitura come `"invsting"`, un valore non stringa o maiuscole errate ricadono nell'euristica predefinita e il report segnala il conto nel pannello di stato con una nota di valore sconosciuto. Niente smette di essere visualizzato e niente viene accettato silenziosamente.

## Modifica di una classificazione

Le classificazioni non hanno effetto per data. Un prospetto per qualsiasi periodo utilizza le dichiarazioni così come sono oggi. Per modificarne una, modifica la direttiva `open`; il controllo versioni del registro registra cosa è cambiato e quando.

## Dove si applicano le dichiarazioni

Un risolutore condiviso produce il ruolo finale per ciascun conto e ogni consumatore legge da esso:

- Il report del flusso di cassa: sezioni di attività, insieme di cassa ed equivalenti e riconciliazione della riga finale.
- Esportazioni CSV, Markdown e stampa: gli stessi numeri. La nota di classificazione-inferita appare solo per le righe ancora risolte dall'euristica.
- Il diagramma del flusso di cassa nella panoramica: `"cash"` esclude il conto dai nodi di flusso e i ruoli di attività dichiarati vengono onorati per i conti non di Reddito. Il Reddito rimane il lato fonte e il Patrimonio Netto rimane escluso dal diagramma; le dichiarazioni non rimappano mai questi due.
- Il pannello di stato del conto: un conto dichiarato non appare più come attività non classificata.

## Portabilità

I metadati sulle direttive `open` sono sintassi core di Beancount. `bea check`, Fava e ogni strumento v2/v3 li analizzano e ignorano la chiave sconosciuta, quindi il registro rimane pienamente utilizzabile al di fuori di Beancount.io. Vedi [Sintassi di Beancount](https://beancount.io/it/docs/Basics/syntax) per il formato generale dei metadati.
