Ajoutez la métadonnée cash-flow-role à la directive open d'un compte pour déclarer comment le rapport de flux de trésorerie classe ce compte. Une clé, quatre valeurs. Les comptes sans métadonnée conservent les heuristiques par défaut.
2000-01-01 open Assets:US:Brokerage
cash-flow-role: "investing"
2000-01-01 open Assets:US:Marcus:Savings
cash-flow-role: "cash"Clé et valeurs
| Clé | Emplacement | Type de valeur | Valeurs acceptées |
|---|---|---|---|
cash-flow-role | métadonnées de la directive open | chaîne de caractères | "cash", "operating", "investing", "financing" |
La correspondance est sensible à la casse et exacte. La valeur doit être une chaîne entre guillemets. Les autres clés de métadonnées sur la même directive sont ignorées par le rapport, et cette clé est ignorée par tous les autres outils.
Effet de chaque valeur
Un rôle déclaré répond à deux questions à la fois : si le compte fait partie du stock de trésorerie, et à quelle section d'activité il appartient sinon.
"cash"— le compte rejoint l'ensemble de la trésorerie et des équivalents. Les comptes de trésorerie n'apparaissent jamais comme des postes d'activité. Le résultat final du relevé, la variation nette de la trésorerie et des équivalents, est égal à la somme de leurs variations de période. Les transferts entre deux comptes de trésorerie s'annulent. Utilisez-le pour les comptes que l'heuristique de nom manque, comme un fonds monétaire ou un portefeuille de stablecoins."operating","investing","financing"— le compte n'est pas de la trésorerie, et sa variation de période apparaît comme un poste sous cette section d'activité. Déclarer l'un de ces rôles sur un compte que l'heuristique de nom traiterait comme de la trésorerie, tel queAssets:US:Bank:CD, le retire à la fois de l'ensemble de trésorerie et le classe sous la section déclarée.
Les déclarations priment sur les conventions comptables. Un compte d'Equity déclaré "operating" est honoré tel quel.
Priorité
La priorité la plus élevée l'emporte :
- Métadonnée
cash-flow-rolesur la directiveopendu compte. - Les heuristiques par défaut intégrées ci-dessous.
Classifications par défaut
Un compte sans rôle déclaré est classé par sa racine, avec une vérification du nom décidant de l'appartenance à la trésorerie :
| Racine du compte | Activité par défaut |
|---|---|
Income, Expenses | Exploitation |
Assets (hors trésorerie) | Investissement |
Liabilities, Equity | Financement |
Les comptes d'actifs dont les noms contiennent Cash, Checking, Savings ou Bank sont traités par défaut comme de la trésorerie et des équivalents. Un rôle déclaré remplace la vérification du nom dans les deux sens.
Valeurs invalides
Une valeur non reconnue est traitée comme absente. Une faute de frappe telle que "invsting", une valeur non textuelle ou une mauvaise casse retombe sur l'heuristique par défaut, et le rapport signale le compte dans le panneau d'état avec une note de valeur inconnue. Rien ne cesse de s'afficher, et rien n'est accepté silencieusement.
Modification d'une classification
Les classifications ne sont pas effectives par date. Un relevé pour toute période utilise les déclarations telles qu'elles existent aujourd'hui. Pour en modifier une, modifiez la directive open ; le contrôle de version du grand livre enregistre ce qui a changé et quand.
Où les déclarations s'appliquent
Un résolveur partagé produit le rôle final pour chaque compte, et chaque consommateur le lit :
- Le rapport de flux de trésorerie : sections d'activité, ensemble de trésorerie et équivalents, et rapprochement du résultat final.
- Exports CSV, Markdown et impression : les mêmes chiffres. La mention que la classification est déduite apparaît uniquement pour les lignes encore résolues par l'heuristique.
- Le diagramme de flux de trésorerie de la vue d'ensemble :
"cash"exclut le compte des nœuds de flux, et les rôles d'activité déclarés sont honorés pour les comptes non-Income. Income reste le côté source et Equity reste exclu du diagramme ; les déclarations ne remappent jamais ces deux-là. - Le panneau d'état du compte : un compte déclaré n'apparaît plus comme un actif non classé.
Portabilité
Les métadonnées sur les directives open sont une syntaxe de base de Beancount. bean-check, Fava et tous les outils v2/v3 les analysent et ignorent la clé inconnue, donc le grand livre reste entièrement utilisable en dehors de Beancount.io. Voir Syntaxe Beancount pour le format général des métadonnées.
