Full de referència de Beancount - Guia de consulta ràpida

Estructura del compte

Tipus de compte i signes

Type          Sign    Example
------------------------------------------------
Assets        (+)     Assets:US:BofA:Checking
Liabilities   (-)     Liabilities:Credit:Amex
Income        (-)     Income:Salary:Gross
Expenses      (+)     Expenses:Food:Restaurant
Equity        (-)     Equity:Opening-Balances

Format de la mercaderia

# Financial
USD, EUR, CAD, AUD     # Standard currencies
GOOG, AAPL, VTI       # Investment vehicles
BTC, ETH              # Cryptocurrencies

# Custom tracking
HOURS                 # Time tracking
AIRMILES             # Rewards points
HOME_MAYST           # Property

Sintaxi de la directiva

Gestió de comptes

# Opening accounts
2024-01-01 open Assets:Checking            # Simple
2024-01-01 open Assets:Investing USD,GOOG  # With constraints

# Closing accounts
2024-12-31 close Assets:Old:Account

Declaració de mercaderies

2024-01-01 commodity VTSAX
    name: "Vanguard Total Stock Market Index"
    asset-class: "equity"

Enregistrament de transaccions

# Basic transaction
2024-01-15 * "Grocery Store" "Weekly shopping"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries

# With metadata and tags
2024-01-15 * "Restaurant" "Business dinner" #work ^invoice-123
    id: "T-1234"
    receipt: "path/to/receipt.pdf"
    Expenses:Meals      80.00 USD
    Liabilities:Credit

Especificacions de publicació

# Basic amount
Assets:Cash              100.00 USD

# Cost basis tracking
Assets:Invest:VTSAX      10 VTSAX {100.00 USD}        # Per-unit
Assets:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     # Total cost
Assets:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} # With fees

# Price specifications
Assets:Forex            1000.00 USD @ 0.85 EUR        # Per-unit
Assets:Forex            1000.00 USD @@ 850.00 EUR     # Total price

# Dated lots
Assets:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

Verificació del saldo

# Balance assertion
2024-01-31 balance Assets:Checking  1000.00 USD

# Balance padding
2024-01-01 pad Assets:Checking Equity:Opening-Balances

Seguiment de metadades

# Note attachment
2024-01-15 note Assets:Checking "Called bank about fee"

# Document linking
2024-01-15 document Assets:Checking "path/to/statement.pdf"

# Price recording
2024-01-15 price VTSAX  100.00 USD

Enregistrament d'esdeveniments

# Location tracking
2024-01-15 event "location" "New York, USA"

# Property changes
2024-01-15 event "address" "123 Main Street"

Gestió d'etiquetes

# Tag scope control
pushtag #vacation
2024-01-15 * "Hotel"
    Expenses:Travel:Lodging   200.00 USD
    Assets:Credit
poptag #vacation

Opcions de configuració

# Basic settings
option "title" "Llibre de comptes de finances personals"
option "operating_currency" "USD"

# Account naming
option "name_assets" "Actius"
option "name_liabilities" "Passius"
option "name_income" "Ingressos"
option "name_expenses" "Despeses"
option "name_equity" "Patrimoni net"

# Document handling
option "documents" "/path/to/docs"

Comentaris i organització

; Comentari d'una sola línia

* Capçalera de secció
** Subsecció
; El bloc de transaccions segueix...

; Agrupació de comptes
; Actius
2024-01-15 ...

; Despeses
2024-01-16 ...

Aquesta referència proporciona una visió general completa dels elements de sintaxi de Beancount amb exemples pràctics.