Skip to content

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):

EmailRolAlcancePara qué sirve acá
supervisor@cislatam.testSupervisorGT-CAP-001 y GT-QUE-002, sin PDV activoEs 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.testCajeroSolo GT-CAP-001Es quien mira desde fuera de ese alcance (caso 3) y quien sube primero en el caso 4
admin@cislatam.testAdminGuatemala, todos los PDVControl: ve todo, y busca las transacciones de prueba
tesoreria@cislatam.testTesoreríaGuatemalaFondea 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.)

#PasoResultado esperado
1.1Entrar como supervisor@. En Saldos, tener abierta hoy la caja de GT-QUE-002 con saldo suficienteCaja del día abierta
1.2En 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.4Iniciar pago → Confirmar pagoLa transacción pasa a PAID y descuenta la caja. station_id sigue siendo el de GT-QUE-002
1.5Mirar 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.6Tocar Imprimir papeleta A4 (desde G5.5 hay dos botones: tirilla y A4)Se descarga el PDF A4. Sin aviso de error
1.7En 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.8Volver a Pago, buscar el MTCN y subir la Papeleta firmadaAviso «Papeleta firmada guardado»; el badge baja Faltan N
1.9En Saldos, Cerrar cajaLa caja cierra. Es el paso que antes de G2.1 quedaba trabado sin salida
1.10En Pago, buscar de nuevo el MTCN y mirar Datos del pago; mirar también el panel Mis transaccionesEl formulario trae los datos cargados al pagar (no vacío) y la transacción figura en el panel
1.11Como admin@, AuditoríaTRANSACTION_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:

bash
docker exec soterex-backend-1 php artisan test --filter PagadorOtroPdvApiTest
#Qué comprueba el testResultado esperado
2.1B, después de pagar, pide los soportes, uno de ellos, la papeleta y la búsqueda de Pago200 en las tres primeras; datos_pago no es nulo; puede_subir es true
2.2B sube la papeleta firmada y cierra su cajaEl cierre responde 422 PENDING_PAYMENT_DOCUMENTS antes de subirla y 200 después
2.3Un tercero del PDV B, que no pagó, pide soportes, descarga, papeleta y sube404 en todo; la búsqueda lo encuentra pero con datos_pago nulo
2.4A (que subió los documentos) pide los soportes y trata de subirVe los soportes (200, es el PDV de la transacción) y no sube: 403 CANNOT_MANAGE_DOCUMENTS
2.5B 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.6Un 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 TransaccionesEl 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.7El Cajero pagador (acotado a lo propio, A5.2) pide el listado generalTrae lo propio de su PDV y no la tx que pagó en el PDV A: la excepción no llega al listado
2.8B con el rol de antes de A5.1 (transacciones sin lectura)Soportes y papeleta 200, igual que el Cajero actual
2.9Un Admin acotado al PDV B que canceló una tx del PDV ASoportes 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.10Quien 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.11Un 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 ​

#PasoResultado esperado
3.1Como 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.2Como backoffice@ (Cajero de GT-CAP-001), en Pago buscar QLa búsqueda la encuentra: estado PAID, nombre y monto
3.3En esa misma ficha, mirar Datos del pagoLos campos aparecen vacíos: los datos personales no se envían fuera del alcance
3.4Mirar Documentación del pagoEn 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.5Repetir 3.2 a 3.4 con la PAID sin PDVLo mismo (ver la observación en el apartado 6)
3.6Como admin@ (o supervisor@ para una de GT-QUE-002), buscar el mismo MTCNVe todo: datos cargados, stepper, los dos botones de Imprimir papeleta
3.7Como 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:

bash
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"])'
#PedidoResultado esperado con backoffice@ y una PAID de GT-QUE-002 (o sin PDV)
3.8GET /transacciones/{id}/documentos404
3.9GET /transacciones/{id}/papeleta404
3.10GET /pago/buscar?q={mtcn}200 y datos_pago: null
3.11Los 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):

#PasoResultado esperado hoy
4.1Como backoffice@ (PDV A), subir Carta e identificación (anverso y reverso) a una ACCEPTED que nadie haya tocadoBadge Completa
4.2Como B, en Pago buscar ese MTCNSe encuentra, con los datos de Soterex y el formulario
4.3Mirar 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.4Mirar Iniciar pagoDeshabilitado, 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.5Como supervisor@ (alcance sobre GT-CAP-001), buscar el mismo MTCNVe 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 ​

#PasoResultado esperado
5.1Un 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ó otroVe los soportes y la papeleta; no ve el botón Subir (solo sube quien pagó, un Supervisor con alcance o un Admin)
5.2Con 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.3Con 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.4Pagar una ACCEPTED con los tres documentos subidos desde un solo PDV, ida y vuelta, como antesSin diferencias: descuenta caja y prefondeo como siempre
5.5Tests del alcance existentesVerdes sin tocarlos (comando abajo)
bash
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 PAID sin 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»).

Documentación viva — se actualiza junto con el código, no es un anexo aparte.