Plan de Pruebas — G2: quien paga una transacción de otro PDV recupera sus soportes y su papeleta
Fecha: 2026-10-06 Decisión: ADR-008 (actualización G2.1) · plan de ajustes v3, entrega G2 (RV3-14, D3-2 a) Ambiente: Dev local (./start-dev.sh) — http://localhost:5173 — o Staging con las cuentas de prueba
Qué cambió: quien tiene su id en resolved_by_user_id (pagó o canceló) entra a esa transacción —soportes, papeleta, datos del pago, subir la firmada— aunque su PDV no coincida con el de la transacción. Y la pantalla de Pago, cuando el backend responde 404 a los soportes, dice que se pagó en otro punto de venta en lugar de «No se pudo cargar» y no ofrece Imprimir papeleta. Ver Pago con documentos, §1.6.
Antes de empezar
Usuarios (las contraseñas están en doc/environments/dev.md):
| Rol | Alcance | Para qué sirve acá | |
|---|---|---|---|
supervisor@cislatam.test | Supervisor | GT-CAP-001 y GT-QUE-002, sin PDV activo | Es el pagador del caso 1: con dos PDV y ninguno activo, el PDV de lo que paga lo da la caja que tiene abierta (G4.1, ADR-020); sin caja abierta, el sistema lo rechaza (G2.2) |
backoffice@cislatam.test | Cajero | Solo GT-CAP-001 | Es quien mira desde fuera de ese alcance (caso 3) y quien sube primero en el caso 4 |
admin@cislatam.test | Admin | Guatemala, todos los PDV | Control: ve todo, y busca las transacciones de prueba |
tesoreria@cislatam.test | Tesorería | Guatemala | Fondea la caja del pagador, si hace falta |
Para el caso 4 hace falta además un Cajero asignado solo a GT-QUE-002. En dev no existe: se crea el usuario en el emulador de Firebase (dev.md, «Crear un usuario de prueba adicional») y se le asigna el rol Cajero, país Guatemala y PDV GT-QUE-002 desde Usuarios y Accesos con admin@. En Staging, la cuenta equivalente es la que crea G0.7 del plan de ajustes v3, si ya está creada.
Transacción de prueba: una ACCEPTED sin documentos (el seed de demo las trae; si hace falta una nueva, el comando tinker está en el plan de pruebas de ADR-008).
Caja del pagador: una caja abierta hoy, a su nombre y con saldo mayor que el monto a pagar (en Saldos). Si quedó abierta de un día anterior hay que cerrarla y abrirla de nuevo (ADR-013).
1. El pagador con dos PDV recupera lo suyo (supervisor@)
El ciclo completo en la pantalla. Es el caso que se puede reproducir hoy con las cuentas que ya existen. (Cuando se escribió, supervisor@ pagaba y la transacción quedaba sin PDV; desde G4a queda en el PDV de la caja que abrió, así que ya no es el caso «sin PDV» de la excepción: ese escenario, y el de un PDV distinto al del pagador, lo cubre PagadorOtroPdvApiTest por API.)
| # | Paso | Resultado esperado |
|---|---|---|
| 1.1 | Entrar como supervisor@. En Saldos, tener abierta hoy la caja de GT-QUE-002 con saldo suficiente | Caja del día abierta |
| 1.2 | En Pago, buscar el MTCN de la ACCEPTED de prueba. Completar los datos y tocar Guardar datos; subir Carta e identificación (anverso y reverso) | Badge Completa y Iniciar pago habilitado |
| 1.3 | (Opcional) Mirar la fila en Adminer: select station_id from transactions where mtcn = '…' | station_id es el de GT-QUE-002: el usuario tiene dos PDV y ninguno activo, así que el primer documento toma el PDV de la caja que tiene abierta (G4.1). Sin caja abierta, el paso 1.2 habría respondido 422 ACTIVE_STATION_REQUIRED (ver el plan de pruebas de G4a) |
| 1.4 | Iniciar pago → Confirmar pago | La transacción pasa a PAID y descuenta la caja. station_id sigue siendo el de GT-QUE-002 |
| 1.5 | Mirar Documentación del pago (en la misma pantalla o buscando de nuevo el MTCN) | El stepper con los documentos del pago en efectivo (cinco casilleros: los cuatro de transferencia solo se muestran si el medio de pago es transferencia), con Carta e identificación tildadas y el badge Faltan N. No aparece el aviso gris de «se pagó en otro punto de venta» ni «No se pudo cargar la documentación» |
| 1.6 | Tocar Imprimir papeleta A4 (desde G5.5 hay dos botones: tirilla y A4) | Se descarga el PDF A4. Sin aviso de error |
| 1.7 | En Saldos, intentar Cerrar caja sin haber subido la papeleta firmada. Mirar también el aviso de Pago «Tenés N pagos con documentación pendiente» | El cierre se frena (PENDING_PAYMENT_DOCUMENTS) y la lista de pendientes incluye ese MTCN; el aviso de Pago también lo cuenta (es suya) |
| 1.8 | Volver a Pago, buscar el MTCN y subir la Papeleta firmada | Aviso «Papeleta firmada guardado»; el badge baja Faltan N |
| 1.9 | En Saldos, Cerrar caja | La caja cierra. Es el paso que antes de G2.1 quedaba trabado sin salida |
| 1.10 | En Pago, buscar de nuevo el MTCN y mirar Datos del pago; mirar también el panel Mis transacciones | El formulario trae los datos cargados al pagar (no vacío) y la transacción figura en el panel |
| 1.11 | Como admin@, Auditoría | TRANSACTION_DOCUMENT_UPLOADED (la firmada) y PAPELETA_GENERATED a nombre de supervisor@, y el cierre de caja |
2. A sube desde su PDV, B paga desde el suyo
Es el escenario del plan: A (PDV A) sube la Carta y la identificación, la transacción queda en el PDV A, y B (PDV B) la paga desde su caja. Lo prueba el CI por API, y no se puede recorrer entero por pantalla: en pantalla, B no llega a Iniciar pago (caso 4). Para correrlo:
docker exec soterex-backend-1 php artisan test --filter PagadorOtroPdvApiTest| # | Qué comprueba el test | Resultado esperado |
|---|---|---|
| 2.1 | B, después de pagar, pide los soportes, uno de ellos, la papeleta y la búsqueda de Pago | 200 en las tres primeras; datos_pago no es nulo; puede_subir es true |
| 2.2 | B sube la papeleta firmada y cierra su caja | El cierre responde 422 PENDING_PAYMENT_DOCUMENTS antes de subirla y 200 después |
| 2.3 | Un tercero del PDV B, que no pagó, pide soportes, descarga, papeleta y sube | 404 en todo; la búsqueda lo encuentra pero con datos_pago nulo |
| 2.4 | A (que subió los documentos) pide los soportes y trata de subir | Ve los soportes (200, es el PDV de la transacción) y no sube: 403 CANNOT_MANAGE_DOCUMENTS |
| 2.5 | B pide soportes y papeleta de otras transacciones del PDV A (una pagada por otro, una cancelada, una ACCEPTED ya reclamada) | 404 en todas: la excepción es por transacción, no por PDV |
| 2.6 | Un Supervisor acotado al PDV B que pagó la transacción del PDV A (el perfil que podría equivocarse: la excepción lo deja entrar a sus soportes y a su papeleta), pide el listado y el detalle de Transacciones | El listado trae lo del PDV B y no la del PDV A; el detalle de la del PDV A responde 404 y el de una del PDV B, 200 |
| 2.7 | El Cajero pagador (acotado a lo propio, A5.2) pide el listado general | Trae lo propio de su PDV y no la tx que pagó en el PDV A: la excepción no llega al listado |
| 2.8 | B con el rol de antes de A5.1 (transacciones sin lectura) | Soportes y papeleta 200, igual que el Cajero actual |
| 2.9 | Un Admin acotado al PDV B que canceló una tx del PDV A | Soportes 200; la papeleta 422 TRANSACTION_NOT_PAID (está dentro del alcance, pero no se pagó); otro Admin del PDV B que no la canceló recibe 404 en ambos |
| 2.10 | Quien pagó una tx de GT y hoy solo tiene asignación en otro país (SV) | 404 en soportes, descarga, papeleta y subida: el permiso por país va primero |
| 2.11 | Un Supervisor acotado al PDV A que pagó una tx del PDV B, o sin PDV, pide GET /pago/pendientes (se corre con PagoApiTest, no con este comando) | La lista trae esas dos y no las que resolvió otro fuera de su PDV |
Si hace falta recorrerlo a mano, B tiene que pagar por API (el PATCH /transacciones/{id}/pay con los datos del pago completos) y después seguir en la pantalla desde el paso 1.5.
3. Quien no pagó y es de otro PDV: el 404 con su mensaje
| # | Paso | Resultado esperado |
|---|---|---|
| 3.1 | Como admin@, Reporte individual: filtrar Pagada y el PDV GT-QUE-002. Copiar un MTCN (llamémosla Q). Si existe, buscar también una PAID sin PDV (el seed de demo trae algunas; en el listado se reconoce porque la columna PDV queda vacía) | Un MTCN de cada tipo |
| 3.2 | Como backoffice@ (Cajero de GT-CAP-001), en Pago buscar Q | La búsqueda la encuentra: estado PAID, nombre y monto |
| 3.3 | En esa misma ficha, mirar Datos del pago | Los campos aparecen vacíos: los datos personales no se envían fuera del alcance |
| 3.4 | Mirar Documentación del pago | En gris, no en rojo: «Esta transacción se pagó en otro punto de venta: sus soportes y su papeleta los ven ese PDV, un Supervisor o un Administrador.» Sin stepper y sin los botones de Imprimir papeleta (ni el de tirilla ni el de A4) |
| 3.5 | Repetir 3.2 a 3.4 con la PAID sin PDV | Lo mismo (ver la observación en el apartado 6) |
| 3.6 | Como admin@ (o supervisor@ para una de GT-QUE-002), buscar el mismo MTCN | Ve todo: datos cargados, stepper, los dos botones de Imprimir papeleta |
| 3.7 | Como backoffice@, buscar una PAID de su propio PDV (GT-CAP-001) | Ve todo, como siempre: es el control de que el aviso no sale donde no corresponde |
Por API (en dev; los tres pedidos son de solo lectura). El {id} sale de la URL de la ficha en Reporte individual:
TOKEN=$(curl -s -X POST 'http://localhost:9099/identitytoolkit.googleapis.com/v1/accounts:signInWithPassword?key=fake-api-key' \
-H 'Content-Type: application/json' \
-d '{"email":"backoffice@cislatam.test","password":"<la de dev.md>","returnSecureToken":true}' \
| python3 -c 'import sys,json;print(json.load(sys.stdin)["idToken"])')
for ruta in "transacciones/{id}/documentos" "transacciones/{id}/papeleta"; do
curl -s -o /dev/null -w "$ruta -> %{http_code}\n" -H "Authorization: Bearer $TOKEN" "http://localhost:3000/$ruta"
done
curl -s -H "Authorization: Bearer $TOKEN" 'http://localhost:3000/pago/buscar?q=<mtcn>' | python3 -c 'import sys,json;print(json.load(sys.stdin)["data"][0]["datos_pago"])'| # | Pedido | Resultado esperado con backoffice@ y una PAID de GT-QUE-002 (o sin PDV) |
|---|---|---|
| 3.8 | GET /transacciones/{id}/documentos | 404 |
| 3.9 | GET /transacciones/{id}/papeleta | 404 |
| 3.10 | GET /pago/buscar?q={mtcn} | 200 y datos_pago: null |
| 3.11 | Los mismos tres con admin@ | 200, 200 y datos_pago con los datos |
4. Antes de pagar: una ACCEPTED que ya reclamó otro PDV — 📋 pregunta abierta para Carlos
G2.1 empieza al pagar: resolved_by_user_id no existe antes. Una ACCEPTED cuyos documentos subió el PDV A sigue acotada a ese PDV, y esto es lo que pasa hoy cuando la abre un Cajero acotado a otro (B, solo GT-QUE-002):
| # | Paso | Resultado esperado hoy |
|---|---|---|
| 4.1 | Como backoffice@ (PDV A), subir Carta e identificación (anverso y reverso) a una ACCEPTED que nadie haya tocado | Badge Completa |
| 4.2 | Como B, en Pago buscar ese MTCN | Se encuentra, con los datos de Soterex y el formulario |
| 4.3 | Mirar Documentos para poder pagar | «No se pudo cargar la documentación de esta transacción.»: la lista de soportes responde 404 porque la transacción ya quedó en el PDV A |
| 4.4 | Mirar Iniciar pago | Deshabilitado, con el motivo «Faltan documentos: Carta de Soterex, Identificación (anverso), Identificación (reverso)» aunque estén subidos: la pantalla no los puede ver |
| 4.5 | Como supervisor@ (alcance sobre GT-CAP-001), buscar el mismo MTCN | Ve los tres documentos y puede pagarla |
No es un cambio de G2 ni un defecto nuevo: es la consecuencia de ADR-008 §1 (la ACCEPTED queda «reclamada» por el PDV de quien subió el primer documento). Lo que falta decidir es si está bien. Si sí, B tiene que pedirle el pago a un Supervisor o un Admin con alcance sobre el PDV A. Si no, hay que abrir la lectura de esos tres documentos previos al pago, que son PII, para quien va a pagar. Ver la sección «Tres consecuencias de la excepción» de la actualización de ADR-008.
5. No se rompió nada de lo que ya existía
| # | Paso | Resultado esperado |
|---|---|---|
| 5.1 | Un segundo Cajero de GT-CAP-001 (la cuenta de G0.7 en Staging; en dev, crearlo como en el caso 4) mira una PAID de ese PDV que pagó otro | Ve los soportes y la papeleta; no ve el botón Subir (solo sube quien pagó, un Supervisor con alcance o un Admin) |
| 5.2 | Con DevTools → Network → Offline, buscar una PAID ya cargada y volver a pedir sus soportes | «No se pudo cargar la documentación de esta transacción.» en rojo, no el aviso gris; la papeleta sigue ofrecida |
| 5.3 | Con la red cortada, tocar Imprimir papeleta A4 (o tirilla) | «No se pudo generar la papeleta, probá de nuevo», no el de «no tenés acceso» |
| 5.4 | Pagar una ACCEPTED con los tres documentos subidos desde un solo PDV, ida y vuelta, como antes | Sin diferencias: descuenta caja y prefondeo como siempre |
| 5.5 | Tests del alcance existentes | Verdes sin tocarlos (comando abajo) |
docker exec soterex-backend-1 php artisan test --filter 'PermissionServiceTransactionScopeTest|TransactionDocumentApiTest|PapeletaFormatosTest|PagadorOtroPdvApiTest'
docker exec soterex-frontend-1 sh -c 'cd /app && npx vitest run src/components/__tests__/DocumentacionPago.spec.ts src/composables/__tests__/useTransactionDocuments.spec.ts'6. Qué NO es parte de este cambio (no reportar como bug)
- G2.2, el 422 al usuario con más de un PDV y sin PDV activo, salió después, con G4a (no con G2): ver el plan de pruebas de G4a. Para este plan, el efecto es que
supervisor@necesita una caja abierta para subir el primer documento (paso 1.1) y que la transacción que paga queda en el PDV de esa caja. - El texto del aviso con una
PAIDsin PDV. Dice «se pagó en otro punto de venta» aunque la transacción no tenga PDV (paso 3.5): la redacción no distingue los dos casos. Queda anotado para decidir si se afina; no está en el alcance de G2. - Que el formulario de Datos del pago se vea vacío para quien no la pagó (paso 3.3): es el backend sin mandar PII.
Cómo reportarme el feedback
Para cada punto que falle, con el número de la tabla alcanza (ej. «1.9 no cerró la caja»).

