Reglas de conciliación
Objetivo
Sección titulada «Objetivo»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. |
Modos de conciliación
Sección titulada «Modos de conciliación»| 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. |
Transacción de cierre (R11)
Sección titulada «Transacción de cierre (R11)»Con hasMonthlyClose = true, todo ocurre en una sola transacción atómica:
- Validar R1 a R10.
- Verificar que no exista otro lote final para esa cuenta y mes.
- Insertar la conciliación como cerrada.
- Marcar los movimientos del lote como conciliados.
- Insertar el cierre mensual con los totales consolidados de todo el mes.
- 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).
Implementación de R12
Sección titulada «Implementación de R12»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.
Diferencias entre la spec y el código
Sección titulada «Diferencias entre la spec y el código»- 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 escribereopened_*niclose_status = reabierto. - Dos flujos vivos:
POST account-conciliationyPUT .../revertson el flujo anterior, sin período ni cierre de mes. El vigente esconciliateyunconciliate, que calculaopening_balanceyclosing_balance, crea el cierre mensual y guarda el motivo.
Convenciones contables
Sección titulada «Convenciones contables»- 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.
