| Descripción | Inserta una entidad StudentGroupAssociation (Alumno-Grado-Grupo), para un Colegio en un Ciclo en específico. Se valida que el colegio pertenezca al ciclo escolar, verificando consistencia entre los niveles del colegio y grados indicados en los parámetros. Antes de insertar en la entidad Alumno-Grado-Grupo, se verifica que no exista para evitar duplicidad. |
| Referencia SIF | Extensión de SIF 3.0.1 |
| Tipo de Petición | POST |
| Parámetros o Campos | | Campos en llamada | Descripción | Reglas de negocio |
|---|
| school | - (Obligatorio) Id del Colegio correspondiente
| - El identificador del colegio debe existir, en caso de no ser válido devuelve:
- 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.
| | 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:
- 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 payload | Descripción | Reglas de negocio |
|---|
| unoStudentRefId | - (Obligatorio) alumno.alumno_id
| - 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:
- 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>
| | 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:
| | 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:
|
|
| 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) </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? | |