Glosario

La contabilidad de texto plano toma vocabulario de la contabilidad de partida doble y añade algunas palabras propias 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 ayuda. Cada entrada tiene su propio enlace, para que puedas señalar a un compañero directamente a una definición.

Cuenta​

Una cuenta es un contenedor con nombre que rastrea un flujo de valor, escrita como una jerarquía separada por dos puntos bajo uno de cinco tipos raíz: Assets, Liabilities, Equity, Income o Expenses. 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. Toda cuenta debe declararse antes de usarse. Consulta Sintaxis del Lenguaje Beancount para las reglas de nomenclatura.

Base devengada​

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

Amortización​

La amortización distribuye un solo pago grande a lo largo de los períodos que realmente cubre, para que cada mes asuma 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, o escribes los asientos divididos a mano o los generas con un plugin — consulta Amortizar.

Verificación de saldo​

Una verificación de saldo es una directiva balance que establece cuál debe ser el saldo de una cuenta al inicio de una fecha determinada, de modo que tu extracto bancario se convierta en una comprobación automática de tus libros. Si el saldo calculado difiere en más que la tolerancia de la verificación, Beancount falla de forma notoria con los montos esperado y real. Esa tolerancia es una unidad del último decimal que escribiste — 4.27 RGAGX acepta cualquier valor entre 4.26 y 4.28 — y un ~ antes de la moneda establece la tuya propia. Esparcir una verificación por cuenta y por extracto es la forma más económica 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 de 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. Te ofrece una sintaxis estricta y analizable, un lenguaje de consultas 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 Consultas de Beancount​

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

Método de registro​

Un método de registro es la regla que Beancount aplica cuando una reducción tiene que elegir qué lotes existentes retirar. Beancount 3.2.3 acepta siete nombres: STRICT (el predeterminado, donde tú identificas el lote), STRICT_WITH_SIZE, NONE, FIFO, LIFO, HIFO y AVERAGE. Establece uno por cuenta en su directiva open, o para todo el archivo con option "booking_method". Seis de los siete están implementados: AVERAGE se analiza, pero lanza AVERAGE method is not supported en el momento que tiene que registrar una reducción. El método que elijas cambia tus ganancias de capital realizadas, así que elige el que tu jurisdicción fiscal espera y mantenlo estable. Gestión de Existencias ejecuta los siete sobre los mismos lotes y publica el libro mayor que falla bajo AVERAGE.

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 al principio ahorra muchos renombramientos después; consulta Configuraciones por Industria para puntos de partida.

Directiva de cierre​

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

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

Commodity​

Una 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 inventas como VACATION-DAYS. Beancount nunca convierte entre commodities a tus espaldas, así que un monto siempre es un número emparejado con la commodity en la 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, registrada en la moneda con la que pagaste y llevada junto a la tenencia mientras la posees. Beancount la escribe entre llaves — 10 AAPL {150.00 USD} significa diez acciones adquiridas a 150 dólares cada una. Dobla las llaves y el número se convierte en el total en lugar del precio unitario, así que 10 AAPL {{1,500.00 USD}} registra el mismo lote. Como la base viaja con la posición, las ganancias de capital salen de la aritmética cuando vendes. Consulta Gestión de Existencias.

Directiva​

Una directiva es una instrucción en un archivo de Beancount, usualmente con fecha, y las directivas son de lo que está hecho un libro mayor. Doce tipos llevan fecha: open, close, balance, price, note, document, pad, event, commodity, custom, query, y la transacción misma. Algunas no llevan ninguna y actúan sobre el archivo en lugar de sobre un día — option, include, plugin, y el par pushtag/poptag. Beancount ordena las fechadas por fecha antes de procesar, así que puedes mantenerlas en el orden que mejor se lea; una sin fecha tiene efecto donde está escrita.

Contabilidad de partida doble​

La contabilidad de partida doble es la práctica de registrar cada evento económico como al menos dos asientos coincidentes, de modo que sus pesos siempre sumen cero. El dinero nunca se crea ni se destruye: solo se mueve entre cuentas, que es por lo que la técnica detecta errores que una lista de una sola columna jamás haría. Un peso es el monto propio de un asiento, o su costo o precio convertido de vuelta a una moneda, así que dos lados en commodities diferentes todavía se cancelan. Beancount aplica la regla estrictamente: una transacción cuyos asientos no equilibran es un error, no una advertencia.

2026-03-02 * "Bank" "Buy euros"
  Assets:US:BofA:EUR       100.00 EUR @ 1.08 USD
  Assets:US:BofA:Checking -108.00 USD

Presupuesto de sobres​

El presupuesto de 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 viene 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, estados de ingresos, un editor de consultas y un formulario de entrada, servidos desde tu archivo de libro mayor. Es principalmente de lectura y se ejecuta localmente, así que cambia cómo ves tus libros sin cambiar cómo los registras. beancount.io aloja una versión gestionada junto con su propio conjunto de herramientas; la guía Características de la Interfaz de Usuario cubre lo que puedes hacer allí.

Existencias​

Las existencias son la colección de posiciones que una cuenta posee actualmente, cada una con su propia commodity y, donde sea relevante, su propia base de costo y fecha de adquisición. Una cuenta de corretaje que compró la misma acción tres veces posee tres lotes separados en un solo inventario, no un número mezclado. Mantener los lotes distintos es lo que hace posibles los cálculos precisos de ganancias.

Diario​

El diario es la lista cronológica de todo lo que ocurrió 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 de diario de Fava suele ser el lugar más rápido para detectar una entrada mal clasificada.

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 cualquier cosa que incluya). La palabra sirve también como el nombre de todo el libro de cuentas y el nombre del archivo mismo. Como es texto, un libro mayor puede ser comparado, revisado, ramificado y fusionado como código fuente.

Lote​

Un lote es una adquisición específica de una commodity, identificada por su base de costo y fecha de adquisición. Comprar el mismo ETF en enero y otra vez en junio crea dos lotes, y al vender significa elegir qué lote estás vendiendo. Los lotes son la razón por la que Beancount puede calcular 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 transacción. Es para humanos: "Alquiler mensual", "Compras y 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 desde la que puede usarse, y opcionalmente las commodities que puede mantener y el método de registro que usa. Beancount exige que toda cuenta se abra antes de su primer asiento, que es lo que detiene que un error tipográfico cree silenciosamente una cuenta nueva. Restringir las commodities permitidas convierte otra clase entera de errores en errores.

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

Pad​

Una directiva pad le dice a Beancount que inserte el monto que sea necesario para hacer que la siguiente verificació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 historial. Acolchar más allá de esa configuración inicial normalmente significa que se está ocultando un error real.

Beneficiario​

El beneficiario es con quién transaccionaste, 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 funcionar los informes por beneficiario y los importadores automáticos. Beancount trata al beneficiario como opcional; una transacción puede llevar solo una narración.

Contabilidad de texto plano​

La contabilidad de 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 código abierto en línea de comandos. Cambia 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 leerlos. Beancount, Ledger y hledger son las tres implementaciones más conocidas.

Plugin​

Un plugin 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 plugins son cómo se implementan la previsión, los calendarios de amortización y las comprobaciones personalizadas sin cambiar el lenguaje núcleo. Habilita uno con una línea plugin independiente en la parte superior de tu libro mayor, nunca con una option — option "plugin" "…" se rechaza con Option 'plugin' may not be set. La guía Plugin de Previsión recorre un ejemplo real.

Asiento​

Un asiento es una pata de una transacción: una cuenta, un monto, y opcionalmente un costo o precio. Lo que tiene que sumar cero en una transacción no son los montos brutos sino sus pesos: un monto simple se pesa a sí mismo, 10 FUND @ 38.46 USD pesa 384.60 USD, y 10 FUND {384.61 USD} pesa 3,846.10 USD, porque las llaves simples contienen el costo de una unidad. Como máximo un asiento puede dejar su monto en blanco, en cuyo caso Beancount calcula la cifra de equilibrio por ti. Consulta Precisión & Tolerancias para las reglas completas de peso.

Directiva de precio​

Una directiva price registra el tipo de cambio entre dos commodities en una fecha, que es como Beancount convierte una tenencia a su valor de mercado en los informes. Una directiva price es puramente datos de referencia: no mueve dinero y no pertenece a ninguna transacción. No la confundas con el precio @ escrito dentro de un asiento, que es aritmético — da a 10 FUND @ 38.46 USD un peso de 384.60 USD y así decide si la transacción equilibra. Sin directivas de precio, una cartera todavía equilibra 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 probar que tus libros coinciden con un registro externo como un extracto bancario o de corretaje. En contabilidad de texto plano es en gran medida mecánica: añade una verificación de saldo para cada fecha de extracto y deja que la herramienta te diga si los números coinciden. Un libro 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 con fecha junto con los asientos que lo registran, y es la directiva que escribirás más a menudo. Lleva una bandera (* para confirmado, ! para necesita revisión), un beneficiario opcional, una narración, y dos o más asientos cuyos pesos sumen cero. Todo lo demás en un archivo de Beancount existe para declarar, comprobar o anotar transacciones.

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

¿Sigue atascado en una palabra? El Centro de Ayuda indexa cada guía de este sitio, y la Hoja de Referencia pone la sintaxis de cada directiva lado a lado.