Skip to content

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

bash
docker compose exec backend php artisan demo:reseed

Paso 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.

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

MTCNEstadoCómo se resolvió
9000000001CANCELLEDEl Cancel de Soterex (cliente de la API, sin persona)
9000000002CANCELLEDEl vencimiento del MTCN (el sistema, sin persona ni cliente)
9000000003CANCELLEDUna persona de CIS (supervisor@cislatam.test) que no tiene un PDV que resolver
9000000004ACCEPTEDTodaví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».

EmailPerfilAlcanceQué ve en Reporte individual
admin@cislatam.testAdminGuatemala, todos los PDVsTodo lo de su alcance
supervisor@cislatam.testSupervisorGT-CAP-001 + GT-QUE-002Todo lo de su alcance, bolsa de disponibles incluida
backoffice@cislatam.testCajeroGT-CAP-001Solo lo que resolvió él
tesoreria@cislatam.testTesoreríaGuatemala, todos los PDVsNo 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 ​

#PasoResultado esperado
1.1docker exec soterex-backend-1 php artisan test --filter=ReporteIndividualProcesadaPorTestPasan 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='TransactionExportApiTestTransactionApiTest'`
1.3docker 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.4docker 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.

#PasoResultado esperado
2.1Mirá los encabezados de la tablaNueve columnas, en este orden: MTCN, Beneficiario, Estado, País, PDV, Monto, Creada, Última actualización y, al final, Procesada por
2.2Buscá Prueba G4 o filtrá por el MTCN 9000000001PDV: Cancelada por Soterex · Procesada por: Soterex (API)
2.3Lo mismo con 9000000002PDV: Cancelada por vencimiento del MTCN · Procesada por: Sistema (no «Soterex (API)»: no la canceló Soterex)
2.4Lo mismo con 9000000003PDV: Sin PDV asignado · Procesada por: supervisor@cislatam.test
2.5Filtrá por estado ACCEPTED y mirá cualquier fila de la bolsaPDV: Sin asignar (bolsa del país) · Procesada por: vacío
2.6Filtrá por estado PAID y buscá una fila de GT-CAP-001PDV: el nombre del PDV · Procesada por: backoffice@cislatam.test
2.7En las pagadas, buscá una que diga Sin PDV asignadoProcesada por: supervisor@cislatam.test (es el hueco de datos de RV3-17: pagó alguien con dos PDV y ningún PDV activo)
2.8Con el filtro CANCELLED, mirá una cancelada de la demoEl correo de quien la canceló y el nombre de su PDV
2.9Recorré los tres estados (PAID, CANCELLED, ACCEPTED) y varias páginasNinguna celda de PDV dice «—» ni queda vacía: o el nombre del PDV o uno de los cuatro textos
2.10Hacé clic en el encabezado Procesada porSe 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.11Hacé clic de nuevoOrden inverso; las filas sin persona pasan al principio
2.12Con ese orden puesto, cambiá el filtro de estado y pagináEl orden se mantiene y no hay error

3. La ficha ​

#PasoResultado esperado
3.1Abrí 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.2Abrí la de 9000000002PDV: Cancelada por vencimiento del MTCN y Procesada por: Sistema
3.3Abrí una pagada de GT-CAP-001PDV: el nombre · Procesada por: el correo de quien la pagó
3.4Abrí la de 9000000004 (ACCEPTED)PDV: Sin asignar (bolsa del país) y no hay renglón «Procesada por»
3.5En esa misma ficha, cancelala desde Cancelar transacciónAl 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.6En esa misma ficha, mirá el HistorialEl cambio de estado figura con el correo del Admin
3.7Mirá el Historial de 9000000001 y de 9000000002Siguen 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 ​

#PasoResultado esperado
4.1Entrá como backoffice@cislatam.test (Cajero) → Reporte individualSolo transacciones que resolvió él. La columna Procesada por trae en todas las filas su propio correo. No hay ACCEPTED
4.2Con ese usuario, ordená por Procesada porFunciona sin error (todas las filas tienen el mismo valor)
4.3Con 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.4Entrá como supervisor@cislatam.testVe 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.5Entrá como tesoreria@cislatam.testReporte individual no está en el menú, y entrar por la URL /transacciones no abre el listado

5. El Excel ​

#PasoResultado esperado
5.1Como Admin, filtrá por estado CANCELLED y tocá Exportar a ExcelBaja un archivo llamado reporte-individual-AAAAMMDD-HHMM.xlsx (antes se llamaba transacciones-…)
5.2Abrilo y mirá la primera filaNueve 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.3Buscá las filas 9000000001, 9000000002 y 9000000003Mismos textos que en pantalla (2.2, 2.3, 2.4), tanto en PDV como en Procesada por
5.4Mirá toda la columna PDVNinguna celda con «—» ni vacía
5.5Exportá con el filtro ACCEPTEDLa columna PDV dice «Sin asignar (bolsa del país)» y Procesada por queda vacía en todas
5.6Exportá con el filtro PAIDLas pagadas sin PDV dicen «Sin PDV asignado»; las demás, el nombre del PDV. Procesada por trae el correo en todas
5.7Ordená 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.8Como backoffice@, exportáEl archivo trae solo sus filas, con su correo en la novena columna
5.9Como Admin, entrá a Administración → Auditoría y buscá la acción Exportación de transaccionesHay 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) ​

#PasoResultado esperado
6.1En Reporte individual, abrí DevTools → Network → la llamada GET /transacciones?… → ResponseCada elemento de data trae procesada_por como texto (vacío "" en una ACCEPTED). No trae resolved_by, resolvedBy ni resolved_by_user_id
6.2Abrí una ficha → la llamada GET /transacciones/{id}data.procesada_por con el mismo texto que el listado; tampoco trae resolved_by
6.3Ordená por Procesada por y mirá la URL de la llamadaLleva sort=procesada_por y responde 200
6.4Armá la misma URL con un orden inexistente (sort=cualquiera)Responde 422: el orden sigue siendo una lista cerrada

7. Pantalla chica y modo oscuro ​

#PasoResultado esperado
7.1A 1280 px de ancho, con el menú lateral abiertoLa página no tiene scroll horizontal; la tabla se desplaza dentro de su recuadro y Procesada por se ve al llegar al final
7.2A 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.3Pasá al modo oscuro y repetí 2.2 a 2.4 y 3.1Los 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 ​

#PasoResultado esperado
8.1Como Cajero, pagá una disponible desde Pago (necesita la Carta y la Identificación cargadas y una caja abierta) y volvé a Reporte individualLa pagada aparece con su correo en Procesada por
8.2Pagá otra desde la ficha, como Admin (mismos requisitos)Pago normal, sin error, y la ficha pasa a mostrar Procesada por: admin@cislatam.test
8.3Filtrá por país, PDV, fechas y buscá por nombre y por MTCNTodo funciona como antes; los filtros se pueden combinar con el orden por Procesada por
8.4Imprimí la papeleta de una pagada y abrí la sección de documentosSin cambios
8.5El Dashboard y ReportesSin 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.

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