Versions Compared

Version Old Version 16 New Version Current
Changes made by

Alfredo Bernal

Alfredo Bernal

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

https://homol.uno-internacional.com/pegasus-api/censo/empresas/76/ciclos/1188/colegios/17919/niveles/32/grados/85/grupos/2280/alumnos/26041025/activarInactivar

Payload:

Code Block
{
  "activo": 0,
  "razonInactivoId": 0,
  "observaciones": ""
}

...

https://homol.uno-internacional.com/pegasus-api/censo/empresas/76/ciclos/1188/colegios/17919/niveles/33/grados/90/grupos/2280/alumnos/26041017/mover

Payload:

Code Block
{
  "nuevoNivelId": 32,
  "nuevoGradoId": 85,
  "nuevoGrupoId": 2280,
  "observaciones": "teste"
}

...

  • El usuario firmado tiene rol Administrador [SA, CTU, AN]

  • El usuario firmado tiene rol Gestor Colegio [GC] y el alumno no tiene pago asociado y el porcentaje de pago es cero

    • data[].conPago = false

    • data[].porcentajePago = 0

Perfil de Alumno

Obtener Alumno por ID

Reiniciar Contraseña

Método: GETPUT

Ejemplo:

https://homol.uno-internacional.com/pegasus-api

...

/censo/empresas/

...

8/ciclos/

...

785/colegios/

...

13244/niveles/33/grados/90/grupos/

...

2280/alumnos

...

Datos del Alumno

En base a la respuesta del servicio para obtener el alumno por ID, se obtiene la siguiente información.

...

Nombre: data.persona.nombreCompleto

...

Nivel/Segmento: data.nivel.nivel

...

Grado/Ano: data.grado.grado

...

Grupo/Turma: data.grupo.grupo

...

Sexo/Género: data.persona.sexoMoral

  • M: Masculino

  • F: Femenino

...

/26041220/updatePasswordInicial

Payload

Se envía un body vacío

Perfil de Alumno

...

Obtener Alumno por ID

Método: GET

Ejemplo:

https://homol.uno-internacional.com/pegasus-api/prometeo/censo/empresas/76/ciclos/1188/colegios/17919/niveles/33/grados/90/grupos/2281/alumnos/26041387

Datos del Alumno

En base a la respuesta del servicio para obtener el alumno por ID, se obtiene la siguiente información.

  • Nombre: data.persona.nombreCompleto

  • Nivel/Segmento: data.nivel.nivel

  • Grado/Ano: data.grado.grado

  • Grupo/Turma: data.grupo.grupo

  • Sexo/Género: data.persona.sexoMoral

    • M: Masculino

    • F: Femenino

  • Activo: data.activo

  • Fecha de nacimiento: data.persona.fechaNacimiento

  • Fecha de registro: data.fechaDesde

  • ID Responsable: data.idResponsable

    • Debe mostrarse con el formato de CPF

  • Login: data.login

...

Actualizar login del alumno por sello / empresa

Método: PUT

Ejemplo:

...

    • forma de pago (ejemplo: transferencia): data[].formaPago.formaPago

    • referencia: data[].referencia

    • quién paga: data[].personaPaga.nombreCompleto

    • neto: data[].neto

    • razón data[].razon.razon

    • estatus: data[].aplicado

      • true: Realizado

      • false: Pendiente

Actualizar login del alumno por sello / empresa

Método: PUT

Ejemplo:

https://homol.uno-internacional.com/pegasus-api/censo/empresas/8/ciclos/785/colegios/17388/niveles/33/grados/89/grupos/580/alumnos/26041477/updateLogin

...

Code Block
{
  "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

Actualizar descuento del alumno por sello / empresa

...

Code Block
{
  "razonDescuentoId": 4214,
  "porcentajeDescuento": 49,
  "padreId": 0
}

...

En la respuesta de ese servicio, en el elemento ´componentes´ componentes está el array ´secciones´ secciones, se debe buscar la sección que corresponde a “descuento” descuento

...

Dentro de la sección “descuento” descuento está el elemento ´formulario´ formulario y dentro del objeto ´formulario´ formulario hay una bandera que se llama ´useFn´ useFn:

...

  • true: significa que si se debe mostrar la lista de padres de familia

  • false: significa que no es necesario mostrar la lista de padres de familia

...

Code Block
{
  "tipo": "programa",
  "articulos": [
    106102
  ]
}

  • tipo: dependiendo el tipo de material que se quiere asignar puede ser

    • programa

    • servicio

    • digital

  • articulos: es un array que contiene el id del material seleccionado

...

https://homol.uno-internacional.com/pegasus-api/censo/empresas/8/ciclos/785/colegios/17388/niveles/33/grados/89/grupos/580/alumnos/26041477/releasedAlumno

Payload

...

/releasedAlumno

Payload

  • se envía un body vacío en el request

Lógica de guardar/actualizar por paquetes en procesos masivos

Se debe obtener https://project-tools-santillana.atlassian.net/wiki/spaces/CCORP/pages/edit-v2/436306231#Configuraci%C3%B3n-de-Censo-por-colegio-y-ciclo-escolar, en el elemento settings se encuentra el elemento procesosMasivos

...

Este objeto procesosMasivos tiene los siguientes elementos:

  • intervaloMilisegundos: Valor en milisegundos que se usara como intervalo de espera (delay) entre el envío de los paquetes.

  • mostrarTrack: Boolean que indica si se debe mostrar un mensaje de progreso en lo que dura el proceso masivo

  • registrosPorPaquete: Es la cantidad de llamados que se deben enviar de forma simultanea en los procesos masivos

Instrucciones

Se debe evaluar el total de registros a guardar con el valor de registrosPorPaquete.

Escenario:

  • totalRegistros: 40

  • registrosPorPaquete: 25

  • totalPaquetes = Math.ceil(totalRegistros / registrosPorPaquete)

    • siempre se redondea hacia arriba para contemplar los registros faltantes cuando totalRegistros no es múltiplo de registrosPorPaquete

En este caso, se debe armar un paquete con 25 registros y un paquete con 15 registros.

Se debe llevar un control de las respuestas de cada petición para poder mostrar al final un resumen de registros guardados de forma exitosa y cuántos tuvieron error, así como el resumen de los errores.

Catálogos

Razones de descuento

...

Se debe obtener la https://project-tools-santillana.atlassian.net/wiki/spaces/CCORP/pages/edit-v2/436306231#Configuraci%C3%B3n-de-Censo-por-colegio-y-ciclo-escolar en el elemento ´settings´ settings se encuentra el elemento ´categoriasDescuentos´ categoriasDescuentos

...

Lista de razones de descuento

...

https://homol.uno-internacional.com/pegasus-api/dashboard/empresas/8/razones?parametroTrans=DCTO&parametro%5B%5D=FFS&parametro%5B%5D=AMB2&parametro%5B%5D=DEC&parametro%5B%5D=AVCA&parametro%5B%5D=ALIN&parametro%5B%5D=ALRE&parametro%5B%5D=DMU&parametro%5B%5D=DALN&parametro%5B%5D=DSA&parametro%5B%5D=DAMA&parametro%5B%5D=DECO&parametro%5B%5D=HP&parametro%5B%5D=DEDC

Parametros en la URL

...

Dentro de la configuración del elemento ‘settings’ settings está el objeto “descuentos” descuentos, en este objeto se encuentra el array ´descuentosDisponibles´ descuentosDisponibles que contiene los id’s de las razones de descuento que se deben mostrar en el dropdown de la asignación de descuentos.

...