Contabilidad en Texto Plano con Beancount y Python: Auditoría Inmutable para PYMEs

January 5, 2026 (10mo ago)

Los sistemas tradicionales de contabilidad en hojas de cálculo o bases de datos opacas sufren de un problema estructural: es trivial alterar un registro pasado sin dejar rastro claro de auditoría. Para resolver esto en pequeñas y medianas empresas, la metodología de Plain Text Accounting (PTA) propone registrar cada transacción como texto plano bajo el principio inmutable de la partida doble.

En PYME-Ledger Pro, diseñamos un motor que conecta el punto de venta (POS) y las facturas de venta con el motor de contabilidad en texto plano Beancount, permitiendo auditoría formal bajo el Plan Contable General Empresarial (PCGE) peruano.

1. ¿Por Qué Beancount y Texto Plano?

  • Control de Versiones con Git: Cada asiento contable puede rastrearse con git diff, git log y firmas criptográficas.
  • Inmutabilidad de la Partida Doble: Beancount rechaza cualquier transacción cuyos débitos y créditos no sumen exactamente cero.
  • Visualización Inmediata con Fava: Una interfaz web moderna que genera balances generales, estados de resultados y flujos de caja en tiempo real.

2. Generación Automatizada de Asientos con Python

Cada vez que un cliente realiza una compra en el POS, el servicio en Python genera un asiento estructurado:

from datetime import date
from decimal import Decimal
 
def generate_sale_entry(
    sale_id: str,
    customer: str,
    amount_subtotal: Decimal,
    amount_igv: Decimal,
    total: Decimal
) -> str:
    """
    Genera un asiento de venta en formato Beancount bajo nomenclatura PCGE.
    """
    today = date.today().isoformat()
    return f"""
{today} * "Venta Comercial" "Boleta {sale_id} - {customer}"
  Assets:PE:BCP:CuentaCorriente          {total:.2f} PEN
  Liabilities:PE:SUNAT:IGVPorPagar     -{amount_igv:.2f} PEN
  Income:PE:VentasMercaderias          -{amount_subtotal:.2f} PEN
"""

Al validar con el CLI de Beancount:

bean-check ledger.beancount

El validador garantiza que Assets + Liabilities + Income == 0. Cualquier descuadre de un solo centavo arroja un error inmediato antes de consolidar el ejercicio contable.

3. Despliegue en Contenedores Docker

El ecosistema se distribuye mediante Docker Compose, aislando la aplicación web de gestión del visualizador contable Fava:

version: '3.8'
 
services:
  app:
    build: .
    ports:
      - "8000:8000"
    volumes:
      - ./data:/app/data
    environment:
      - LEDGER_FILE=/app/data/main.beancount
 
  fava:
    image: yegor256/fava
    ports:
      - "5000:5000"
    volumes:
      - ./data:/data
    command: fava -H 0.0.0.0 -p 5000 /data/main.beancount

Conclusión

El paradigma de contabilidad en texto plano demuestra que la simplicidad del texto plano combinada con la disciplina de la ingeniería de software ofrece una transparencia y auditabilidad superiores a soluciones comerciales cerradas. PYME-Ledger Pro es un ejemplo práctico de cómo llevar innovación de software al sector empresarial.