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.

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​

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 compteEquity 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 per al format general de metadata.