Plan de Pruebas — G9: Cumplimiento, recibo A4, búsqueda con «C-» y los tres PDV reales
Fecha: 2026-10-07 Decisión: plan de ajustes v3, entrega G9 (RV3-32, 87 a 95 y H3-05; decisiones D3-17, D3-18 y D3-22; preguntas QC-19 a QC-24 con su valor por defecto) · plan, §4 G9 Ambiente: Dev local (./start-dev.sh) — http://localhost:5173 — o Staging con las cuentas de prueba
Qué cambió, en cuatro frases: el reporte de Cumplimiento pone el prefijo C- al MTCN (columna 21) y no al PIN (22), saca la entidad pagadora de un mapa por país (24) y deja siempre vacías las notas (30); la pantalla de Pago y el filtro del Reporte individual encuentran un MTCN pegado como lo imprime la carta de Soterex (C-5436014032); el recibo A4 vuelve a los cuatro incisos de la declaración, los mismos de la tirilla; y los tres puntos de venta reales de Guatemala se cargan por la pantalla de un Admin (es un procedimiento, no una migración). Lo que no cambia: las columnas 23 (Transaction Status) y 29 (Update) siguen como estaban hasta que el cliente conteste QC-19 y QC-20. Ver el manual de Cumplimiento, el de Pago y el runbook de los PDV.
Antes de empezar
Usuarios (las contraseñas están en doc/environments/dev.md):
| Perfil | Para qué sirve acá | |
|---|---|---|
backoffice@cislatam.test | Cajero (GT-CAP-001) | Buscar en Pago con el prefijo y pagar una transacción para ver el A4 |
supervisor@cislatam.test | Supervisor | Buscar en el Reporte individual |
admin@cislatam.test | Admin | Descargar Cumplimiento, mirar Auditoría y (en el ensayo del punto 6) editar estaciones |
Datos. En dev, php artisan demo:reseed deja transacciones ACCEPTED, PAID y CANCELLED (en dev; correrlo en Staging lo decide Carlos, ver staging.md). Los MTCN de la demo tienen ceros a la izquierda (0000000144); en Staging son de 10 dígitos reales. Abajo, <MTCN> es el de una transacción ACCEPTED y <MTCN pagada> el de una PAID.
Sin tocar variables. El prefijo del reporte es C- por defecto. Apagarlo es configuración de infraestructura (ver el runbook) y lo cubre una prueba automatizada: no se prueba a mano en dev.
El throttle de Pago. La búsqueda de Pago admite 10 por minuto. Si aparece un 429 en medio de los casos, esperar un minuto.
1. Pago: el MTCN tal como lo imprime la carta (H3-05)
Entrar como backoffice@ a Pago. Escribir en el buscador y apretar Enter. Para ver qué viaja, abrir las herramientas del navegador, pestaña Red.
| # | Se escribe | Resultado esperado |
|---|---|---|
| 1.1 | <MTCN> solo, con ceros y todo | Encuentra la transacción (como antes) |
| 1.2 | C-<MTCN> | Encuentra la misma transacción. En la pestaña Red, el pedido es GET /api/pago/buscar?q=<MTCN>: viajan solo los dígitos; el campo conserva lo que pegaste |
| 1.3 | c-<MTCN> (minúscula) | La encuentra |
| 1.4 | C <MTCN> (espacio en vez de guion) y c - <MTCN> | La encuentra, las dos |
| 1.5 | C-8834-201-9921 con algún grupo de dígitos separado por guion o espacio | Se acepta como número (los separadores se ignoran); encuentra algo solo si ese MTCN existe |
| 1.6 | C, c, C-, c - | «Ingresá un MTCN». No sale ningún pedido en la pestaña Red |
| 1.7 | Carlos, C-abc, CC-123, C-C-123, D-123 | «Ingresá un MTCN». Sin pedido a la API |
| 1.8 | C<MTCN> sin separador (por ejemplo C0000000144) | «Ingresá un MTCN»: el prefijo exige el guion o el espacio |
| 1.9 | Una búsqueda por nombre (Rojas) | «Ingresá un MTCN», como antes: Pago no busca por nombre (es la regla anti-enumeración y no se aflojó) |
| 1.10 | Abrir el recorrido guiado de Pago (? → Ver el recorrido), paso del buscador | El texto dice que se puede pegar el MTCN con o sin «C-» |
2. Por API: la misma regla, sin depender de la pantalla
Con el emulador de Firebase de dev. La API ya rechaza lo que la pantalla frena, así que se prueba directo.
login() { # login <email> <password de dev.md>
curl -s -X POST 'http://localhost:9099/identitytoolkit.googleapis.com/v1/accounts:signInWithPassword?key=fake-api-key' \
-H 'Content-Type: application/json' \
-d "{\"email\":\"$1\",\"password\":\"$2\",\"returnSecureToken\":true}" \
| python3 -c 'import sys,json;print(json.load(sys.stdin)["idToken"])'
}
TOKEN=$(login backoffice@cislatam.test '<su contraseña>')
for q in 'C-<MTCN>' 'c-<MTCN>' 'C%20<MTCN>' 'C-' 'C' 'Carlos' 'C-abc' 'CC-123' 'C<MTCN>'; do
printf '%-22s ' "$q"
curl -s -o /tmp/r.json -w '%{http_code} ' -H "Authorization: Bearer $TOKEN" "http://localhost:3000/pago/buscar?q=$q"
python3 -c 'import json;d=json.load(open("/tmp/r.json"));print(d.get("code") or len(d.get("data",[])))'
done| # | Pedido | Resultado esperado |
|---|---|---|
| 2.1 | q=C-<MTCN>, c-<MTCN> y C%20<MTCN> | 200 con 1 resultado cada uno |
| 2.2 | q=C-, C, Carlos, C-abc, CC-123, C<MTCN> | 422 con code: INVALID_MTCN y el mensaje «Ingresá un MTCN» |
| 2.3 | Como admin@, Auditoría, acción Búsqueda en Pago, después de 2.1 y 2.2 | Un evento por intento, también los que dieron 422. Los válidos muestran lo tipeado y la cantidad de resultados; los inválidos no guardan lo tipeado (ni Carlos ni C-abc) y dicen «búsqueda inválida · 0 resultado(s)» |
| 2.4 | GET /transacciones?search=C-<MTCN> y search=c-<MTCN> con admin@ (o supervisor@) | 200 con la misma transacción que search=<MTCN> |
| 2.5 | GET /transacciones?search=C-Ruiz | 200 sin resultados: el prefijo se descarta solo cuando lo que sigue son dígitos, así un apellido que empieza con «C-» queda intacto |
3. Reporte individual: el filtro de búsqueda
Entrar como supervisor@ (o admin@) a Reporte individual.
| # | Paso | Resultado esperado |
|---|---|---|
| 3.1 | En Buscar, escribir <MTCN> | Lista la transacción |
| 3.2 | Escribir C-<MTCN> y c-<MTCN> | Lista la misma transacción |
| 3.3 | Escribir C-Ruiz o C- | No falla ni lo toma por un MTCN: busca ese texto tal cual (en la demo no hay nada que lo contenga), porque el prefijo solo se descarta delante de dígitos |
| 3.4 | Con C-<MTCN> escrito, exportar el listado | El archivo trae esa transacción (el export usa el mismo filtro) |
| 3.5 | En la ficha y en la columna MTCN del listado | El MTCN sin prefijo: el C- no se guarda ni se muestra, solo se tolera al buscar |
4. Cumplimiento: el Excel
Entrar como admin@ a Reportes → Cumplimiento. País Guatemala, rango abierto (Quitar fechas) y estado Todos; Descargar Excel y abrirlo (Excel, Numbers o LibreOffice). Letras de columna: la 21 es U, la 22 V, la 23 W, la 24 X, la 29 AC, la 30 AD y la 33 a 36 AG a AJ.
| # | Qué mirar | Resultado esperado |
|---|---|---|
| 4.1 | La fila de encabezados | 36 columnas, los mismos nombres y el mismo orden que antes. La AD se sigue llamando Transaction Status-Additional Notes |
| 4.2 | U (MTCN Number) | C- más el MTCN, en todas las filas: C-0000000315 en la demo, C-5436014032 en un MTCN real. Es texto: conserva los ceros |
| 4.3 | V (PIN Number) | El mismo número sin prefijo |
| 4.4 | W (Transaction Status) | Sent en todas, igual que antes. Esta columna no se tocó: el cliente escribió «Send» y no se sabe cuál es el literal de su planilla (QC-19) |
| 4.5 | X (Payer Name) | CIS Guatemala en todas las filas de Guatemala |
| 4.6 | AC (Transaction Status - Update) | Pending, Paid o Cancelled, según el estado. No se tocó: sigue en inglés (el cliente lo escribió en español: QC-20) |
| 4.7 | AD (Additional Notes) | Vacía en todas las filas, también en las canceladas (antes traía el motivo) y en las pagadas (antes traía el código del PDV) |
| 4.8 | AG a AJ de una fila Paid | Nombre del PDV, su ciudad, su provincia y el país. En las ACCEPTED y CANCELLED, las cuatro vacías |
| 4.9 | En Auditoría, la descarga | Un evento Exportación de reporte con país, fechas, estado y cantidad de filas. Nada del contenido: ni un MTCN ni un nombre |
| 4.10 | Un país que no tiene entrada en el mapa de entidades pagadoras | La X sale vacía: el reporte no inventa una razón social. No se puede armar a mano en dev (solo Guatemala tiene entrada y está activa): lo cubren las pruebas automatizadas del final |
| 4.11 | Con el prefijo apagado en Staging (solo después del runbook «Apagar o cambiar el prefijo») | U trae el número crudo y V sigue igual |
5. Recibo A4: cuatro incisos
Como backoffice@, pagar una transacción ACCEPTED (con los datos del pago completos y los documentos que bloquean) y, ya pagada, apretar Imprimir papeleta A4. Después, Imprimir papeleta tirilla de la misma.
| # | Qué mirar | Resultado esperado |
|---|---|---|
| 5.1 | La declaración del cliente del A4, en cada copia | Cuatro incisos, (i) a (iv). No hay (v) |
| 5.2 | El texto de los cuatro, contra la tirilla | Idéntico, palabra por palabra. El último termina en «…comerciales y de marketing.» (el quinto inciso que había agregado B5.3 ya no está) |
| 5.3 | La hoja | Una sola página, con las dos copias (cliente y agencia) separadas por la línea de corte, y las firmas del cliente y del operador completas en las dos |
| 5.4 | El A4 de una transacción ya pagada hace días (reimpresión) | También sale con cuatro: la declaración no se guarda por recibo, es una constante |
| 5.5 | Pagar otra con dirección de ~240 caracteres y mail de ~78, y bajar el A4 | Sigue en una página con las dos copias, cuatro incisos y nada cortado; la letra puede salir un poco más chica |
| 5.6 | La línea Agencia | El nombre del PDV y su Ciudad (la ciudad del PDV; la del domicilio del beneficiario está más arriba). Un PDV sin ciudad cargada imprime un guion |
| 5.7 | Transacción fija: Sí / No | Se sigue imprimiendo igual, para marcar a mano. Nadie contestó qué significa (QC-24) |
| 5.8 | La tirilla | Sin cambios: mismo contenido y mismo tamaño que antes de G9 |
6. Los tres PDV reales de Guatemala (G9.7)
Es un procedimiento para un Admin, no una migración (D3-17): Cargar los tres puntos de venta reales de Guatemala. No se ejecutó al cerrar G9. Acá, cómo verificarlo cuando se haga.
| # | Paso | Resultado esperado |
|---|---|---|
| 6.1 | (Ensayo, solo en dev.) Como admin@, Parámetros › Estaciones / PDV › Editar GT-CAP-001: nombre, dirección, provincia y ciudad de la tabla del runbook, sin tocar el código interno; Guardar cambios | «Estación actualizada.»; la columna Ciudad / provincia ya no es un guion; Auditoría trae Estación modificada (STATION_UPDATED) con el valor anterior y el nuevo |
| 6.2 | Lo mismo con GT-QUE-002 y Nueva estación para Chimaltenango | «Estación creada.»; la nueva trae su caja y deja Estación creada (STATION_CREATED) en Auditoría. Elegir una ciudad que no cuelga de la provincia no se deja (la ciudad se habilita después de la provincia) |
| 6.3 | Pagar una transacción en cada PDV (la caja de Chimaltenango arranca en cero: fondearla antes) y bajar el A4 | En la línea Agencia: el nombre real del PDV y su ciudad |
| 6.4 | Bajar Cumplimiento (estado Pagada) | AG el nombre, AH la ciudad, AI la provincia y AJ el país del PDV de cada pago |
| 6.5 | Que GT-MIX-003 y GT-ESC-004 sigan activos y con sus datos | Sí: no están en la lista del cliente y se dejan hasta que apruebe la muestra (D3-23) |
| 6.6 | Cerrar el ensayo en dev: docker exec soterex-backend-1 php artisan db:seed --class=StationSeeder | Los dos PDV editados vuelven a sus datos de fixture (el de Chimaltenango, creado a mano, queda: se desactiva desde Estaciones si estorba, previo cierre de su caja). demo:reseed no toca las estaciones. Nunca StationSeeder ni db:seed en Staging: revierten los datos reales de un PDV |
Dos decisiones que quedan en el valor por defecto hasta que el cliente conteste: las direcciones se cargan tal cual vinieron, con «NTERAMERICANA» y «MVEL 2» (QC-22), y la ciudad de la capital queda como «Guatemala», no «Ciudad de Guatemala» (QC-23: renombrarla cambia también el A4 y Cumplimiento de todos los pagos de ese municipio).
7. Lo que no tiene que haber cambiado
| # | Qué mirar | Resultado esperado |
|---|---|---|
| 7.1 | El MTCN en la API de Soterex (SendRequest, Cancel) y en la ficha | Sigue siendo de 10 dígitos, sin prefijo: Cancel exige exactamente 10. G9 no toca la integración C2P |
| 7.2 | Los extractos de Tesorería, la papeleta y el listado | El MTCN sin C- |
| 7.3 | Las demás columnas de Cumplimiento (beneficiario, monto, fechas, moneda, estado y agencia) y las dos que esperan al cliente (W y AC) | Igual que antes |
| 7.4 | Los permisos del reporte | Siguen siendo solo Admin; backoffice@ y supervisor@ no ven la pestaña ni la descarga |
Qué sigue abierto (no bloquea nada)
| Pregunta | Tema | Mientras tanto |
|---|---|---|
| QC-19 | Transaction Status: el cliente escribió «Send» y el archivo dice «Sent» | Queda Sent: es un archivo regulatorio y una letra de diferencia es un error |
| QC-20 | Transaction Status - Update: ¿en español? | Queda en inglés |
| QC-21 | ¿Siguen necesitando el C- en el MTCN del reporte? (también S-2, a Soterex) | Se aplica C-; se apaga con una variable |
| QC-22 | ¿Las direcciones tal cual o corregidas? | Tal cual |
| QC-23 | ¿La capital se llama «Ciudad de Guatemala»? | Queda «Guatemala» |
| QC-24 | ¿Qué significa Transacción fija: Sí / No? | Se sigue imprimiendo igual |
Al terminar
- Las descargas de Cumplimiento y los A4 con datos de prueba son para mirar: no se guardan en el repo (llevan datos de personas de demo).
- Si se hizo el ensayo del punto 6 en dev, volver a los datos de fixture con el comando de 6.6 (solo local).
- Los pagos de prueba de Staging quedan en el historial: anotar con qué usuario se hicieron.
Pruebas automatizadas que lo respaldan
docker exec soterex-backend-1 php artisan test --filter MtcnBusquedaTest
docker exec soterex-backend-1 php artisan test --filter PagoApiTest
docker exec soterex-backend-1 php artisan test --filter TransactionApiTest
docker exec soterex-backend-1 php artisan test --filter ReporteCumplimientoApiTest
docker exec soterex-backend-1 php artisan test --filter PapeletaFormatosTest
docker exec soterex-backend-1 php artisan test --filter ManualPdfTest
docker exec soterex-frontend-1 sh -c 'cd /app && npx vitest run src/utils/__tests__/mtcn.spec.ts src/views/__tests__/PagoView.spec.ts'Qué cubre cada una: MtcnBusquedaTest, la regla del prefijo (una sola C, mayúscula o minúscula, más al menos un guion o espacio y solo si lo que sigue son dígitos con separadores) con la tabla de lo que se acepta y lo que no; PagoApiTest, la búsqueda con prefijo, que se audita igual, y que C, C- y Carlos dan 422 sin consultar transactions ni guardar lo tipeado; TransactionApiTest, el filtro del listado; ReporteCumplimientoApiTest, los 36 encabezados, el MTCN con prefijo y el PIN sin él, el prefijo apagado y cambiado por configuración, la entidad pagadora por país (con un país sin entrada y una entrada en blanco, que salen vacíos), la columna 30 vacía en los tres estados y que el servicio ya no lee la auditoría; PapeletaFormatosTest, los cuatro incisos, el texto idéntico al de la tirilla, que cada copia imprime el suyo y que con una dirección de 240 caracteres sigue en una sola hoja; ManualPdfTest, que los cuatro manuales por perfil se siguen armando con las páginas que cambiaron (Pago, Reporte individual, Cumplimiento y Países); y las del frontend, la regla del buscador de Pago (la misma tabla que la del backend, para que no se separen) y que a la API solo le llegan los dígitos.

