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.
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, comeAssets: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:
- Metadati
cash-flow-rolesulla direttivaopendel conto. - 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. bean-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 per il formato generale dei metadati.
