Voeg cash-flow-role-metadata toe aan de open-directive van een rekening om aan te geven hoe het cashflow-rapport die rekening classificeert. Eén sleutel, vier waarden. Rekeningen zonder deze metadata behouden de standaardheuristiek.
2000-01-01 open Assets:US:Brokerage
cash-flow-role: "investing"
2000-01-01 open Assets:US:Marcus:Savings
cash-flow-role: "cash"Sleutel en waarden
| Sleutel | Waar | Waardetype | Toegestane waarden |
|---|---|---|---|
cash-flow-role | open-directive-metadata | string | "cash", "operating", "investing", "financing" |
Matching is hoofdlettergevoelig en exact. De waarde moet een string tussen aanhalingstekens zijn. Andere metadata-sleutels op dezelfde directive worden door het rapport genegeerd, en deze sleutel wordt door alle andere tools genegeerd.
Wat elke waarde doet
Een gedeclareerde rol beantwoordt twee vragen tegelijk: of de rekening deel uitmaakt van de kasmiddelen, en anders onder welke activiteitensectie deze valt.
"cash"— de rekening wordt toegevoegd aan de verzameling kasmiddelen en -equivalenten. Kasrekeningen verschijnen nooit als activiteitenposten. De onderste regel van het overzicht, de nettoverandering in kasmiddelen en -equivalenten, is gelijk aan de som van hun periodieke veranderingen. Overboekingen tussen twee kasrekeningen vallen tegen elkaar weg. Gebruik dit voor rekeningen die de naamheuristiek over het hoofd ziet, zoals een geldmarktfonds of een stablecoin-portemonnee."operating","investing","financing"— de rekening is geen kas, en de periodieke verandering verschijnt als een post onder die activiteitensectie. Het declareren van een van deze op een rekening die de naamheuristiek als kas zou behandelen, zoalsAssets:US:Bank:CD, verwijdert deze zowel uit de kasverzameling als plaatst deze onder de gedeclareerde sectie.
Declaraties prevaleren boven boekhoudkundige conventies. Een Eigen vermogen-rekening die als "operating" is gedeclareerd, wordt letterlijk geëerd.
Prioriteit
Hoogste wint:
cash-flow-role-metadata op deopen-directive van de rekening.- De ingebouwde standaardheuristieken hieronder.
Standaardclassificaties
Een rekening zonder gedeclareerde rol wordt geclassificeerd op basis van de root, met een naamcontrole die bepaalt of deze als kas wordt behandeld:
| Rekening-root | Standaardactiviteit |
|---|---|
Income, Expenses | Operating |
Assets (niet-kas) | Investing |
Liabilities, Equity | Financing |
Rekeningen waarvan de namen Cash, Checking, Savings of Bank bevatten, worden standaard als kasmiddelen en -equivalenten behandeld. Een gedeclareerde rol overschrijft de naamcontrole in beide richtingen.
Ongeldige waarden
Een niet-herkende waarde wordt beschouwd als afwezig. Een typfout zoals "invsting", een niet-string-waarde of verkeerde hoofdletters valt terug op de standaardheuristiek, en het rapport markeert de rekening in het statuspaneel met een notitie over een onbekende waarde. Er wordt niets niet gerenderd en niets wordt stilzwijgend geaccepteerd.
Een classificatie wijzigen
Classificaties zijn niet datumeffectief. Een overzicht voor elke periode gebruikt de declaraties zoals ze vandaag zijn. Om iets te wijzigen, bewerk je de open-directive; de versiebeheer van het grootboek registreert wat er is veranderd en wanneer.
Waar declaraties van toepassing zijn
Eén gedeelde resolver produceert de uiteindelijke rol voor elke rekening, en elke consumer leest daaruit:
- Het cashflow-rapport: activiteitensecties, de verzameling kasmiddelen en -equivalenten, en de afstemming op de onderste regel.
- CSV-, Markdown- en print-exporten: dezelfde cijfers. De openbaarmaking dat de classificatie is afgeleid, verschijnt alleen voor rijen die nog steeds door de heuristiek worden opgelost.
- Het cashflow-overzichtsdiagram:
"cash"sluit de rekening uit van stromingsknooppunten, en gedeclareerde activiteitsrollen worden geëerd voor niet-Income-rekeningen. Income blijft aan de bronkant en Equity blijft uitgesloten van het diagram; declaraties wijzigen die twee nooit. - Het statuspaneel van rekeningen: een gedeclareerde rekening verschijnt niet langer als niet-geclassificeerd.
Draagbaarheid
Metadata op open-directives is kern-Beancount-syntaxis. bean-check, Fava en elke v2/v3-tool parseren dit en negeren de onbekende sleutel, zodat het grootboek volledig bruikbaar blijft buiten Beancount.io. Zie Beancount-syntaxis voor het algemene metadata-formaat.
