Censo - Profesores
- 1 Lista de profesores
- 2 Perfil de Profesor
- 2.1 Obtener Profesor por ID
- 2.2 Guardar datos generales del profesor
- 2.3 Obtener profesores vinculados a cada sello / empresa
- 2.4 Información del profesor por sello / empresa
- 2.5 Actualizar login del profesor por sello / empresa
- 2.6 Asignar niveles al profesor por sello / empresa
- 2.7 Obtener Grupos / Turmas
- 2.8 Asignar Grupos / Turmas a un profesor por sello / empresa
- 2.9 Lista de materias en los niveles asignados al profesor por sello / empresa
- 2.10 Asignar materias a un profesor por sello / empresa
- 2.11 Lista de aplicaciones por profesor y sello / empresa
- 2.12 Liberar aplicaciones del profesor por sello / empresa
- 3 Actualización masiva de profesores
- 4 Catálogos
- 4.1 Lista de niveles
Lista de profesores
Listar profesores
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/8/ciclos/785/colegios/13244/niveles/32/profesores
Datos de los profesores
NUI:
data[].persona.personaId
Nombre:
data[].persona.nombreCompleto
Sexo/Género:
data[].persona.sexoMoral
M
: MasculinoF
: Femenino
Activo:
data[].activo
Descargar lista de profesores
Todo el colegio
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/reportes/empresas/8/ciclos/785/reportes/profesores?typeResponse=file&colegioId=13244
Parámetros en la URL
typeResponse
: indica el formato esperado en la respuestafile
: la respuesta es un archivo
colegioId
: El ID del colegio para el cuál se quiere descargar el reporte
Activar/Inactivar Profesor
Método: POST
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/8/ciclos/785/colegios/13244/niveles/32/profesores/13471804/activarInactivar
Payload
{
"activo": 0
}
Activo:
0
- para inactivar1
- para activar
Instrucciones:
Se debe utilizar el valor de NUI como el ID del profesor a enviar en la petición a la API.
Editar Profesor
Al elegir la opción de editar alumno, se debe redireccionar al usuario a la vista del Perfil del Profesor
Obtener información de sellos por Id’s de los profesores
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/76/ciclos/1188/colegios/17919/niveles/33/profesorWithUnificados?personaIds[0]=13475544
Parámetros en la URL
personaIds
: Es un array que contiene los personaId de cada profesor que se quiere obtener la información de los sellos, para obtener el valor de personaId de cada profesor, ver Censo - Profesores | Listar profesores
Datos del profesor en cada sello
La respuesta de este servicio es un array en donde cada item corresponde a cada uno de los profesores que fueron consultados en los parámetros de la URL, y contiene la información del profesor en cada sello dentro del item unificados
:
personaId:
data[].unificados[].persona.personaId
empresaId:
data[].unificados[].colegioNivelCiclo.empresa.empresaId
cicloEscolarId:
data[].unificados[].colegioNivelCiclo.cicloEscolar.cicloEscolarId
colegioId:
data[].unificados[].colegioNivelCiclo.colegio.colegioId
nivelId:
data[].unificados[].colegioNivelCiclo.nivel.nivelId
Reiniciar contraseña de profesores
Método: PUT
Ejemplo:
http://homol.uno-internacional.com/pegasus-api/usuarios/empresas/8/personas/13475534/password-reset
Payload
Se envía un body vacío
Perfil de Profesor
Obtener Profesor por ID
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/8/ciclos/785/colegios/13244/niveles/32/profesores/13417090
Datos del Profesor
En base a la respuesta del servicio para obtener el profesor por ID, se obtiene la siguiente información.
Nombre:
data.nombreCompleto
Sexo/Género:
data.persona.sexoMoral
M
: MasculinoF
: Femenino
Activo:
data.niveles[].activo
Se debe recorrer el array
data.niveles[]
y filtrar el nivel por el campodata.niveles[].nivel.nivelId
que corresponde al nivel seleccionado en la lista de profesores
Login:
data.personaLogin.login
Niveles:
data.niveles[]
Cada elemento de este array es un nivel que el profesor tiene asignado
Grupos:
data.niveles[].colegioGradoGrupos[]
Cada elemento de este array es un conjunto de grado-grupo que el profesor tiene asignado
Materias:
data.materias[]
Cada elemento de este array es una material que el profesor tiene asignada
Cada materia está asociada a un Grado en específico
Información de los sellos/empresas
En base a la respuesta del servicio para obtener el profesor por ID, se obtiene la siguiente información.
sellos:
data.empresas[].empresa
empresas
es un array donde cada item es un sello, se toma el campoempresa
para indicar el nombre del sello.se puede utilizar el campo
parametro
para identificar qué imagen mostrar en cada sellose debe utilizar el campo
empresaId
para los siguientes llamados a la API que corresponden a las acciones en cada sello.
Guardar datos generales del profesor
Método: PUT
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/censo/empresas/8/ciclos/785/colegios/13244/niveles/32/profesores/13475534
Payload:
{
"nombre": "Alfredo Test",
"apellidoPaterno": "Cadastro U",
"apellidoMaterno": "Test",
"sexo": "M",
"idOficial": "35685390041",
"email": "test@santillana.com"
}
Obtener profesores vinculados a cada sello / empresa
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/censo/empresas/76/ciclos/1188/colegios/17919/niveles/33/profesores/13475550/profesorUnificados
Información del profesor por sello / empresa
En base a la respuesta del servicio Censo - Profesores | Obtener profesores vinculados a cada sello / empresa, la respuesta es un array donde cada item dentro de esta respuesta corresponde a la información del profesor en cada sello:
Datos por sello:
NUI:
data[].personaId
Nombre:
data[].nombreCompleto
Sexo / Género:
data[].sexoMoral
M
: MasculinoF
: Femenino
Login:
data[].personaLogin.login
Actualizar login del profesor por sello / empresa
Método: PUT
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/8/ciclos/785/colegios/13244/niveles/32/profesores/13417090/updateLoginProfesor
Payload
{
"login": "alfredo.profesor.test"
}
Validaciones
Antes de actualizar el login, se debe validar el login informado en el formulario con el siguiente servicio
Método: POST
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/dashboard/empresas/8/validarLogin
Payload
login
: el login que se quiere usarpersonaId
: siempre con valor cerogradoId
: siempre con valor cero
Asignar niveles al profesor por sello / empresa
Método: POST
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/8/ciclos/785/colegios/13244/profesores/13417090/asignarNivel
Payload:
niveles
: Es un array que contiene los ids de los niveles que se quieren asignar al profesorniveles[].nivelId
: es el ID del nivel que se quiere asignar al profesor
NOTA: Un profesor puede existir en varios niveles.
Obtener Grupos / Turmas
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/dashboard/empresas/8/ciclos/785/colegios/13244/niveles/34/colegioGradoGrupos
Información de los grupos / turmas
Grado:
data[].grado.grado
Grupo:
data[].grupo.grupo
Instrucciones
Para mostrar el nombre de un grupo, se debe concatenar el valor de grado y grupo
data[].grado.grado
+data[].grupo.grupo
Asignar Grupos / Turmas a un profesor por sello / empresa
Método: POST
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/8/ciclos/785/colegios/13244/profesores/13417090/asignarColegioGradoGrupo
Payload
niveles
: Es un array que contiene la información que se va a agregar al profesornivel
: Es un objeto que contiene elnivelId
en el cual se van a agregar los grupos / turmas al profesorcolegioGradoGrupos
: Es un array que contiene los grupos / turmas que se van a agregar al profesorcolegioGradoGrupo
: Es un objeto que contiene elcolegioGradoGrupoId
que se va a agregar al profesor
Lista de materias en los niveles asignados al profesor por sello / empresa
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/censo/empresas/8/ciclos/785/colegios/13244/materias?niveles[]=32&niveles[]=34&niveles[]=35
Parámetros en la URL
niveles
: Es un array que contiene los IDs de los niveles que tiene asignado el profesor
Datos de las materias
materiaId
: Id de la materiamateria
: Nombre de la materiamateriasGrados[]
: Es un array que contiene la relación entre las materias en los grados y nivelesNombre del grado:
materiasGrados[].grado.grado
Id del grado:
materiasGrados[].grado.gradoId
Nombre del nivel:
materiasGrados[].nivel.nivel
Id del nivel:
materiasGrados[].nivel.nivelId
Id de la asociación entre materias, grados y niveles:
materiasGrados[].materiaGradoId
Asignar materias a un profesor por sello / empresa
Método: POST
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/8/ciclos/785/colegios/13244/niveles/32/profesores/13417090/asignarMaterias
Payload:
materiasGrados
: Es un array que contiene losmateriaGradoId
de cada materia que se va asignar a un profesor
Lista de aplicaciones por profesor y sello / empresa
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/censo/empresas/8/ciclos/785/colegios/13244/niveles/32/personas/13417090/listaArticulosPersona?rolClave=PROF
Liberar aplicaciones del profesor por sello / empresa
Método: POST
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/8/ciclos/785/colegios/13244/niveles/32/profesores/13417090/releasedProfesor
Payload
se envía un body vacío en el request
Actualización masiva de profesores
Actualizar datos generales
Descargar plantilla
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/censo/empresas/8/ciclos/785/colegios/13244/descargarPlantillaEdicionMasivaProfesor?descargar=1
Parámetros en la URL
descargar
: Indica si se debe descargar o no la plantilla1
: descargar archivo0
: obtener el listado de profesores en formato json
Subir plantilla
Método: POST
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/censo/empresas/8/ciclos/785/colegios/13244/uploadPlantilla
Guardar datos generales por profesor
Ver Censo - Profesores | Guardar datos generales del profesor
Asignar niveles por profesor
Ver Censo - Profesores | Asignar niveles al profesor por sello / empresa
Actualizar login y contraseñas
Descargar plantilla
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/censo/empresas/76/ciclos/1188/colegios/17919/descargarPlantillaEdicionMasivaProfesor?descargar=1&isOnlyLogin=1
Parámetros en la URL
descargar
: Indica si se debe dar el archivo para descargar1
: se debe descargar el archivo
isOnlyLogin
: para indicar que la plantilla solo debe contener lo necesario para actualizar login y contraseñas de los profesores1
: para este caso siempre debe ir en 1/true
Subir plantilla
Método: POST
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/censo/empresas/76/ciclos/1188/colegios/17919/uploadPlantilla
Payload (form-data)
file
: El archivo de la plantillatipo
: Indica el tipo de plantilla que se está subiendoPara este caso el valor debe ser:
actualizacionProfesoresLogin
Catálogos
Lista de niveles
Método: GET
Ejemplo:
https://homol.uno-internacional.com/pegasus-api/dashboard/empresas/8/ciclos/785/colegios/13244/niveles