Censo - Profesores

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: Masculino
- F: 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 respuesta
- file: 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 inactivar
- 1 - 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 https://project-tools-santillana.atlassian.net/wiki/spaces/CCORP/pages/edit-v2/563380318#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: Masculino
- F: Femenino
Activo: data.niveles[].activo
- Se debe recorrer el array data.niveles[]y filtrar el nivel por el campo data.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 campo empresa para indicar el nombre del sello.
- se puede utilizar el campo parametro para identificar qué imagen mostrar en cada sello
- se 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 https://project-tools-santillana.atlassian.net/wiki/spaces/CCORP/pages/edit-v2/563380318#Obtener-profesores-vinculados-a-cada-sello-%2F-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: Masculino
- F: 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": "alfredo.testllamados.9.test",
  "personaId": 0,
  "gradoId": 0
}

login: el login que se quiere usar
personaId: siempre con valor cero
gradoId: 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": [
    {
      "nivelId": 32
    }
  ]
}

niveles: Es un array que contiene los ids de los niveles que se quieren asignar al profesor
- niveles[].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": [
    {
      "nivel": {
        "nivelId": 35
      },
      "colegioGradoGrupos": [
        {
          "colegioGradoGrupo": {
            "colegioGradoGrupoId": 545109
          }
        }
      ]
    }
  ]
}

niveles: Es un array que contiene la información que se va a agregar al profesor
- nivel: Es un objeto que contiene el nivelId en el cual se van a agregar los grupos / turmas al profesor
- colegioGradoGrupos: Es un array que contiene los grupos / turmas que se van a agregar al profesor
  - colegioGradoGrupo: Es un objeto que contiene el colegioGradoGrupoId 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 materia
materia: Nombre de la materia
materiasGrados[]: Es un array que contiene la relación entre las materias en los grados y niveles
- Nombre 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": [
    309410,
    310784
  ]
}

materiasGrados: Es un array que contiene los materiaGradoId 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

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 plantilla
- 1: descargar archivo
- 0: 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 https://project-tools-santillana.atlassian.net/wiki/spaces/CCORP/pages/edit-v2/563380318#Guardar-datos-generales-del-profesor

Asignar niveles por profesor

Ver https://project-tools-santillana.atlassian.net/wiki/spaces/CCORP/pages/edit-v2/563380318#Asignar-niveles-al-profesor-por-sello-%2F-empresa

Catálogos

Lista de niveles

Método: GET

Ejemplo:

https://homol.uno-internacional.com/pegasus-api/dashboard/empresas/8/ciclos/785/colegios/13244/niveles