Preguntas Frecuentes de Beancount: Contabilidad en Texto Plano

Unos cinco conceptos, no una carrera. Necesitas los cinco tipos de cuenta (activos, pasivos, patrimonio, ingresos, gastos), la idea de que cada transacción mueve valor entre al menos dos de ellos, y la regla de que una transacción debe cuadrar. Beancount aplica el resto por ti — marca cualquier transacción cuyos números no sumen como un error en lugar de aceptarla en silencio, así que el software detecta los errores que un principiante pasaría por alto.

Empieza con la Introducción a Beancount, mantén el Glosario abierto en una pestaña, y añade tus primeras transacciones en el Inicio Rápido.

Beancount no usa las palabras "débito" y "crédito" en absoluto — usa números con signo que deben sumar cero. El dinero que sale de una cuenta es negativo, el dinero que entra es positivo, y una transacción es válida cuando sus asientos se cancelan. Esta es la misma contabilidad por partida doble que hacen los contables, con el vocabulario que confunde a los recién llegados eliminado.

Si has usado software de contabilidad tradicional, la traducción es: un débito es un número positivo y un crédito es uno negativo. Consulta la referencia de Sintaxis del Lenguaje para ver cómo se escriben los asientos, o Débitos y Créditos Explicados para los fundamentos contables en lenguaje sencillo.

Porque el dinero siempre viene de algún sitio, y la suma cero es lo que convierte ese hecho en una comprobación de errores. Si gastas $40 en la compra, ese dinero salió de una cuenta bancaria — registrar ambas mitades significa que las dos deben cancelarse, y cualquier errata en cualquiera de los importes se marca como error en lugar de producir silenciosamente un saldo incorrecto.

Por esto un libro en texto plano es más fiable que una hoja de cálculo de gastos: la estructura misma se autocontrola. Una aserción de saldo es el mecanismo relacionado que contrasta tu libro con la realidad.

Registra una transacción en tu fecha de inicio que mueva el saldo actual de cada cuenta desde Equity:Opening-Balances, luego añade una aserción balance para dejarlo fijado. No necesitas reconstruir tu historial financiero — elige una fecha de inicio, toma los saldos tal como están ese día, y avanza desde ahí.

El Inicio Rápido recorre un ejemplo completo de saldos iniciales.

Empieza de forma general y divide solo cuando una división más fina cambiaría una decisión. Veinte cuentas más o menos son suficientes para empezar; si te encuentras preguntándote si "Expenses:Food" debería separar la compra del restaurante, la prueba útil es si realmente harías algo diferente sabiendo la división.

Renombrar y dividir más tarde es un buscar-y-reemplazar en un archivo de texto, así que el coste de empezar simple es bajo. Los nombres de cuenta se anidan, así que puedes empezar con una categoría amplia y dividirla en subcuentas después sin reescribir el historial — consulta Cómo Diseñar un Plan de Cuentas si quieres una estructura que copiar.

Una hoja de cálculo no puede decirte cuándo está mal. La contabilidad en texto plano aplica la partida doble, así que cada transacción se autocontrola, y el archivo permanece grepeable, diferenciable y scriptable mientras existan los archivos de texto. También obtienes un historial de versiones real: git log en tu libro muestra exactamente qué cambió, cuándo y por qué.

La diferencia práctica se manifiesta con múltiples cuentas, divisas o inversiones, donde una hoja de cálculo de partida simple se desvía silenciosamente de la realidad. Consulta Contabilidad Transparente y Auditable.

Si solo quieres saber cuánto gastaste en café, sí — una hoja de cálculo basta. La partida doble se justifica en el momento en que tienes varias cuentas, una hipoteca, una cuenta de valores o más de una divisa, porque esas son exactamente las situaciones donde el seguimiento de partida simple pierde dinero sin avisarte.

Una forma útil de pensarlo: la partida doble es una suma de verificación para tus finanzas. Consulta la Introducción para el argumento extendido.

No. Fava es una interfaz web completa sobre el mismo archivo de texto — balances, cuentas de resultados, gráficos y entrada de transacciones — y Beancount.io la ejecuta por ti con tu libro en la nube. El archivo de texto sigue siendo la fuente de verdad, así que puedes usar la interfaz web a diario y bajar a una terminal solo cuando quieras. Si prefieres una terminal, el comando de línea bea crea, verifica y genera informes sobre ese mismo archivo — consulta el inicio rápido de la CLI.

Consulta Funciones de la Interfaz para ver qué puede hacer la interfaz, o prueba la demo en vivo.

La mayoría de la gente importa el 80–95% de las transacciones y teclea el resto a mano. En orden aproximado de fiabilidad: una descarga directa OFX/QFX de tu banco, una exportación CSV más reglas de importación, una conexión con un agregador, y — solo como último recurso — un extracto PDF convertido a CSV. La sincronización bancaria de Beancount.io se encarga de la conexión y la categorización por ti.

Cuenta con escribir o ajustar una regla por institución: las exportaciones CSV de los bancos son notoriamente inconsistentes, y un nombre de comercio que contenga una coma sin escapar es un problema real y común. Consulta Importación Inteligente para la vía automatizada.

Para un archivo puntual, dos conversores gratuitos de navegador hacen la parte mecánica sin subir nada: CSV a Beancount para exportaciones de hojas de cálculo, y OFX y QIF a Beancount para las descargas .ofx, .qfx, .qbo y .qif que los bancos ofrecen cuando no ofrecen ningún CSV.

Los importadores deduplican contra los asientos ya presentes en tu libro, comparando por fecha, importe y beneficiario, y señalan cualquier ambigüedad para que la confirmes en lugar de adivinar. El flujo de trabajo habitual marca las importaciones dudosas como pendientes para que las revises antes de que formen parte del registro permanente.

OFX lo hace más fácil que CSV: cada transacción lleva un FITID que el banco mantiene estable entre descargas, así que un importador puede comparar por identidad en lugar de por inferencia — el conversor OFX lo preserva como un campo de metadatos id:.

La otra mitad de la respuesta son las transferencias: el dinero que se mueve entre dos cuentas tuyas aparece en las exportaciones de ambos bancos. Regístralo una vez como una única transacción con dos asientos.

No — y para muchas personas esta es la razón de usar contabilidad en texto plano. Puedes exportar OFX o CSV de tu banco tú mismo y nunca entregar credenciales a un agregador. Si prefieres la sincronización automatizada, Beancount.io usa un agregador autorizado por el banco en lugar de almacenar tu contraseña de banca online.

Lee los detalles en la página de seguridad.

Añade una aserción balance con la cifra de cierre del extracto, fechada el día posterior a la fecha de cierre. Las aserciones de saldo se evalúan al inicio de su fecha, así que la aserción de la mañana siguiente es la que incluye todas las transacciones hasta el último día del extracto. Si tu libro no coincide con el banco, bea check reporta un error Balance failed y termina con código distinto de cero, lo que convierte la conciliación de una comparación manual en algo que el software verifica cada vez que se ejecuta.

Una periodicidad mensual es suficiente para la mayoría. Consulta Filtrado y Búsqueda para localizar una discrepancia.

De forma nativa, y esta es una de sus mayores ventajas sobre las aplicaciones financieras de consumo. Cada importe lleva su divisa, las cuentas pueden contener varias a la vez, y las conversiones se registran explícitamente con @ para un precio o {} para un coste, así que un cambio en el tipo de cambio nunca reescribe tu historial en silencio.

Nada se convierte a tus espaldas — siempre ves tanto la divisa original como el valor convertido. Consulta Sintaxis del Lenguaje, Precisión y Tolerancias, y Contabilidad Multidivisa para el lado contable.

Usa Precios en Vivo para los activos compatibles en un libro alojado en Beancount.io, o descarga cotizaciones a archivos de precios locales para Beancount y Fava originales. El selector te permite elegir una divisa de cotización y copiar los includes gestionados. Las versiones compatibles de bea también admiten includes gestionados; la guía de configuración enlaza a sus instrucciones.

Los precios gestionados afectan a la valoración de mercado, no a los importes de las transacciones ni a la base de coste. Tu propio precio tiene prioridad para la misma fecha y par. Las actualizaciones pueden usar precios en caché obsoletos durante una interrupción, y una cotización posterior no puede rellenar una fecha de valoración histórica faltante.

Registra las compras con un coste entre llaves — 10 AAPL {150.00 USD} — y Beancount hace seguimiento de cada lote por separado. Cuando vendes, indicas qué lote estás reduciendo, y la plusvalía de capital sale de la aritmética automáticamente en lugar de ser algo que calculas a mano.

Beancount admite los métodos de asignación STRICT, FIFO, LIFO y NONE. La asignación por coste medio se analiza pero no está totalmente implementada — si tu jurisdicción fiscal exige el coste medio, planea hacerle seguimiento con un plugin o lotes explícitos. Consulta Gestión de Inventario.

Exactamente igual que cualquier otra mercancía: una criptomoneda es una unidad con un coste, así que se aplica la misma maquinaria de lotes y asignación. Un intercambio de un token por otro es una única transacción que reduce un lote y abre otro, que es también cómo obtienes la ganancia realizada que la mayoría de las autoridades fiscales quieren que se declare.

Consulta Seguimiento de Carteras de Criptomonedas y las plantillas de cripto ya preparadas.

Las empresas lo usan, incluidas compañías con cientos de miles de transacciones. Maneja la contabilidad por devengo, estructuras multi-entidad, y los informes que espera un contable. Los límites honestos son que no hay edición concurrente multiusuario, no hay interfaz de facturación integrada, y no hay flujo de aprobación de cuentas por pagar — es un libro, no un ERP.

Consulta Configuraciones Específicas por Sector y el Libro Abierto que muestra libros reales de empresas.

Mantenlos separados — ya sea como árboles de cuentas de nivel superior distintos en un archivo o como dos archivos combinados con include. Mezclarlos hace que la cuenta de resultados del negocio pierda sentido y dificulta la declaración de impuestos, y separarlos no cuesta nada por adelantado.

Dos archivos suele ser la opción más limpia una vez que el negocio tiene su propia cuenta bancaria. Consulta Soporte Multi-Archivo.

Modela las cuentas por cobrar como una cuenta de activo y las cuentas por pagar como un pasivo, luego registra la factura cuando la emites y el pago cuando llega — eso es contabilidad por devengo, y Beancount la admite directamente. Lo que no tiene es una interfaz de facturación: hace seguimiento de lo que te deben, no genera ni envía la factura.

Consulta Plantillas de Informes Financieros para el lado de los informes, Configuraciones Específicas por Sector para ejemplos resueltos, y Entender las Cuentas por Cobrar para los conceptos.

Exporta los informes en lugar del libro. Tu contable casi con seguridad no quiere un archivo de texto — quiere una cuenta de resultados, un balance y una lista de transacciones, que puedes producir como CSV o PDF desde la interfaz web o con una consulta.

Consulta las Guías de Preparación de Impuestos, Plantillas de Informes Financieros, y Consultas con SQL para extraer exactamente los números que te pidan.

Los tres son sistemas de partida doble en texto plano con formatos de archivo similares. Ledger es el original y el analizador más permisivo; hledger es una reimplementación en Haskell conocida por sus amigables reglas de importación CSV y su documentación; Beancount tiene el analizador más estricto y el mejor soporte para inversiones, lotes y múltiples divisas, además de una API de plugins en Python.

La estrictez es el verdadero compromiso: Beancount se niega a cargar un archivo que considera ambiguo, lo que detecta errores pronto a costa de ser más exigente. Consulta Beancount vs Ledger CLI y Beancount vs hledger.

No de forma nativa — esta es una carencia real y no una función oculta. El presupuesto integrado de Beancount es limitado, y quienes quieren un comportamiento estricto de sobres normalmente usan un plugin de la comunidad o modelan los sobres como cuentas.

Si el presupuesto por sobres es lo principal que quieres, lee Beancount vs YNAB antes de cambiar. Para lo que sí funciona hoy, consulta Presupuestos en Beancount.

Sí. La directiva document vincula un archivo a una cuenta y fecha, y la interfaz web te permite subir y navegar esos documentos junto a las transacciones a las que pertenecen. Los recibos permanecen como archivos ordinarios en el disco, así que son tan portables como el propio libro.

Consulta Funciones de la Interfaz.

Sí — Beancount.io publica aplicaciones para iOS y Android para ver tu libro y capturar transacciones sobre la marcha, que es la carencia que la mayoría de las configuraciones en texto plano dejan abierta.

Para captura rápida sin una aplicación, mucha gente anota una nota aproximada y la concilia en el libro después.

Una década de finanzas personales son unos pocos megabytes y se carga en bastante menos de un segundo. Beancount recalcula los saldos desde el historial completo de transacciones en cada carga, y eso se mantiene rápido hasta cientos de miles de asientos. Más allá de eso, el límite es la comodidad de edición y comparación, no el tiempo de carga: dividir por año con include mantiene pequeños los archivos individuales, pero los archivos incluidos siguen formando un único libro combinado que Beancount carga y recalcula por completo, así que es una conveniencia de organización de archivos más que una aceleración o una forma de mantener libros separados.

Consulta Soporte Multi-Archivo para saber cómo dividir un libro que crece.