Borrador de la respuesta al cliente — su respuesta del 14/10 (nacionalidad, A4, Fondeo PDVs, documentos y la bóveda del PDV)
Date: 2026-10-19
BORRADOR — NO ENVIADO — lo revisa y lo manda Carlos
Este archivo es un borrador. No se mandó, no se guardó como borrador en ningún sistema de correo y nadie lo mandó en nombre de Carlos. Todo lo que está antes de «El mail» y después de él es solo para Carlos: no va al cliente. El mail va en el bloque de código y no lleva claves internas (nada de entregas, claves de pregunta, ADR ni números de PR).
La fecha de instalación está en blanco, entre corchetes, a propósito. Se completa solo después de ver el deploy de Staging en verde y los tres cambios en pantalla (la lista está al final, «Antes de mandarla»). Ya pasó una vez que una carta dijo «instalado» sobre algo que no estaba: no se escribe esa palabra sobre nada que no se haya visto desplegado.
| Para | Los mismos destinatarios que el borrador del 13/10 |
| CC | El mismo criterio que ese borrador |
| Asunto | RE: Herramienta Soterex Guatemala: lo instalado, lo que cambiamos con sus respuestas y la bóveda del punto de venta |
| Firma | Carlos |
| Tono | Español neutro y cortés, sin voseo, como los mails anteriores |
Qué es. La respuesta al mail del 14/10 del cliente. Reemplaza al borrador del 13/10: ese todavía dice «hecho, en desarrollo» sobre lo que ahora es otra cosa (ver el plan de la ronda, §2). Lo que dice, en este orden:
- Gracias, y que quedan cerrados los puntos que marcaron «OK».
- La corrección: las capturas que mandaron muestran la versión anterior; lo de nacionalidad, A4 y operador recién queda instalado el [fecha]. Y que el formulario de «Fondear caja» que van a ver en Fondeo PDVs se va a reemplazar por lo que piden.
- Lo que hicimos con sus respuestas (hecho, para la próxima actualización) y lo que queda como está.
- Cómo entendimos la bóveda del PDV, con un ejemplo, y cuatro preguntas.
- El recibo y los soportes de los tres pagos (Pago 15): lo estamos revisando.
- La muestra: cuándo y qué incluye.
Antes de mandar
Completar o decidir
- [ ] La fecha de instalación (apartado 2 del mail, una sola vez). Es el día en que el deploy a Staging de lo de nacionalidad, A4 y Fondeo PDVs terminó en verde. No la completes hasta haber hecho el punto «Promover y verificar» de la lista de más abajo.
- [ ] Qué está instalado cuando la mandes. El mail dice que lo del A4 sin «Transacción fija» y los documentos al tocar «Iniciar pago» quedó hecho y se instala en la próxima actualización. Si para cuando mandes la carta ya están en Staging, cambiá esa frase del apartado 3 por «instalado el [fecha]» (con su fecha). Lo de la bóveda no está hecho: el mail dice que lo entendimos así y pregunta.
- [ ] «Pago 15». La carta dice «lo estamos revisando», sin prometer causa. Si lo reproducís antes de mandar y todo carga, cambiá la frase por «con la versión instalada se ve bien; avísennos si les sigue pasando». Si falla, no mandes la carta con esa frase.
- [ ] Lo de seguridad de los documentos. Con esta carta les pedimos volver a subir documentos con identificaciones (ya aceptaron hacerlo). Decidí antes con cuáles de las exposiciones abiertas convivís (ver el punto de seguridad de la lista de abajo).
- [ ] «C-» y el resto de lo que depende de Soterex. La carta dice que el prefijo se mantiene «mientras Soterex lo envíe». Si Soterex ya contestó que no lo usa, cambiá esa frase.
Lo que la carta afirma y de dónde sale
| Afirmación | Fuente |
|---|---|
| Aceptaron con «OK» los 15 puntos que estaban pendientes y los tres que quedaban como están | Su mail del 14/10, tal como lo transcribe el plan de la ronda (§1.1 y §1.2) |
| Las capturas muestran la versión anterior | Plan de la ronda, §2: staging no se tocó desde el 7/10 y main tenía lo nuevo |
| «Transacción fija» fuera del A4 | Su respuesta a la pregunta 6; hecho en la entrega L1 |
| Los documentos al tocar «Iniciar pago» y un botón «Pagar» | Su respuesta a la pregunta 1; hecho en la entrega L2 (solo la pantalla Pago) |
| Ningún país dudoso cargado, DPI sin espacios, «Sent», estados en inglés, operador de 4 caracteres en todos los formatos | Sus respuestas a las preguntas 2 a 5 y 8; ya estaba así y se dejó fijado con pruebas |
| El prefijo «C-» se mantiene mientras Soterex lo envíe | Su respuesta a la pregunta 7 |
| La bóveda: cómo la entendimos | Su pedido textual para Prefondeo 2 (plan de la ronda, §1.4) y su respuesta a la pregunta 9 |
El mail
Hola a todos:
Gracias por la respuesta y por las capturas. Las revisamos una por una contra lo que hoy está en el ambiente de pruebas (Staging).
1. LO QUE MARCARON «OK»
Quedan cerrados los quince puntos que estaban pendientes en su Excel del 5 de octubre, los tres que habíamos dejado como están, la variante de quién cierra una caja, la vuelta a subir los documentos que se hayan perdido y el envío de la muestra. No hay nada más que hacer con ellos.
2. UNA CORRECCIÓN SOBRE LO QUE LES DIJIMOS
En nuestro mail anterior les contamos que estaban instalados el desplegable de nacionalidad, el recibo A4 reordenado y el formulario para fondear un punto de venta. Las capturas que nos mandaron muestran la versión anterior, y tienen razón: ese mail se adelantó. Esos cambios recién quedaron instalados el [FECHA DE INSTALACIÓN]. Les pedimos disculpas por la confusión.
Ahora sí, por favor vuelvan a probar:
- Pago, nacionalidad: ahora es un desplegable de países, el mismo que «País de la identificación».
- Pago, recibo A4: con el orden nuevo, y de la persona que atiende se imprimen solo los primeros 4 caracteres de su correo (por ejemplo «back••••»), sin el dominio. Un recibo que se reimprima de un pago anterior sale con el orden nuevo.
- Fondeo PDVs, pestaña PDV: ahí van a ver un formulario «Fondear caja». Es lo primero que hicimos, pero no es lo que ustedes piden: lo vamos a reemplazar por lo que describimos en el punto 4.
3. LO QUE HICIMOS CON SUS RESPUESTAS
Quedó hecho y se instala en la próxima actualización:
- Recibo A4: se quitó «Transacción fija: Sí / No». Queda solo el tipo de transacción.
- Documentos al consultar: al buscar una transacción ya no se muestran los documentos que alguien subió antes. La sección de documentos aparece recién al tocar «Iniciar pago», y para confirmar el pago hay un botón «Pagar» debajo de ella. Para poder tocar «Iniciar pago» hacen falta los datos del pago completos y guardados; para poder tocar «Pagar», además, los tres documentos. Esto vale para la pantalla Pago; el detalle de la transacción en el Reporte individual no cambia.
- Países: no cargamos Chipre del Norte, Irlanda del Norte, Somalilandia ni el #216 «Santo Tomas». Si más adelante hacen falta, los agregamos.
Y queda como está, tal como lo confirmaron:
- El DPI se escribe con o sin espacios: el formulario los quita.
- Transaction Status: «Sent». Transaction Status – Update: en inglés (Pending, Paid, Cancelled), como lo envía Soterex.
- Prefijo «C-» en el listado de Cumplimiento: se mantiene mientras Soterex lo envíe; si Soterex nos dice que ya no lo usa, lo quitamos.
- Operador del recibo: los primeros 4 caracteres de su correo, el resto oculto, en todos los formatos.
4. FONDEAR UN PUNTO DE VENTA: CÓMO ENTENDIMOS LA BÓVEDA
Entendimos que Tesorería manda el dinero al punto de venta (no a una caja), y que recién ahí se decide a qué cajas se reparte, sin obligación de repartir todo. Para eso cada punto de venta tendría una «bóveda» (la caja 0, la del líder): ahí llega el dinero de Tesorería, y desde ahí se pasa a las cajas. También se podría pasar dinero entre cajas, y de una caja a la bóveda.
Un ejemplo, con números inventados:
- Tesorería manda 5,000 USD al punto de venta. Quedan en la bóveda: 5,000 USD.
- El Supervisor pasa 2,000 USD a la Caja 1 y 1,500 USD a la Caja 2. Quedan 1,500 USD en la bóveda.
- A media tarde el operador de la Caja 2 no pagó nada y el de la Caja 1 se quedó sin fondos: el Supervisor pasa 500 USD de la Caja 2 a la Caja 1.
- Al cierre, la Caja 1 devuelve 300 USD a la bóveda.
Pasar dinero de un lugar a otro dentro del punto de venta (de la bóveda a una caja, entre cajas, o de una caja a la bóveda) no cambia el total del punto de venta ni el saldo del país: lo único que lo baja son los pagos. Los pagos salen siempre de una caja, nunca de la bóveda, y la bóveda no se abre ni se cierra como una caja.
Así lo vamos a construir salvo que nos digan otra cosa. Les pedimos que nos confirmen cuatro puntos.
5. PREGUNTAS
Cada una tiene el valor que aplicamos si no nos contestan.
1. Circuito y permisos: ¿es correcto que Tesorería manda el dinero a la bóveda del punto de venta, que el Supervisor la reparte a las cajas, y que las cajas pueden devolverla o pasársela entre sí? ¿Quién debe poder hacerlo? Sin respuesta: el Supervisor de ese punto de venta, Tesorería y el Administrador; el cajero no.
2. Fondeo directo: ¿se sigue pudiendo fondear directamente una caja abierta, como hoy desde Saldos, o todo fondeo tiene que pasar por la bóveda? Sin respuesta: se puede, como un atajo.
3. Cajas abiertas: para pasar dinero entre cajas, ¿alcanza con que las dos estén abiertas ese día? Una caja ya cerrada no puede mandar ni recibir; para sacarle dinero hay que volver a abrirla. La bóveda no necesita estar abierta. Sin respuesta: así.
4. Devolver al país: ¿hace falta devolver dinero del punto de venta al país (sacarlo de la bóveda hacia Tesorería) como una operación propia? Hoy se haría con un ajuste de la bóveda. Sin respuesta: un ajuste con motivo «Otro» y una descripción.
6. EL RECIBO Y LOS SOPORTES DE LOS TRES PAGOS (PAGO 15)
Lo estamos revisando. Si después de volver a probar con la versión instalada les sigue pasando, nos ayuda saber el usuario, la hora y el número MTCN de cada caso.
7. MUESTRA PARA VALIDAR
Apenas esté instalado lo del punto 2 les mandamos el Excel de Cumplimiento y el PDF del recibo A4 (ya con el orden nuevo y sin «Transacción fija»), con datos de prueba, más capturas del menú de cada perfil y de los estados de cuenta. Necesitamos un OK explícito de cada uno. Les pedimos que en sus capturas usen transacciones de prueba o tapen los datos de las personas.
Saludos,
CarlosLas preguntas de esta carta y de dónde salen
| # en el mail | Pregunta | Si no contestan |
|---|---|---|
| 1 | Circuito y quién puede pasar dinero | Supervisor de su punto de venta, Tesorería y Administrador; el cajero no |
| 2 | ¿Se mantiene fondear una caja abierta directamente? | Se mantiene, como atajo |
| 3 | ¿Alcanza con que las dos cajas estén abiertas ese día? | Sí; la bóveda no necesita sesión |
| 4 | ¿Devolver dinero del punto de venta al país como operación propia? | Ajuste de la bóveda con motivo «Otro» y descripción |
Antes de mandarla
La lista es la del plan de la ronda (§3, «L0»). Todo esto lo hacés vos: promover a Staging necesita tu OK y la sesión que escribió este borrador no lo hace.
- [ ] Promover y verificar. Confirmá el atraso (
git fetch originygit log origin/staging..origin/main --oneline), hacé el PR demainastagingy mirá el deploy hasta el final (gh run watchsobredeploy-staging.yml). Después, en pantalla y con un usuario de prueba: el A4 de un pago (orden nuevo, operadorback••••también en la tirilla), la nacionalidad como desplegable y la pestaña PDV de Fondeo PDVs con el formulario «Fondear caja». - [ ] Completar la fecha del apartado 2 con el día en que el deploy quedó en verde y lo anterior se vio en pantalla.
- [ ] Reproducir el recibo y los soportes de los tres pagos (Pago 15) con el usuario del cliente, en Staging ya actualizado. Si todo carga, cambiá la frase del apartado 6; si falla, no mandes la carta con esa frase y anotá qué responden
GET /api/transacciones/{id}/documentosy la descarga de la papeleta. - [ ] Seguridad de los documentos. El PR #101 (revisión de seguridad de G1) sigue abierto y sin mergear. Marca exposiciones que pueden estar activas en Staging; decidí con cuáles convivís antes de que el cliente vuelva a subir identificaciones.
- [ ] La muestra (apartado 7): el Excel de Cumplimiento y el PDF del A4 con transacciones de prueba, y las capturas de menú y estados de cuenta. Las genera quien tenga acceso a Staging.
- [ ] Releer el apartado 3 contra lo que haya instalado ese día (ver «Completar o decidir»).
- [ ] Mandar la carta. Es un borrador: no se manda solo.

