Glosario

La contabilidad en texto plano toma prestado vocabulario de la contabilidad por partida doble y añade un puñado de términos propios de Beancount. Este glosario define los términos que encontrarás al leer esta documentación o tu propio archivo de libro mayor, cada uno con un breve ejemplo cuando sea útil. Cada entrada tiene su propio enlace, para que puedas dirigir a un compañero directamente a una definición.

Cuenta​

Una cuenta es un contenedor con nombre que sigue un flujo de valor, escrito como una jerarquía separada por dos puntos bajo uno de cinco tipos raíz: Assets (Activos), Liabilities (Pasivos), Equity (Capital), Income (Ingresos) o Expenses (Gastos). La jerarquía es toda la estructura organizativa de tus libros: Assets:US:BofA:Checking y Expenses:Food:Restaurant se ordenan y agregan automáticamente. Cada cuenta debe declararse antes de usarse. Consulta Sintaxis del lenguaje Beancount para las reglas de nomenclatura.

Base contable de devengo​

La contabilidad de devengo registra los ingresos cuando se ganan y los gastos cuando se incurren, independientemente de cuándo se mueva realmente el efectivo. La contabilidad de caja hace lo contrario: reconoce ambos solo cuando el dinero cambia de manos. El devengo ofrece una imagen más fiel del rendimiento de un período, por lo que una factura que enviaste en marzo pertenece a marzo incluso si el cliente paga en mayo.

Amortización​

La amortización distribuye un pago único grande a lo largo de los períodos que realmente cubre, de modo que cada mes asume su parte justa del costo. Una prima de seguro anual pagada en enero es un gasto de los doce meses, no solo de enero. En Beancount, puedes escribir las divisiones del asiento a mano o generarlas con un complemento; consulta Amortizar.

Aserción de saldo​

Una aserción de saldo es una directiva balance que establece cuál debe ser el saldo de una cuenta al inicio de una fecha determinada, para que tu extracto bancario se convierta en una verificación automática de tus libros. Si el saldo calculado difiere, Beancount falla ruidosamente con los importes esperado y real. Esparcir una aserción por cuenta y por extracto es la forma más barata de mantener un libro mayor confiable.

2026-01-01 balance Assets:US:BofA:Checking   4,321.00 USD

Beancount​

Beancount es un sistema de contabilidad por partida doble de código abierto cuyo libro mayor es un archivo de texto plano que editas en cualquier editor de texto y validas con una herramienta de línea de comandos. Proporciona una sintaxis estricta y analizable, un lenguaje de consulta y una interfaz web, sin base de datos ni formato de archivo propietario. Como el libro mayor es texto, vive felizmente en Git junto a tu código. Empieza con Introducción a Beancount.

Lenguaje de consulta Beancount​

El lenguaje de consulta Beancount, normalmente abreviado BQL, es el lenguaje similar a SQL que usas para hacer preguntas a tu libro mayor. Se ejecuta sobre las directivas analizadas en lugar de una base de datos, por lo que SELECT account, sum(position) WHERE year = 2026 responde inmediatamente desde el mismo archivo que editas. Lee la guía del lenguaje de consulta para la gramática completa.

Método de registro​

Un método de registro es la regla que Beancount aplica cuando una reducción debe elegir qué lotes existentes consumir. Las opciones son STRICT (debes identificar el lote tú mismo), FIFO, LIFO, AVERAGE y NONE, configuradas por cuenta en su directiva open. El método que elijas cambia tus ganancias de capital realizadas, así que elige el que tu jurisdicción fiscal espera y mantenlo estable.

Plan de cuentas​

Un plan de cuentas es la lista completa de cuentas que usa tu libro mayor, junto con la estructura que las organiza. En Beancount no hay un archivo de plan separado: el conjunto de directivas open es tu plan de cuentas. Diseñarlo bien desde el principio ahorra muchas renombraciones posteriores; consulta Configuraciones por sector para puntos de partida.

Directiva de cierre​

Una directiva close marca la fecha a partir de la cual una cuenta ya no puede usarse, lo cual es como retiras una cuenta bancaria o un préstamo liquidado sin eliminar su historial. Las transacciones pasadas siguen siendo válidas y reportables; solo se rechazan los nuevos asientos. Cerrar cuentas en desuso mantiene los informes legibles a medida que el libro mayor envejece.

2026-03-31 close Assets:US:OldBank:Checking

Commodity​

Un commodity es cualquier unidad de valor que tu libro mayor rastrea: una moneda como USD, un ticker de acción como AAPL, un activo cripto como BTC, o algo que inventes como VACATION-DAYS. Beancount nunca convierte entre commodities a tus espaldas, por lo que un importe siempre es un número emparejado con el commodity en el que está denominado. Una directiva opcional commodity te permite adjuntar metadatos como un nombre o una clase de activo.

Base de costo​

La base de costo es lo que realmente pagaste por una tenencia, registrado en la moneda con la que pagaste y arrastrado junto con la tenencia mientras la poseas. Beancount lo escribe entre llaves: 10 AAPL {150.00 USD} significa diez acciones adquiridas a 150 dólares cada una. Como la base viaja con la posición, las ganancias de capital surgen de la aritmética cuando vendes. Consulta Gestión de inventarios.

Directiva​

Una directiva es una instrucción fechada en un archivo de Beancount, y las directivas son todo lo que contiene un libro mayor. Cada línea que comienza con una fecha es una: open, close, balance, price, note, document, pad, event, commodity y la propia transacción. Beancount ordena las directivas por fecha antes de procesarlas, para que puedas mantenerlas en el orden que mejor se lea.

Contabilidad por partida doble​

La contabilidad por partida doble es la práctica de registrar cada evento económico con al menos dos asientos coincidentes, de modo que los importes siempre sumen cero. El dinero nunca se crea ni se destruye, solo se mueve entre cuentas, por lo que la técnica detecta errores que una lista de una sola columna nunca detectaría. Beancount aplica la regla estrictamente: una transacción cuyos asientos no cuadran es un error, no una advertencia.

Presupuesto por sobres​

El presupuesto por sobres aparta dinero para un propósito antes de gastarlo, de modo que cada categoría tiene su propio límite en lugar de competir por un saldo agrupado. El nombre proviene de los sobres de papel que la gente llenaba con efectivo el día de pago. En un libro mayor de texto plano, modelas los sobres con cuentas dedicadas o directivas de presupuesto; consulta Presupuestos.

Fava​

Fava es la interfaz web para Beancount: gráficos, balances de situación, cuentas de resultados, un editor de consultas y un formulario de entrada, servidos desde tu archivo de libro mayor. Es de solo lectura en su mayor parte y se ejecuta localmente, por lo que cambia cómo ves tus libros sin cambiar cómo los registras. beancount.io aloja una versión gestionada junto con sus propias herramientas; la guía Funciones de la interfaz de usuario cubre lo que puedes hacer allí.

Inventario​

Un inventario es la colección de posiciones que una cuenta posee actualmente, cada una con su propio commodity y, cuando corresponde, su propia base de costo y fecha de adquisición. Una cuenta de corretaje que compró la misma acción tres veces tiene tres lotes separados en un inventario, no un número combinado. Mantener los lotes distintos es lo que permite hacer cálculos precisos de ganancias.

Diario​

El diario es la lista cronológica de todo lo que sucedió en tus libros: el flujo bruto de transacciones, en orden de fecha, antes de cualquier agrupación o resumen. Es la vista que escaneas cuando quieres responder "¿qué hice realmente en marzo?". La página del diario de Fava suele ser el lugar más rápido para detectar una entrada mal categorizada.

Libro mayor​

Un libro mayor es el conjunto completo de registros contables para una entidad, que en Beancount significa tu archivo de texto plano (más todo lo que incluya). La palabra sirve tanto como nombre de todo el libro de cuentas como nombre del archivo en sí. Por ser texto, un libro mayor puede compararse, revisarse, bifurcarse y fusionarse como código fuente.

Lote​

Un lote es una adquisición específica de un commodity, identificada por su base de costo y fecha de adquisición. Comprar el mismo ETF en enero y nuevamente en junio crea dos lotes, y vender más tarde implica elegir qué lote estás vendiendo. Los lotes son la razón por la que Beancount puede calcular las ganancias realizadas exactamente en lugar de aproximarlas.

2026-06-15 * "Broker" "Buy VTI"
  Assets:US:Broker:VTI     5 VTI {260.00 USD, 2026-06-15}
  Assets:US:Broker:Cash            -1,300.00 USD

Narración​

La narración es la descripción en texto libre de para qué fue una transacción, escrita como la segunda cadena entre comillas en la línea de la transacción. Es para humanos: "Alquiler mensual", "Comida y artículos del hogar". Beancount no la analiza, pero es lo que leerás cuando la entrada ya no tenga sentido seis meses después.

Directiva de apertura​

Una directiva open declara una cuenta, la fecha a partir de la cual es utilizable y opcionalmente los commodities que puede contener y el método de registro que utiliza. Beancount requiere que cada cuenta se abra antes de su primer asiento, lo que evita que un error tipográfico cree silenciosamente una cuenta nueva. Restringir los commodities permitidos convierte otra clase completa de errores en fallos.

2026-01-01 open Assets:US:Broker:VTI   VTI   "FIFO"

Pad​

Una directiva pad le indica a Beancount que inserte la cantidad necesaria para que la siguiente aserción de saldo en una cuenta tenga éxito, registrando la diferencia en una segunda cuenta. Existe exactamente para un trabajo: abrir un libro mayor a mitad de camino sin reconstruir años de historia. Hacer padding más allá de esa configuración inicial generalmente significa que se está encubriendo un error real.

Beneficiario​

El beneficiario es con quién realizaste la transacción, escrito como la primera cadena entre comillas en una línea de transacción. Mantener los beneficiarios consistentes — siempre "Whole Foods", nunca a veces "WholeFoods" — es lo que hace que los informes basados en beneficiarios y los importadores automatizados funcionen. Beancount trata el beneficiario como opcional; una transacción puede llevar solo una narración.

Contabilidad en texto plano​

La contabilidad en texto plano es la práctica de mantener tus libros en un archivo de texto legible por humanos bajo control de versiones, procesado por herramientas de línea de comandos de código abierto. Intercambia una interfaz de apuntar y hacer clic por durabilidad, auditabilidad y automatización: tus datos sobreviven a cualquier proveedor, cada cambio es un diff revisable y cualquier script puede leerlo. Beancount, Ledger y hledger son las tres implementaciones más conocidas.

Complemento​

Un complemento es un módulo de Python que Beancount carga mientras procesa tu archivo, permitiéndole añadir, transformar o validar directivas antes de que se construyan los informes. Los complementos son cómo se implementan la previsión, los programas de amortización y las comprobaciones personalizadas sin cambiar el lenguaje central. Activas uno con una línea plugin al principio de tu libro mayor; la guía Complemento de previsión recorre un ejemplo real.

Asiento​

Un asiento es una pata de una transacción: una cuenta, un importe y opcionalmente un costo o precio. Una transacción necesita al menos dos asientos, y sus importes deben sumar cero. Como máximo, un asiento puede dejar su importe en blanco, en cuyo caso Beancount calcula la cifra de ajuste por ti.

Directiva de precio​

Una directiva price registra el tipo de cambio entre dos commodities en una fecha, que es cómo Beancourt convierte una tenencia a su valor de mercado en los informes. Los precios son datos de referencia puros: nunca mueven dinero y nunca aparecen en una transacción. Sin ellos, una cartera aún cuadra al costo pero no puede valorarse a mercado.

2026-06-30 price VTI   271.40 USD

Conciliación​

La conciliación es el acto de demostrar que tus libros coinciden con un registro externo, como un extracto bancario o de corretaje. En la contabilidad en texto plano es en gran medida mecánica: añade una aserción de saldo para cada fecha de extracto y deja que la herramienta te diga si los números coinciden. Un libro mayor que se concilia limpiamente cada mes es uno desde el que puedes presentar impuestos sin miedo.

Etiquetas y enlaces​

Las etiquetas y los enlaces son las dos marcas que adjuntas a las transacciones para agruparlas fuera de la jerarquía de cuentas: una etiqueta con # marca un tema como #trip-japan, y un enlace con ^ une entradas relacionadas como ^invoice-2026-014. Las etiquetas responden "muéstrame todo en esta categoría"; los enlaces responden "muéstrame las entradas que pertenecen a este evento". Ambos son filtrables en Fava y consultables en BQL; consulta Filtrado y búsqueda.

Transacción​

Una transacción es un evento económico fechado junto con los asientos que lo registran, y es la directiva que escribirás con más frecuencia. Lleva una bandera (* para confirmada, ! para necesita revisión), un beneficiario opcional, una narración y dos o más asientos cuyos importes suman cero. Todo lo demás en un archivo de Beancount existe para declarar, verificar o anotar transacciones.

2026-02-14 * "Blue Bottle" "Coffee with Dana"
  Expenses:Food:Coffee      9.50 USD
  Assets:US:BofA:Checking  -9.50 USD

¿Aún atascado con una palabra? El Centro de ayuda indexa todas las guías de este sitio, y la Hoja de referencia rápida presenta la sintaxis de cada directiva una al lado de la otra.