SIU - Contribuciones del usuario [es]

Ecosistema/circuitos funcionales/guarani sq valorizacion

2026-07-20T20:51:12Z

Sbarrios:

[[Archivo:Grafico_ecosistemaWiki_guarani_SQ.png|centro|1000px]]
[[Archivo:SIU logo iso.png|derecha|link=Ecosistema/version1.0.0/circuitos_funcionales]] 
 
{{TOClimit|4}}
[[Ecosistema|<Volver]]
= Circuito de Valorización de Propuestas y Cursos Guaraní & Sanavirón-Quilmes =
== Módulos Incluidos ==

* Sanavirón-Quilmes
* Guaraní


== Requisitos Técnicos de Configuración ==

Luego de la instalación de ambos sistemas:

==='''Guaraní Gestión'''===
Crear el archivo sanaviron/cliente.ini y configurar usuario, contraseña y URL del servicio:

[[Archivo:GUA_SQ_cliente_ini_guarani.png|1000px]] 

Configurar los siguientes parámetros del sistema:
* '''sq_usa_sanaviron:''' Indica si se utiliza Sanaviron-Quilmes como módulo de cobros
* '''sq_url_pagos:''' Base de la URL para generar ventas de suscripciones en Sanavirón-Quilmes
* '''sq_id_externo:''' Indica la forma en que se identificará la instalación de Guaraní en el Sanaviron-Quilmes
 

==='''Guaraní Autogestión'''===
Solicitar al administrador de SIU-SQ usuario, contraseña y URLs para utilizar el servicio REST. 

Configurar la URL de SIU-SQ en el archivo <path proyecto 3w>/instalacion/config.php :

[[Archivo:GUA_SQ_config_php_G3W.png|1000px]] 
 
Configurar el archivo <path proyecto 3w>/instalacion/servicios_web_config.php:

[[Archivo:GUA_SQ_servweb_config_php_G3W.png|1000px]]
 

==='''Sanaviron-Quilmes:'''===
Configurar usuario, contraseña y URLs de servicio rest en los archivos sq.ini de los módulos núcleo y académico.

[[Archivo:SQ_sq_ini_guarani.png|1000px]] 

Configurar en la operación de '''Administrar Sistemas Externos''' el ID de Guaraní que fue configurado anteriormente en el parámetro '''sq_id_externo''' de Guaraní Gestión.

* [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.20.0/interfaces/sanaviron Configurar Interfaz Guaraní-SQ]

== Elementos que pueden valorizarse ==

* Planes de Propuestas de Pregrado
* Planes de Propuestas de Grado
* Planes de Propuestas de Posgrado
* Comisiones de Actividades de tipo Curso

== Pasos del Circuito ==

=== Valorización de Propuestas ===

1. [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/documentacion_de_las_operaciones/Propuestas/administrar_propuestas_formativas Crear la Propuesta Formativa]

2. [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/documentacion_de_las_operaciones/propuestas/planes_de_estudio Crear el Plan de Estudios y configurarlo como cobrable]

3. [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/documentacion_de_las_operaciones/administracion/Sincronizar_Novedades_con_SQ Sincronizar Novedades con SQ]

4. [https://documentacion.siu.edu.ar/wiki/SIU-Sanaviron-Quilmes/version2.12.0/operacionesacad-serviinst Desde SQ-Académico valorizar el Plan de Estudios]

5. Realizar las inscripciones a Propuesta: [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/documentacion_de_las_operaciones/matr%C3%ADcula/inscripcion_a_propuestas_formativas Inscribir a Propuesta desde Gestión], [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/documentacion_de_las_operaciones/matr%C3%ADcula/inscripcion_a_propuestas_formativas_desde_preinscripcion Inscribir a Propuesta desde Preinscripción]

6. El alumno realiza el pago '''IMPORTANTE:''' El momento en que se notifique el cobro desde Guaraní a SQ según el estado de la inscripción a propuesta dependerá de cómo se configure el parámetro "sq_notif_insc_pendientes".

=== Valorización de Cursos ===

1. [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/documentacion_de_las_operaciones/propuestas/planes_de_estudio#Configuraci.C3.B3n_del_Plan_de_estudio_Estructurado Indicar las actividades de tipo curso como cobrables dentro del plan de estudios]

2. [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/documentacion_de_las_operaciones/cursadas/administrar_comisiones Generar la comisión e indicarla como Cobrable]

3. [https://documentacion.siu.edu.ar/wiki/SIU-Sanaviron-Quilmes/version2.12.0/operacionesacad-serviinst#Comisiones Desde SQ-Académico valorizar la comisión]

4. Los alumnos se inscriben a la comisión y realizan el pago.

Nota:las inscripciones de los alumnos a la propuestas recién van a generar un cobro en SQ una vez que el estado de la inscripción pase a estado "Aceptada",es decir, una inscripción a propuesta que se encuentra en estado "Pendiente" no genera un cobro en SQ.

== Webinar sobre valorización de Propuestas y Cursos ==

[https://www.youtube.com/watch?v=n0SgP4mdhgM Webinar Guaraní-SQ]

== Situación en Base Demo ==

En proceso de Implementación

== Preguntas Frecuentes ==

* '''¿Cómo diagnosticar un error 500 durante la sincronización entre Guaraní y Sanaviron? '''

1 - Verificar que la URL configurada corresponda a SQ Académico. 
2 - Revisar los logs de SQ Académico. 
3 - Ejecutar la misma petición mediante curl para aislar si el problema proviene de Guaraní o del servicio REST. 
4 - Si el error persiste, analizar el detalle de la excepción registrada en los logs de SQ Académico. 

* ''' La sincronización falla con un error relacionado con caracteres o encoding. ¿Qué debo revisar? '''

Si en los logs de SQ Académico aparecen mensajes similares a "Un carácter no se encuentra en el conjunto de caracteres codificado", se recomienda:

1 - Verificar que las bases de datos utilicen codificación UTF-8. 
2 - Revisar los logs completos de SQ Académico para identificar en qué operación se produce el error. 
3 - Comprobar si el inconveniente se reproduce ejecutando directamente el POST /servicios mediante curl. 
4 - Si el problema persiste aun con la configuración correcta y la base en UTF-8, analizar posibles particularidades del ambiente o personalizaciones, ya que el equipo de desarrollo pudo reproducir exitosamente el mismo escenario en un ambiente estándar. 

* '''El alumno realizó el pago, la venta figura como cobrada en Sanaviron, pero Guaraní continúa mostrando el pago como pendiente. ¿Qué debo revisar? '''

Si la venta ya figura como cobrada en SQ Académico pero Guaraní no refleja el pago, es probable que el problema no esté en el proceso de cobro sino en el procesamiento de la notificación hacia Guaraní.

1 - La venta no existe en SQ Académico: revisar la configuración de integración entre Guaraní y Sanaviron. 
2 - La venta existe pero no está cobrada: revisar el circuito de pago. 
3 - La venta figura como cobrada pero Guaraní no actualiza el estado: revisar los workers y la configuración de Supervisor en SQ Académico, ya que son los encargados de procesar las notificaciones hacia Guaraní. 

* '''¿Cómo implementar el cobro en Sanaviron únicamente para una nueva cohorte de una propuesta que ya tiene alumnos activos? '''

Si la institución desea comenzar a gestionar los cobros mediante Sanaviron solo para los nuevos ingresantes, el circuito recomendado es crear un nuevo plan de estudios asociado a la propuesta.

1- Crear un nuevo plan de estudios para la nueva cohorte. 
2- Configurar ese plan como cobrable e informarlo a Sanaviron para su valorización. 
3 - Mantener a los alumnos de cohortes anteriores en el plan original, que continúa con su circuito académico habitual. 
4 - Realizar pruebas en un ambiente de desarrollo o testing antes de implementarlo en producción. 

* ''' Un alumno pagó su deuda en Sanaviron, pero en Guaraní continúa figurando como moroso. ¿Por qué ocurre? '''

La condición de moroso no se sincroniza en tiempo real entre SIU-Sanaviron y SIU-Guaraní.Cuando un alumno paga la venta por la cual fue considerado moroso, la actualización en Guaraní se realiza únicamente cuando se ejecuta el proceso Notificar morosos a G3, configurado en el Planificador de tareas. Hasta ese momento, Guaraní puede seguir mostrando al alumno como moroso

[[Ecosistema|<Volver]]

Ecosistema/circuitos funcionales/guarani sq valorizacion

2026-07-20T20:50:48Z

Sbarrios:

2026-07-20T19:33:47Z

Sbarrios:

Ecosistema/circuitos funcionales/guarani sq valorizacion

2026-07-20T19:31:14Z

Sbarrios:

Ecosistema/circuitos funcionales/guarani sq valorizacion

2026-07-20T19:30:19Z

Sbarrios:

2026-02-02T19:46:12Z

Sbarrios:

SIU-Guarani/preinscripcion3.23.0/administracion

2026-02-02T19:40:46Z

Sbarrios:

__TOC__

=== Operaciones ===

La interfaz de Administración de Preinscripción provee las siguientes funcionalidades:

* [[SIU-Guarani/preinscripcion3.23.0/administracion#Configuraci.C3.B3n_de_campos_de_formulario|Configuración de campos de formulario]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Borrar_cach.C3.A9_APC|Borrar caché APC]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Administrar_Perfil_de_Datos|Administrar Perfil de Datos]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Probar_Conexi.C3.B3n_con_G3|Probar conexión con G3]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Probar_Correo|Probar correo]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Videos_De_Accesibilidad|Videos de Accesibilidad]]

==== Configuración de campos de formulario ====

A través de esta operación el sistema permite realizar una personalización rápida de los campos que componen el formulario de preinscripción, definiendo, para cada campo y tipo de carrera:

* Si el campo es visible,
* Si es obligatorio completarlo antes de imprimir,
* Si se imprime en el comprobante del alumno y
* Si se utilizará para la confección de estadísticas en un futuro módulo (no disponible por el momento).

[[Archivo:GUA_Pre_Adm_2.png|1000px]] 

[[Archivo:GUA_Pre_Adm_3.png|1000px]] 

A pesar de que la configuración se realice con el usuario administrador del punto de acceso, cualquier cambio que se realice se aplicará en los demás puntos de acceso. La configuración de los datos personales y censales es única para toda la Institución.

==== Borrar caché APC ====

Como se explica en las [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/apc| consideraciones técnicas]], el sistema trabaja con un mecanismo de caché (APC) para evitar costos innecesarios de acceso a datos.

Si se realizan acciones de actualización mediante operaciones del sistema, la invalidación de la porción de caché APC relacionada con esos datos viene garantizada. Pero si se modifican o se insertan datos por fuera de la aplicación (ya sea desde SQL o exportando datos desde Guaraní), habrá que invalidar manualmente la caché mediante esta operación.

Su aplicación es muy sencilla: basta con presionar el botón "Limpiar caché" para que se borre toda la caché del sistema.

[[Archivo:GUA_Pre_Adm_4.png|1000px]] 

==== Administrar Perfil de Datos ====

Cada administrador de punto de acceso, tendrá la posibilidad de configurar su perfil de datos tal como se detalla en la pantalla a continuación:

[[Archivo:GUA_Pre_Adm_5.png|1000px]] 

Dicha configuración limitará las preinscripciones que se podrán registrar en el punto de acceso por parte de los aspirantes.

==== Probar Correo ====

Se proveé esta operación para probar la configuración y correcto funcionamiento del servidor de correo electrónico, teniendo en cuenta que es un componente indispensable del sistema, ya que la validación de las cuentas de usuario y la eventual recuperación de clave se realizan mediante e-mails.

La configuración del servidor de correo se realiza en el bloque 'smtp' del archivo 'config.php' de la carpeta 'instalacion'.

[[Archivo:GUA_Pre_Adm_7.png|1000px]] 

==== Videos de Accesibilidad ====

Desde Siu-Guarani se desarrollo una personalización de preinscripción sobre la versión 3.21.2 con la finalidad de añadir iconos de accesibilidad, las unis podrán descargarla desde sus respectivos nodos de colab.

Esta personalización incorporara íconos de accesibilidad desde diferentes puntos y secciones del módulo de preinscripción que permitirán abrir videos tutoriales en lengua de señas argentinas asociados a cada paso/pestaña. Se deberán mostrar únicamente si la sección está habilitada desde administrar preinscripción.

1- El ícono que se utilizará para representar a la opción de accesibilidad será: IconoAccesibilidad.png

[[Archivo:GUA_Pre_Adm_Icono.png|150px]] 

2- Las URL de cada video se deben asociar a cada icono para que al clickarlo abra el mismo en una pantalla de reproducción dentro del propio formulario de preinscripción evitando redireccionar a otra ventana. Una vez que el video finaliza se debe cerrar la ventana del reproductor.

Ejemplo, la home de Preinscripción tendrá para cada ícono que acompaña al botón, su correspondiente video y mensaje en pop-up

[[Archivo:GUA_Pre_Adm_AltaPre.png|1000px]] 

[[SIU-Guarani/preinscripcion3.23.0/documentacion_funcional|< Volver]]

SIU-Guarani/preinscripcion3.23.0/administracion

2026-02-02T19:40:29Z

Sbarrios:

__TOC__

=== Operaciones ===

La interfaz de Administración de Preinscripción provee las siguientes funcionalidades:

* [[SIU-Guarani/preinscripcion3.23.0/administracion#Configuraci.C3.B3n_de_campos_de_formulario|Configuración de campos de formulario]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Borrar_cach.C3.A9_APC|Borrar caché APC]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Administrar_Perfil_de_Datos|Administrar Perfil de Datos]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Probar_Conexi.C3.B3n_con_G3|Probar conexión con G3]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Probar_Correo|Probar correo]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Videos_De_Accesibilidad|Videos de Accesibilidad]]

==== Configuración de campos de formulario ====

A través de esta operación el sistema permite realizar una personalización rápida de los campos que componen el formulario de preinscripción, definiendo, para cada campo y tipo de carrera:

* Si el campo es visible,
* Si es obligatorio completarlo antes de imprimir,
* Si se imprime en el comprobante del alumno y
* Si se utilizará para la confección de estadísticas en un futuro módulo (no disponible por el momento).

[[Archivo:GUA_Pre_Adm_2.png|1000px]] 

[[Archivo:GUA_Pre_Adm_3.png|1000px]] 

A pesar de que la configuración se realice con el usuario administrador del punto de acceso, cualquier cambio que se realice se aplicará en los demás puntos de acceso. La configuración de los datos personales y censales es única para toda la Institución.

==== Borrar caché APC ====

Como se explica en las [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/apc| consideraciones técnicas]], el sistema trabaja con un mecanismo de caché (APC) para evitar costos innecesarios de acceso a datos.

Si se realizan acciones de actualización mediante operaciones del sistema, la invalidación de la porción de caché APC relacionada con esos datos viene garantizada. Pero si se modifican o se insertan datos por fuera de la aplicación (ya sea desde SQL o exportando datos desde Guaraní), habrá que invalidar manualmente la caché mediante esta operación.

Su aplicación es muy sencilla: basta con presionar el botón "Limpiar caché" para que se borre toda la caché del sistema.

[[Archivo:GUA_Pre_Adm_4.png|1000px]] 

==== Administrar Perfil de Datos ====

Cada administrador de punto de acceso, tendrá la posibilidad de configurar su perfil de datos tal como se detalla en la pantalla a continuación:

[[Archivo:GUA_Pre_Adm_5.png|1000px]] 

Dicha configuración limitará las preinscripciones que se podrán registrar en el punto de acceso por parte de los aspirantes.

==== Probar Correo ====

Se proveé esta operación para probar la configuración y correcto funcionamiento del servidor de correo electrónico, teniendo en cuenta que es un componente indispensable del sistema, ya que la validación de las cuentas de usuario y la eventual recuperación de clave se realizan mediante e-mails.

La configuración del servidor de correo se realiza en el bloque 'smtp' del archivo 'config.php' de la carpeta 'instalacion'.

[[Archivo:GUA_Pre_Adm_7.png|1000px]] 

==== Videos de Accesibilidad ====

Desde Siu-Guarani se desarrollo una personalización de preinscripción sobre la versión 3.21.2 con la finalidad de añadir iconos de accesibilidad, las unis podrán descargarla desde sus respectivos nodos de colab.

Esta personalización incorporara íconos de accesibilidad desde diferentes puntos y secciones del módulo de preinscripción que permitirán abrir videos tutoriales en lengua de señas argentinas asociados a cada paso/pestaña. Se deberán mostrar únicamente si la sección está habilitada desde administrar preinscripción.

1- El ícono que se utilizará para representar a la opción de accesibilidad será: IconoAccesibilidad.png

[[Archivo:GUA_Pre_Adm_Icono.png|500px]] 

2- Las URL de cada video se deben asociar a cada icono para que al clickarlo abra el mismo en una pantalla de reproducción dentro del propio formulario de preinscripción evitando redireccionar a otra ventana. Una vez que el video finaliza se debe cerrar la ventana del reproductor.

Ejemplo, la home de Preinscripción tendrá para cada ícono que acompaña al botón, su correspondiente video y mensaje en pop-up

[[Archivo:GUA_Pre_Adm_AltaPre.png|1000px]] 

[[SIU-Guarani/preinscripcion3.23.0/documentacion_funcional|< Volver]]

SIU-Guarani/preinscripcion3.23.0/administracion

2026-02-02T19:40:02Z

Sbarrios:

__TOC__

=== Operaciones ===

La interfaz de Administración de Preinscripción provee las siguientes funcionalidades:

* [[SIU-Guarani/preinscripcion3.23.0/administracion#Configuraci.C3.B3n_de_campos_de_formulario|Configuración de campos de formulario]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Borrar_cach.C3.A9_APC|Borrar caché APC]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Administrar_Perfil_de_Datos|Administrar Perfil de Datos]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Probar_Conexi.C3.B3n_con_G3|Probar conexión con G3]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Probar_Correo|Probar correo]]
* [[SIU-Guarani/preinscripcion3.23.0/administracion#Videos_De_Accesibilidad|Videos de Accesibilidad]]

==== Configuración de campos de formulario ====

A través de esta operación el sistema permite realizar una personalización rápida de los campos que componen el formulario de preinscripción, definiendo, para cada campo y tipo de carrera:

* Si el campo es visible,
* Si es obligatorio completarlo antes de imprimir,
* Si se imprime en el comprobante del alumno y
* Si se utilizará para la confección de estadísticas en un futuro módulo (no disponible por el momento).

[[Archivo:GUA_Pre_Adm_2.png|1000px]] 

[[Archivo:GUA_Pre_Adm_3.png|1000px]] 

A pesar de que la configuración se realice con el usuario administrador del punto de acceso, cualquier cambio que se realice se aplicará en los demás puntos de acceso. La configuración de los datos personales y censales es única para toda la Institución.

==== Borrar caché APC ====

Como se explica en las [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/apc| consideraciones técnicas]], el sistema trabaja con un mecanismo de caché (APC) para evitar costos innecesarios de acceso a datos.

Si se realizan acciones de actualización mediante operaciones del sistema, la invalidación de la porción de caché APC relacionada con esos datos viene garantizada. Pero si se modifican o se insertan datos por fuera de la aplicación (ya sea desde SQL o exportando datos desde Guaraní), habrá que invalidar manualmente la caché mediante esta operación.

Su aplicación es muy sencilla: basta con presionar el botón "Limpiar caché" para que se borre toda la caché del sistema.

[[Archivo:GUA_Pre_Adm_4.png|1000px]] 

==== Administrar Perfil de Datos ====

Cada administrador de punto de acceso, tendrá la posibilidad de configurar su perfil de datos tal como se detalla en la pantalla a continuación:

[[Archivo:GUA_Pre_Adm_5.png|1000px]] 

Dicha configuración limitará las preinscripciones que se podrán registrar en el punto de acceso por parte de los aspirantes.

==== Probar Correo ====

Se proveé esta operación para probar la configuración y correcto funcionamiento del servidor de correo electrónico, teniendo en cuenta que es un componente indispensable del sistema, ya que la validación de las cuentas de usuario y la eventual recuperación de clave se realizan mediante e-mails.

La configuración del servidor de correo se realiza en el bloque 'smtp' del archivo 'config.php' de la carpeta 'instalacion'.

[[Archivo:GUA_Pre_Adm_7.png|1000px]] 

==== Videos de Accesibilidad ====

Desde Siu-Guarani se desarrollo una personalización de preinscripción sobre la versión 3.21.2 con la finalidad de añadir iconos de accesibilidad, las unis podrán descargarla desde sus respectivos nodos de colab.

Esta personalización incorporara íconos de accesibilidad desde diferentes puntos y secciones del módulo de preinscripción que permitirán abrir videos tutoriales en lengua de señas argentinas asociados a cada paso/pestaña. Se deberán mostrar únicamente si la sección está habilitada desde administrar preinscripción.

1- El ícono que se utilizará para representar a la opción de accesibilidad será: IconoAccesibilidad.png

[[Archivo:GUA_Pre_Adm_Icono.png|1000px]] 

2- Las URL de cada video se deben asociar a cada icono para que al clickarlo abra el mismo en una pantalla de reproducción dentro del propio formulario de preinscripción evitando redireccionar a otra ventana. Una vez que el video finaliza se debe cerrar la ventana del reproductor.

Ejemplo, la home de Preinscripción tendrá para cada ícono que acompaña al botón, su correspondiente video y mensaje en pop-up

[[Archivo:GUA_Pre_Adm_AltaPre.png|1000px]] 

[[SIU-Guarani/preinscripcion3.23.0/documentacion_funcional|< Volver]]

Archivo:GUA Pre Adm AltaPre.png

2026-02-02T19:39:36Z

Sbarrios:

Archivo:GUA Pre Adm Icono.png

2026-02-02T19:37:25Z

Sbarrios:

2023-12-15T16:15:58Z

Sbarrios:

== Correspondencia entre versiones ==
{| class="wikitable"
|-
!Versión
|-
! Gestión Autogestión!! Preinscripción !!SIU-Kolla !! API Sidcer!! SIU-SQ!! SIU-Tehuelche!! Moodle !!SIU-WICHI!!
|-
|3.21.0
|3.21.0
|
|API Guaraní
|
|
|3.5 a 4

|-
|3.20.1
|3.13.0
|4.3.2 a 4.7.x
|API Guaraní
|2.0.8
|4.3.x / 4.4.0
|3.5 a 3.10

|-
|3.20.0
|3.13.0
|4.3.2 a 4.7.x
|API Guaraní
|2.0.8
|4.3.x / 4.4.0
|3.5 a 3.10
|-

|3.19.1
|3.12.0
|4.3.2 a 4.7.x
|API Guaraní
|2.0.8
|4.2.x
|3.5 a 3.10

|-
|3.19.0
|3.12.0
|4.3.2 a 4.7.x
|API Guaraní
|2.0.8
|4.1.x
|3.5 a 3.10

|}

[https://documentacion.siu.edu.ar/wiki/SIU-Guarani/correspondencia_entre_versiones/old Versiones anteriores]

[[SIU-Guarani/Version3.21.0|< Volver]]