Preguntas Abiertas — Módulo Caja
Análisis Funcional: Módulo Caja — parte 7 de 7. ← UX de múltiples cajas y fondeo · Índice
Lo que todavía falta confirmar con el cliente, más lo que se implementó por analogía o por criterio del equipo y nunca se validó. Mismo criterio que las Preguntas Abiertas del análisis original: numeradas, con estado y fecha, y sin redondear como cerrado nada que no lo esté.
Estados: ✅ RESUELTO (y en main) · ⚠️ ABIERTA · 📌 PENDIENTE NO BLOQUEANTE · 📌 CERRADA POR DEFECTO (el cliente contestó de una manera que se lee como un sí sin decirlo, y se implementó eso; si no era lo que querían, se revierte)
6.1 Abiertas
Alcance del Prefondeo Holding: ¿pool único global o por país?— ✅ RESUELTO (2026-08-06): global. Enmain. La transcripción de la reunión admitía las dos lecturas y nadie las había reconciliado: Carlos habló de un fondeo único para todos los países, y Diego ejemplificó con 200 USD repartidos entre Ecuador y Guatemala —que se lee igual de bien como "200 globales" que como "200 de esta holding para estos dos países"—. Eran modelos distintos: uno tiene un saldo, el otro tiene N. Resolución (Carlos, 2026-08-06): el ledger conservacountry_iden cada asiento y en cada pago, pero el saldo que se muestra es la suma global de todos los países —PrefundingService::globalBalance(). Así el reporte desagregado por país y PDV que se le informa a Soterex sigue funcionando. Ver ADR-007 §1.Catálogo exacto de motivos: ¿
Blindadova también como motivo de ajuste? — ⚠️ ABIERTA (2026-08-05). No bloqueante. Diego lo mencionó primero como tipo de ajuste — pidió "un ajuste que sea netamente identificable de este tipo de transacción de blindados", para distinguirlo de un ajuste por faltante — y al enumerar los tipos de ajuste dijo "faltante de arqueo, el blindado y sobrante de arqueo". Después, cuando Carlos aclaró que "esto es solo fondeo, todo aumenta; después están los ajustes, que pueden ser positivo o negativo",Blindadoquedó del lado de fondeo y Diego cerró con "en el de fondeo está bien: fondeo inicial, blindado, transferencia financiero, y otro". Implementado así (CashMovement::MOTIVOS_FONDEO/MOTIVOS_AJUSTE,backend/app/Models/CashMovement.php:30-50, ya enmain): fondeo →Fondeo inicial,Blindado,Transferencia financiero,Otro; ajuste →Faltante de arqueo,Sobrante de arqueo,Otro. Qué hace falta: confirmar si tesorería también quiereBlindadodisponible en ajustes. Si la respuesta es sí, es agregar una constante — por eso no bloquea. El catálogo se decidió cerrado justamente para que nadie escriba "blindado" y "transferencia de dinero" como conceptos distintos, así que agregar motivos siempre va a ser una decisión de tesorería, no del operador. Actualización 2026-10-06 (G7): el catálogo de ajuste pasó a cuatro motivos —Faltante de arqueo,Sobrante de arqueo,Retiro por baja de cajayOtro—. El nuevo no lo pidió Tesorería: lo agregó Carlos (D3-14 a) para poder vaciar una caja antes de darla de baja, y nadie de Tesorería lo vio todavía. Ver la pregunta #23.Blindadoen ajustes sigue abierta.¿Qué rol carga el Prefondeo País?— ✅ RESUELTO (2026-08-06): Supervisor y Admin. Enmain. SUPERADO (2026-10-02, B6): el cliente pidió un perfil propio y existe Tesorería; carga el Prefondeo País (y la Holding) Tesorería o el Admin, y el Supervisor ya no. Lo que sigue es la resolución de agosto. Teresa dejó explícito que la carga es manual, por tesorería, pero "tesorería" no es un rol del sistema: los sembrados son Backoffice, Supervisor y Admin (RoleSeeder). Resolución (Carlos): no se crea un rol nuevo —prefondeo_paisqueda con L·E para Supervisor y todo para Admin (RoleSeeder.php:72-94,95-113), mismo criterio que el prefondeo que ya existe.Un mismo usuario con dos cajas abiertas a la vez— ✅ RESUELTO (2026-08-06): se bloquea la segunda apertura. Enmain. El diseño de múltiples cajas asumía "una caja abierta por persona a la vez; cambio de turno = cerrar y volver a abrir", pero nada lo impedía: el índice único parcialcash_sessions_one_open_per_boxgarantiza una sola sesión abierta por caja, no por usuario. Con dos cajas abiertas a su nombre,applyCashBoxDiscount()resolvía la caja con unfirst()sinorderBy: de cuál salía la plata lo decidía el orden de la base. Resolución (Carlos), implementada:USER_ALREADY_HAS_OPEN_CASH_BOX(409) más el índice únicocash_sessions_one_open_per_user(backend/database/migrations/2026_08_06_130000_e4b_una_sola_caja_abierta_por_usuario.php), yapplyCashBoxDiscount()ahora ordena explícitamente (orderByDesc('opened_at'),TransactionController.php:328) como defensa en profundidad para lo que hubiera quedado abierto de a dos antes de esta regla.Alcance del permiso de caja: ¿por país o por PDV asignado?— ✅ RESUELTO (2026-08-06): por PDV. Era un bug, ya corregido y enmain.CashBoxController::disponibles()listaba las cajas acotadas por PDV (PermissionService::allowedStationIds), pero todas las demás operaciones sobre una caja puntual —apertura, cierre, fondeo, ajuste, movimientos, reporte— pasaban porauthorizeStationScope(), que a pesar del nombre validaba solo a nivel país. Un Backoffice (hoy Cajero) acotado a la sucursal A no veía en pantalla las cajas de la sucursal B, pero podía operarlas por API conociendo el id. Resolución:authorizeStationScope()(CashBoxController.php:621-638) ahora chequea tambiénallowedStationIds, mismo criterio queTransactionController::authorizeScope. Las asignaciones sin PDVs (todos los del país, ej. Admin) siguen sin restricción. Sigue siendo un caso a revisar en E6.La caja que paga puede ser de un PDV distinto al que se le atribuye la transacción — 📌 PENDIENTE NO BLOQUEANTE (2026-08-04). Parcialmente resuelto. Desde múltiples cajas, "a qué PDV se atribuye la transacción" y "qué caja física paga" son dos cosas que se resuelven por separado: la primera por el PDV activo del usuario, la segunda por la caja que ese usuario abrió. El caso multipaís —pagar una transacción de un país con la caja de otro— ya se cerró:
CASH_BOX_COUNTRY_MISMATCHlo bloquea desde el 2026-08-05 (TransactionController::applyCashBoxDiscount(),:342-355). Lo que sigue sin resolver es el cruce dentro de un mismo país: un operador con acceso a dos sucursales del mismo país podría tener abierta la caja de una y pagar una transacción atribuida a la otra — quedaría un reporte por PDV que no coincide con el movimiento de caja. Está documentado como decisión consciente en el diseño de E4-multi §2.3 ("no pedido, no se agrega esa validación cruzada"). Qué hace falta: ver si en el uso real aparece; si aparece, es un chequeo chico.Actualización (2026-10-06, G4.1, ADR-020) — sigue parcial, y la condición queda escrita. Apareció en el uso real (RV3-17): un operador pagó dos transacciones desde la misma caja de Central y una quedó con PDV «—» y la otra con «Mixco Plaza». Se resolvió la mitad que es un hueco: con módulo Caja, el PDV de la caja de la que sale la plata llena el PDV del pago cuando ninguna otra regla lo resuelve (la persona no tiene PDV activo ni un único PDV en su alcance), y los pagos viejos que quedaron sin PDV se completan desde su movimiento
PAGOcon una migración de datos que corre con el deploy (D3-7 b y D3-8). Lo que persiste: cuando el PDV ya venía fijado por otro camino (el PDV activo de la persona, o el que fijó el primer documento), gana ese y no se compara con la caja: un pago hecho con la caja de Central por quien tiene activo Mixco Plaza sigue atribuido a Mixco Plaza. Está fijado por un test (test_pay_con_caja_el_pdv_activo_gana_sobre_el_pdv_de_la_caja). Pendiente de la respuesta de la cliente (QC-9): si el PDV de un pago debe ser siempre el de la caja, es la opción (a) de D3-7 y el cambio es chico (ver el ADR).Las reglas del
AJUSTEnunca se confirmaron con el cliente — 📌 PENDIENTE NO BLOQUEANTE (2026-08-05). La operación de ajuste no está en las decisiones del plan v2 — la agregó el equipo por analogía al implementar E4, y el cliente la vio funcionando recién en la reunión del 2026-08-05 (donde la usó sin objetarla, y de hecho pidió motivos para ella). Quedan sin confirmar tres criterios que se decidieron solos:- Se gatea con
fondeo_caja:write(Supervisor/Admin; desde B6, Tesorería/Admin), no con un permiso propio. - Un ajuste que dejaría la caja en negativo se rechaza (
ADJUSTMENT_WOULD_GO_NEGATIVE). - Requiere sesión de caja abierta — y con el saldo arrastrándose entre sesiones (ya en
main), un blindado o faltante detectado fuera de horario sigue sin poder registrarse hasta la próxima apertura (ver 06.1 #11 más abajo). Qué hace falta: validarlas con tesorería.
- Se gatea con
¿La validación de saldo se saca también en los países sin módulo Caja?— ✅ RESUELTO (2026-08-06): se mantiene. Enmain.ADR-007 §2 conserva una validación de saldo para los países sin Caja (Ecuador, con EPOS, en producción), ahora contra el Prefondeo País. Era una asunción del equipo, no un pedido. Resolución (Carlos): se mantiene. Implementado enTransactionController::pay()(:232-245): decisión consciente y no como omisión.Los comprobantes membretados de apertura y cierre están decididos pero no existen — 📌 PENDIENTE NO BLOQUEANTE (2026-08-05). Llega con E5. Las decisiones #14 y #15 del plan v2 definen un comprobante membretado de apertura y otro de cierre, en formato térmico de 58 mm, accesibles y reimprimibles desde la lista de movimientos. Las columnas están (
cash_sessions.opening_receipt_pathyclosing_receipt_path) pero nadie las escribe: la generación de PDFs quedó fuera del alcance de E4 y llega con E5, con el mismo motor que la papeleta. El mensaje falso ya se corrigió. La versión anterior de este documento señalaba que, al cerrar una caja, la app decía "El comprobante de cierre queda disponible en Movimientos" sin que existiera ningún comprobante. Ese texto se sacó al reescribir el modal de cierre para E4b.1: hoy la notificación de éxito es simplementeCaja cerrada(CajaView.vue:206), sin mencionar ningún comprobante. Sigue pendiente lo de fondo: los comprobantes en sí no existen, y eso sigue siendo trabajo de E5.¿Qué pasa con el ledger de una caja si el país cambia de moneda de pago?— ✅ RESUELTO (2026-08-06): la moneda se guarda en cada movimiento. Enmain.cash_movements.amount_localguardaba un número sin moneda: se infería del país. Si un país que venía operando en moneda local pasaba a pagar en USD —o al revés— los movimientos viejos y los nuevos quedaban en el mismo ledger, en monedas distintas, y el saldo derivado sumaba peras con manzanas. No era hipotético:pago_en_moneda_locales editable desde ABM Países. Resolución (Carlos), implementada:cash_movements.currency(backend/database/migrations/2026_08_06_110000_e4b2_moneda_de_pago_por_pais.php) registra en qué moneda se cargó cada movimiento. El histórico nunca se reinterpreta —CashBoxService::balance()filtra por moneda vigente (:31-40) y expone lo que quedó en una moneda anterior víaresidualBalances()(:50-62).¿Se puede fondear o ajustar una caja cerrada? — 📌 PENDIENTE NO BLOQUEANTE (2026-08-05). Hoy no: fondeo y ajuste exigen una sesión abierta (
CASH_SESSION_CLOSED, 422). El escenario que describió Diego encaja igual —"la caja el día uno tiene saldo cero; viene el blindado, llegan los 20; voy a esta pantallita, fondeo inicial, ingresan los 20"—: se abre la caja y después se fondea. Pero si un blindado llega fuera del horario de operación, la plata no se puede registrar hasta la próxima apertura. Con el saldo ya arrastrándose entre sesiones (E4b.1, enmain), este desfasaje pesa un poco más que antes de resolverlo, porque ahora "esperar a la apertura siguiente" es la única vía. Desde B3 se suma un caso: una caja que quedó abierta de ayer tampoco admite fondeo ni ajuste (CASH_SESSION_FROM_PREVIOUS_DAY) hasta que se la cierre y se la abra de nuevo (ADR-013 §1); es a propósito, para que el saldo final de cada día no se siga moviendo después de terminado. Qué hace falta: confirmar que ese desfasaje no molesta en la operación real.
6.2 Cerradas en la revisión del 2026-08-05 — ya en main
Estaban abiertas antes de la reunión y quedaron definidas ahí. A diferencia de cuando se escribió la primera versión de este documento, las cuatro ya están implementadas y corriendo en main — mergearon el 2026-08-06, más de un mes antes de esta revisión.
¿El saldo inicial de apertura lo tipea el operador o se hereda? — ✅ RESUELTO (2026-08-05) e implementado. Se hereda del cierre anterior de esa misma caja (cero en la primera apertura), y no es editable ni se ofrece como sugerencia. Diego: "que lo tome automáticamente, no debería ser como sugerencia".
CashBoxService::inheritedOpeningBalance()(backend/app/Services/CashBoxService.php:79-82). Ver Modelo de saldos §1.8.¿La apertura y el cierre necesitan autorización de un Supervisor? — ✅ RESUELTO (2026-08-05) e implementado: no. Se eliminó la reautenticación in-band que había definido ADR-005.
opened_by_supervisor_idquedónullabley dejó de escribirse (backend/database/migrations/2026_08_06_100000_e4b1_caja_sin_supervisor_y_motivos_cerrados.php:24), y el códigoSUPERVISOR_INVALIDya no existe. Carlos: "sacamos los validadores para abrir caja y cerrar caja por parte de los supervisores".Fondear una caja por encima del prefondeo del país: ¿se bloquea? — ✅ RESUELTO (2026-08-05) e implementado: no se bloquea, se avisa. Diego lo pidió "como una alerta más que un validador".
CashBoxController::fondeo()responde 201, crea el movimiento igual, y agrega unwarningcon códigoOVER_COUNTRY_PREFUNDINGcuando el disponible para distribuir del país queda negativo (overDistributionWarning(),:406-425). Ver 5.4.¿En qué moneda se paga? — ✅ RESUELTO (2026-08-05) e implementado: configurable por país. Guatemala paga en dólares porque no tiene autorización para cambio de divisa (Teresa):
countries.pago_en_moneda_local(defaultfalse,backend/database/migrations/2026_08_06_110000_e4b2_moneda_de_pago_por_pais.php). Con la bandera apagada,NO_EXCHANGE_RATEno puede dispararse (TransactionController::applyCashBoxDiscount(),:357-371). El módulo de tipo de cambio no se tocó: queda para cuando llegue la autorización o aparezca la casa de cambio tercerizada que Teresa mencionó como segunda instancia.
6.3 Abiertas desde B7 (2026-10-02) — extractos de tesorería
Salen de implementar los cuatro extractos (ADR-015). Ninguna bloquea: cada una tiene un comportamiento por defecto conservador y reversible, y cambiarlo es un cambio chico. Las cuatro primeras se las llevaban Magaly y Teresa; la #20 y la #21 son de permisos y trazabilidad y las decide Carlos.
Actualización (2026-10-07, G12). El cliente contestó el 2026-10-02 con una hoja nueva («Módulo tesorería») y un mail que dice que, para el estado de cuenta de cada entidad, vale solo esa hoja y se descarta cualquier otra información (RV3-96 y RV3-97 del plan de ajustes v3). Con eso, la #18 y la #19 quedan contestadas para Guatemala, la #16 se cierra por defecto, y la #17, la #20 y la #21 siguen abiertas.
¿
REF BANyREF INTcomo dos campos separados en el asiento de la Holding? — 📌 CERRADA POR DEFECTO (2026-10-07, G12). En el Financial Report de Ecuador cada prefondeo lleva dos referencias: la del banco y la interna. Hoy el asiento tiene una (prefunding_entries.motivo, texto libre de 255, en pantalla Referencia) y se escriben juntas. Qué contestó el cliente: «tomar en cuenta lo detallado en la pestaña módulo tesorería y desechar cualquier otra info», y esa pestaña no tiene columnas de referencia bancaria ni interna (la hoja de Prefondeo pide una «Referencia», en singular). No es un sí explícito, es una inferencia: se queda una sola. Si las quieren separadas: son dos columnas opcionales, dos campos en el formulario y dos columnas en el extracto.¿Necesitan ver el
RS-xxxxxde Soterex como referencia de cada pago? — ⚠️ ABIERTA (2026-10-02). No bloqueante. El Financial Report lo trae y nada en el repo lo modela. Qué hace falta: preguntarle a Soterex si el dato existe y en qué mensaje viaja. Hasta entonces la referencia de un pago es el MTCN. (2026-10-07: el cliente ya fijó su regla, «si Soterex lo manda, se mantiene en el reporte; si no, se elimina», y la hoja nueva pide solo el «# de MTCN» como referencia. Sigue abierta porque depende de la respuesta de Soterex, no de la del cliente.)¿El débito de cada pago en «Soterex ↔ CIS Holding» es principal más comisión también en Ecuador? — ✅ RESUELTA PARA GUATEMALA (2026-10-07, G12); Ecuador sigue por defecto. La planilla de Guatemala lo hace así (50.000 − 1.010 = 48.990) y es lo que hace
PrefundingService::balance(), y la hoja nueva del cliente lo muestra igual: el débito de un pago es el principal más la comisión (celda B46, el ejemplo de Guatemala). La versión de Ecuador (B78) está en el bloque oculto de la hoja, que no se toma como requisito, así que para Ecuador rige lo mismo por defecto y no está confirmado. Qué falta, si algún día importa: que alguien confirme el Financial Report de Ecuador.¿La comisión suma al saldo de la Holding? — ✅ RESUELTA PARA GUATEMALA (2026-10-07, G12). El extracto CIS Holding calcula recibido − enviado a países + comisiones, que es como lo muestra la planilla del cliente, y la hoja nueva lo confirma: la comisión suma a «CIS Holding» (celda H43; con los números del ejemplo, 20.000 + 208 = 20.208). Desde G12 el encabezado del extracto dice además «de los cuales comisiones: 208», con las líneas de comisión del rango. Si Teresa lo quisiera al revés, se cambia el signo de una fuente del extracto y el test de la planilla lo vuelve a decir (ADR-015 §4). Ojo, que esto no es lo mismo que la #25: acá se contesta que la comisión suma al saldo de la Holding; la #25 es qué pasa cuando ese saldo se junta con el de un país.
¿Una asignación acotada por PDV tiene que poder leer los extractos de país entero (los dos de la Holding y el de País)? — ⚠️ ABIERTA (2026-10-02). No bloqueante. Esos tres listan cada pago y cada fondeo de todos los PDVs del país, más de lo que da una asignación acotada: hoy, para ellos, ese país no cuenta como leído (el extracto del PDV sí sigue el alcance por PDV). Con la matriz sembrada no cambia nada. Qué hace falta: que Carlos decida si una asignación acotada puede leerlos; se cambia en
TreasuryStatementController::resolveScope()(ADR-015 §5, pregunta 5).¿Tesorería necesita ver quién cargó cada asiento («Cargado por»)? — ⚠️ ABIERTA (2026-10-02). No bloqueante. Las dos listas viejas de asientos traían el email de quien cargó cada uno; los extractos, con las columnas que pidió el cliente, no. El dato sigue en
created_byy en Auditoría (que Tesorería no puede leer). Qué hace falta: que Carlos decida si se devuelve; son una columna en el extracto y en el export más el test de claves permitidas (ADR-015 §7, pregunta 6).
6.4 Abierta desde G6 (2026-10-06): quién cierra una caja ajena
Sale de implementar la regla de quién cierra una caja (ADR-021). No bloquea: tiene un comportamiento por defecto conservador y reversible, ya implementado.
- ¿Hay PDV sin Supervisor, donde la caja vencida de un cajero ausente quedaría sin salida? — ⚠️ ABIERTA (2026-10-06). No bloqueante. Lo que se implementó (decisión D3-12 B de Carlos, 2026-10-05): una caja la cierra quien la abrió, el Supervisor del PDV o el Admin; ningún otro Cajero, ni Tesorería. Es lo que pidió el cliente (RV3-25: "el mismo operador que abre una caja debe ser el único autorizado a cerrarla") con una salida para el caso de todos los días: el cajero que se va sin cerrar. Pero si un PDV no tiene Supervisor, esa caja queda trabada —no paga, no fondea, no ajusta, y el índice único por usuario le impide a su dueño abrir otra— hasta que un Admin la cierre. El Admin siempre puede, así que nunca queda sin salida; lo que cuesta es depender de él. Valor por defecto: el implementado. Qué hace falta: preguntarle al cliente (QC-12 del plan de ajustes v3) si hay PDV sin Supervisor, o con un solo cajero y sin nadie más con ese perfil. Si los hay, la variante (C) de ADR-021 es un cambio chico: en
PermissionService::canCloseCashSession(), devolver tambiéntruesi la sesión está vencida ($session->isFromPreviousDay()) y el usuario tieneapertura_cierre_caja:writesobre el PDV. Vuelve a abrir el hueco de ADR-013 §5, pero solo para la caja vencida, y cambian los tests que fijan el 403 de la vencida (CashBoxApiTestyPerfilesAccesoApiTest). La otra evolución posible, una celda explícita «cerrar cajas ajenas» en la matriz, se descartó por ahora: cambia permisos de usuarios reales con el deploy. El mismo mail al cliente lleva QC-14: si alcanza con que el correo de quien tiene cada caja lo vea cualquiera que vea la lista de cajas de ese PDV (valor por defecto: sí). Punto relacionado, sin resolver (lo dejó la revisión de G6): el aviso al que hace el cambio existe solo en la baja de un usuario (G6.B4). Cambiarle o quitarle la asignación a un Cajero que tiene una caja abierta no avisa nada: la caja desaparece de su pantalla y solo la cierra un Supervisor o un Admin del PDV; lo único que hace el sistema hoy es que, al intentar abrir otra, el 409 le diga a quién pedírsela. Falta decidir si la pantalla de asignaciones tiene que avisar igual que la de Usuarios (el cambio es chico y es de backend: mismoUSER_HAS_OPEN_CASH_BOX).
6.5 Abiertas desde G7 (2026-10-06): alta y baja de cajas
Salen de implementar la baja de cajas y la línea de país de Saldos (ADR-022). Ninguna bloquea: las dos tienen un comportamiento por defecto implementado y reversible.
¿Tesorería aprueba el motivo de ajuste «Retiro por baja de caja»? ¿Y está de acuerdo en que una caja con plata no se desactive? — ⚠️ ABIERTA (2026-10-06). No bloqueante. El cliente pidió poder «activar, desactivar» cajas (RV3-30) y la baja de una caja con plata necesita una forma de sacarla: el único ajuste negativo que existía era
Faltante de arqueo, que afirma algo falso (acá no falta nada: se retira a propósito). Carlos decidió (D3-14 a, 2026-10-05) rechazar la baja de una caja con saldo y agregar un motivo nuevo al catálogo cerrado. El catálogo es de Tesorería (#2: «agregar motivos siempre va a ser una decisión de tesorería») y no lo vio. Valor por defecto: el implementado —409CASH_BOX_HAS_BALANCEy, para dejarla en cero, abrir, ajustar conRetiro por baja de caja(monto negativo, 422 si es positivo), cerrar y desactivar—. Qué hace falta: preguntarle a Teresa y a Diego (a través del cliente, QC-16 del plan de ajustes v3): (a) que el nombre y el uso del motivo les sirven, y (b) que prefieren esto a la alternativa —permitir desactivar la caja con su saldo y que siga sumando en el total del PDV, marcada—. Cambiar de (a) a (b) es sacar el 409 del PATCH y hacer que el total de Saldos sume también las cajas de baja (ADR-022, «Si se revierte»); el motivo puede quedar. Si Tesorería lo rechaza o lo quiere con otro nombre, es una constante (CashMovement::MOTIVO_RETIRO_POR_BAJA) y los movimientos ya cargados conservan su texto. Pendiente que deja esta decisión (revisión de G7): el ajuste escribe siempre en la moneda de pago vigente del país, así que una caja con efectivo en una moneda anterior (el país cambió de moneda) no se puede dejar en cero con este motivo y, por lo tanto, tampoco desactivar. Hoy ningún país cambió de moneda. Si pasa, hace falta una entrega aparte —un ajuste con moneda explícita, que el ajuste de hoy no tiene— y mientras tanto el manual manda a pedir soporte. La misma regla alcanza a las otras vías por las que una caja deja de ser operable (revisión de G7): desactivar su PDV, mudarlo de país y apagar el módulo Caja del país se rechazan con una sesión abierta o plata adentro (ADR-022 §5). Es una extensión de D3-14 (a) que no estaba en el plan; si Carlos prefiere solo avisar, es sacar el control deStationController::updatey deCountryController::update.La línea de país de Saldos: ¿es el total de las cajas o el disponible para distribuir? — ⚠️ ABIERTA (2026-10-06). No bloqueante. El cliente dibujó sobre la captura de Saldos una línea «GUATEMALA · USD 24878.53» (RV3-28). Esa cifra es la suma de las tres tarjetas por PDV y el mismo número que Distribuido en cajas de Fondeo PDVs: el total de plata en las cajas, no el disponible para distribuir. Lo escribió el cliente, así que no es una duda de diseño; falta que lo confirme. Valor por defecto: el implementado —el total de las cajas, igual a «Distribuido en cajas» con el alcance completo, y «Total de tus PDV» con el parcial—. Qué hace falta: que el cliente confirme (QC-15). Si además quiere el disponible, se suma una segunda cifra solo para quien tiene
prefondeo_pais:read(Tesorería y Admin), reusandoCountryPrefundingService::availableToDistribute(); no cambia el contrato de lo que ya existe. Una diferencia que conviene decirle: con el alcance completo la línea cuenta el ledger de todas las cajas del país, también las de un PDV inactivo, que no tienen tarjeta. Desde G7 no se desactiva un PDV con plata en sus cajas, así que la línea y la suma de las tarjetas coinciden salvo en un PDV que ya estaba inactivo con plata antes de G7. Si el cliente quiere la línea igual a la suma de las tarjetas aun en ese caso, la línea pasa a sumar solo las cajas operables y deja de ser «Distribuido en cajas».
6.6 Abierta desde G12 (2026-10-07): el «Saldo final CIS Holding» de la hoja
Sale de comparar los números de la app con los de la hoja «Módulo tesorería» que mandó el cliente. No bloquea: con el comportamiento por defecto la app sigue mostrando los tres números de siempre, y no se implementó nada para esta pregunta.
Una nota de numeración. El plan de ajustes v3 la llamaba «la 22 nueva». Entre medio, G6 y G7 ocuparon la #22, la #23 y la #24, así que esta es la #25. El plan también dice que las preguntas de G13 empiezan en la #23: empiezan en la #26.
El «Saldo final CIS Holding» de la hoja es 32.708: ¿es un doble conteo o es el número que quieren ver? — ⚠️ ABIERTA (2026-10-07). No bloqueante, y no se decide leyendo. Es la pregunta QC-33 del plan de ajustes v3 (RV3-67). De dónde sale el número. La hoja suma dos cosas: lo que la Holding tiene sin repartir (20.208, que es la columna CIS Holding: 50.000 recibidos − 30.000 enviados a Guatemala + 208 de comisiones) y el saldo final de CIS Guatemala (12.500: 30.000 recibidos − 17.500 de principales pagados). 20.208 + 12.500 = 32.708. Qué muestra la app hoy: 32.292 (el saldo con Soterex, que descuenta principal más comisión), 20.208 (el Monto actual de la pestaña CIS Holding) y 12.500 (el saldo del país); no hay ninguna pantalla que dé 32.708. Por qué no se decide leyendo: 32.708 supera en 208 —exactamente la comisión— a la plata que físicamente queda, que según las cuentas del plan es 50.000 − 17.500 de principales pagados = 32.500. Hay dos lecturas y las dos son posibles:
- (a) Doble conteo. La comisión no sale de ninguna caja ni de ningún país, así que esos 32.500 (50.000 − 17.500) ya la incluyen; volver a sumarla sobre el saldo del país cuenta 208 dos veces. Entonces el número correcto sería 32.500, y lo que hay que corregir es la hoja.
- (b) Un número contable, no de caja. La hoja suma a propósito la comisión como algo que la Holding ganó, por encima de la plata que hay (es la lectura que ya hace la pestaña CIS Holding, #19), y 32.708 es lo que Teresa quiere ver. Entonces el número es legítimo y falta darle un lugar y un nombre en la pantalla.
Valor por defecto: no se muestra. Las tres cifras de arriba siguen como están y la hoja se lee como una pregunta, no como un pedido. Qué hace falta: preguntarle a Teresa (a través de Magaly) cuál de las dos lecturas es. Si es la (b) y lo quieren en pantalla: es una línea derivada, en el encabezado de la pestaña CIS Holding y con un rótulo propio —nunca una fila del saldo corrido ni un saldo guardado (ADR-005, ADR-007)—, que suma el Monto actual de la Holding y el saldo de los países cubiertos. Cuidado con dos cosas al hacerla: con alcance parcial esa suma sería la de sus países, no la de toda la Holding (la misma regla que la tarjeta, G12), y en un país que paga en moneda local el saldo del país no está en dólares. Si es la (a), no se hace nada en la app.
6.7 Abiertas desde L3 (2026-10-19): la bóveda del PDV
Salen de implementar la bóveda y los traspasos (ADR-029) con los valores por defecto del plan de la ronda del 14/10. Ninguna bloquea: cada una tiene un comportamiento por defecto implementado y reversible. Son las QC-42 a QC-45 del plan; en la carta al cliente van como las preguntas 1 a 4.
El circuito y quién puede pasar plata (QC-42). — ⚠️ ABIERTA (2026-10-19). No bloqueante. Tesorería manda la plata a la bóveda del PDV, el Supervisor (o Tesorería, o el Admin) la reparte a las cajas, y las cajas pueden devolverla o pasársela entre sí. Valor por defecto:
traspaso_cajapara el Supervisor de sus PDV, Tesorería y Admin; el Cajero no (D5-3). Si el cliente quiere que solo lo haga Tesorería, es la celda del Supervisor en la matriz (una migración de datos conEnsureRolePermissions::setCells); si quiere al Cajero, es la del Cajero.¿Se sigue pudiendo fondear una caja abierta directamente, como hoy desde Saldos? (QC-43). — ⚠️ ABIERTA (2026-10-19). No bloqueante. Valor por defecto: se puede, como un atajo (D5-5): no se rompe nada ya aprobado (Saldos 6). Si el cliente quiere que todo pase por la bóveda, el cambio es rechazar
fondeosobre una caja operativa, y la pantalla de Saldos deja de ofrecerlo.Para pasar plata entre cajas, ¿alcanza con que las dos estén abiertas ese día? (QC-44). — ⚠️ ABIERTA (2026-10-19). No bloqueante. Una caja ya cerrada no puede mandar ni recibir; para sacarle plata hay que reabrirla. La bóveda no necesita sesión. Valor por defecto: así (D5-6), por ADR-013: el saldo final de un día no se mueve después de cerrado.
¿Hace falta devolver plata del PDV al país como una operación propia? (QC-45). — ⚠️ ABIERTA (2026-10-19). No bloqueante. Sacar plata de la bóveda hacia Tesorería. Valor por defecto: no hay operación propia; hoy se haría con un ajuste de la bóveda con motivo «Otro» y una descripción (y, para dar de baja un PDV, con «Retiro por baja de caja», D5-10). Si hace falta, sería una operación nueva que escriba en el ledger del país.
Resumen — qué bloquea de verdad
- No queda nada bloqueando ni pendiente de definición cerrada. Las cinco preguntas que quedaban abiertas al 2026-08-05 se cerraron el 2026-08-06: #1 (Holding global con desglose por país), #3 (Prefondeo País lo cargan Supervisor y Admin; desde B6, Tesorería y Admin), #4 (se bloquea la segunda apertura del mismo usuario), #5 (el permiso de caja acota por PDV — era un bug, ya corregido) y #8 (los países sin Caja mantienen validación contra el Prefondeo País). Las cuatro decisiones de la reunión del cliente (#12-#15) están implementadas y en
maindesde esa misma fecha. - #5 igual conserva su lugar en la auditoría de seguridad de E6: el fix cierra el agujero concreto, pero el alcance de permisos sobre plata merece una pasada completa.
- #6 pasó de "abierta" a "parcialmente resuelta": el cruce multipaís se cerró con
CASH_BOX_COUNTRY_MISMATCH; el cruce PDV↔caja dentro de un mismo país sigue sin validarse, a propósito. - El resto (#2, #7, #9, #11) son pendientes menores que no frenan nada — #9 en particular ya no incluye un mensaje falso en la app, solo falta implementar el comprobante en sí (E5).
- Las seis de B7 (#16 a #21) son confirmaciones sobre los extractos de tesorería —cuatro con el cliente y dos de permisos y trazabilidad que decide Carlos—, cada una con su comportamiento por defecto ya implementado: no frenan nada. Desde G12 (2026-10-07): la #18 y la #19 están contestadas para Guatemala por la hoja nueva del cliente, la #16 se cerró por defecto (una sola referencia), y siguen abiertas la #17 (depende de Soterex), la #20 y la #21 (de Carlos).
- La de G6 (#22) es una confirmación con el cliente sobre los PDV sin Supervisor. Con el comportamiento por defecto, el Admin destraba cualquier caja: no frena nada.
- Las dos de G7 (#23 y #24) son confirmaciones sobre lo que ya está implementado: una de Tesorería sobre el motivo «Retiro por baja de caja» y una del cliente sobre la línea de país. Ninguna frena nada: con el valor por defecto se puede dar de baja una caja y se ve la línea.
- La de G12 (#25) es una pregunta al cliente sobre un número de su hoja (32.708) que la app no muestra. No frena nada: no se implementó nada y los tres números de siempre siguen donde estaban.
Análisis Funcional: Módulo Caja — parte 7 de 7. ← UX de múltiples cajas y fondeo · Índice

