Versions Compared

Version Old Version 7 New Version 8
Changes made by

Samara Carmona. CCORP

Samara Carmona. CCORP

Saved on

Key

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

...

Descripción

Inserta una entidad StudentGroupAssociation (Alumno-Grado-Grupo), para un Colegio en un Ciclo en específico. Se valida que el alumno no tenga borrado lógico, que el colegio pertenezca al ciclo escolar, verificando consistencia entre los niveles del colegio y grados indicados en los parámetros. Antes de insertar la entidad Alumno-Grado-Grupo, se verifica que no exista para evitar duplicidad.

Referencia SIFExtensión de SIF 3.0.1
Tipo de PeticiónPOST
Parámetros o Campos


Campos en llamadaDescripciónReglas de negocio
school
  • (Obligatorio) Id del Colegio correspondiente
  • El identificador del colegio debe existir, en caso de no ser válido devuelve:
    •  <code>400</code>

      <message>El identificador propocionado no es válido.</message>

  • Si no se especifica el parámetro, como es obligatorio devuelve:
    •  <code>400</code>
      <message>Debe especificar el identificador del colegio.</message>
  • El colegio debe existir en el ciclo escolar que se especifica.
  • Si el alumno ya se encuentra relacionado a un colegio distinto al que se indica en el parámetro, devuelve:

    • <code>409</code>
      <message>El alumno ya está asignado a un grupo.</message>

  • En caso de que el alumno tenga borrado lógico, se devuelve el siguiente mensaje:

    • <error id="00000000-0000-1000-0000-000781714646" >
      <code>409</code>
      <message>Ocurrió un error al guardar la información del alumno.</message>
      </error>

  • En caso que el usuario que invoca el servicio (generatorId) no tenga permisos en la empresa donde esta relacionado el colegio, devuelve:

    • <code>403</code>
      <message>No tiene permiso para insertar o modificar en la empresa a la que pertenece el colegio.</message>

schoolYear
  • (Obligatorio) Año escolar que se consulta 
  • El colegio debe existir en el año escolar, en caso de no ser válido devuelve:

    • <code>400</code>
      <message>El identificador propocionado no es válido</message>

  • Si no se especifica el parámetro, como es obligatorio devuelve:
    •  <code>400</code>
      <message>Debe especificar un ciclo para consultar.</message>


Campos en XML payloadDescripciónReglas de negocio
unoStudentRefId
  • (Obligatorio)  alumno.alumno_id (Identificador único en la BDC, asignado para el ciclo escolar)
  • En caso que no se especifique correctamente el tag del grado devuelve:
    • <code>400</code>
      <message>El xml del payload no se encuentra bien formado.</message>
  • El identificador del alumno debe existir, en caso de no ser válido devuelve:

    • <code>400</code>
      <message>>El identificador propocionado no es válido.</message>

  • El alumno debe tener relacionada una persona, en caso de no ser válido devuelve:
    • <code>400</code>
      <message>Ocurrió un error al guardar la información personal.</message>

  • En caso que el usuario que invoca el servicio (generatorId) no tenga permisos en la empresa donde esta relacionado el alumno_id, devuelve:

    • <code>403</code>
      <message>No tiene permiso para insertar o modificar en la empresa a la que pertenece el alumno.</message>

gradeRefId
  • En caso que no se especifique correctamente el tag del grado devuelve:
    • <code>400</code>
      <message>El xml del payload no se encuentra bien formado.</message>
  • El identificador del grado debe existir, en caso de no ser válido devuelve:

      • <code>400</code>
        <message>>El identificador propocionado no es válido.</message>

 

groupRefId
  • (Obligatorio)  grupo_id. Ver maestro de Grupos.
  • En caso que no se especifique correctamente el tag del grupo devuelve:
    • <code>400</code>
      <message>El xml del payload no se encuentra bien formado.</message>
  • El identificador del grupo debe existir, en caso de no ser válido devuelve:

      • <code>400</code>
        <message>>El identificador propocionado no es válido.</message>


Ejemplo de llamada o de formulario

http://desenv.uno-internacional.com/sif/studentGroupAssociation;contextId={"school":1135, "schoolYear":2014}

Ejemplo XML payload

<studentGroupAssociation refId="">

    <unoStudentRefId>

00000000-0000-1000-0000-000001696188  alumno.alumno_id (Identificador único en la BDC, asignado para el ciclo escolar)

    </unoStudentRefId>

    <gradeRefId>00000000-0000-1000-0000-000000000026</gradeRefId> grado_id. Ver maestro de Grados y Niveles. 

    <groupRefId>00000000-0000-1000-0000-000000000017</groupRefId> grupo_id. Ver maestro de Grupos.

</studentGroupAssociation>

Respuesta

<createResponse>

    <creates>

        <create id="00000017-0000-1000-0000-000001696188" alumno.alumno_id.

statusCode="200" /> Se realizó exitosamente la inserción de la asociación StudentGroupAssociation (Alumno-Grado-Grupo).

    </creates>

</createResponse>

¿Quién lo utiliza y cómo?

 

...