Estructura de comptes
Tipus de comptes i signes
Tipus Signe Exemple
------------------------------------------------
Assets (+) Assets:US:BofA:Checking
Liabilities (-) Liabilities:Credit:Amex
Income (-) Income:Salary:Gross
Expenses (+) Expenses:Food:Restaurant
Equity (-) Equity:Opening-BalancesFormat de les mercaderies
Les mercaderies són símbols en majúscules — divises, tíckers i unitats personalitzades. Aquests són exemples de nomenclatura, no directives:
Divises: USD, EUR, CAD, AUD
Inversions: GOOG, AAPL, VTI
Criptomonedes: BTC, ETH
Unitats pròpies: HOURS, AIRMILES, HOME_MAYSTSintaxi de directrius
Gestió de comptes
; Obrir comptes
2024-01-01 open Assets:Checking ; Simple
2024-01-01 open Assets:Investing USD,GOOG ; Amb restriccions
; Tancar comptes
2024-12-31 close Assets:Old:AccountDeclaració de mercaderies
2024-01-01 commodity VTSAX
name: "Vanguard Total Stock Market Index"
asset-class: "equity"Registre de transaccions
; Transacció bàsica
2024-01-15 * "Grocery Store" "Weekly shopping"
Assets:Checking -100.00 USD
Expenses:Food:Groceries
; Amb metadades i etiquetes (#work és una etiqueta, ^invoice-123 és un enllaç)
2024-01-15 * "Restaurant" "Business dinner" #work ^invoice-123
id: "T-1234"
receipt: "path/to/receipt.pdf"
Expenses:Meals 80.00 USD
Liabilities:CreditEspecificacions d'apunts
Aquestes són línies d'apunt — cadascuna se situa dins d'una transacció, sagnada sota la seva línia de data:
; Import bàsic
Assets:Cash 100.00 USD
; Seguiment de la base de cost
Assets:Invest:VTSAX 10 VTSAX {100.00 USD} ; Cost per unitat
Assets:Invest:VTSAX 10 VTSAX {{1000.00 USD}} ; Cost total
Assets:Invest:VTSAX 10 VTSAX {100.00 # 9.95 USD} ; Cost per unitat més comissió total
; Especificacions de preu
Assets:Forex 1000.00 USD @ 0.85 EUR ; Per unitat
Assets:Forex 1000.00 USD @@ 850.00 EUR ; Preu total
; Lots amb data
Assets:Invest:VTSAX 10 VTSAX {100.00 USD, 2024-01-15}Verificació de saldos
; Farciment de saldo: omple Assets:Checking fins a Equity:Opening-Balances
2024-01-01 pad Assets:Checking Equity:Opening-Balances
; Asserció de saldo: es comprova a l'inici de la seva data, així que data-la després del pad
2024-02-01 balance Assets:Checking 1000.00 USDSeguiment de metadades
; Adjunció de notes
2024-01-15 note Assets:Checking "Called bank about fee"
; Enllaç de documents
2024-01-15 document Assets:Checking "path/to/statement.pdf"
; Registre de preus
2024-01-15 price VTSAX 100.00 USDPer a llibres allotjats, Live Prices pot subministrar preus de valoració amb data automàticament. Trieu parells d'actius compatibles al selector i copieu els includes al vostre llibre. Mantingueu els preus de transacció i la base de cost explícits.
Registre d'esdeveniments
; Seguiment d'ubicació
2024-01-15 event "location" "New York, USA"
; Canvis de propietat
2024-01-15 event "address" "123 Main Street"Gestió d'etiquetes
; Control d'abast d'etiquetes: #vacation s'aplica a cada transacció entre pushtag i poptag
pushtag #vacation
2024-01-15 * "Hotel"
Expenses:Travel:Lodging 200.00 USD
Assets:Credit
poptag #vacationOpcions de configuració
; Configuració bàsica
option "title" "Personal Finance Ledger"
option "operating_currency" "USD"
; Nomenclatura de comptes
option "name_assets" "Assets"
option "name_liabilities" "Liabilities"
option "name_income" "Income"
option "name_expenses" "Expenses"
option "name_equity" "Equity"
; Gestió de documents
option "documents" "/path/to/docs"Comentaris i organització
; Comentari d'una sola línia
* Capçalera de secció
** Subsecció
; A continuació, bloc de transaccions...
; Agrupació de comptes
; Assets
2024-01-15 ...
; Expenses
2024-01-16 ...Aquesta referència ofereix una visió completa dels elements de sintaxi de Beancount amb exemples pràctics.