Esta funcionalidad le permite ejecutar el cierre de una cursada desde un servicio web, sin necesidad de realizar el proceso manualmente dentro del sistema.

El servicio utiliza la misma lógica de cierre ya existente en Quinttos, por lo que respeta las validaciones y comportamientos habituales del proceso.

También permite indicar si el cierre debe aplicarse únicamente a estados promovidos y aprobados, siempre que la cursada esté configurada para permitirlo.

Esta funcionalidad está orientada a usuarios administradores que consumen servicios web del sistema.

• Debe tratarse de un usuario con rol administrador.
• Además, debe contar con estos permisos: PERMISO_CIERRE_CURSADA o PERMISO_CIERRE_CURSADA_MASIVO.
• Para ejecutar el servicio, el usuario debe disponer de una API Key válida.

El endpoint se encuentra dentro del servicio web WSTeachingGroup, en la operación closeByTeachingGroup.

La invocación se realiza por fuera de la interfaz habitual del sistema, por ejemplo desde Postman o desde una integración externa.

• teachingGroupId (entero, obligatorio): identifica la cursada que se desea cerrar.
• periodId (entero, opcional): identifica el período específico que se desea cerrar.
• closeOnlyApprovedPromoted (booleano, opcional, valor por defecto false): indica si el cierre debe aplicarse solo a estados promocionados y aprobados.

Si no se informa periodId, el sistema toma automáticamente el último período de la cursada.

1. Obtenga una API Key de un usuario administrador habilitado para ejecutar cierres de cursada.
2. Identifique el teachingGroupId de la cursada que desea cerrar.
3. Si necesita cerrar un período puntual, identifique también el periodId correspondiente a esa misma cursada.
4. Envíe una solicitud al endpoint WSTeachingGroup → closeByTeachingGroup.
5. Incluya teachingGroupId y, si corresponde, periodId.
6. Si desea cerrar solo estados aprobados y promocionados, envíe además closeOnlyApprovedPromoted = true.
7. Revise la respuesta del servicio para confirmar si el cierre se realizó correctamente o si se devolvió una validación de error.

• Si el cierre se realiza correctamente, el servicio responde con estado exitoso.
• Si falta teachingGroupId, el sistema informa que falta un parámetro obligatorio.
• Si se envía un parámetro no permitido, el sistema devuelve un error de validación.
• Si el usuario no es administrador o no tiene permisos de cierre, el sistema rechaza la operación.
• Si la cursada no existe, el sistema informa que no pudo encontrarla.
• Si el período no pertenece a la cursada o no es válido para el cierre, el sistema informa el error correspondiente.
• Si se solicita el cierre solo de aprobados y promocionados sin la configuración necesaria, el sistema devuelve una validación de negocio.

• Usted necesita cerrar una cursada desde una integración externa sin ingresar manualmente al sistema.
• Usted desea ejecutar el cierre sobre un período específico de la cursada.
• Usted necesita automatizar el cierre respetando las mismas validaciones que ya existen en Quinttos.
• Usted desea cerrar solo estados aprobados y promocionados cuando la materia está preparada para ese comportamiento.

• El servicio sólo puede ser ejecutado por usuarios administradores.
• Además del rol, el usuario debe tener alguno de los permisos de cierre habilitados.
• El sistema permite cerrar una sola cursada por solicitud.
• Si no se informa período, el sistema toma el último período de la cursada.
• La opción closeOnlyApprovedPromoted = true solo funciona si la materia está correctamente configurada.
• Los cierres pueden verificarse en la tabla ciclo_procesos o en la planilla de calificaciones, dentro de la columna Sit. Cursada.

¿Qué ocurre si no envío el período?

El sistema toma automáticamente el último período de la cursada indicada.

¿Puedo usar esta funcionalidad con cualquier usuario?

No. Solo puede utilizarla un usuario administrador con permisos de cierre y una API Key válida.

¿Qué sucede si la cursada no permite cerrar solo aprobados y promocionados?

Si usted envía closeOnlyApprovedPromoted = true sin esa configuración activa, el sistema devuelve un error y no realiza el cierre.

¿Dónde puedo verificar si el cierre se registró correctamente?

Puede verificarlo en la tabla ciclo_procesos o en la planilla de calificaciones, dentro de la columna Sit. Cursada.