Análisis Funcional: Módulo Caja (efectivo por punto de venta)
Date: 2026-08-05 · Actualizado: 2026-10-06 Status: Vigente — describe el módulo tal como está implementado hoy (E4, E4-multi y E4b, mergeadas a main, más las entregas B3 y B7 del plan de ajustes v2: el cierre diario y los extractos de tesorería). Lo poco que sigue pendiente está marcado como tal, caso por caso, y listado en Preguntas Abiertas. Autor: Product Owner + UI Engineer Agents (metodología Raxar Factory) Fuentes: revisión "Revisión desarrollo Caja Soterex" (2026-08-05, Teresa Ortiz y Diego Sánchez de CIS-EC + Carlos San Martín de CIS-AR), ADR-005, ADR-007, los diseños técnicos de E4/E4-multi, y el código de main.
Por qué existe este paquete aparte
El Análisis Funcional original es del 2026-07-24 y no cubre el módulo Caja: cuando se escribió, el módulo no existía ni estaba pedido. Llegó después, con la entrega E4 del plan v2, y se construyó guiado por ADRs y diseños técnicos — sin pasar por un análisis funcional propio. Este paquete paga esa deuda.
No reemplaza al análisis original: lo complementa. Todo lo que hace a transacciones, roles, prefondeo y administración sigue viviendo allá.
Cómo leer este documento
Todo lo que este paquete describe está implementado y funcionando, salvo lo que se marca explícitamente como pendiente. Leelo en presente.
Nota para quien lo leyó antes del 2026-09-14. Este paquete se escribió el 2026-08-05, cuando E4b todavía era un plan, y quedó lleno de marcas "✅ implementado hoy" / "📋 planificado". Las tres sub-entregas se mergearon el 2026-08-06 (PRs #14, #15 y #16), así que durante más de un mes esas marcas dijeron exactamente lo contrario de la realidad: presentaban como vigente el modelo de dos saldos —que ya no existe— y como futuro el de tres capas, que es el que corre. Se eliminaron. Un análisis funcional tiene que describir el sistema que hay; la historia de cómo llegó vive en los ADRs y en los planes.
El plan de ejecución de E4b, con el detalle de cada sub-entrega, está en 2026-08-05-e4b-ajustes-caja-reunion-cliente.
Desde el 2026-10-02 la caja opera solo el día en que se abrió (entrega B3, ADR-013). El cliente pidió apertura y cierre diarios "para control de saldos finales por día"; una sesión abierta un día anterior queda vencida y solo se puede cerrar —no paga, no se fondea, no se ajusta—, y el reporte Cierres por día muestra el saldo final de cada caja y día. No hay cierre automático. Lo describen la regla R18 del resumen, el flujo 2.10, la secuencia 3.5 y las pantallas 4.2.7 y 4.5.1.
Desde el 2026-10-06 cada caja la cierra quien la abrió (entrega G6 del plan de ajustes v3, ADR-021). La caja que abrió otra persona la cierran solo un Supervisor o un Admin del PDV; la pantalla dice quién tiene cada caja abierta y solo ofrece Cerrar caja a quien puede. Reemplaza la regla de B3 por la que cualquiera con el permiso podía cerrar la caja vencida de un cajero ausente. Lo describen la regla R20 del resumen, el flujo 2.2, la secuencia 3.6 y las pantallas 4.2.2, 4.2.3 y 4.2.7. Queda una pregunta abierta, la #22: un PDV sin Supervisor.
Desde el 2026-10-06 una caja se desactiva y se reactiva (entrega G7 del mismo plan, ADR-022), y Saldos muestra una línea por país con la plata que hay en sus cajas (G6.C). La baja no borra nada: la caja conserva su número y su ledger, deja de verse en Saldos y de poder abrirse, y sigue en Reportes → Cajas marcada Inactiva. No se desactiva con una sesión abierta ni con plata adentro: primero se la deja en cero con un ajuste negativo de motivo nuevo, Retiro por baja de caja. Lo describen las reglas R21 a R23 del resumen, el modelo de saldos 1.10, el flujo 2.7 y las pantallas 4.5 y 4.6. Quedan dos preguntas abiertas, la #23 (Tesorería y el motivo nuevo) y la #24 (la línea de país).
Desde el 2026-10-07 una Tesorería que no lee todos los países ve de la Holding solo la parte de los suyos (entrega G12 del mismo plan, ADR-007 §1 y ADR-015 §5): la tarjeta de Prefondeo Soterex —que ahora se llama Saldo con Soterex, como la hoja del cliente— suma solo sus países y lo avisa, en vez de mostrar el saldo global, y un país inactivo y sin movimientos (El Salvador y Honduras) ya no cuenta como un país que falta. Quién ve qué extracto, entidad por entidad de la hoja, está en el modelo de saldos 1.10 y en la tabla de roles. La hoja nueva del cliente contestó dos de las preguntas de los extractos (la #18 y la #19, para Guatemala), la #16 se cerró por defecto, y queda una pregunta nueva, la #25: el «Saldo final CIS Holding» de 32.708, que la app no muestra.
Dos cosas se implementaron distinto de como las había escrito el plan, ambas decididas al construirlas y documentadas en ADR-007:
- El cierre de caja no genera ningún movimiento de retiro. El plan decía conservarlo; al implementarlo resultó que dejaba la caja mostrando cero con la plata físicamente en el PDV, y hacía ambiguo el saldo heredado cuando dos cierres caían en el mismo segundo. La plata se queda en la caja y la apertura siguiente arranca con ese saldo.
- Una sola caja abierta por usuario, garantizado por la base de datos y no solo por código.
Lo que sigue pendiente de verdad, a la fecha de esta actualización:
- El aviso entre la Holding y el Prefondeo País no existe: repartir a los países más de lo que la Holding recibió no avisa nada, a diferencia de la frontera de abajo (país → caja), que sí avisa. Está documentado en ADR-010 (Proposed) y planificado como entrega F2 del plan v3.
- El filtro por motivo en Reportes → Cajas (sí existe en la pantalla de Caja).
- Los comprobantes membretados de apertura y cierre.
- El bloque de UI "Circuito de fondos" que diseña el documento 6.
Índice
- Resumen del alcance — qué problema resuelve, para quién, qué queda afuera, y el glosario del dominio.
- Modelo de saldos — cómo se mueve la plata entre las capas, con el ejemplo numérico de la reunión y, en 1.10, el diagrama del circuito completo con los cuatro extractos de tesorería. Empezá por acá si es tu primer contacto con el módulo.
- Flujos de Caja — apertura, cierre (y quién puede hacerlo), fondeo, ajuste, pago, alta y baja de cajas, tipo de cambio, y la caja vencida (2.10).
- Diagramas de Actividad — secuencias entre actores, el circuito completo del dinero, los casos de concurrencia, la medianoche (3.5) y el cierre de la caja de otro (3.6).
- Secuencias de Pantalla — cada pantalla del módulo, su ruta, su permiso y sus estados, incluido el aviso de caja vencida, el reporte Cierres por día y las pestañas de extracto de Prefondeo Soterex y Fondeo PDVs.
- UX de múltiples cajas y fondeo — criterio de diseño de lo más delicado: elegir caja, distinguir fondeo de ajuste, alertar sin bloquear.
- Preguntas Abiertas — qué falta confirmar con el cliente y qué quedó pendiente de implementar.

