Skip to content

Plan de Pruebas — G12: qué ve de la Holding una Tesorería de un solo país, y los rótulos de los extractos ​

Fecha: 2026-10-07 Decisión: ADR-007 §1 (actualización de G12), ADR-014 §1 (Tesorería es un único perfil) y ADR-015 §5 · plan de ajustes v3, entrega G12 (RV3-48, 55, 58, 66, 72, 73, 85, 97, H3-10 y H3-11; decisiones D3-T1 y D3-19 b; QC-32 por defecto) · plan, §4 G12 Ambiente: Dev local (./start-dev.sh) — http://localhost:5173 — o Staging con las cuentas de prueba (ver «En Staging», al final)

Qué cambió, en cuatro frases: la tarjeta de Prefondeo Soterex se llama Saldo con Soterex (el «saldo final con Soterex» de la hoja del cliente) y, para quien no lee todos los países, suma solo los suyos, se llama Saldo de la Holding — de sus países y trae un aviso, en vez de mostrarle el saldo global; «no lee todos los países» deja de contar a un país inactivo y sin movimientos (El Salvador y Honduras se siembran así), así que una Tesorería de los países reales ya no ve un aviso de «parcial» sin motivo; los extractos se rotulan como la hoja: el de País se encabeza CIS Guatemala, su PDF se titula Extracto — Fondeo PDVs · País (disponible para distribuir) y el encabezado de CIS Holding dice «de los cuales comisiones»; y el manual dice que se carga el monto que notificó el nivel de arriba y no el que acreditó el banco. Lo que no cambia: ningún saldo, ningún asiento, ningún permiso ni la matriz de perfiles, y no hay migración ni comando que correr. Ver el manual de Prefondeo Soterex y el análisis funcional de Roles y Permisos, 2.3.3, con la tabla de quién ve qué extracto.

Este es el primer plan de pruebas de los cuatro extractos de tesorería (B7 no tuvo uno): además de lo de G12, la sección 6 recorre cada extracto con los rótulos de la hoja del cliente.

Antes de empezar ​

Usuarios (las contraseñas están en doc/environments/dev.md):

EmailPerfilAlcancePara qué sirve acá
tesoreria@cislatam.testTesoreríaSolo Guatemala, todos los PDVLa «Tesorería Local» de la hoja: el caso central
admin@cislatam.testAdminSolo Guatemala, todos los PDVActivar y desactivar países, dar de alta cuentas, mirar Auditoría. Como tesoreria@, ve la Holding de un solo país
supervisor@cislatam.testSupervisorGT-CAP-001 y GT-QUE-002Ve solo la pestaña PDV de Fondeo PDVs
Una cuenta regional (regional@cislatam.test)TesoreríaLa que arme cada caso (sección 3)La «Tesorería Regional» de la hoja: no existe en dev, se crea desde Usuarios y Accesos con admin@ (alta por correo; la contraseña se muestra una sola vez, copiarla). No es un perfil aparte: es el perfil Tesorería con una asignación por país, porque no existe una asignación «todos los países»

El estado de los países en dev. Guatemala está activa; El Salvador (SV) y Honduras (HN) existen, pero inactivos y sin ningún movimiento. Es la misma base que Staging. Los casos de abajo los activan y desactivan desde Parámetros › Países (/admin/ubicaciones/paises, botones Reactivar y Desactivar) con admin@; al terminar hay que dejarlos como estaban (ver «Al terminar»).

Qué cuenta como «un país que falta». Una persona que no tiene asignación de Tesorería en un país lo ve como faltante si ese país está activo o tiene movimientos (un asiento de prefondeo, un envío al país o un pago pagado), aunque esté inactivo. Un país inactivo y vacío no cuenta. Esa regla es una sola para la tarjeta y para los dos extractos de la Holding.

Los números de dev no son los de la planilla del cliente. Un demo:reseed los cambia. Por eso los casos comparan números entre sí (la tarjeta contra el Monto actual de la pestaña) y no contra una cifra fija. Los de la planilla (32.292 / 20.208 / 7.000 / 1.500 / 4.000 y 12.500) los reproduce el test test_reproduce_la_planilla_del_cliente_paso_a_paso (ver el final).

Por API (los casos de la sección 5), con el emulador de Firebase de dev:

bash
login() {  # login <email> <contraseña 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 tesoreria@cislatam.test '<su contraseña>')
SV=$(docker exec soterex-postgres-1 psql -U postgres -d soterex -Atc "select id from countries where iso_code = 'SV'")
GT=$(docker exec soterex-postgres-1 psql -U postgres -d soterex -Atc "select id from countries where iso_code = 'GT'")

1. La base de dev tal cual: Tesorería de Guatemala, sin ningún aviso (H3-10) ​

SV y HN están inactivos y vacíos. Entrar como tesoreria@ a Tesorería › Prefondeo Soterex.

#PasoResultado esperado
1.1Mirar la tarjeta de arriba a la izquierdaSe llama Saldo con Soterex (no «Saldo global de la Holding»)
1.2Leer la leyenda de la tarjetaEmpieza con «De todos los países juntos.», sigue con «Cada pago resta el principal más la comisión…» y no hay ningún aviso azul debajo
1.3Pestaña Soterex ↔ CIS HoldingSin aviso de extracto parcial. Su Monto actual (con la leyenda «Saldo con Soterex: lo que queda de su prefondeo») es el mismo número que la tarjeta
1.4Pestaña CIS HoldingSin aviso de extracto parcial. Antes de G12 el aviso salía acá aunque SV y HN estuvieran vacíos
1.5No existe un filtro País en las dos pestañasCon un solo país legible no se dibuja (comportamiento de B7)
1.6Entrar como admin@ (también de solo Guatemala)Lo mismo que 1.1 a 1.4
1.7Por API: curl -s -H "Authorization: Bearer $TOKEN" 'http://localhost:3000/prefondeo'Trae balance, scope.partial = false, scope.countries con solo GT y scope.message = null

2. Hay otro país que cuenta: la tarjeta pasa a ser la de sus países (H3-11) ​

Como admin@, ir a /admin/ubicaciones/paises y Reactivar El Salvador. Volver como tesoreria@ y recargar Prefondeo Soterex.

#PasoResultado esperado
2.1Mirar la tarjetaSe llama Saldo de la Holding — de sus países
2.2Leer la leyendaYa no dice «De todos los países juntos.» Empieza con «Cada pago resta el principal más la comisión…»
2.3Debajo de la leyendaUn aviso azul: «Este saldo es el de GT: el saldo global de la Holding incluye también los demás países.»
2.4Pestañas Soterex ↔ CIS Holding y CIS HoldingLas dos con el aviso azul de extracto parcial: «Se muestran solo los movimientos de GT: el saldo global de la Holding incluye también los demás países.»
2.5Comparar el número de la tarjeta con el Monto actual de la pestaña Soterex ↔ CIS HoldingIguales, y la leyenda del Monto actual ya no dice Saldo con Soterex sino «Saldo de la Holding de sus países: lo que queda de su prefondeo», igual que la tarjeta. Con SV activo pero vacío el número coincide con el de antes: lo que cambió es el rótulo y el aviso (el caso con otro número está en la sección 4)
2.6Cargar un asiento de USD 10 en Guatemala (con Referencia «QA G12»)«Asiento cargado.» La tarjeta sube 10, sigue llamándose Saldo de la Holding — de sus países y el aviso no desaparece (la respuesta del alta usa el mismo alcance). demo:reseed borra ese asiento
2.7Abrir el recorrido guiado (? › Ver el recorrido), paso 1El título es Saldo con Soterex y el texto aclara que, con acceso a algunos países, la tarjeta se llama Saldo de la Holding — de sus países y avisa cuáles suma. El resaltado cae sobre la tarjeta (no se movió)
2.8Entrar como admin@ (también de solo Guatemala) con El Salvador activoLo mismo: tarjeta de sus países y aviso. El alta de un país no asigna al Admin; si da de alta uno, él también tiene que asignarse
2.9Como admin@, Desactivar El Salvador y recargar como tesoreria@Vuelve el caso de la sección 1: sin aviso y con Saldo con Soterex
2.10Modo oscuro y 375 pxEl aviso azul y la leyenda se leen; la tarjeta no se corta

3. Una Tesorería de todos los países: regional por asignación (D3-T1, RV3-48 y RV3-73) ​

Con admin@, en Usuarios y Accesos, dar de alta regional@cislatam.test con dos asignaciones de Tesorería, Guatemala y El Salvador, ambas sin acotar por PDV (una asignación por país: no existe «todos los países»). Honduras sin asignación. Reactivar El Salvador. Entrar como regional@ a Prefondeo Soterex.

#PasoResultado esperado
3.1La tarjetaSaldo con Soterex, con «De todos los países juntos.» y sin aviso: Honduras está inactivo y vacío, no es un país que falte
3.2Las dos pestañas de extractoSin aviso de parcial. Aparece el filtro País (ahora son dos países legibles): Todos los países, Guatemala y El Salvador
3.3En el filtro País, elegir GuatemalaEl extracto se vuelve parcial: el aviso azul dice que se muestran solo los movimientos de GT (pide el desglose de un país, comportamiento de B7)
3.4Como admin@, Reactivar Honduras, y recargar como regional@Ahora la tarjeta se llama Saldo de la Holding — de sus países, con el aviso «Este saldo es el de GT, SV: …» y los dos extractos con el aviso: Honduras es un país nuevo activo y la persona no lo tiene asignado. Es lo que dice el manual: al dar de alta un país hay que sumárselo
3.5Como admin@, sumarle a regional@ una asignación de Tesorería en Honduras y recargar como regional@Vuelve el caso 3.1: Saldo con Soterex, «De todos los países juntos.» y sin aviso
3.6Buscar en Usuarios y Accesos si existe un rol «Tesorería Local» o «Regional»No existe: son cuatro roles. La cuenta regional@ tiene el mismo rol que tesoreria@, y las pantallas no muestran ninguna etiqueta «Regional» ni «Local»
3.7Como admin@, abrir Roles y permisos de la ficha de regional@La matriz de Tesorería es la de siempre (Prefondeo Soterex y Fondeo PDVs con lectura y escritura): G12 no cambió ninguna celda

4. El número cambia: un país inactivo con movimientos cuenta (H3-10 y H3-11) ​

Es el caso que muestra, con números distintos, la diferencia entre el saldo global y el de sus países. Deja un asiento en la base local para siempre (los asientos no se borran desde la app; ver «Al terminar»): hacerlo una sola vez. Partir del estado del final de la sección 3, con regional@ asignada a GT, SV y HN y los tres países activos.

#PasoResultado esperado
4.1Como regional@, anotar el Saldo con Soterex (lo llamamos S). Cargar un asiento de USD 100 en El Salvador (elegir el país en el alta, referencia «QA G12»)«Asiento cargado.» La tarjeta pasa a S + 100 y sigue siendo Saldo con Soterex, sin aviso
4.2Como tesoreria@ (solo GT), mirar la tarjetaSaldo de la Holding — de sus países con el valor S (no S + 100: los 100 de El Salvador no se le muestran), y el aviso azul
4.3Pestaña Soterex ↔ CIS Holding de tesoreria@El Monto actual es S, igual que la tarjeta, y no lista el asiento de El Salvador
4.4Como admin@, Desactivar Honduras (sigue vacío) y recargar como tesoreria@Sigue el aviso y la tarjeta de sus países con S: El Salvador está activo. Todavía no discrimina nada
4.5Como admin@, Desactivar El Salvador. Recargar como tesoreria@Sigue el aviso y la tarjeta de sus países con S. Este es el caso que prueba la regla: Honduras (inactivo y vacío) no pesa, y El Salvador (inactivo pero con movimientos) sí, porque su plata está en el saldo global. Si el aviso desapareciera acá, la regla estaría mal
4.6Recargar como regional@Saldo con Soterex con S + 100, sin aviso: tiene asignados los tres países y por eso ve la Holding completa aunque El Salvador y Honduras estén inactivos

5. Por API: lo que no se ve, no se ve, y lo que no se puede cargar, no se carga ​

Con $TOKEN de tesoreria@ (solo Guatemala) y con El Salvador existente (activo o no). Antes de empezar, anotar cuántos asientos hay:

bash
docker exec soterex-postgres-1 psql -U postgres -d soterex -Atc \
  "select (select count(*) from prefunding_entries), (select count(*) from country_prefunding_entries)"
#PedidoResultado esperado
5.1GET /prefondeo?country_id=$SV403 PERMISSION_DENIED, «No tenés acceso a ese país.»
5.2GET /tesoreria/extractos/pais?country_id=$SV403, el mismo mensaje
5.3GET /tesoreria/extractos/holding?country_id=$SV y …/soterex-holding?country_id=$SV403 los dos
5.4POST /prefondeo con {"country_id":"<SV>","amount":1}403 PERMISSION_DENIED, «No tenés permiso para cargar prefondeo en ese país.» (las escrituras son siempre por país; el test faltaba y ahora existe)
5.5POST /prefondeo-pais con el mismo cuerpo403, el mismo mensaje
5.6Volver a contar los asientosLos mismos números que antes: ningún 403 escribió nada
5.7GET /prefondeo (sin país)200 con scope.countries = solo GT: nunca lista los países que le faltan
5.8Con $TOKEN de supervisor@: GET /prefondeo, GET /tesoreria/extractos/holding, …/soterex-holding y …/pais?country_id=$GT403 los cuatro. Solo …/pdv de sus PDV responde 200
5.9Con $TOKEN de tesoreria@: GET /tesoreria/extractos/pdv?station_id=<un PDV de Guatemala>200, completo: la Tesorería de un país ve todos los PDV del país
5.10Con admin@, dar de alta acotada@cislatam.test con una asignación de Tesorería en Guatemala acotada a un solo PDV (GT-CAP-001) y pedir con su token GET /prefondeo?country_id=$GT403 PERMISSION_DENIED, sin saldo ni asientos en el cuerpo: un país acotado por PDV no cuenta para la tarjeta, igual que para los extractos
5.11Con el mismo token: GET /prefondeo (sin país) y GET /tesoreria/extractos/soterex-holdingEl primero, 200 con balance en null y sin asientos; el segundo, 403. La tarjeta y el extracto leen los mismos países

6. Los rótulos que el cliente compara con su hoja (G12.4) ​

Entrar como tesoreria@, con el rango por defecto o uno que tenga pagos.

#DóndeResultado esperado
6.1Fondeo PDVs › País, encima del extractoUn encabezado CIS Guatemala (la columna «CIS GUATEMALA» de la hoja)
6.2La leyenda del Monto actual del extracto PaísDisponible para distribuir del país: es el «CIS Guatemala» de la planilla, y no el saldo del país de la tarjeta de arriba (la diferencia está explicada en el manual)
6.3Exportar PDF del extracto PaísEl archivo se titula «Extracto — Fondeo PDVs · País (disponible para distribuir)» y el membrete dice CIS Guatemala. (El nombre del archivo no cambió: extracto-pais-gt-<desde>-<hasta>.pdf; extracto_pais es la entidad con la que queda el export en Auditoría)
6.3bCon El Salvador activo (sección 2): Exportar PDF de CIS Holding y de Soterex ↔ CIS Holding como tesoreria@El encabezado del PDF, en el alcance, dice «Guatemala — parcial: no incluye los demás países». Con El Salvador inactivo (sección 1) dice «Todos los países»
6.4Exportar Excel del extracto PaísAbre, con las columnas Fecha, Concepto, Referencia, Débito, Crédito y Saldo y la fila Saldo anterior. El Excel no lleva título ni membrete: eso es del PDF
6.5Prefondeo Soterex › Soterex ↔ CIS Holding, leyenda del Monto actual«Saldo con Soterex: lo que queda de su prefondeo» (con un alcance parcial, «Saldo de la Holding de sus países: …», ver 2.5)
6.6Prefondeo Soterex › CIS Holding, leyenda del Monto actual«Lo que la Holding tiene sin repartir. Incluye las comisiones; no incluye lo ya enviado a los países», y la nota de abajo lo repite
6.7Fondeo PDVs › PDV, extracto de un PDVSin encabezado CIS: es el de un PDV, no el del país. Sin cambios respecto de B7
6.8Buscar en la app el rótulo viejo «Saldo global de la Holding»No aparece en la pantalla ni en el recorrido guiado

7. «De los cuales comisiones» en CIS Holding (G12.3, RV3-66) ​

Hace falta tener pagos en el rango (php artisan demo:reseed los deja; solo contra la base local).

#PasoResultado esperado
7.1Prefondeo Soterex › CIS Holding: mirar la tarjeta Créditos del períodoDebajo del monto dice «de los cuales comisiones: USD …»
7.2Pasar a la página 2 del listado (si el rango tiene más de una página)El número no cambia: es la suma de las comisiones de todo el rango, no de la página que se ve
7.3Exportar a Excel y sumar a mano la columna Crédito de las filas con concepto Comisión del pagoEl total es el mismo que el de la tarjeta
7.4Elegir un rango sin ningún pago (por ejemplo, uno anterior al primer movimiento de la base)Dice «de los cuales comisiones: USD 0.00»: con cero se muestra el cero
7.5Pestaña Soterex ↔ CIS HoldingNo tiene esa línea: ahí la comisión va adentro del débito de cada pago
7.6Fondeo PDVs › País y › PDVNo tienen esa línea: la comisión nunca toca el país ni la caja
7.7Por API: GET /tesoreria/extractos/holdingTrae commissions_total en el primer nivel. Los exports no lo traen
7.8Con la planilla del cliente (no a mano: lo hace el test)Comisiones 208 y pagos de PDV 3.500 y 14.000: el 208 es lo que dice esta línea; 3.500 y 14.000 son los Débitos del período de los extractos de PDV1 y PDV2

8. El manual y el recorrido (RV3-58) ​

#PasoResultado esperado
8.1Abrir el manual (/documentacion/manual-usuario) como tesoreria@, sección Prefondeo SoterexDice «Cargue el monto que Soterex envió o notificó», no el que acreditó el banco, y que el costo bancario queda fuera del sistema
8.2Misma sección, Si su usuario ve solo algunos paísesExplica la tarjeta de sus países, que un país inactivo y vacío no genera el aviso, y que al dar de alta un país hay que sumárselo a quien tiene que ver la Holding completa
8.3Sección Fondeo PDVsLo mismo para el monto que envió o notificó la Holding, y un párrafo para quien ve un solo país (ve País y PDV completos de su país)
8.4Como admin@, el manual, sección PaísesTiene el apartado «Un país nuevo y la Tesorería que ve toda la Holding»
8.5Sección Perfiles y menúDice que la Tesorería de un país ve la parte de su país de la Holding y la tarjeta con su saldo, y ya no que «ese alcance está previsto ajustarlo»
8.6docker exec soterex-backend-1 php artisan manual:generar-pdf y abrir el PDF de TesoreríaSale con las mismas secciones; ningún enlace interno queda roto

9. No se rompió nada de lo que ya existía ​

#PasoResultado esperado
9.1Con admin@ y tesoreria@, cargar un asiento de USD 5 en Guatemala en Prefondeo Soterex y otro en Fondeo PDVsFuncionan como antes; los dos aparecen en su extracto
9.2Pagar una transacción de Guatemala con backoffice@ (caja abierta)Paga como siempre. El saldo con Soterex baja principal más comisión; el del país, solo el principal. G12 no toca el pago
9.3Mirar el DashboardLos números no cambiaron
9.4supervisor@, Fondeo PDVsVe solo la pestaña PDV de GT-CAP-001 y GT-QUE-002
9.5Un PDV, un país y el rango de fechas en cada extractoSe filtran, se ordenan y se exportan como en B7
9.6Modo oscuro y 375 px en las dos pantallasSe leen; el encabezado CIS Guatemala y la línea de comisiones no se cortan

Al terminar ​

Dejar la base local como estaba:

  • Desactivar El Salvador y Honduras desde /admin/ubicaciones/paises (la base de dev los trae inactivos).
  • Quitar las asignaciones de regional@ o desactivarla: una cuenta de prueba más no estorba, pero con asignaciones sueltas confunde otras pruebas.
  • El asiento de USD 100 de la sección 4 queda (un asiento no se borra desde la app, y demo:reseed solo limpia los de Guatemala). Si molesta, solo en la base local: docker exec soterex-postgres-1 psql -U postgres -d soterex -c "delete from prefunding_entries where country_id = (select id from countries where iso_code = 'SV')". Mientras esté, El Salvador cuenta como país con movimientos: tesoreria@ va a seguir viendo el aviso aunque el país esté inactivo.
  • El asiento de USD 10 de 2.6 y los de 9.1 los borra php artisan demo:reseed.

En Staging ​

G12 no tiene migración, ni comando, ni dato que cargar: el deploy no necesita ningún paso manual. Lo que hay que mirar cuando llegue:

  • La base de Staging tiene Guatemala activa y El Salvador y Honduras inactivos y sin movimientos. Con una Tesorería asignada solo a Guatemala (la de Staging no existe hasta que Carlos corra StagingTestUsersSeeder), el caso de la sección 1: sin aviso y con Saldo con Soterex. Antes de G12 esa persona recibía el aviso de «parcial» desde el primer día.
  • Para confirmar que El Salvador y Honduras siguen inactivos y vacíos, la consulta 2 de G0.6 del plan (select iso_code, active from countries) alcanza: si alguno estuviera activo, el aviso de la sección 2 es el esperado, no un error.
  • Nadie con alcance parcial tiene hoy una cuenta real en Staging: el cambio de número de la tarjeta (sección 4) no le cambia nada a un usuario real todavía.

Pruebas automatizadas que lo respaldan ​

bash
docker exec soterex-backend-1 php artisan test --filter PrefundingApiTest
docker exec soterex-backend-1 php artisan test --filter TreasuryStatementApiTest
docker exec soterex-backend-1 php artisan test --filter ManualPdfTest
docker exec soterex-frontend-1 sh -c 'cd /app && npx vitest run src/views/__tests__/PrefondeoView.spec.ts src/components/__tests__/ExtractoTesoreria.spec.ts src/tours/__tests__/prefondeo.spec.ts'

Qué cubre cada una: PrefundingApiTest, la tarjeta (GET /prefondeo trae el saldo de los países del usuario y scope cuando no lee todos, el global cuando sí, un país inactivo vacío que no la vuelve parcial y uno con movimientos que sí, y la respuesta del alta con el mismo alcance —también con una Tesorería de dos países de tres—, un país acotado por PDV que no cuenta en la tarjeta y es 403, y un país inactivo con pagos sin pagar que no la vuelve parcial) y que una Tesorería de un solo país no puede cargar un asiento de Holding en otro país; TreasuryStatementApiTest, los extractos (la Holding parcial solo con países que cuentan, una Tesorería de un país con País y PDV completos, los 403 de los otros países, commissions_total (del rango y del alcance) y los totales de la planilla —208, 3.500 y 14.000—, el título y el membrete del export de País, los exports de la Holding de una Tesorería de un solo país (Excel sin filas de otro país, PDF que dice «parcial», 403 sin auditoría al pedir otro país), la tarjeta que coincide con el extracto con una asignación acotada por PDV, y la planilla paso a paso: 32.292 / 20.208 / 7.000 / 1.500 / 4.000 y 12.500, más el bloque oculto del Escenario 2); ManualPdfTest, que el manual (con las secciones nuevas) sigue generando los PDF por perfil con todos sus enlaces; y las del frontend, el nombre de la tarjeta en cada alcance (con las dos anclas del recorrido sin moverse), el encabezado CIS país y «de los cuales comisiones» del extracto, y el texto del primer paso del recorrido.

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