Preguntas Frecuentes de Beancount: Contabilidad en Texto Plano

Aproximadamente cinco conceptos, no es un título. Necesitas los cinco tipos de cuentas (activos, pasivos, patrimonio, ingresos, gastos), la regla de que cada transacción mueve valor entre al menos dos de ellas, y la regla de que una transacción debe cuadrar. Beancount aplica el resto por ti: marca cualquier transacción cuyos números no cuadren como un error en lugar de aceptarlos silenciosamente, por lo que el software detecta los errores que un principiante pasaría por alto.

Comienza con la Introducción a Beancount, mantén el Glosario abierto en una pestaña, y añade 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 dinero que entra es positivo, y una transacción es válida cuando sus asientos se cancelan mutuamente. Esto es la misma contabilidad por partida doble que hacen los contadores, con un vocabulario que elimina la confusión para los novatos.

Si has utilizado software de contabilidad tradicional, la traducción es: un débito es un número positivo y un crédito es un número negativo. Consulta la Sintaxis del Lenguaje para saber cómo se escriben los asientos, o Débitos y Créditos Explicados para conocer los antecedentes contables en inglés sencillo.

Porque el dinero siempre proviene de algún lugar, y la regla de la suma cero es lo que convierte ese hecho en una verificación de errores. Si gastas $40 en comestibles, ese dinero sale de una cuenta bancaria: registrar ambas mitades significa que los dos lados deben cancelarse mutuamente, y cualquier error de mecanografía en cualquier cantidad se señala como un error en lugar de producir silenciosamente un saldo incorrecto.

Esta es la razón por la que un libro mayor en texto plano es más confiable que una hoja de cálculo: la estructura misma se autocontrola. Una verificación de saldo es el mecanismo relacionado que comprueba tu libro mayor contra la realidad.

Registra una transacción en tu fecha de inicio que mueva el saldo actual de cada cuenta desde Patrimonio:Saldos-Iniciales, y luego añade una verificación de saldo para fijarlo. No necesitas reconstruir tu historial financiero: elige una fecha de inicio, toma los saldos tal como están en ese día, y sigue adelante desde ahí.

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

Empieza con un nivel general y divide solo cuando una división más fina cambiaría una decisión. Veinte cuentas aproximadamente es suficiente para empezar; si te encuentras preguntándote si "Gastos:Comida" debería separar los comestibles de los restaurantes, la prueba útil es si realmente harías algo diferente sabiendo esa distinción.

Renombrar y dividir es fácil: es una operación de buscar y reemplazar en un archivo de texto, por lo que el costo de empezar con un nivel general es bajo. Divide las cuentas cuando lo necesites, no por adelantado. Para obtener una guía sobre cómo diseñar una estructura de cuentas, consulta Cómo Diseñar un Plan de Cuentas.

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

La diferencia práctica se hace evidente cuando tienes múltiples cuentas, monedas o inversiones, donde una hoja de cálculo de una sola entrada se desvía silenciosamente de la realidad. Consulta Contabilidad Transparente y Auditable.

Si solo quieres saber en qué gastaste tu café, no: una hoja de cálculo es suficiente. La partida doble cobra sentido cuando tienes varias cuentas, una hipoteca, un corretaje o más de una moneda, que es exactamente cuando las herramientas de una sola entrada pierden el control sin que te des cuenta.

Una forma útil de pensarlo: la partida doble es una suma de verificación para tus finanzas. Consulta la Introducción para conocer los detalles.

No. Fava es una interfaz web completa sobre el mismo archivo de texto: saldos, estados de resultados, gráficos y entrada de transacciones, y Beancount.io lo ejecuta por ti en la nube. El archivo de texto sigue siendo la fuente de la verdad, por lo que puedes usar la interfaz web para el día a día y recurrir a la línea de comandos solo cuando lo necesites. Si prefieres la terminal, la línea de comandos bea crea, verifica y genera informes sobre ese mismo archivo; consulta la guía rápida de CLI.

Consulta las Características de la Interfaz de Usuario para conocer lo que la interfaz puede hacer, o prueba la demostración en vivo.

La mayoría de las personas importan el 80–95% de las transacciones y registran el resto manualmente. En orden aproximado de confiabilidad: una descarga OFX/QFX directa de tu banco, un archivo CSV con reglas de importación, y — solo como último recurso — un estado de cuenta en PDF convertido a CSV. Beancount.io sincroniza el banco y categoriza automáticamente por ti.

Espera ajustar o escribir un modelo de reglas por institución: las exportaciones CSV de los bancos son notoriamente inconsistentes, y un nombre de comercio que contiene una coma sin escapar es un problema real y común. Consulta Importación Inteligente para conocer el camino automatizado.

Para una importación única, los conversores gratuitos en la web hacen el trabajo mecánico sin subir nada: CSV a Beancount para exportaciones de hojas de cálculo, y OFX y QIF a Beancount para los formatos .ofx, .qfx, .qbo y .qif que ofrecen los bancos cuando no ofrecen CSV en absoluto.

Los importadores deduplican las entradas comparándolas con las que ya están en tu libro mayor, utilizando fecha, importe y beneficiario, y marcan las importaciones no confirmadas como pendientes para que las revises antes de que pasen a formar parte del registro permanente.

Hacer coincidir por identidad es mejor que hacer coincidir por importe: los estados de cuenta OFX incluyen un FITID que el banco mantiene estable entre descargas, por lo que un importador puede coincidir por identidad en lugar de por inferencia. El conversor OFX a Beancount lo conserva como un metadato id:.

No, y para muchas personas esta es la razón principal para usar contabilidad en texto plano. 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 utiliza un agregador autorizado por el banco en lugar de almacenar tu contraseña de banca en línea.

Lee los detalles en la página de seguridad.

Añade una verificación de saldo para la cifra de cierre del estado de cuenta, fechada el día posterior a la fecha de cierre. Las verificaciones de saldo se evalúan al inicio de su fecha, por lo que la verificación de la mañana siguiente incluye todas las transacciones hasta el último día del estado de cuenta. Si tu libro mayor no coincide con el banco, bea check informa un error Saldo fallido y sale con un 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 frecuencia 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 ventajas más fuertes sobre las aplicaciones de finanzas personales. Cada importe 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, de modo que un cambio en el tipo de cambio nunca reescribe tu historial silenciosamente.

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 en Moneda Extranjera para conocer el aspecto contable.

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

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

Exactamente igual que cualquier otro producto básico: una criptomoneda es una unidad con un costo, por lo que se aplican las mismas reglas de lote y registro. Un intercambio de un token por otro es una transacción que reduce un lote y abre otro, que es también como se obtiene la ganancia realizada que la mayoría de las autoridades fiscales requieren que se declare.

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

Las empresas lo utilizan, incluidas aquellas con cientos de miles de transacciones. Beancount maneja la contabilidad de devengo, las estructuras de múltiples entidades y los informes que un contador espera. Los límites honestos son que no hay edición concurrente multiusuario, ni facturación integrada en la interfaz de usuario, ni flujo de trabajo de aprobación de cuentas por pagar: es un libro mayor, no un ERP.

Consulta Configuraciones Específicas por Industria y el Libro Mayor Abierto para ver ejemplos reales de libros de empresas.

Mantenlos separados, ya sea como estructuras de cuentas de nivel superior distintas 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 declaración de impuestos, y separarlos no cuesta nada por adelantado.

Dos archivos suele ser la opción más limpia cuando el negocio tiene su propia cuenta bancaria. Consulta Soporte para Múltiples Archivos.

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 devengo, y Beancount lo admite directamente. Lo que no tiene es una interfaz de facturación: realiza un seguimiento de lo que te deben, pero no genera ni envía la factura.

Consulta Plantillas de Informes Financieros para el aspecto de los informes, Configuraciones Específicas por Industria para ver ejemplos prácticos, y Comprensión de las Cuentas por Cobrar para conocer los conceptos.

Exporta los informes en lugar del archivo de texto. Tu contador casi con seguridad no quiere un archivo de texto: quiere un estado de resultados, un balance general y una lista de transacciones, que puedes generar como CSV o PDF desde la interfaz web o mediante una consulta.

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

Los tres son sistemas de contabilidad por 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 fáciles de usar y su documentación; Beancount tiene el analizador más estricto y el soporte más sólido para inversiones, lotes y múltiples monedas, además de una API de plugins en Python.

Lo estricto es el verdadero trade-off: Beancount se niega a cargar un archivo que encuentra ambiguo, lo que detecta errores tempranamente a costa de ser más exigente. Consulta Beancount vs Ledger CLI y Beancount vs hledger.

No de forma nativa: esta es una brecha real en lugar de una característica oculta. La funcionalidad de presupuesto integrada de Beancount es limitada, y las personas que desean un comportamiento estricto de sobres suelen utilizar un plugin de la comunidad o modelar los sobres como cuentas.

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

Sí. La directiva documento vincula un archivo a una cuenta y una fecha, y la interfaz web te permite subir y navegar por esos documentos junto con las transacciones a las que pertenecen. Los recibos permanecen como archivos normales en el disco, por lo que son tan portátiles como el propio libro mayor.

Consulta Características de la Interfaz de Usuario.

Sí: Beancount.io publica iOS y Android para ver tu libro mayor y capturar transacciones sobre la marcha, que es el vacío que la mayoría de las configuraciones de texto plano dejan abierto.

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

Una década de finanzas personales ocupa unos pocos megabytes y se carga en mucho menos de un segundo. Beancount recalcula los saldos a partir del historial completo de transacciones en cada carga, y eso se mantiene rápido hasta cientos de miles de entradas. 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 los archivos individuales pequeños, pero los archivos incluidos siguen formando un libro mayor combinado que Beancount carga y recalcula en su totalidad, por lo que es una conveniencia organizativa más que una aceleración o una forma de mantener libros separados.

Consulta Soporte para Múltiples Archivos para saber cómo dividir un libro mayor en crecimiento.