Este artículo describe el servicio web que permite consultar un listado de actas por fuera del sistema ALPHA. La consulta puede realizarse con filtros opcionales y devuelve información general de cada acta.

Además, el servicio puede incluir el listado de estudiantes inscriptos en cada acta y también los miembros configurados como presidente y vocal, según los parámetros enviados en la consulta.

• Usuarios con rol administrador que además tengan habilitado el permiso 1701 - PERMISO_ACTAS_ACCESO_ACTAS.

Endpoint: GET /api/v1/WSExaminationRecords/getList

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

1. Realice una solicitud GET al endpoint /api/v1/WSExaminationRecords/getList.
2. Envíe el header X-API-KEY con una clave válida.
3. Agregue los filtros que necesite. Todos son opcionales.
4. Si desea incluir estudiantes, envíe withStudents=true.
5. Si desea incluir presidente y vocales, envíe withPresidentMembers=true.
6. Revise la respuesta paginada y avance de página si necesita más resultados.

Ejemplo básico: GET /api/v1/WSExaminationRecords/getList

Ejemplo con filtros: GET /api/v1/WSExaminationRecords/getList?schoolYearId=1&year[]=1&call=1

Ejemplo con datos ampliados: GET /api/v1/WSExaminationRecords/getList?withStudents=true&withPresidentMembers=true

Students

Si la consulta se realiza con withStudents=true, cada acta puede incluir el arreglo students con estos datos:

• recordNumberId
• lastName
• firstName

No se incluyen inscripciones eliminadas.

President and Members

Si la consulta se realiza con withPresidentMembers=true, cada acta puede incluir el arreglo presidentAndMembers con estos datos:

• individualId
• lastName
• firstName
• type

Tipos de miembro:

• 1: Presidente
• 2: Vocal

• Si no se informa limit, el servicio utiliza 500.
• Si se informa un valor mayor a 500, el sistema lo ajusta a 500.
• La respuesta incluye datos de paginación como page, limit, total y total_pages.

• Consultar todas las actas disponibles de un ciclo lectivo.
• Obtener actas de determinadas carreras o materias.
• Filtrar por llamado para procesos administrativos específicos.
• Recuperar estudiantes asociados a cada acta para cruces de información.
• Recuperar presidente y vocales para control o seguimiento institucional.

• Las actas eliminadas no deben aparecer en el listado.
• Los filtros se combinan entre sí. Es decir, si envía varios filtros, el sistema devuelve solo las actas que cumplen todas las condiciones indicadas.
• El filtro por número de llamado aplica sobre escenarios donde ese dato exista y haya sido configurado.

¿Puedo consultar el servicio sin enviar filtros?

Sí. En ese caso el sistema devuelve el listado paginado de actas disponibles, respetando el límite máximo por página.

¿El servicio siempre devuelve estudiantes y miembros del acta?

No. Solo los incluye cuando se envían los parámetros withStudents=true o withPresidentMembers=true.

¿Qué ocurre si envío un parámetro incorrecto?

El sistema responde con un error y detalla el inconveniente para que usted pueda corregir la solicitud.