Plan de Pruebas — G4: Reporte individual (Procesada por y PDV con rótulo)
Fecha: 2026-10-06 Alcance: doc/plans/2026-10-04-ajustes-v3-cliente-gt.md, entrega G4.3, G4.4 y G4.5 (pedidos RV3-15, RV3-16 y RV3-17 del cliente): la columna Procesada por, el nombre del Excel (reporte-individual-…) y los textos que reemplazan el «—» de la columna PDV. Decisiones y contrato: ADR-016 (Actualización G4.3) y Secuencias de pantalla, 5.9. Ambiente: Dev local (./start-dev.sh) — http://localhost:5173
Qué NO cubre este plan. Que el PDV de un pago sea el de la caja que pagó (G4.1, G4.2, G4.6 y G4.7) va en otra entrega y tiene su propio plan. Acá se prueba cómo se muestra una transacción sin PDV, no que deje de quedar sin PDV.
Antes de empezar
Paso 1. Dejá la demo fresca. Borra y vuelve a sembrar los datos de demostración de Guatemala (solo contra la base local):
docker compose exec backend php artisan demo:reseedPaso 2. Creá cuatro transacciones que la demo no trae. La demo cancela siempre con un PDV y siempre con una persona, así que no tiene una cancelada por Soterex, una por el vencimiento ni una cancelada por alguien sin PDV. Corré esto después del paso 1: demo:reseed borra todas las transacciones de Guatemala, estas incluidas.
docker compose exec backend php artisan tinker --execute="$(cat <<'PHP'
$gt = App\Models\Country::where('iso_code', 'GT')->first();
$sup = App\Models\User::where('email', 'supervisor@cislatam.test')->first();
$crear = fn ($n, $mtcn) => App\Models\Transaction::create([
'soterex_transaction_id' => "RS-QA-G4-$n", 'mtcn' => $mtcn, 'status' => 'ACCEPTED', 'country_id' => $gt->id,
'first_name' => 'Prueba', 'last_name' => "G4-$n", 'amount' => 100, 'fee' => 3.5,
'origin_currency' => 'USD', 'destination_country' => 'GT', 'sender' => 'US',
]);
$cancelaciones = app(App\Services\TransactionCancellationService::class);
$soterex = App\Models\ApiClient::firstOrCreate(['client_id' => 'qa-g4'], ['name' => 'qa-soterex', 'active' => true]);
// El Cancel de Soterex: la cancela un cliente de la API, no una persona.
$cancelaciones->cancel($crear(1, '9000000001'), $soterex, 'QA G4');
// El vencimiento del MTCN: la cancela el sistema, sin usuario ni cliente.
$cancelaciones->cancel($crear(2, '9000000002'), null, App\Services\TransactionCancellationService::MOTIVO_EXPIRADA);
// Una persona de CIS que no tiene un PDV que resolver (dos PDV y ninguno activo).
$cancelaciones->cancel($crear(3, '9000000003'), $sup, 'QA G4');
// Disponible, para cancelarla a mano en el paso 3.5.
$crear(4, '9000000004');
PHP
)"Quedan cuatro transacciones de Guatemala, con el beneficiario «Prueba G4-N» y estos MTCN:
| MTCN | Estado | Cómo se resolvió |
|---|---|---|
9000000001 | CANCELLED | El Cancel de Soterex (cliente de la API, sin persona) |
9000000002 | CANCELLED | El vencimiento del MTCN (el sistema, sin persona ni cliente) |
9000000003 | CANCELLED | Una persona de CIS (supervisor@cislatam.test) que no tiene un PDV que resolver |
9000000004 | ACCEPTED | Todavía nadie; se mira en 3.4 y se cancela a mano en 3.5 |
Paso 3. Al terminar, para dejar la base limpia, volvé a correr demo:reseed.
Usuarios de prueba
Las contraseñas están en doc/environments/dev.md, sección «Datos iniciales y usuarios de desarrollo».
| Perfil | Alcance | Qué ve en Reporte individual | |
|---|---|---|---|
admin@cislatam.test | Admin | Guatemala, todos los PDVs | Todo lo de su alcance |
supervisor@cislatam.test | Supervisor | GT-CAP-001 + GT-QUE-002 | Todo lo de su alcance, bolsa de disponibles incluida |
backoffice@cislatam.test | Cajero | GT-CAP-001 | Solo lo que resolvió él |
tesoreria@cislatam.test | Tesorería | Guatemala, todos los PDVs | No tiene la pantalla |
En la demo, las pagadas y canceladas de cada PDV las resolvió su operador (GT-CAP-001: backoffice@, GT-QUE-002: supervisor@, Mixco y Escuintla: admin@), y unas pocas pagadas quedaron sin PDV, resueltas por supervisor@ (tiene dos PDV y ninguno activo).
1. Base en verde antes de tocar nada
| # | Paso | Resultado esperado |
|---|---|---|
| 1.1 | docker exec soterex-backend-1 php artisan test --filter=ReporteIndividualProcesadaPorTest | Pasan todos: lo que dice la columna por estado, que pantalla y Excel dicen lo mismo, el orden y los rótulos del PDV |
| 1.2 | `docker exec soterex-backend-1 php artisan test --filter='TransactionExportApiTest | TransactionApiTest'` |
| 1.3 | docker exec soterex-frontend-1 sh -c 'cd /app && npx vitest run src/views/__tests__/TransaccionesView.spec.ts src/views/__tests__/TransaccionDetalleView.spec.ts src/utils/__tests__/pdvDeLaTransaccion.spec.ts src/services/__tests__/transactions.spec.ts' | Pasan todos |
| 1.4 | docker exec soterex-frontend-1 sh -c 'cd /app && npm run build' | Compila sin errores de TypeScript (vue-tsc) |
2. El listado — como Admin
Entrá como admin@cislatam.test → menú Caja → Reporte individual.
| # | Paso | Resultado esperado |
|---|---|---|
| 2.1 | Mirá los encabezados de la tabla | Nueve columnas, en este orden: MTCN, Beneficiario, Estado, País, PDV, Monto, Creada, Última actualización y, al final, Procesada por |
| 2.2 | Buscá Prueba G4 o filtrá por el MTCN 9000000001 | PDV: Cancelada por Soterex · Procesada por: Soterex (API) |
| 2.3 | Lo mismo con 9000000002 | PDV: Cancelada por vencimiento del MTCN · Procesada por: Sistema (no «Soterex (API)»: no la canceló Soterex) |
| 2.4 | Lo mismo con 9000000003 | PDV: Sin PDV asignado · Procesada por: supervisor@cislatam.test |
| 2.5 | Filtrá por estado ACCEPTED y mirá cualquier fila de la bolsa | PDV: Sin asignar (bolsa del país) · Procesada por: vacío |
| 2.6 | Filtrá por estado PAID y buscá una fila de GT-CAP-001 | PDV: el nombre del PDV · Procesada por: backoffice@cislatam.test |
| 2.7 | En las pagadas, buscá una que diga Sin PDV asignado | Procesada por: supervisor@cislatam.test (es el hueco de datos de RV3-17: pagó alguien con dos PDV y ningún PDV activo) |
| 2.8 | Con el filtro CANCELLED, mirá una cancelada de la demo | El correo de quien la canceló y el nombre de su PDV |
| 2.9 | Recorré los tres estados (PAID, CANCELLED, ACCEPTED) y varias páginas | Ninguna celda de PDV dice «—» ni queda vacía: o el nombre del PDV o uno de los cuatro textos |
| 2.10 | Hacé clic en el encabezado Procesada por | Se ordena por correo, de menor a mayor (flecha hacia arriba); las filas sin persona (disponibles, canceladas por Soterex o por el sistema) quedan juntas al final |
| 2.11 | Hacé clic de nuevo | Orden inverso; las filas sin persona pasan al principio |
| 2.12 | Con ese orden puesto, cambiá el filtro de estado y paginá | El orden se mantiene y no hay error |
3. La ficha
| # | Paso | Resultado esperado |
|---|---|---|
| 3.1 | Abrí la de 9000000001 (clic en la fila) | En Datos de la transacción: PDV: Cancelada por Soterex y un renglón Procesada por: Soterex (API) |
| 3.2 | Abrí la de 9000000002 | PDV: Cancelada por vencimiento del MTCN y Procesada por: Sistema |
| 3.3 | Abrí una pagada de GT-CAP-001 | PDV: el nombre · Procesada por: el correo de quien la pagó |
| 3.4 | Abrí la de 9000000004 (ACCEPTED) | PDV: Sin asignar (bolsa del país) y no hay renglón «Procesada por» |
| 3.5 | En esa misma ficha, cancelala desde Cancelar transacción | Al confirmar aparece el renglón Procesada por: admin@cislatam.test con el estado ya en CANCELLED (la respuesta de cancelar también trae el dato) |
| 3.6 | En esa misma ficha, mirá el Historial | El cambio de estado figura con el correo del Admin |
| 3.7 | Mirá el Historial de 9000000001 y de 9000000002 | Siguen diciendo quién cambió el estado, con su redacción de siempre: «API de Soterex» la primera, «Sistema» la segunda |
4. Cada perfil ve lo suyo
| # | Paso | Resultado esperado |
|---|---|---|
| 4.1 | Entrá como backoffice@cislatam.test (Cajero) → Reporte individual | Solo transacciones que resolvió él. La columna Procesada por trae en todas las filas su propio correo. No hay ACCEPTED |
| 4.2 | Con ese usuario, ordená por Procesada por | Funciona sin error (todas las filas tienen el mismo valor) |
| 4.3 | Con ese usuario, abrí por URL la ficha de una transacción que no es suya (por ejemplo la de 9000000003: copiá su URL desde la sesión del Admin) | «No encontrada», igual que antes: no la resolvió él |
| 4.4 | Entrá como supervisor@cislatam.test | Ve todo lo de GT-CAP-001 y GT-QUE-002, incluida la bolsa. Procesada por muestra el correo de cada operador (backoffice@, supervisor@, admin@ si corresponde) |
| 4.5 | Entrá como tesoreria@cislatam.test | Reporte individual no está en el menú, y entrar por la URL /transacciones no abre el listado |
5. El Excel
| # | Paso | Resultado esperado |
|---|---|---|
| 5.1 | Como Admin, filtrá por estado CANCELLED y tocá Exportar a Excel | Baja un archivo llamado reporte-individual-AAAAMMDD-HHMM.xlsx (antes se llamaba transacciones-…) |
| 5.2 | Abrilo y mirá la primera fila | Nueve encabezados, en el mismo orden que la pantalla: MTCN, Beneficiario, Estado, País, PDV, Monto, Creada, Última actualización, Procesada por (la nueva, última) |
| 5.3 | Buscá las filas 9000000001, 9000000002 y 9000000003 | Mismos textos que en pantalla (2.2, 2.3, 2.4), tanto en PDV como en Procesada por |
| 5.4 | Mirá toda la columna PDV | Ninguna celda con «—» ni vacía |
| 5.5 | Exportá con el filtro ACCEPTED | La columna PDV dice «Sin asignar (bolsa del país)» y Procesada por queda vacía en todas |
| 5.6 | Exportá con el filtro PAID | Las pagadas sin PDV dicen «Sin PDV asignado»; las demás, el nombre del PDV. Procesada por trae el correo en todas |
| 5.7 | Ordená la pantalla por Procesada por y exportá | El Excel trae las mismas filas, en el mismo orden que la pantalla, y no da error |
| 5.8 | Como backoffice@, exportá | El archivo trae solo sus filas, con su correo en la novena columna |
| 5.9 | Como Admin, entrá a Administración → Auditoría y buscá la acción Exportación de transacciones | Hay un evento por cada exportación, con la etiqueta de siempre. El detalle dice la cantidad de filas y los filtros (por ejemplo «12 fila(s) · estado CANCELLED»), sin correos de operadores ni nada de la columna nueva |
6. El contrato de la API (Network de DevTools)
| # | Paso | Resultado esperado |
|---|---|---|
| 6.1 | En Reporte individual, abrí DevTools → Network → la llamada GET /transacciones?… → Response | Cada elemento de data trae procesada_por como texto (vacío "" en una ACCEPTED). No trae resolved_by, resolvedBy ni resolved_by_user_id |
| 6.2 | Abrí una ficha → la llamada GET /transacciones/{id} | data.procesada_por con el mismo texto que el listado; tampoco trae resolved_by |
| 6.3 | Ordená por Procesada por y mirá la URL de la llamada | Lleva sort=procesada_por y responde 200 |
| 6.4 | Armá la misma URL con un orden inexistente (sort=cualquiera) | Responde 422: el orden sigue siendo una lista cerrada |
7. Pantalla chica y modo oscuro
| # | Paso | Resultado esperado |
|---|---|---|
| 7.1 | A 1280 px de ancho, con el menú lateral abierto | La página no tiene scroll horizontal; la tabla se desplaza dentro de su recuadro y Procesada por se ve al llegar al final |
| 7.2 | A 375 px de ancho (celular) | Igual: sin scroll horizontal de la página. En la tabla el correo va en una sola línea (se llega a él desplazando la tabla); en la ficha, si es muy largo, sí puede partirse en dos renglones, a propósito, para no desbordar |
| 7.3 | Pasá al modo oscuro y repetí 2.2 a 2.4 y 3.1 | Los textos se leen con buen contraste; no hay texto sobre fondo del mismo color |
8. No se rompió nada de lo que ya existía
| # | Paso | Resultado esperado |
|---|---|---|
| 8.1 | Como Cajero, pagá una disponible desde Pago (necesita la Carta y la Identificación cargadas y una caja abierta) y volvé a Reporte individual | La pagada aparece con su correo en Procesada por |
| 8.2 | Pagá otra desde la ficha, como Admin (mismos requisitos) | Pago normal, sin error, y la ficha pasa a mostrar Procesada por: admin@cislatam.test |
| 8.3 | Filtrá por país, PDV, fechas y buscá por nombre y por MTCN | Todo funciona como antes; los filtros se pueden combinar con el orden por Procesada por |
| 8.4 | Imprimí la papeleta de una pagada y abrí la sección de documentos | Sin cambios |
| 8.5 | El Dashboard y Reportes | Sin cambios |
9. Qué NO es parte de este cambio (no reportar como bug)
- Una pagada que sigue diciendo «Sin PDV asignado» no es un error de esta entrega (G4b): ahora el sistema lo dice, pero no lo corrige. Que el PDV de un pago sea el de la caja que pagó lo resuelve G4a (ADR-020): los pagos nuevos con módulo Caja ya lo traen y los viejos se completan desde su movimiento de caja. Lo que queda con «Sin PDV asignado» es un pago de un país sin módulo Caja hecho por un Admin, o un dato viejo o de demo sin movimiento de caja.
- Solo el correo, no el nombre y apellido de quien procesó: el sistema no guarda el nombre de las personas. Si el cliente lo quiere hay que agregarlo al usuario (QC-10 del plan, sin respuesta todavía; por defecto, el correo).
- «Sistema» y «Soterex (API)» son dos cosas distintas. Una transacción vencida no se le atribuye a Soterex. El plan de ajustes v3 solo preveía la API; el vencimiento se agregó porque también cancela sin persona. Los textos «Sistema» y «Cancelada por vencimiento del MTCN» no están en el plan: quedan para confirmar junto con QC-10.
- «Soterex (API)» es lo que queda por descarte: una cancelada sin persona y sin la marca del sistema se atribuye a Soterex, como fijó el plan. Una cancelada vieja o de demo sin operador también dice «Soterex (API)» (ver 5.9.1 del análisis funcional).
- A 1280 px con el menú abierto hay que desplazar la tabla para ver la novena columna. La tabla ya se desbordaba con ocho: no se rediseñó.
- Una pagada sin operador grabado (dato anterior a que se grabara) deja Procesada por vacía, no «Soterex (API)»: la API solo cancela. No hay un caso de esos en la demo; lo cubre un test automático.
- El Historial de la ficha conserva su redacción («API de Soterex», «Sistema»); la columna usa «Soterex (API)», que es el texto que pidió el plan.
Cómo reportarme el feedback
Para cada punto que falle, con el número de la tabla alcanza (ej. «2.3 dice Soterex (API) en vez de Sistema»). Si es algo visual, sumá el ancho de la pantalla y si estaba en modo claro u oscuro.

