Plantillas de asientos

Una plantilla de asiento es una estructura prearmada con cuentas y fórmulas que generás una vez y aplicás cada vez que necesitás repetir el mismo patrón. Las fórmulas usan variables (por ejemplo {{monto}}) que el sistema reemplaza al aplicarse, y el evaluador es un parser matemático tightly-scoped - no se ejecuta eval().

Tiempo de lectura: ~6 min

Cuándo usar esto

• Pasás un mismo asiento todos los meses (alquiler, servicios, prorrateos).
• Necesitás una mecánica de cálculo automática (ITBIS al 18%, retenciones, prorrateos por porcentaje).
• Querés estandarizar cómo tu equipo registra ciertos eventos para evitar errores de cuenta.
• Tu contador definió una tabla de asientos modelo que querés digitalizar.

Antes de empezar

• El módulo Contabilidad está activo y tu rol incluye permiso accounting:journal-entry-template.
• Tenés cargado el Plan de cuentas con las cuentas que vas a referenciar.
• Sabés qué variables va a tomar la plantilla y qué fórmulas aplicar a cada línea.

Cómo funciona el modelo

Una plantilla (JournalEntryTemplate) tiene una cabecera y una colección de líneas (JournalEntryTemplateLine). Cada línea apunta a una cuenta y declara una de dos fórmulas:

• debitFormula: expresión matemática que produce el débito.
• creditFormula: expresión matemática que produce el crédito.

Solo se llena una de las dos por línea (XOR). Las fórmulas pueden incluir:

• Constantes numéricas (1500, 0.18).
• Variables entre llaves dobles: {{monto}}, {{base}}, {{tasa}}.
• Operadores aritméticos: +, -, *, /, paréntesis.

Ejemplos:

• {{monto}} - usa la variable directa.
• {{monto}} * 0.18 - calcula ITBIS al 18%.
• {{base}} * {{tasa}} / 100 - porcentaje configurable.

Paso a paso - crear una plantilla

1. Andá a Contabilidad → Plantillas y pulsá Nueva plantilla.
2. En la cabecera completá:
   • Nombre obligatorio (máx. 150 caracteres). Aparece en el selector al aplicar.
   • Descripción opcional.
   • Activa - desactiva si la querés ocultar sin perder la definición.
3. Sumá las líneas con Agregar línea (mínimo 2, con al menos una de débito y una de crédito):
   • Cuenta desde el selector del Plan de cuentas.
   • Fórmula débito o Fórmula crédito (nunca ambas).
   • Descripción opcional.
   • Orden - usá las flechas Subir / Bajar para ordenar.
4. Mosce ERP valida que haya al menos una línea de débito y una de crédito antes de permitir guardar. La validación de balance ocurre al aplicar la plantilla, no al definirla, porque las variables son las que cierran las sumas.
5. Guardá. La plantilla queda disponible en el listado y aparecerá como opción al crear nuevos asientos.

Aplicar una plantilla

1. Desde el listado de plantillas, abrí la fila y pulsá Aplicar plantilla. También podés invocarla desde el formulario de un nuevo asiento.
2. Paso 1 - Variables: ingresá un valor numérico para cada {{variable}} detectada en las fórmulas. Si la plantilla no tiene variables, pasás directo al siguiente paso.
3. Paso 2 - Vista previa: pulsá Calcular vista previa. El sistema evalúa cada fórmula, te muestra cuenta, débito, crédito y descripción de cada línea, y un indicador Asiento balanceado / desbalanceado con los totales.
4. Si el balance es correcto, completá los datos del asiento final:
   • Fecha del asiento.
   • Período fiscal.
   • Descripción y Referencia opcionales.
5. Tenés dos rutas:
   • Confirmar - crea el asiento en Borrador y lo deja listo para registrar.
   • Abrir en editor - te lleva al formulario de asiento con las líneas precargadas para que ajustes manualmente antes de guardar.

Editar y desactivar

• Editar: abrí la plantilla y modificá líneas, fórmulas o cuentas. Los asientos ya creados a partir de ella no se ven afectados (no hay relación viva entre plantilla y asiento posteado).
• Desactivar: pulsá Eliminar plantilla. Se marca como inactiva (isActive = false) y deja de aparecer en los selectores. La definición se preserva.

Resultado esperado

• Plantillas reutilizables que reducen errores de cuenta y aceleran cierres mensuales.
• Asientos resultantes con source = TEMPLATE y rastreables como cualquier otro asiento manual.
• Las fórmulas se calculan de forma segura - el parser solo acepta aritmética básica y variables declaradas.

Errores comunes

Relacionados

• Asientos contables
• Plantillas recurrentes
• Plan de cuentas
• Centros de costo