Ir al contenido

Reglas de conciliación

Agrupar los movimientos de una cuenta en lotes de conciliación mensuales, validados en orden cronológico, para tener un punto de corte contable por cuenta, bloquear alteraciones retroactivas, dejar trazabilidad y permitir una reversión controlada.

# Regla
R1 Orden cronológico estricto. Se concilia del más antiguo al más reciente: payment_date ASC, id ASC.
R2 Un solo mes por lote. Todos los movimientos pertenecen al mismo mes calendario.
R3 Varios lotes por mes (cortes parciales), distinguidos por sequence.
R4 Sin saltos. No se concilia el mes M+1 si quedan movimientos sin conciliar del mes M.
R5 Sin inserción retroactiva. Un movimiento con payment_date menor o igual a la última fecha conciliada se rechaza. El ajuste va como movimiento nuevo con fecha actual.
R6 Inmutabilidad. Un movimiento conciliado no cambia sus campos financieros (montos, fecha, tipo, cuenta).
R7 Reversión LIFO. Solo se revierte la conciliación más reciente cerrada de la cuenta.
R8 Integridad del saldo. closingBalance = openingBalance + netAmount, y el openingBalance de un lote es el closingBalance del anterior (o 0 si es el primero).
R9 Alcance por cuenta. Cada cuenta tiene su propia cadena, independiente de las demás.
R10 Cero tolerancia a diferencia, pero solo cuando el lote cierra el mes (hasMonthlyClose = true).
R11 El lote que cierra el mes crea el cierre mensual en la misma transacción.
R12 Bloqueo con mes cerrado. Mientras exista un cierre mensual activo para la cuenta y el mes, no se crea ninguna conciliación nueva en ese mes.
Modo hasMonthlyClose Extracto R10 Al cerrar
Lote de revisión false No requiere No aplica Solo sella los movimientos.
Lote que cierra el mes true Obligatorio Se valida Sella los movimientos y crea el cierre mensual.

Con hasMonthlyClose = true, todo ocurre en una sola transacción atómica:

  1. Validar R1 a R10.
  2. Verificar que no exista otro lote final para esa cuenta y mes.
  3. Insertar la conciliación como cerrada.
  4. Marcar los movimientos del lote como conciliados.
  5. Insertar el cierre mensual con los totales consolidados de todo el mes.
  6. Actualizar la última conciliación, la última fecha conciliada y el último cierre de la cuenta.

Si un paso falla, se revierte todo: no puede quedar una conciliación sin cierre, ni un cierre sin conciliación. Al revertir el lote final (R7), su cierre mensual se deshace en la misma transacción (según la spec se marca como revertido; en el código se elimina con soft delete, ver más abajo).

Antes de insertar la conciliación, consultar si existe un cierre mensual en estado cerrado para (cuenta, año, mes); si existe, rechazar. En el código real (AccountConciliationService) el rechazo es una ValidationException sobre la clave period, es decir, responde 422, no 409 como decía la spec. El UNIQUE del lote final no basta: permite lotes con hasMonthlyClose = false cuando el mes ya está cerrado.

  • R12: responde 422 con la clave period, no 409.
  • R11 al revertir: el cierre mensual se elimina con soft delete (delete()); no se marca como reabierto ni se escribe reopened_* ni close_status = reabierto.
  • Dos flujos vivos: POST account-conciliation y PUT .../revert son el flujo anterior, sin período ni cierre de mes. El vigente es conciliate y unconciliate, que calcula opening_balance y closing_balance, crea el cierre mensual y guarda el motivo.
  • Inmutabilidad del pasado: una vez conciliado un período, no se edita. Todo ajuste va como movimiento nuevo con fecha actual.
  • Partidas en tránsito: movimientos que existen de un lado pero todavía no del otro. Se excluyen del lote y quedan pendientes.
  • Arqueo: es el equivalente al extracto bancario para cuentas de efectivo.
  • Reversión: solo LIFO, para no dejar huecos en la cadena de saldos.