Hoja de trucos de Beancount - Guía de referencia rápida

Estructura de la cuenta

Tipos de cuenta y signos

Tipo          Signo   Ejemplo
------------------------------------------------
Activos       (+)     Assets:US:BofA:Checking
Pasivos       (-)     Liabilities:Credit:Amex
Ingresos      (-)     Income:Salary:Gross
Gastos        (+)     Expenses:Food:Restaurant
Patrimonio    (-)     Equity:Opening-Balances

Formato de divisa

# Financiero
USD, EUR, CAD, AUD     # Divisas estándar
GOOG, AAPL, VTI       # Vehículos de inversión
BTC, ETH              # Criptomonedas

# Seguimiento personalizado
HOURS                 # Seguimiento del tiempo
AIRMILES             # Puntos de recompensa
HOME_MAYST           # Propiedad

Sintaxis de directivas

Gestión de cuentas

# Apertura de cuentas
2024-01-01 open Assets:Checking            # Simple
2024-01-01 open Assets:Investing USD,GOOG  # Con restricciones

# Cierre de cuentas
2024-12-31 close Assets:Old:Account

Declaración de divisa

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

Registro de transacciones

# Transacción básica
2024-01-15 * "Grocery Store" "Compra semanal"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries

# Con metadatos y etiquetas
2024-01-15 * "Restaurant" "Cena de negocios" #work ^invoice-123
    id: "T-1234"
    receipt: "path/to/receipt.pdf"
    Expenses:Meals      80.00 USD
    Liabilities:Credit

Especificaciones de contabilización

# Cantidad básica
Assets:Cash              100.00 USD

# Seguimiento de la base del costo
Assets:Invest:VTSAX      10 VTSAX {100.00 USD}        # Por unidad
Assets:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     # Costo total
Assets:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} # Con comisiones

# Especificaciones de precio
Assets:Forex            1000.00 USD @ 0.85 EUR        # Por unidad
Assets:Forex            1000.00 USD @@ 850.00 EUR     # Precio total

# Lotes fechados
Assets:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

Verificación de saldo

# Aserción de saldo
2024-01-31 balance Assets:Checking  1000.00 USD

# Relleno de saldo
2024-01-01 pad Assets:Checking Equity:Opening-Balances

Seguimiento de metadatos

# Adjuntar nota
2024-01-15 note Assets:Checking "Llamada al banco por la comisión"

# Enlace de documentos
2024-01-15 document Assets:Checking "path/to/statement.pdf"

# Registro de precios
2024-01-15 price VTSAX  100.00 USD

Registro de eventos

# Seguimiento de la ubicación
2024-01-15 event "location" "New York, USA"

# Cambios de propiedad
2024-01-15 event "address" "123 Main Street"

Gestión de etiquetas

# Control del alcance de la etiqueta
pushtag #vacation
2024-01-15 * "Hotel"
    Expenses:Travel:Lodging   200.00 USD
    Assets:Credit
poptag #vacation

Opciones de configuración

# Configuración básica
option "title" "Libro mayor de finanzas personales"
option "operating_currency" "USD"

# Nombramiento de cuentas
option "name_assets" "Assets"
option "name_liabilities" "Liabilities"
option "name_income" "Income"
option "name_expenses" "Expenses"
option "name_equity" "Equity"

# Gestión de documentos
option "documents" "/path/to/docs"

Comentarios y organización

; Comentario de una sola línea

* Encabezado de sección
** Subsección
; El bloque de transacción sigue...

; Agrupación de cuentas
; Activos
2024-01-15 ...

; Gastos
2024-01-16 ...

Esta referencia proporciona una visión general completa de los elementos de sintaxis de Beancount con ejemplos prácticos.