Preguntas Frecuentes de Beancount: Preguntas sobre Contabilidad en Texto Plano

Unos cinco conceptos, no un título. Necesitas los cinco tipos de cuentas (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 hace cumplir el resto por ti: se niega a cargar un archivo cuyas transacciones no sumen, por lo que el software detecta los errores que un principiante cometería silenciosamente.

Comienza con la Introducción a Beancount, mantén el Glosario abierto en una pestaña y agrega tus primeras transacciones en la Guía de 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 que llega es positivo, y una transacción es válida cuando sus asientos se cancelan entre sí. Esto es la misma contabilidad de partida doble que hacen los contadores, pero sin el vocabulario que confunde a los principiantes.

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 lugar, y la suma cero convierte ese hecho en una verificación de errores. Si gastas $40 en comestibles, ese dinero salió de una cuenta bancaria: registrar ambas partes significa que las dos deben cancelarse, y cualquier error tipográfico en cualquiera de los montos hace que el archivo no se cargue en lugar de producir silenciosamente un saldo incorrecto.

Por eso un libro de contabilidad en texto plano es más confiable que una hoja de cálculo de gastos: la estructura misma se autocontrola. Una aserción de saldo es el mecanismo relacionado que verifica tu libro contra la realidad.

Registra una transacción en tu fecha de inicio que mueva el saldo actual de cada cuenta desde Equity:Opening-Balances, luego agrega una aserción balance para fijarlo. No necesitas reconstruir tu historial financiero: elige una fecha de inicio, toma los saldos tal como están ese día y continúa desde allí.

La Guía de Inicio Rápido te lleva a través de un ejemplo completo de saldos iniciales.

Empieza con lo general y divide solo cuando una división más fina cambiaría una decisión. Unas veinte cuentas son suficientes para empezar; si te encuentras preguntándote si "Gastos:Comida" debería separar comestibles de restaurantes, la prueba útil es si realmente harías algo diferente al conocer la división.

Renombrar y dividir más tarde es un buscar y reemplazar en un archivo de texto, por lo que el costo de empezar simple es bajo. Los nombres de cuentas se anidan, así que puedes comenzar con una categoría amplia y dividirla en subcuentas más tarde 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 hace cumplir la partida doble, por lo que cada transacción se autocontrola, y el archivo sigue siendo buscable, diferenciable y scriptable mientras existan los archivos de texto. También obtienes historial de versiones real: git log en tu libro muestra exactamente qué cambió, cuándo y por qué.

La diferencia práctica aparece con múltiples cuentas, monedas o inversiones, donde una hoja de cálculo de entrada única 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 es suficiente. La partida doble vale la pena en el momento en que tienes varias cuentas, una hipoteca, una correduría o más de una moneda, porque esas son exactamente las situaciones donde el seguimiento de entrada única 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 más extenso.

No. Fava es una interfaz web completa sobre el mismo archivo de texto: balances generales, estados de resultados, gráficos y entrada de transacciones — y Beancount.io lo ejecuta por ti con tu libro en la nube. El archivo de texto sigue siendo la fuente de verdad, por lo que puedes usar la interfaz web a diario y recurrir a la terminal solo cuando quieras.

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

La mayoría de las personas importan el 80–95% de las transacciones y registran el resto a mano. En orden aproximado de confiabilidad: una descarga OFX/QFX directa de tu banco, una exportación CSV más reglas de importación, una conexión de agregador y — solo como último recurso — un estado de cuenta PDF convertido a CSV. La sincronización bancaria de Beancount.io maneja la conexión y la categorización por ti.

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

Para un archivo puntual, dos convertidores gratuitos en el 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 ofrecen los bancos cuando no ofrecen CSV en absoluto.

Los importadores deduplican contra las entradas ya en tu libro, comparando fecha, monto y beneficiario, y marcan cualquier cosa ambigua para que la confirmes en lugar de adivinar. El flujo de trabajo habitual marca las importaciones inciertas como pendientes para que las revises antes de que formen parte del registro permanente.

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

OFX hace esto más fácil que CSV: cada transacción lleva un FITID que el banco mantiene estable entre descargas, por lo que un importador puede hacer coincidir por identidad en lugar de por inferencia — el convertidor OFX lo conserva como un campo de metadatos id:.

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

Lee los detalles en la página de seguridad.

Agrega una aserción balance con el saldo de cierre y la fecha del estado de cuenta. Beancount se negará a cargar el archivo si tu libro no coincide con el banco, lo que convierte la conciliación de una comparación manual a algo que el software verifica cada vez que se ejecuta.

Una cadencia mensual es suficiente para la mayoría de las personas. Consulta Filtrado y Búsqueda para localizar una discrepancia.

De forma nativa, y esta es una de sus mayores ventajas sobre las aplicaciones de finanzas para consumidores. Cada monto lleva su moneda, las cuentas pueden tener varias a la vez, y las conversiones se registran explícitamente con @ para un precio o {} para un costo, por lo que un cambio en el tipo de cambio nunca reescribe silenciosamente tu historial.

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

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

Beancount admite los métodos de registro STRICT, FIFO, LIFO y NONE. El registro de costo promedio se analiza pero no está completamente implementado — si tu jurisdicción fiscal requiere costo promedio, planifica rastrearlo con un plugin o lotes explícitos. Consulta Gestión de Inventarios.

Exactamente como cualquier otro producto básico: una criptomoneda es una unidad con un costo, por lo que se aplica la misma maquinaria de lotes y registro. Un intercambio de un token por otro es una sola 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 reporte.

Consulta Seguimiento de Carteras de Criptomonedas y las plantillas de criptomonedas listas para usar.

Las empresas sí lo usan, incluidas compañías con cientos de miles de transacciones. Maneja contabilidad de acumulación, estructuras multi-entidad y los informes que un contador espera. 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 de contabilidad, no un ERP.

Consulta Configuraciones Específicas por Industria y el Open Ledger con ejemplos de libros de empresas reales.

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 el estado de resultados del negocio no tenga sentido y dificulta la temporada 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 Multiarchivo.

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 de acumulación, y Beancount la admite directamente. Lo que no tiene es una interfaz de facturación: rastrea 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 Industria para ejemplos trabajados y Entendiendo las Cuentas por Cobrar para los conceptos.

Exporta los informes en lugar del libro. Tu contador casi con certeza no quiere un archivo de texto: quiere un estado de resultados, un balance general 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 Consulta con SQL para extraer exactamente los números que piden.

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 reglas de importación CSV amigables y su documentación; Beancount tiene el analizador más estricto y el mejor soporte para inversiones, lotes y múltiples monedas, además de una API de plugins en Python.

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

No de forma nativa: esta es una brecha genuina, no una característica oculta. El presupuesto integrado de Beancount es limitado, y las personas que quieren un comportamiento estricto de sobres suelen usar un plugin de la comunidad o modelar los sobres como cuentas.

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

Sí. La directiva document vincula un archivo a una cuenta y fecha, y la interfaz web te permite subir y explorar esos documentos junto con las transacciones a las que pertenecen. Los recibos permanecen como archivos ordinarios en el disco, por lo que son tan portátiles 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 brecha que la mayoría de las configuraciones de texto plano dejan abierta.

Para una captura rápida sin aplicación, muchas personas registran una nota aproximada y la concilian en el libro más tarde.

Una década de finanzas personales son unos pocos megabytes y carga en mucho menos de un segundo. Beancount recalcula los saldos a partir del historial completo de transacciones en cada carga, y eso sigue siendo rápido hasta cientos de miles de entradas; más allá de eso, dividir por año con include mantiene las cosas cómodas.

Consulta Soporte Multiarchivo para saber cómo dividir un libro en crecimiento.