Plan — Respuesta del cliente del 14/10: Staging al día, A4, Pago 9 y la bóveda del PDV
Date: 2026-10-19
Fuentes:
- Mail de Magaly Benavides (CIS-EC) del 2026-10-14 (18:17 UTC), «RE: Herramienta Soterex Guatemala». Contesta, inline, el mail de Carlos del mismo día («Envío la actualización de lo que se encuentra instalado») e incluye cuatro capturas. No se sube al repositorio: las capturas muestran datos de beneficiarios y el mail de una persona. Este plan transcribe lo que hace falta; los MTCN se citan, los datos personales no.
- Marcas de Magaly: «OK» (verde) = acepta lo entregado; texto en rojo = pendiente o rechazado; fondo amarillo = su respuesta a una de las nueve preguntas.
- Plan de los pendientes del Excel v3 (J0 a J5: lo que este mail contesta) y plan de ajustes v3 (RV3, QC).
- Estado de
mainystagingal 2026-10-19 (verificado congitygh run list, no de memoria): ver §2.
Qué es esto. El cruce de cada línea del mail contra lo que hay hoy en el código y en Staging, y el plan de lo que falta. Está escrito para que lo ejecute otra sesión de Claude Code con Sonnet, sin preguntar: las decisiones que el plan no puede tomar por vos tienen un valor por defecto reversible (§4). El prompt para esa sesión está en 2026-10-19-prompt-ajustes-v3-respuesta-14-oct.md.
Estado de la ejecución
| Entrega | Qué | Quién | Tamaño | Estado |
|---|---|---|---|---|
| L0 | Staging al día + verificaciones + seguridad de G1 | Carlos | — | ⏳ sin hacer |
| L1 | A4 sin «Transacción fija» y lo que el cliente confirmó | Sonnet (PR A) | XS | ✅ hecha en el PR A, verificada a mano con el A4 y la tirilla de un pago de demo |
| L2 | Pago 9 (b): los documentos aparecen al tocar «Iniciar pago» | Sonnet (PR A) | S–M | ✅ hecha en el PR A; verificada a mano hasta «Pagar» → Confirmar pago (el pago de demo no se completó: la caja de demo no alcanzaba, ver el PR) |
| L3 | La bóveda del PDV (caja 0) y los traspasos | Sonnet (PR B) | L | ⏳ sin hacer |
| L4 | Pago 15 (recibo y soportes de los tres pagos) | Carlos, y Sonnet solo si se reproduce | ? | ⏳ espera a L0.4 |
| L5 | La carta al cliente (borrador) y los documentos | Sonnet (en los dos PR) | S | 🔄 parcial: el borrador de la carta viaja en el PR A; los documentos de la bóveda, en el PR B |
Resumen para Carlos
1. Lo más importante: J1, J2 y J3 no están en Staging. Tu mail del 14/10 dice «hecho e instalado en Staging» de tres cosas (nacionalidad como desplegable, A4 reordenado, fondear un PDV). No era cierto: están en main desde el PR #102, pero staging no se tocó desde el 2026-10-07. Las capturas de Magaly lo confirman (la nacionalidad sigue siendo un campo de texto, el A4 sigue con el orden viejo y el mail completo del operador, y Fondeo PDVs no tiene ningún formulario). Lo que ella marca en rojo en esos tres puntos es la versión anterior, no un rechazo. Detalle y evidencia en §2. Hay que promover a Staging y avisarle (L0), con el tono de «las capturas muestran la versión anterior; ahora sí está instalada».
2. Lo que Magaly cerró. Aceptó con «OK» los 15 ítems que estaban marcados «PENDIENTE» (Pago 6, 8, 10, 11 · Reporte individual 1 y 2 · Prefondeo 1 · Saldos 1, 2, 3, 4 y 6 · Parámetros 1 · Menús 1), los tres puntos que quedaban como están, la variante de quién cierra una caja, la propuesta de volver a subir los documentos perdidos y el envío de la muestra (Excel de Cumplimiento, PDF del A4, capturas). No hay que hacer nada más con esos ítems salvo mandarle la muestra (§3, L0.6).
3. Lo que cambió con sus respuestas a las nueve preguntas (§1.3): casi todas confirman el valor por defecto. Quedan dos cambios: sacar «Transacción fija: Sí / No» del A4 (L1) y que los documentos aparezcan recién al tocar «Iniciar pago», con un botón «Pagar» aparte (L2). Las demás (DPI sin espacios, «Sent», estados en inglés, «C-», operador de 4 caracteres en todos los formatos, ningún país dudoso) ya están así: solo hay que dejarlo escrito y fijarlo con tests.
4. Lo grande: la bóveda del PDV (L3). Magaly dice que Fondeo PDVs tiene que repensarse: Tesorería manda la plata al PDV, no a una caja; llega a una caja 0 / bóveda / líder y de ahí se reparte a las cajas, sin obligación de repartir todo. Además hay que poder pasar plata entre cajas, y de las cajas a la bóveda (el caso: un operador no pagó y el otro se quedó sin fondos). Hoy no existe nada de eso: el fondeo de J3 exige una caja ya abierta. Es un cambio de modelo (una capa más entre el país y la caja, ADR-007) y de permisos (quién traspasa). Está diseñado en §3 (L3) con valores por defecto y cuatro preguntas para ella (§5).
5. Pago 15 sigue «aún pendiente» (recibo y soportes de los tres pagos de Magaly). No sabemos si falla con el código de hoy: hay que reproducirlo en Staging después de promover (L0.4). Solo si se reproduce se escribe código (L4).
Orden recomendado:
- Hoy, L0.1 a L0.3: promover
maina Staging y verificar J1 a J3 en pantalla. Corrige lo que dijo el mail del 14/10. - Sesión A (Sonnet), PR A: L1 + L2 + el borrador de la carta (L5). Chico, sin migraciones, se promueve enseguida.
- Sesión B (Sonnet), PR B: L3, la bóveda. Después de A, en la misma carpeta y nunca a la vez (el stack local es uno).
- L0.4 (reproducir Pago 15) apenas Staging esté al día; L4 solo si falla.
- L0.5 (seguridad de G1) antes de que el cliente vuelva a subir documentos con datos reales.
Lo que necesito de vos (todo con recomendación y valor por defecto en §4): D5-0 a D5-10. Las que más importan: D5-3 (quién puede traspasar: Supervisor, Tesorería y Admin) y D5-5 (si se mantiene el fondeo directo a una caja).
1. Qué dice el mail, línea por línea
1.1 Los 15 ítems «PENDIENTE» del 5/10 y el pedido de volver a probar (§1 de la carta)
Todos en OK: Pago 6, 8, 10 y 11 · Reporte individual 1 («Procesada por») y 2 (PDV) · Prefondeo 1 · Saldos 1, 2, 3, 4 y 6 · Parámetros 1 · Menús 1. «Volver a subir los documentos que se hayan perdido»: OK. → Cerrados. No se toca nada.
1.2 Los tres puntos que quedan como están (§2) y la variante de quién cierra una caja (§3)
Pago 9 (se contesta en la pregunta 1, abajo) · catálogo de formas de pago (OK: solo efectivo) · selector de perfil (OK: se suman las opciones) · quién cierra una caja (OK: quien la abrió, un Supervisor o un Admin del PDV). → Cerrados.
1.3 Las nueve preguntas (§5)
| # | Pregunta | Respuesta de Magaly | Qué implica | Dónde |
|---|---|---|---|---|
| 1 | Documentos al consultar (Pago 9) | (b) la sección de documentos aparece recién al tocar «Iniciar pago». «Seguramente habrá que incluir un botón adicional para PAGAR y continuar con el proceso» | Cambio de flujo en la pantalla Pago | L2 |
| 2 | Países sin cargar (Chipre del Norte, Irlanda del Norte, Somalilandia, el #216 «Santo Tomas») | «Quitemos esos países hasta que sean necesarios» | Ninguno está cargado (están en la lista de dudosos de catalogo_paises_cumplimiento.php, sin cargar). Solo hay que fijarlo con un test | L1 |
| 3 | DPI con espacios | El formulario los quita | Ya está así (sinSeparadores, QC-30). Verificar | L1 |
| 4 | Transaction Status | «Sent» | Ya está así (ESTADO_ENVIADO). Hay que sacar el «NO SE TOCA hasta QC-19» del código | L1 |
| 5 | Transaction Status - Update | En inglés, tal como lo envía Soterex | Ya está así (Pending / Paid / Cancelled). Sacar el «NO SE TOCA hasta QC-20» | L1 |
| 6 | «Transacción fija: Sí / No» del A4 | «Eliminar ese texto» | Cambio en papeleta-a4-copia.blade.php:104 | L1 |
| 7 | Prefijo «C-» | «Prefijo enviado por Soterex; si ellos no lo requieren, quitarlo; si no, mantenerlo» | Se mantiene (CUMPLIMIENTO_MTCN_PREFIX). Depende de lo que conteste Soterex (S-2): si dice que ya no lo usa, se vacía el env. Sin código | L1 (comentario) |
| 8 | Operador del recibo | Primeros 4 caracteres del correo, el resto oculto, dominio incluido, para todos los formatos | Ya está en A4 y tirilla (J1, PapeletaService::enmascararOperador). Falta promover | L0 |
| 9 | Fondear un PDV: ¿caja abierta o plata al PDV antes de que abra? | Plata al PDV primero, y después se reparte, con la posibilidad de no repartir todo (§1.4) | Cambio de modelo | L3 |
1.4 Los cuatro pedidos nuevos (§4), con lo que dice Magaly en rojo
| Pedido | Lo que dice Magaly | Qué es en realidad | Entrega |
|---|---|---|---|
| Pago 13, nacionalidad como desplegable | «Aún está como texto para ingresar» (captura de un campo de texto) | La captura es de Staging sin J2. Falta promover | L0 |
| Pago 14, A4 reordenado | «Aún está sin el orden requerido» (dos capturas, una de un pago nuevo del 14/10 11:57 y una reimpresión) | Staging sin J1: las dos capturas muestran el orden viejo y el mail completo del operador (…@…). Falta promover | L0 |
| Prefondeo 2, fondear un PDV | «Aún pendiente la opción en la pestaña PDV, pero es necesario repensar esta parte…» (captura de Fondeo PDVs sin formulario) | Dos cosas: (1) Staging sin J3; (2) aun con J3, no es lo que quieren: ver abajo | L0 y L3 |
| Pago 15, recibo y soportes de los tres pagos | «Los tres primeros ya se pueden probar; les pedimos que los incluyan en la nueva ronda de pruebas. – aún pendientes» | No dice si siguen fallando o si todavía no los probaron. Hay que reproducirlo con el código de hoy | L0.4 / L4 |
Lo que Magaly pide para Prefondeo 2, textual (es la especificación de L3): «Tesorería prefondea al PDV, pero el dinero le llega al PDV y recién ahí se decide a qué caja/s se distribuye el dinero, es necesario tener una caja 0 / bóveda / líder donde llegue el dinero para el PDV y de esa caja se pase dinero al resto de cajas. Igualmente debe poder pasarse dinero entre cajas o del resto de las cajas a la cero, por ejemplo para cuando un operador no haya pagado y el otro se haya quedado sin fondos.» Y en la respuesta 9: «con la posibilidad de no repartir todo en las cajas».
1.5 La muestra para validar (§6)
«OK, ahora que está todo instalado les mandamos el Excel de Cumplimiento y el PDF del A4 con datos de prueba, más capturas del menú y de los estados de cuenta». → Hay que mandarla después de promover (el A4 tiene que salir con el orden nuevo y sin «Transacción fija»). Con transacciones de prueba o con los datos tapados. Es L0.6.
2. Hallazgo: Staging no tiene J1, J2 ni J3
Verificado el 2026-10-19:
git fetch origin
git log origin/staging..origin/main --oneline # lo que main tiene y Staging no
git diff --stat origin/staging origin/main -- backend frontend
gh run list --workflow=deploy-staging.yml --branch staging --limit 3origin/maintiene 10 commits questagingno tiene. Cuatro traen código:887aac2yad757a3(J1, A4 y operador enmascarado),b625ba4(J2, nacionalidad) y69f723f(J3, fondeo desde Fondeo PDVs), más el merge4422c35(PR #102); los otros cinco son documentación. El diff de código son 16 archivos debackend/yfrontend/. (stagingtiene además 26 commits quemainno tiene, pero son solo los merges de cada promoción: no hay código ahí.)- El último deploy a Staging es del 2026-10-07 21:38 UTC (corrida 37690884664, «Merge pull request #100», que solo trajo documentación). Antes, el del PR #96 (G1 a G12). El deploy es automático con el push a
staging; nadie lo hizo para #102. - El mail de Carlos del 14/10 11:18 dice que J1 a J3 están «instalados en Staging». El commit
11aa862(«la carta al cliente dice que J1 a J3 ya están instalados en Staging») deja ese mismo texto en el plan. Lo que no pasó es el paso intermedio: el PR demainastaging. La carta y el plan se escribieron dando por hecho un deploy que no se había hecho. - Las capturas de Magaly (14/10, posteriores al mail) muestran exactamente la versión del 07/10.
Consecuencia para la carta: hay que decirlo sin vueltas y sin dramatizar. Algo así: «Las capturas que nos mandaron muestran la versión anterior: la actualización de esos tres puntos recién quedó instalada el [fecha]. Por favor vuelvan a probarlos.» La carta de L5 lo trae escrito.
Qué corrige L0: promover (main → staging) y verificar los tres puntos en pantalla antes de mandar nada. La regla que falló: no se escribe «instalado» hasta ver el deploy en verde y el cambio en pantalla. Va en el prompt de la sesión que redacte la carta.
3. Entregas
L0 — Staging al día, verificaciones y seguridad (lo hacés vos; sin código)
Todo esto es tuyo: promover a Staging necesita tu OK explícito (CLAUDE.md) y las sesiones de Sonnet no lo hacen.
- L0.1 Confirmar el atraso. Los dos comandos de §2.
- L0.2 Promover. PR de
mainastagingcon el mismo formato de los anteriores (gh pr create --base staging --head main --title "Promover a Staging: J1 a J3 (A4, nacionalidad, Fondeo PDVs)"). J1 a J3 no traen migraciones, así que el riesgo del deploy es el de siempre (Aurora dormida, verdoc/environments/staging.md). Mirá el deploy hasta el final:gh run watchsobre la corrida dedeploy-staging.yml. Recomendación D5-0: promover hoy, sin esperar al PR A, porque el cliente está esperando poder probar y lo que dijimos el 14/10 sigue siendo falso mientras no lo hagas. Después se promueve de nuevo con el PR A, y otra vez con el PR B (cada deploy tarda 10 a 20 minutos). - L0.3 Verificar en pantalla (con un usuario de prueba; datos inventados, nada de datos reales):
- A4 (J1): generar el A4 de un pago. De arriba abajo: agencia · ciudad · operador; MTCN · fecha; remitente; el bloque del beneficiario; montos; declaración y firmas. El operador sale como
back••••(4 caracteres y «••••»), también en la tirilla de 58 mm. Reimprimir uno viejo: sale con el orden nuevo. - Nacionalidad (J2): en Pago, el campo es un desplegable de países, el mismo que «País de la identificación».
- Fondeo PDVs (J3): pestaña PDV, con Tesorería o Admin, aparece «Fondear caja» (esto es lo que L3 va a reemplazar; no se prueba más que para confirmar que está instalado).
- A4 (J1): generar el A4 de un pago. De arriba abajo: agencia · ciudad · operador; MTCN · fecha; remitente; el bloque del beneficiario; montos; declaración y firmas. El operador sale como
- L0.4 Reproducir Pago 15 (la parte J0.3 del plan anterior). Entrar con el usuario de Magaly (Cajero · GT) y abrir en Pago los tres MTCN: 8377395541, 9886366176 y 6872628774. Mirar tres cosas en cada uno: los datos del pago, los soportes y los dos botones de papeleta.
- Todo carga → se cierra el ítem. Si faltan archivos es porque se subieron antes de G1 (S3) y se perdieron: se vuelven a subir (ella ya aceptó hacerlo).
- Falla → anotá
GET /api/transacciones/{id}/documentosy la descarga de la papeleta (DevTools › Red): un 404 concodees de alcance; un 500 está en CloudWatch. Anotá también las asignaciones del usuario (país, PDV, PDV activo). Con eso arranca L4.
- L0.5 Seguridad de G1, antes de que el cliente vuelva a subir documentos. El PR #101 (revisión de
securityde G1) sigue abierto y sin mergear. Marca dos exposiciones que pueden estar activas hoy en Staging: SEC-18 (las contraseñas de las cuentas de prueba en una documentación publicada) y SEC-05 (la llave de Firebase con alcance de Admin SDK como secret del repo), y dice que no se carguen datos reales hasta cerrar SEC-13, SEC-15, SEC-18 y SEC-04. Magaly ya aceptó volver a subir documentos (identificaciones): decidí con cuáles de esas cuatro vas a convivir antes de mandar la carta. Este plan no las resuelve. - L0.6 La muestra. Después de L0.2: el Excel de Cumplimiento y el PDF del A4 (los dos con transacciones de prueba), más capturas del menú de cada perfil y de los cuatro estados de cuenta. Necesitan OK explícito de cada uno (ya dijeron que sí). Las genera quien tenga acceso a Staging; no hay comando que lo haga.
- L0.7 Mandar la carta del PR A (L5). Es un borrador: no se manda solo.
L1 — A4 sin «Transacción fija» y lo que el cliente confirmó · XS · PR A
Es lo único de las nueve respuestas que cambia código en el backend (más la pregunta 1, que es L2).
- Sacar «Transacción fija: Sí / No» de
backend/resources/views/pdf/partials/papeleta-a4-copia.blade.php:104. Esa fila tiene dos celdas (Transacción fija y Tipo de transacción): queda solo Tipo de transacción, sin dejar un hueco ni cambiar el alto de la copia (el A4 tiene dos copias por hoja y una altura fija: ver el comentario depapeleta-a4.blade.php:8). La tirilla (papeleta.blade.php) no lo imprime.- Tests:
backend/tests/Feature/PapeletaFormatosTest.php— que el texto «Transacción fija» no aparezca en el A4 ni en la tirilla. - Documentación:
doc/manual/10-pago.mdy el funcional de la papeleta (doc/functional/2026-08-07-pago-con-documentos/), donde se describa el A4.
- Tests:
- Dejar por escrito lo que el cliente confirmó (sin cambiar comportamiento):
backend/app/Services/ReporteCumplimientoService.php:96-111ybackend/app/Http/Controllers/ReporteCumplimientoController.php:41: los comentarios dicen «NO SE TOCA hasta QC-19 / QC-20». Pasan a decir que el cliente confirmó el 2026-10-14: «Sent» y Pending / Paid / Cancelled, en inglés, como los envía Soterex. Un test que fije los dos valores si no hay uno.backend/config/cumplimiento.php(prefijo «C-»): agregar que el cliente lo mantiene mientras Soterex lo envíe (14/10) y que, si Soterex dice que no, se apaga conCUMPLIMIENTO_MTCN_PREFIX=vacío. No cambia ningún valor.- Países: un test que fije que no están cargados Chipre del Norte, Irlanda del Norte, Somalilandia ni el #216 «Santo Tomas» (hoy solo están en la lista de dudosos de
backend/database/data/catalogo_paises_cumplimiento.php, que no se carga). - DPI con espacios: ya lo quita el formulario (
frontend/src/utils/formatoIdentificacion.ts,sinSeparadores). Solo verificar que hay test y que el manual lo dice.
- No tocar: el enmascarado del operador (J1) ni nada de la tirilla.
L2 — Pago 9 (b): los documentos aparecen al tocar «Iniciar pago» · S–M · PR A
Pedido (la respuesta 1): al consultar una transacción no se muestran los documentos que alguien subió en una visita anterior. Los documentos aparecen recién al tocar «Iniciar pago», y hace falta un botón adicional «Pagar» para continuar. Es solo frontend: frontend/src/views/PagoView.vue (y MatchResultCard.vue).
Hoy (PagoView.vue:546-588): con una ACCEPTED se ven siempre, en este orden, los datos de Soterex, DatosPagoForm y DocumentacionPrePago. «Iniciar pago →» (en MatchResultCard) está deshabilitado hasta que todo esté completo (puedePagar exige prePagoCompleto) y, al tocarlo, abre el modal de confirmación (showConfirmPay).
El problema de diseño: si los documentos solo aparecen después de «Iniciar pago», ese botón no puede seguir exigiendo los documentos (nadie podría subirlos). Hay que partir la condición en dos.
Diseño (D5-1 a, la lectura más literal y la más conservadora):
- Estado nuevo
pagoIniciado(ref booleano), se reinicia al cambiar de resultado (en el mismowatch(resultadoActual)que reiniciaprePagoCompleto). puedeIniciar=puedeOperary los datos del pago completos y guardados y sin formato inválido y la caja no vencida y el MTCN no vencido. Es elpuedePagarde hoy sinprePagoCompleto.puedePagar=puedeIniciaryprePagoCompleto.- «Iniciar pago →» (
@pagardeMatchResultCard) ahora hacepagoIniciado = true: no abre el modal. ConpagoIniciadoel botón se oculta o queda como «Pago iniciado». DocumentacionPrePagose muestra solo conpagoIniciado(hoy:v-if="resultadoActual?.status === 'ACCEPTED'"). Así no se traen los documentos viejos al solo consultar.- Botón nuevo «Pagar», debajo de la sección de documentos, visible con
pagoIniciado. Habilitado conpuedePagar; deshabilitado, muestra el motivo (motivoNoPuedePagar, que sigue diciendo «Faltan documentos: …»). Al tocarlo abre el modal de confirmación de hoy (showConfirmPay = true): medio de pago (solo Efectivo) y confirmar. Nada de esto cambia en el backend:pay()sigue exigiendo los documentos (ADR-008, no se reabre). - «Datos del pago» queda visible antes de iniciar (D5-1 a). Alternativa b: que también aparezca al iniciar; es una línea (mover el
v-if), pero Magaly pidió solo los documentos. motivoNoPuedePagarhoy mezcla motivos de iniciar y de pagar: el texto bajo «Iniciar pago» no tiene que decir «Faltan documentos» (todavía no se ven). SepararmotivoNoPuedeIniciarymotivoNoPuedePagar.- Un botón chico «Volver a la consulta» (opcional) que pone
pagoIniciado = falsesin perder lo guardado.
Alcance (D5-2): solo la pantalla Pago. TransaccionDetalleView.vue (que usa DocumentacionPrePago y DatosPagoForm para el Admin) no cambia: el cliente habla de «Pago 9» y el ítem es de esa hoja. Dejarlo anotado en el PR.
Cuidado con lo que se apoya en esa pantalla:
- El recorrido guiado (
frontend/src/tours/pago.ts, ADR-009) ancla a controles reales condata-tour. Si algún paso apunta a la sección de documentos, ya no existe hasta iniciar el pago: verfrontend/src/tours/__tests__y ajustar el paso (el runner saltea lo que no encuentra, pero el texto tiene que seguir siendo verdad). - Tests existentes (
PagoView.spec.ts,MatchResultCard.spec.ts) asumen «Iniciar pago» → modal. Se reescriben, no se borran:- consulta: no se ven los documentos; «Iniciar pago» habilitado con los datos completos;
- tras iniciar: se ven los documentos y «Pagar»; «Pagar» deshabilitado hasta que estén completos, con el motivo;
- «Pagar» abre el modal; la caja vencida y el MTCN vencido siguen bloqueando «Iniciar pago»;
- un resultado nuevo reinicia
pagoIniciado.
- Manual y ADR:
doc/manual/10-pago.md(el paso a paso) y una nota «Actualización» en ADR-008 (los documentos siguen bloqueando confirmar el pago; solo cambió cuándo se ven). No hace falta un ADR nuevo: no se revierte nada.
L3 — La bóveda del PDV (caja 0) y los traspasos · L · PR B
Es la entrega que contesta Prefondeo 2 y la respuesta 9. Cambia el modelo de plata (ADR-007) y agrega un permiso: leé el ADR-007, el ADR-013 y el ADR-022 antes de empezar, y doc/functional/2026-08-05-modulo-caja/01-modelo-de-saldos.md (el circuito completo, 1.10).
L3.0 El modelo, en una imagen
Holding (global)
└── Prefondeo País (disponible para distribuir = saldo del país − lo repartido)
└── PDV: BÓVEDA (caja 0) ← Tesorería manda la plata acá (FONDEO, sin caja abierta, sin sesión)
├── Caja 1 ← traspaso desde la bóveda (o entre cajas, o de vuelta a la bóveda)
└── Caja 2- Hoy: país → caja (
FONDEOsobre una caja con sesión abierta hoy). Un pago descuenta la caja del operador y el principal del país. - Con L3: país → bóveda del PDV → cajas. Los pagos siguen saliendo solo de una caja operativa (la bóveda no paga). Las invariantes de ADR-005 y ADR-007 no cambian: ningún saldo se guarda (se deriva sumando el ledger), el ledger es inmutable, mover plata dentro del país no descuenta el saldo del país, y
saldo del país = distribuido + disponible para distribuir. - Lo repartido (
CountryPrefundingService::distributedInCashBoxes) pasa a incluir la bóveda: es plata del país que ya está en el PDV. No hay que cambiar la fórmula, porque la bóveda es unaCashBoxy suma como cualquier otra. Un traspaso nunca cambia ni el saldo del país ni lo distribuido (suma cero dentro del mismo país).
L3.1 Datos (migraciones portables)
Portabilidad (importante). El cliente corre en AWS/PostgreSQL hoy, pero hay una migración a Azure/MySQL abierta (PRs #110 a #118, sin mergear). Las migraciones nuevas usan solo el schema builder de Laravel: nada de SQL crudo de PostgreSQL (
::,ILIKE, índices parciales,jsonb). El Azure se traemaincon merge y no tiene que romperse por esto.
- La bóveda es una
CashBoxconnumber = 0. No lleva columna nueva: la unicidad(station_id, number)ya garantiza una por PDV. En el modelo, una sola definición:CashBox::NUMBER_BOVEDA = 0,isBoveda()y scopesboveda()/operativas(). Las cajas operativas siguen siendo 1, 2, 3… y nunca se reutilizan. cash_movements:cash_session_idpasa a nullable (la bóveda no abre ni cierra). Invariante: esnullsi y solo si la caja es la bóveda. No hayCHECKportable: lo fijan el código y un test.transfer_id(uuid, nullable, con índice): une las dos patas de un traspaso.counterpart_cash_box_id(uuid, nullable, FK acash_boxes): la otra caja, para escribir «desde Bóveda» o «hacia Caja 2» sin un join.- Tipo nuevo
TRASPASO: una sola clase de fila con signo (comoAJUSTE): sale con signo negativo de la caja de origen y entra con signo positivo a la de destino.CashMovement::$fillabley losTYPE_LABELS(hay tres copias:CashBoxController,CajaReportesControlleryTreasuryStatementService::cashConcept) lo conocen. CashMovement::MOTIVOS_TRASPASO(catálogo cerrado, como fondeo y ajuste):Reposición de fondos,Devolución de fondos,Otro(D5-7).Otropidemotivo_detalle. Va enCashMovement::motivosFor().
- Migración de datos (idempotente, "crea lo que falta y no pisa"): una bóveda por cada PDV cuyo país tiene
modulo_caja = truey que no la tenga (activo o no: la historia no desaparece). Con los helpers debackend/app/Support/DataMigrations/, como en B1.2. - Permiso nuevo
traspaso_caja(D5-3): también por migración de datos conEnsureRolePermissions::forModule(el deploy no corre seeders, verdoc/environments/staging.md), másRoleSeeder::MATRIX,PermissionModules.php,doc/architecture/matriz-de-perfiles.jsony las tablas de ADR-014 y del manual. Seguí el camino dereporte_cumplimiento(2026_10_02_110000_b4_permiso_reporte_cumplimiento.php,ModulosDePermisosApiTest,PerfilesMigrationTest). Valores[leer, escribir, borrar]: Cajero[0,0,0]· Supervisor[1,1,0](de sus PDV) · Tesorería[1,1,0]· Admin[1,1,1]. Al terminar,php artisan permisos:diferenciastiene que decir «Sin diferencias». - Dónde nacen las bóvedas nuevas. Hoy
CashBoxService::ensureCashBoxesForCountryyensureCashBoxForStationcrean la caja 1. Tienen que crear bóveda y caja 1 al activarmodulo_cajay al dar de alta un PDV de un país con Caja. Cuidado, trampa conocida:ensureCashBoxesForCountryusadoesntHave('cashBox'), yStation::cashBox()es unHasOnesin orden: con la bóveda presente ya no distingue «PDV sin ninguna caja» de «PDV con solo la bóveda». Hay que contar solo las operativas. Revisá todo uso decashBox()/doesntHave('cashBox')(grep -rn "cashBox()" backend/app). - Seeders y demo (
DemoReseedCommand,DemoSeedAcceptedCommand,StationSeeder): que los PDV de demo tengan su bóveda. Nunca correrdemo:reseedsobre la base de dev (regla de los prompts anteriores).
L3.2 Reglas del backend
Fondeo y ajuste sobre la bóveda (CashBoxController::fondeo / ajuste, mismos endpoints, mismo permiso fondeo_caja:write, mismo alcance por PDV): no exigen sesión abierta (no hay), cash_session_id = null, motivo del catálogo de fondeo. El aviso posterior OVER_COUNTRY_PREFUNDING sigue igual (alerta, no bloqueo, ADR-007 §3). El ajuste no puede dejar la bóveda en negativo (ADJUSTMENT_WOULD_GO_NEGATIVE). Apertura y cierre de la bóveda: 422 con un código propio (CASH_BOX_IS_VAULT).
Traspaso — endpoint nuevo POST /api/caja/traspaso, con perm:traspaso_caja,write y el alcance fino por PDV (lo mismo que authorizeStationScope, pero con el módulo traspaso_caja):
| Entrada | Regla |
|---|---|
from_cash_box_id, to_cash_box_id | Distintas (TRANSFER_SAME_BOX) y del mismo PDV (TRANSFER_DIFFERENT_STATION). Entre PDV no hay traspasos |
amount | > 0. No puede superar el saldo de origen (TRANSFER_EXCEEDS_BALANCE, 422): no existe «menos cero» en un cajón (misma regla que el ajuste) |
| Cajas | Las dos operables (CashBox::scopeOperable, CASH_BOX_INACTIVE) |
| Sesiones | Cada extremo que no sea la bóveda tiene que tener una sesión abierta hoy (CASH_SESSION_CLOSED; vencida: CASH_SESSION_FROM_PREVIOUS_DAY, el mismo cuerpo de CashBoxService::fromPreviousDayError). La bóveda no necesita ninguna (D5-6) |
motivo, motivo_detalle | Catálogo MOTIVOS_TRASPASO; Otro exige detalle |
Escribe dos filas (TRASPASO, una negativa y una positiva, mismo transfer_id, cada una con su counterpart_cash_box_id) dentro de una transacción, y una entrada de auditoría CASH_TRANSFERRED (origen, destino, monto, motivo, transfer_id). Concurrencia: tiene que serializarse con un pago y con otro traspaso de la misma caja. pay() bloquea la sesión de la caja del operador (CashSession::abiertaDe(...)->lockForUpdate(), TransactionController::applyCashBoxDiscount). El traspaso bloquea, en orden fijo por cash_box_id, las sesiones abiertas de los extremos operativos y la fila de cash_boxes de la bóveda, y relee los saldos adentro de la transacción. Un test con saldo justo que no deje pasar dos traspasos que juntos exceden el saldo.
Lecturas:
GET /caja/disponibles: cada caja traeis_vault. La bóveda solo la recibe quien ve todas las cajas del PDV (PermissionService::canSeeAllCashBoxes: Supervisor, Tesorería, Admin). El Cajero nunca la ve, ni su saldo, ni en el selector de apertura.sessionesnullen la bóveda.GET /caja/totales-pdv: el total del PDV incluye la bóveda; «cajas abiertas» no la cuenta (no es «2 de 3» con la bóveda de tercera). Sumar al payload el desgloseboveda_balance/cajas_balance.GET /caja/motivos?type=TRASPASO(hoyCashBoxController::motivosvalidain:FONDEO,AJUSTE, ycajaApi.motivossolo acepta esos dos: los dos se amplían);GET /caja/{id}/movimientosy los exports: etiquetaTraspaso, filtro por tipo, y en el concepto la contraparte («desde Bóveda», «hacia Caja 2»).StationController::cajas(ABM Estaciones): la bóveda sale marcadais_vault;actualizarCajala rechaza (la bóveda no se activa ni se desactiva).CashBoxService::bloqueoParaDejarSinOperaryhasBalanceya miran todas las cajas del PDV: una bóveda con plata bloquea desactivar el PDV, mudarlo de país o apagar el módulo Caja del país (STATION_HAS_CASH_BALANCE,COUNTRY_HAS_CASH_BALANCE). Pero el camino de salida que documentan esos errores («abrí la caja, ajustá con Retiro por baja de caja, cerrala») es imposible para la bóveda: no se abre. Se resuelve así (D5-10): el ajuste negativo con el motivoRetiro por baja de cajase acepta sobre la bóveda sin sesión, con el mismo permiso (fondeo_caja:write), y los textos de esos errores yPASOS_PARA_DEJAR_EN_CERO(frontend) distinguen el caso de la bóveda («retirá el saldo de la bóveda con un ajuste»). La bóveda se vacía antes que las cajas o después: da igual, solo cuenta que el total quede en cero.TransactionController::pay: sin cambios de lógica (la bóveda no tiene sesión, así queabiertaDenunca la elige). Solo el texto deINSUFFICIENT_CASH_BALANCE: agregar «Pedile a tu Supervisor que te pase fondos desde la bóveda».
Extractos y reportes (ADR-015: son vistas derivadas del ledger; no se guarda ningún saldo):
- Extracto del país (
TreasuryStatementService::country) y del PDV (::station): excluyenTRASPASO. En el país y en el PDV suman cero y solo meten ruido (dos líneas que se anulan y débitos y créditos inflados). El saldo corrido tiene que seguir cerrando contraCashBoxService::balanceForStationy contradistributedInCashBoxes(los tests de B7 ya lo verifican: que sigan verdes). - El extracto del PDV muestra los movimientos de la bóveda con su caja rotulada «Bóveda» (hoy rotula «Caja N»). Un fondeo a la bóveda es un crédito del PDV y un débito del disponible del país, como cualquier fondeo.
- Reporte de Cajas (
CajaReportesController): el resumen y el detalle incluyen la bóveda como una fila más, rotulada «Bóveda». Cierres por día no tiene filas de la bóveda (no tiene sesiones) y sumatotals.traspaso(neto, con signo) para queapertura + fondeos + ajustes + traspasos + pagos = cierresiga cerrando; columna nueva en pantalla y en el Excel/PDF.
L3.3 Pantallas
CajaView.vue(Saldos). Dentro de un PDV, la bóveda va primero, como una tarjeta distinta de las cajas (título «Bóveda del PDV», con «Caja 0» entre paréntesis la primera vez): saldo, historial de movimientos y el bloque manual de fondeo y ajuste siempre habilitado (no depende de una sesión). Solo la ven los perfiles que ven todas las cajas. Un bloque nuevo «Pasar plata entre cajas», visible conmeStore.canWrite('traspaso_caja'): origen, destino (la bóveda y las cajas con sesión abierta hoy), monto, motivo. Errores con los mensajes del backend; después de un traspaso se refrescan saldos e historial. El Cajero no ve nada de esto.PrefondeoPaisView.vue, pestaña PDV (Fondeo PDVs). El formulario de J3 («Fondear caja», que exige una caja abierta) se reemplaza por «Fondear PDV»: monto y motivo, y la plata va a la bóveda del PDV elegido, sin caja abierta y sin sesión (D5-9). Debajo, una línea que manda a Saldos para repartirla. Sigue yendo a la derecha de los filtros en pantallas anchas. El avisoOVER_COUNTRY_PREFUNDINGse muestra igual. El Supervisor no lo ve (no tienefondeo_caja:write). La tarjeta de arriba del extracto («Monto actual: lo que tiene el PDV en sus cajas») pasa a decir «bóveda y cajas» y suma el desglose de L3.2.- Textos que dicen «cajas» y ahora son «PDV»: «Distribuido en cajas» (tarjeta del país, pestaña País) pasa a «Distribuido en PDVs». Es solo la etiqueta: el número es el mismo.
ExtractoTesoreria.vue: el rótulo de la caja en las líneas, «Bóveda» cuando es la 0.- ABM Estaciones (
AdministrarCajas.vue): la bóveda aparece primero, sin botón de activar/desactivar y con el texto «Es el fondo del PDV: no se abre ni se cierra». - Auditoría (
AuditoriaView.vue): la acciónCASH_TRANSFERREDcon su etiqueta (el filtro multi-select las lista a mano). services/caja.ts: tipos (is_vault,boveda_balance) ycajaApi.traspaso().- Recorrido guiado (
frontend/src/tours/caja.tsyprefondeo.ts): si algún texto dice que se fondea una caja desde Fondeo PDVs, corregirlo. No agregar pasos nuevos.
L3.4 Pruebas obligatorias
Backend (CashBoxApiTest y archivos nuevos):
- la migración crea la bóveda de cada PDV con Caja, es idempotente y no toca PDV de países sin Caja; el alta de un PDV nuevo y activar
modulo_cajacrean bóveda y caja 1; - fondeo y ajuste sobre la bóveda sin sesión (
cash_session_id = null); apertura y cierre de la bóveda dan 422; el Cajero no la recibe en/caja/disponiblesy recibe 403 en el traspaso; - traspaso: bóveda → caja, caja → caja, caja → bóveda; suma cero (
Σ amount_localde las dos filas = 0); no cambia el saldo del país nidistributedInCashBoxes; todos los errores de la tabla (misma caja, otro PDV, monto mayor al saldo, sesión cerrada, sesión vencida, caja inactiva, motivo fuera de catálogo,Otrosin detalle); - alcance: un Supervisor no traspasa en un PDV que no es suyo; una Tesorería de un solo país no traspasa en otro país (el mismo criterio de alcance de G12);
- concurrencia: dos traspasos que juntos exceden el saldo, uno solo pasa;
- extractos: sin líneas de traspaso, el corrido cierra contra el saldo del PDV y del país; Cierres por día suma
traspaso; actualizarCajarechaza la bóveda; desactivar un PDV con la bóveda con plata está bloqueado;permisos:diferenciaslimpio y la migración de permisos idempotente y auditada.
Frontend (CajaView.spec.ts, PrefondeoPaisView.spec.ts, ExtractoTesoreria.spec.ts, el de ABM Estaciones): la tarjeta de la bóveda y el formulario de traspaso (y que el Cajero no los ve), «Fondear PDV» manda el fondeo a la bóveda y ya no pide una caja abierta, los rótulos «Bóveda» y «Distribuido en PDVs».
L3.5 Documentación (va en el mismo PR)
- ADR nuevo:
ADR-029(no024a028: están reservados por los branches de la migración a Azure, sin mergear). Registra la bóveda, el tipoTRASPASO, que la bóveda no tiene sesión, que los traspasos no aparecen en los extractos, el permisotraspaso_cajay que fondear directo una caja se mantiene (D5-5). Va endoc/architecture/index.md. Nota «Actualización» en ADR-007 (la tercera capa ahora tiene una bóveda entre el país y la caja) y en ADR-013 (la bóveda no está sujeta a la regla del día). - Funcional de Caja (
doc/functional/2026-08-05-modulo-caja/): el circuito 1.10 de01-modelo-de-saldos.mdcon la bóveda, los flujos de02-flujos-caja.md, y las preguntas nuevas en06-preguntas-abiertas-caja.md. - Manual (
doc/manual/):30-caja.md,32-caja-fondeo.md,41-prefondeo-pais.md,01-perfiles-y-menu.mdy una página nueva33-caja-traspasos.mdconmodulo: traspaso_caja(el manual se filtra por módulo de permiso; mirá cómo lo hacefrontend/src/utils/manual.tsy sus tests). Los PDF por perfil se generan conphp artisan manual:generar-pdf: ver si se commitean o no antes de correrlo. - Plan de pruebas de QA en
doc/qa/2026-10-19-l3-boveda-plan-de-pruebas.md, con el formato de los de G6 y G7. doc/environments/staging.md: al desplegar L3 cambian permisos de usuarios reales (el Supervisor gana «Pasar plata entre cajas»; el deploy deja un evento de AuditoríaROLE_PERMISSION_GRANTED_BY_MIGRATIONpor cada celda), igual que pasó con B6 y G8: avisar antes.CLAUDE.md: un bullet corto en «Estado actual» (no se copia el plan). Lo hace solo el PR B, para no chocar con el A.
L3.6 Revisión
Toca plata y permisos: code-reviewer sobre el diff y la lente de security sobre el alcance (quién traspasa dónde) y las condiciones de carrera. No se mergea sin tu OK.
L3.7 Lo que la bóveda rompe, según el relevamiento del código (checklist obligatoria)
Una revisión independiente del código (solo lectura, 2026-10-19) buscó todo lo que se rompe o miente con cajas number = 0 y movimientos sin sesión. Esto es lo que encontró; cada línea se cierra en el PR o se explica por qué no. Las líneas son de main al 2026-10-19.
Lo más riesgoso (en este orden):
- La bóveda se podría abrir y pagar.
CashBoxController::apertura(:394-476) no rechazanumber = 0: quien tengaapertura_cierre_caja:writeen el PDV (un Cajero incluido) abriría la bóveda, vería su saldo, yTransactionController::applyCashBoxDiscount(:665-753) escribiría unPAGOcontra ella. Doble guarda: 422CASH_BOX_IS_VAULTenaperturay un chequeo defensivo enapplyCashBoxDiscount(si la caja de la sesión es la bóveda, no paga). Y que la pantalla no ofrezca «Abrir caja» sobre ella. - Fondeo y ajuste exigen sesión (
:704-761,:772-837) y escriben$session->id: sin una rama sin sesión, la bóveda no se puede fondear. Es el flujo principal de L3. - Bloqueo al desactivar (
CashBoxService.php:99-131,StationController.php:102,153,257,CountryController.php:110-116,162): ver L3.2. - Traspasos en reportes y extractos: los totales de
CajaReportesController(:398-403Cierres y:444-449resumen) solo suman fondeo, ajuste y pago, y el saldo incluye el traspaso: la fila no concilia. Sumantraspaso.session_statusde la bóveda hoy daría «CLOSED» (:443): que sea otro valor y se rotule «—». - Las bóvedas no nacen solas: ver L3.1. Los tres puntos de alta que crean solo la caja 1 son
StationController::store(:63-65), mudar un PDV de país (:115-121) yCountryControlleral activar el módulo (:139-141, víaensureCashBoxesForCountry), y los PDV existentes no tienen bóveda hasta la migración de datos.
Backend, el resto:
CashBoxController::validateMovementFilters(:880) valida el tipo conRule::in(array_keys(TYPE_LABELS)): sinTRASPASOahí, el filtro da 422. LosTYPE_LABELSdeCashBoxController(:966) y deCajaReportesController(:38) yTreasuryStatementService::cashConcept(:609) son tres copias.currencyes NOT NULL encash_movements: las dos patas del traspaso llevan la moneda de pago del país, la misma. Si no, el total distribuido no suma cero.totalesPorPdv(:165-204):total_cash_boxesyopen_cash_boxesno cuentan la bóveda («2 de 3 cajas abiertas» con la bóveda de tercera sería mentira); elbalancedel PDV sí la incluye. Un PDV cuya única caja operable es la bóveda sí tiene tarjeta (Tesorería tiene que poder fondearlo). No saques la bóveda deCashBox::scopeOperablepara esconderla: la línea del país con alcance parcial (:266, suma de las cajas visibles) dejaría de coincidir con la de alcance completo (distributedInCashBoxes, que suma todo el ledger). Una sola definición para las dos.disponibles(:55-98): la bóveda sale conis_vault, y no se le manda al Cajero (ni conbalance: null: tampoco su existencia). El frontend no adivina connumber === 0. Hay un test de N+1 sobre/caja/disponibles(CashBoxApiTest.php, ~:2535-2565): no agregues una consulta por caja.- Rótulos «Caja 0»: aparecen en
CajaReportesController(:93,:170,:277),TreasuryStatementService(:271, referencia del extracto del país) yTreasuryStatementController(:449, export). Un solo helper (por ejemploCashBox::etiqueta(int $number): «Bóveda» o «Caja N») que usen todos. - Si los extractos excluyen
TRASPASO(D5-8) no hace falta rango ni concepto para ellos; si algún día se muestran,TreasuryStatementService::RANK(:64-76) tiene que ponerle el crédito antes que el débito (comparten el segundo y desempatan por uuid: se vería un saldo negativo pasajero). DemoReseedCommandyDemoCajaSeedercrean las cajas conensureCashBoxesForCountry: si la bóveda se crea ahí, la demo la tiene; que además reciba un fondeo de demo (hoy ningún seeder fondea cajas por una ruta nueva).
Pruebas que se van a romper a propósito y hay que actualizar (no borrar):
DemoReseedCommandTest.php(~:262, :380: «4 cajas»;~:270-290: «cada caja tiene saldo > 0», que una bóveda recién creada incumple;~:419, :434: conteos antes y después),CashBoxServiceTest.php(~:67-138: conteos deCashBox::count()),StationApiTest.php(~:983-1000:assertDatabaseCount('cash_boxes', 0)).- Muchos tests hacen
CashBox::create(['station_id' => …])sinnumbery dependen del default 1 de2026_08_04_120000_add_number_to_cash_boxes_table.php. No cambies ese default ni el único(station_id, number). Y no agregues un observer del modelo que cree la bóveda sola: rompería decenas de tests y los helpers que arman PDV y cajas a mano (tests/Concerns/SeedsPermissionScenarios.php). La bóveda la crean los servicios y la migración, no el modelo.
Frontend (cada ítem tiene su archivo):
CajaView.vue: el rótuloCaja ${number}(~:782,~:809) → «Bóveda» conis_vault; el badge «Caja cerrada» y el botón «Abrir caja» no van en la bóveda (~:857-865,estadoCaja~:93-97); el bloque «Movimiento manual» está gateado porselected.session(~:891) y para la bóveda tiene que mostrarse sin sesión; el contador «N de M cajas abiertas» (~:741) usa los números nuevos del backend;movementLabels(~:631-637) es unRecord<CashMovement['type'], string>: sumar'TRASPASO'a la unión rompevue-tschasta que el mapa tenga la clave, y las filas necesitan mostrar la contraparte. El orden de/caja/disponiblespone la bóveda primera de cada PDV: revisáloadDisponibles(~:241-253) ycanChangeCashBox(~:112-115) para que el Cajero siga entrando directo a su única caja (no recibe la bóveda, así que no debería cambiar nada: un test lo fija) y que el ancla del recorridocaja-saldosiga existiendo.services/caja.ts:CashMovement.cash_session_id: string | null(y el objetocash_session, que puede sernull),'TRASPASO'en el tipo.PrefondeoPaisView.vue(~:168-179,~:402-407): el formulario de J3 ofrece solo cajas consession !== nully rotula «Caja N»: se reescribe entero (L3.3).ExtractoTesoreria.vue(~:477) yservices/tesoreria.ts(~:26-37): rótulo «Bóveda»;ExtractoFilaTiposinCASH_TRASPASO(no rompe, pero que el tipo diga la verdad).reportes/CajasView.vue(~:104-118,~:202-250) yservices/reportes.ts(~:127-160): «Caja 0», el estado «Cerrada» de la bóveda, el tipoTRASPASOsin etiqueta y las columnas que no concilian.AdministrarCajas.vue(~:195-245) yutils/cajasEstacion.ts(~:11-38): la bóveda sin botón «Desactivar»;resumenDeCajasno la cuenta («3 cajas» con 2 reales y la bóveda); «Este PDV todavía no tiene cajas» tiene que seguir saliendo con solo la bóveda;PASOS_PARA_DEJAR_EN_CEROdistingue la bóveda.
Lo que está bien y no se toca (verificado): DashboardController, ReportesController (Estado de Situación) y RunningBalance no leen las tablas de caja; cierre() y transaccionesConDocumentosPendientes filtran por sesión y toleran null; UserController::avisoDeCajasAbiertas, PermissionService::canCloseCashSession, CashBoxService::openStationIdFor, NotificationPayloadBuilder y ReporteCumplimientoService solo pasan por sesiones o por PAGO, que la bóveda no tiene; useMiCajaVencida usa session?.…; CashBoxService::addCashBoxForStation (max('number') + 1) da 1 cuando la bóveda es la única; CashMovement::cashSession() ya devuelve null sin romper.
L4 — Pago 15: el pagador no ve el recibo ni los soportes de sus pagos · solo si L0.4 lo reproduce
Sin reproducir no se construye nada (la regla del plan v3: no determinado, hay que reproducir). La descripción del síntoma, las tres hipótesis (el 404 de alcance anterior a G2 ya arreglado; un caso que G2 no cubre; un 500) y la regla primero el test que lo reproduce y después el arreglo están en la sección J4 del plan anterior. La revisión de security aplica: cambia quién lee soportes con identificaciones.
L5 — La carta al cliente y los documentos · S · en los dos PR
- PR A:
doc/plans/2026-10-19-borrador-respuesta-al-cliente-ronda-3.md, solo borrador, con la marca arriba: español neutro, sin voseo, sin claves internas (ni L, ni D5, ni QC, ni RV3, ni ADR, ni números de PR). Dice, en este orden:- Gracias y que quedan cerrados los ítems que marcaron OK.
- La corrección: las capturas muestran la versión anterior; recién quedó instalada el [fecha de L0.2]: nacionalidad como desplegable, A4 reordenado y operador de 4 caracteres, (y que el formulario de «Fondear caja» que van a ver en Fondeo PDVs se va a reemplazar por lo que piden abajo). Se completa la fecha solo después de ver el deploy en verde.
- Lo que se hizo con sus respuestas: A4 sin «Transacción fija», documentos al tocar «Iniciar pago» con un botón «Pagar», ningún país dudoso cargado, y lo que queda como está (DPI, «Sent», inglés, «C-» según Soterex, operador de 4 caracteres en todos los formatos).
- Cómo entendimos la bóveda, en pocas líneas y con un ejemplo con números inventados, y las cuatro preguntas (§5).
- Pago 15: que lo estamos revisando y qué dato nos sirve si sigue fallando (usuario, hora y MTCN).
- La muestra: cuándo y qué incluye.
- PR B: los documentos de L3.5.
- El plan (este archivo): actualizar «Estado de la ejecución» al terminar cada PR.
4. Decisiones para vos
Todas tienen un valor por defecto que la sesión de Sonnet aplica sin preguntar. Si decidís otra cosa, cambiá la línea del prompt.
| D | Pregunta | Opciones | Recomendación (valor por defecto) | Destraba |
|---|---|---|---|---|
| D5-0 | ¿Cuándo se promueve J1 a J3? | (a) hoy, sin esperar · (b) junto con el PR A | (a): lo que dijimos el 14/10 sigue siendo falso, y el cliente está esperando probar | L0 |
| D5-1 | Pago 9 (b): ¿qué aparece recién al «Iniciar pago»? | (a) solo los documentos · (b) documentos y datos del pago | (a): es lo que Magaly pidió. (b) es una línea | L2 |
| D5-2 | ¿El cambio de L2 aplica también al detalle de Transacciones? | (a) no, solo Pago · (b) sí | (a): el ítem es de la hoja Pago | L2 |
| D5-3 | ¿Quién puede pasar plata entre cajas y con la bóveda? | (a) Supervisor (de sus PDV), Tesorería y Admin; el Cajero no · (b) solo Tesorería y Admin · (c) también el Cajero | (a): «líder» es el Supervisor; el caso es de mostrador. (b) deja al PDV sin poder resolver un faltante a mitad de día. (c) deja a un cajero mover plata de la caja de otro | L3 |
| D5-4 | ¿La bóveda se abre y se cierra? | (a) no: no tiene sesión ni día · (b) sí, con apertura diaria | (a): es un fondo, no un cajón con un operador; (b) obligaría a Tesorería a esperar a que alguien abra | L3 |
| D5-5 | ¿Se mantiene fondear directamente una caja abierta (hoy, en Saldos)? | (a) sí, queda como atajo · (b) todo fondeo pasa por la bóveda | (a): no se rompe nada ya aprobado (Saldos 6). Se pregunta en la carta (QC-43) | L3 |
| D5-6 | ¿Qué sesión exigen los extremos de un traspaso? | (a) cada caja operativa debe tener una sesión abierta hoy; la bóveda, ninguna · (b) cualquier caja | (a): ADR-013 (el saldo final de un día no se mueve después de cerrado). Para sacar plata de una caja ya cerrada: reabrirla. Se pregunta (QC-44) | L3 |
| D5-7 | Motivos de un traspaso | Reposición de fondos, Devolución de fondos, Otro (con detalle) | Catálogo cerrado, como fondeo y ajuste (E4b.1) | L3 |
| D5-8 | ¿Los traspasos aparecen en los extractos del país y del PDV? | (a) no (suman cero) · (b) sí | (a): duplican líneas y inflan débitos y créditos. Sí aparecen en el historial de cada caja | L3 |
| D5-9 | La pestaña PDV de Fondeo PDVs | (a) «Fondear PDV» manda a la bóveda y reemplaza el formulario de J3 · (b) convive con el de J3 | (a): es lo que pidió; dos formularios confunden | L3 |
| D5-10 | ¿Cómo se vacía la bóveda para dar de baja un PDV o apagar el módulo Caja? | (a) ajuste negativo con el motivo «Retiro por baja de caja», aceptado sobre la bóveda sin sesión · (b) un traspaso a Tesorería | (a): reusa lo que ya existe (G7) sin una operación nueva; (b) sería la QC-45 | L3 |
5. Preguntas nuevas para el cliente
La numeración sigue la del plan v3 (QC-1 a QC-41). Sin respuesta, se hace lo indicado.
| QC | Pregunta | Si no contestan |
|---|---|---|
| QC-42 | Confirmen el circuito: Tesorería manda la plata a la bóveda del PDV; el Supervisor (o Tesorería, o el Administrador) la reparte a las cajas; las cajas pueden devolverla a la bóveda o pasársela entre sí. ¿Quién debe poder hacerlo? | Supervisor (de sus PDV), Tesorería y Administrador; el Cajero no (D5-3) |
| QC-43 | ¿Se sigue pudiendo fondear una caja abierta directamente, como hoy desde Saldos, o todo fondeo tiene que pasar por la bóveda? | Se puede, como atajo (D5-5) |
| QC-44 | Para pasar plata entre cajas, ¿alcanza con que las dos estén abiertas ese día? Una caja ya cerrada no puede mandar ni recibir; para sacarle plata hay que reabrirla. | Así (D5-6) |
| QC-45 | ¿Hace falta devolver plata del PDV al país (sacarla de la bóveda hacia Tesorería) como una operación propia? Hoy se haría con un ajuste de la bóveda. | Ajuste con motivo «Otro» y descripción |
6. Fuera de este plan, pero a la vista
- G13 sigue diferida (alerta al 30 %, confirmaciones de recepción, columna de porcentaje) y la frenan QC-34 a QC-39. La bóveda de L3 no es lo mismo que la «confirmación de recepción» (G13.B): acá la plata llega a la bóveda sin que nadie la confirme. Si el cliente la quiere después, se apoya en la bóveda.
- RV3-67 (el 32.708 de la Holding) y el Escenario 2 de prefondeo siguen sin definir (QC-31, QC-33).
- Azure: si el corte se hace antes que L3, las migraciones de L3 tienen que correr en MySQL. Por eso la regla de portabilidad de L3.1.
- Las S-1 a S-6 para Soterex (mail pendiente): la respuesta a S-2 decide el prefijo «C-».
- Los PRs de la migración a Azure (#110 a #118) siguen abiertos: este plan no los toca.

