Skip to content

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

EmailPerfilPara qué sirve acá
backoffice@cislatam.testCajero (GT-CAP-001)Buscar en Pago con el prefijo y pagar una transacción para ver el A4
supervisor@cislatam.testSupervisorBuscar en el Reporte individual
admin@cislatam.testAdminDescargar 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 escribeResultado esperado
1.1<MTCN> solo, con ceros y todoEncuentra la transacción (como antes)
1.2C-<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.3c-<MTCN> (minúscula)La encuentra
1.4C <MTCN> (espacio en vez de guion) y c - <MTCN>La encuentra, las dos
1.5C-8834-201-9921 con algún grupo de dígitos separado por guion o espacioSe acepta como número (los separadores se ignoran); encuentra algo solo si ese MTCN existe
1.6C, c, C-, c -«Ingresá un MTCN». No sale ningún pedido en la pestaña Red
1.7Carlos, C-abc, CC-123, C-C-123, D-123«Ingresá un MTCN». Sin pedido a la API
1.8C<MTCN> sin separador (por ejemplo C0000000144)«Ingresá un MTCN»: el prefijo exige el guion o el espacio
1.9Una 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.10Abrir el recorrido guiado de Pago (? → Ver el recorrido), paso del buscadorEl 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.

bash
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
#PedidoResultado esperado
2.1q=C-<MTCN>, c-<MTCN> y C%20<MTCN>200 con 1 resultado cada uno
2.2q=C-, C, Carlos, C-abc, CC-123, C<MTCN>422 con code: INVALID_MTCN y el mensaje «Ingresá un MTCN»
2.3Como admin@, Auditoría, acción Búsqueda en Pago, después de 2.1 y 2.2Un 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.4GET /transacciones?search=C-<MTCN> y search=c-<MTCN> con admin@ (o supervisor@)200 con la misma transacción que search=<MTCN>
2.5GET /transacciones?search=C-Ruiz200 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.

#PasoResultado esperado
3.1En Buscar, escribir <MTCN>Lista la transacción
3.2Escribir C-<MTCN> y c-<MTCN>Lista la misma transacción
3.3Escribir 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.4Con C-<MTCN> escrito, exportar el listadoEl archivo trae esa transacción (el export usa el mismo filtro)
3.5En la ficha y en la columna MTCN del listadoEl 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é mirarResultado esperado
4.1La fila de encabezados36 columnas, los mismos nombres y el mismo orden que antes. La AD se sigue llamando Transaction Status-Additional Notes
4.2U (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.3V (PIN Number)El mismo número sin prefijo
4.4W (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.5X (Payer Name)CIS Guatemala en todas las filas de Guatemala
4.6AC (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.7AD (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.8AG a AJ de una fila PaidNombre del PDV, su ciudad, su provincia y el país. En las ACCEPTED y CANCELLED, las cuatro vacías
4.9En Auditoría, la descargaUn evento Exportación de reporte con país, fechas, estado y cantidad de filas. Nada del contenido: ni un MTCN ni un nombre
4.10Un país que no tiene entrada en el mapa de entidades pagadorasLa 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.11Con 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é mirarResultado esperado
5.1La declaración del cliente del A4, en cada copiaCuatro incisos, (i) a (iv). No hay (v)
5.2El texto de los cuatro, contra la tirillaIdé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.3La hojaUna 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.4El 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.5Pagar otra con dirección de ~240 caracteres y mail de ~78, y bajar el A4Sigue en una página con las dos copias, cuatro incisos y nada cortado; la letra puede salir un poco más chica
5.6La línea AgenciaEl 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.7Transacción fija: Sí / NoSe sigue imprimiendo igual, para marcar a mano. Nadie contestó qué significa (QC-24)
5.8La tirillaSin 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.

#PasoResultado 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.2Lo 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.3Pagar una transacción en cada PDV (la caja de Chimaltenango arranca en cero: fondearla antes) y bajar el A4En la línea Agencia: el nombre real del PDV y su ciudad
6.4Bajar Cumplimiento (estado Pagada)AG el nombre, AH la ciudad, AI la provincia y AJ el país del PDV de cada pago
6.5Que GT-MIX-003 y GT-ESC-004 sigan activos y con sus datosSí: no están en la lista del cliente y se dejan hasta que apruebe la muestra (D3-23)
6.6Cerrar el ensayo en dev: docker exec soterex-backend-1 php artisan db:seed --class=StationSeederLos 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é mirarResultado esperado
7.1El MTCN en la API de Soterex (SendRequest, Cancel) y en la fichaSigue siendo de 10 dígitos, sin prefijo: Cancel exige exactamente 10. G9 no toca la integración C2P
7.2Los extractos de Tesorería, la papeleta y el listadoEl MTCN sin C-
7.3Las 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.4Los permisos del reporteSiguen siendo solo Admin; backoffice@ y supervisor@ no ven la pestaña ni la descarga

Qué sigue abierto (no bloquea nada) ​

PreguntaTemaMientras tanto
QC-19Transaction 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-20Transaction 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 ​

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

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