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 logy 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.beancountEl 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.beancountConclusió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.