Page Comparison

...

Situación actual

Descripción

Actualiza un Alumnouno o varios Alumnos. Actualizando también persona, persona_login, persona_domicilio y domicilio.

Referencia SIF

Extensión de SIF 3.0.1

Entidad BDC

Alumno

Entidad SIF

Extensión de la entidad k12student (CEDS_K12.xsd).

Tipo de Petición

PUT

Parámetros o campos

http://desenv.uno-internacional.com/sif/unoStudent/

Campos	Descripción	Reglas de negocio
UUID del Alumno	UUID del Alumno que se consulta Obligatorio	El identificador debe existir. En caso de ser un ID de alumno no válido, entrega el siguiente mensaje: <error refId="00000000-0000-1000-0000-000179262049"> <code>404</code> <message>No se encontraron datos con los parámetros especificados.</message> </error>

Ejemplo de llamada o de formulario

En caso de tener borrado lógico, entrega el siguiente mensaje:
<error refId="00000000-0000-1000-0000-

000004036006

000850968958">
<code>409</code>
<message>Ocurrió un error al guardar la información del alumno.</message>
</error>
La actualización de los datos del alumno solo es permitida para los alumnos de colegios SIS, alumnos de colegios de la empresa Moderna Compartilha o cuando aún no han sido vinculados a un colegio. En caso de cumplirse la regla el servicio devuelve:
- <code>401</code>
  <message>No está autorizado para ejecutar esta acción.</message>
En caso que el usuario que invoca el servicio (generatorId) no tenga permisos en la empresa donde esta relacionado el alumno, devuelve:
- <code>403</code>
  <message>No tiene permiso para insertar o modificar en la empresa a la que pertenece el alumno.</message>

Parámetros en XML payload

Valida payload. En caso de no ser correcto manda mensaje de error.

Campo	Descripción	Reglas de Negocio
unoStudent refId	Identificador único en la BDC alumno.alumno_id Obligatorio	En caso de ser un ID de alumno no válido o con borrado lógico, entrega el siguiente mensaje: <error refId="00000000-0000-1000-0000-001373134177"> <code>404</code> <message>No existe la entidad con el id especificado.</message> </error> En caso de tener borrado lógico, entrega el siguiente mensaje: <error refId="00000000-0000-1000-0000-000850968958"> <code>409</code> <message>Ocurrió un error al guardar la información del alumno.</message> </error> Identificador único en la BDC, asignado para el ciclo escolar.
studentId	Clave del alumno
firstName	Nombre Obligatorio	En caso de no indicar valor entrega el siguiente mensaje: <update id="" statusCode="400" > <error id="00000000-0000-1000-0000-000004036006" > <code>400</code> <message>Los datos del nombre son requerido</message></error> </update>
middleName	Apellido paterno Obligatorio	En caso de no indicar valor entrega el siguiente mensaje: <update id="" statusCode="400" > <error id="00000000-0000-1000-0000-000004036006" > <code>400</code> <message>Los datos del nombre son requerido</message></error> </update>
lastName	Apellido materno Obligatorio	En caso de no indicar valor entrega el siguiente mensaje: <update id="" statusCode="400" > <error id="00000000-0000-1000-0000-000004036006" > <code>400</code> <message>Los datos del nombre son requerido</message></error> </update>
birthDate	Fecha de nacimiento Formato: aaaa-mm-dd Obligatorio	En caso de no indicar valor entrega el siguiente mensaje: <update id="" statusCode="400" > <error id="00000000-0000-1000-0000-000004036006" > <code>400</code> <message>El formato de la fecha es incorrecto.</message></error> </update>
sex	Valores: Male, Female, Not selected
userId	Username Obligatorio En caso de no indicar indicarlo, debe tener 6 o más caracteres.	Si el usuario previamente tiene login y no se indica valor entrega el siguiente mensaje: <update id="" statusCode="409" > <error id="00000000-0000-1000-0000-000004036006" > <code>409</code> <message>Ocurrió un error al guardar la información de login.</message> </error> </update> En caso de ser indicado y tener menos de 6 caracteres entrega el siguiente mensaje: <code>400</code> <message>El userId no es válido. Debe tener 6 o más caracteres.</message> Para crear login, debe dar userId y password.
password	Contraseña	Para crear login, debe dar userId y password.
language	Idioma Valores. Ver catalogo de Catálogos_generales_BDC
personRefId	Identificador único en la BDC persona.persona_id
curp	Curp
addressType	Tipo domicilio Valores: Physical, Mailing, Shipping
line1	Calle
city	Ciudad
neighborhood	Colonia
postalCode	Código postal
buildingSiteNumber	Número
county	Municipio Valores: ver maestro de municipios.
stateProvince	Estado
countyRefId	Identificador único en la BDC municipio.municipio_id Obligatorio Valores: ver maestro de municipios.
phoneNumberType	Tipo Valores: Home, Mobile
number	Teléfono
email	Correo electrónico
exitDate	Inactiva usuario Valor: <exitDate>2017-05-17</exitDate>	Cuando se incluye la etiqueta con fecha válida en el payload se inactiva alumno y persona_rol. (alumno.activo = 0 y persona_rol.activo = 0). Cuando no se incluye la etiqueta en el payload se activa alumno y persona_rol. (alumno.activo = 1 y persona_rol.activo = 1).
admissionDate	Fecha de Ingreso Formato: aaaa-mm-dd Opcional
personRoleId	Persona Rol Id del usuario que realiza el cambio. Opcional	Si el cambio en una entidad se realizó en alguna herramienta administrativa (Acuerdo, Censo, SINCROBDC, etc), el valor almacenado corresponde al usuario con rol administrativo que realizó el cambio (Administrador, Staff, Administrador de Colegio)
paymentResponsibleId	El ID Fiscal del responsable de pago Opcional	El atributo se utiliza para asociar a la persona que realizará el pago de los materiales y los alumnos en el portal de pagos de Brasil UNOi/Educate. Deberá contener un número CPFválido.
lmsBlocked	Indicador para verificar el acceso del alumno al LMS Opcional	El atributo es utilizado para verificar si el alumno puede acceder o no al LMS. Es utilizado en Brasil Moderna Compartilha Los valores aceptados son: true = Indica que el alumno no puede acceder al LMS. false = Indica que el alumno puede acceder al LMS

Ejemplo de llamada o de formulario

En caso de actualizar solo un Alumno:

https://homol.uno-internacional.com/sif/unoStudent/00000000-0000-1000-0000-000004036006

Ejemplo XML Payload

Code Block

language	xml

<unoStudent refId="00000000-0000-1000-0000-000004036006">

alumno.alumno_id (Identificador único en la BDC)
<studentId>JMAV</studentId> Clave del alumno
<name>
<firstName>Joel Maximiliano</firstName> Nombre
<middleName>Aguilar</middleName> Apellido Paterno
<lastName>Valdez</lastName> Apellido Materrno
</name>


    <studentId>JMAV</studentId>
    <name>
        <firstName>Joel Maximiliano</firstName>
        <middleName>Aguilar</middleName>
        <lastName>Valdez</lastName>
    </name>
    <birthDate>2008-12-04</birthDate>

Fecha de nacimiento (aaaa-mm-dd)
<sex>Male</sex> (Male, Female, Not selected)


    <sex>Male</sex>
    <userId>joelmaximiliano.aguilar.9</userId>

Username


    <password>dmFsZXJpYS5w</password>

Contraseña


    <language>ES</language>

Lenguaje


    <personRefId>00000000-0000-1000-0000-000003149709</personRefId>

persona.persona_id (Identificador único en la BDC)


    <curp></curp>

Curp
<addressList> Lista de domicilios
<address


    <addressList>
        <address addressType="Physical">

Tipo domicilio (Physical, Mailing, Shipping)
<street>
<line1>Rosas 101</line1> Calle
</street>
<city>QUINTANA ROO</city> Ciudad
<neighborhood>SM 223 MZA 6 LTE


            <street>
                <line1>Rosas 101</line1>
            </street>
            <city>QUINTANA ROO</city>
            <neighborhood>SM 223 MZA 6 LTE 15..</neighborhood>

Colonia
<postalCode>CANCUN</postalCode> Código postal
<buildingSiteNumber>41</buildingSiteNumber> Número
<county>BENITO JUAREZ</county> Municipio
<stateProvince>Quintana Roo</stateProvince> Estado


            <postalCode>CANCUN</postalCode>
            <buildingSiteNumber>41</buildingSiteNumber>
            <county>BENITO JUAREZ</county>
            <stateProvince>Quintana Roo</stateProvince>
            <countyRefId>00000000-0000-1000-0000-000000015248</countyRefId>

municipio.municipio_id (Identificador único en la BDC)


        </address>


    </addressList>

<phoneNumberList> Lista de teléfonos
<phoneNumber


    <phoneNumberList>
        <phoneNumber phoneNumberType="Home">

Tipo teléfono (Home, Mobile)
<number>53956782</number> Número de teléfono
</phoneNumber>
<phoneNumber


            <number>53956782</number>
        </phoneNumber>
        <phoneNumber phoneNumberType="Mobile">

Tipo teléfono (Home, Mobile)
<number>5537651829</number> Número de teléfono
</phoneNumber>
</phoneNumberList>
<schoolEmailList>
<schoolEmail>
<email>correo@correo.com</email> Correo
</schoolEmail>
</schoolEmailList>


            <number>5537651829</number>
        </phoneNumber>
    </phoneNumberList>
    <schoolEmailList>
        <schoolEmail>
            <email>correo@correo.com</email>
        </schoolEmail>
    </schoolEmailList>
	<admissionDate>2019-01-01</admissionDate>
    <personRoleId>00000000-0000-1000-0000-000000526589</personRoleId>
	<paymentResponsibleId>53465435621</paymentResponsibleId>
	<lmsBlocked>true</lmsBlocked>
</unoStudent>

Respuesta

N/A (Código 204).

Ejemplo de llamada o formulario

Puede actualizar varios:

https://homol.uno-internacional.com/sif/unoStudent

Ejemplo XML Payload

Code Block

language	xml

<unoStudentList>
    <unoStudent refId="00000000-0000-1000-0000-000001696160">
        <studentId />
        <name>
            <firstName>TANIA</firstName>
            <middleName>AGUILAR</middleName>
            <lastName>RUBIO</lastName>
        </name>
        <birthDate>2000-03-15</birthDate>
        <sex>Female</sex>
        <userId>tania.aguilar.sm</userId>
        <password>dLgseXdpfS8b</password>
        <personRefId>00000000-0000-1000-0000-000001003674</personRefId>
        <addressList>
            <address addressType="Physical">
                <street>
                    <line1>Calle tres</line1>
                </street>
                <city />
                <neighborhood />
                <postalCode />
                <buildingSiteNumber>0</buildingSiteNumber>
                <county>METEPEC</county>
                <stateProvince>Estado de México</stateProvince>
                <countyRefId>00000000-0000-1000-0000-000000011121</countyRefId>
            </address>
        </addressList>
        <phoneNumberList />
        <schoolEmailList />
    	<personRoleId>00000000-0000-1000-0000-000000526589</personRoleId>
		<paymentResponsibleId>53465435621</paymentResponsibleId>
    </unoStudent>
    <unoStudent refId="00000000-0000-1000-0000-000001696161">
        <studentId>EICJ000526HMCSSSA6</studentId>
        <name>
            <firstName>JESÚS</firstName>
            <middleName>ESPINOSA DE LOS MONTEROS</middleName>
            <lastName>CASTAÑEDA</lastName>
        </name>
        <birthDate>2000-05-26</birthDate>
        <sex>Male</sex>
        <userId>jesus.espinosa.sm</userId>
        <password>dldjGXdkf8HJhfb</password>
        <personRefId>00000000-0000-1000-0000-000001004648</personRefId>
        <addressList>
            <address addressType="Physical">
                <street>
                    <line1 />
                </street>
                <city />
                <neighborhood />
                <postalCode />
                <buildingSiteNumber>0</buildingSiteNumber>
                <county>METEPEC</county>
                <stateProvince>Estado de México</stateProvince>
                <countyRefId>00000000-0000-1000-0000-000000011121</countyRefId>
            </address>
        </addressList>
        <phoneNumberList />
        <schoolEmailList />
	    <personRoleId>00000000-0000-1000-0000-000000526589</personRoleId>
		<paymentResponsibleId>53465435621</paymentResponsibleId>
    </unoStudent>
    <unoStudent refId="00000000-0000-1000-0000-000001696162">
        <studentId>EAGB001219MMCSRRA9</studentId>
        <name>
            <firstName>BRENDA MONSERRAT</firstName>
            <middleName>ESTRADA</middleName>
            <lastName>GRAJALES</lastName>
        </name>
        <birthDate>2000-12-19</birthDate>
        <sex>Female</sex>
        <userId>brenda.estrada.sm</userId>
        <password>d9Hnsjf7pdfK</password>
        <personRefId>00000000-0000-1000-0000-000001002836</personRefId>
        <exitDate>2013-08-23</exitDate>
        <addressList>
            <address addressType="Physical">
                <street>
                    <line1 />
                </street>
                <city />
                <neighborhood />
                <postalCode />
                <buildingSiteNumber>0</buildingSiteNumber>
                <county>METEPEC</county>
                <stateProvince>Estado de México</stateProvince>
                <countyRefId>00000000-0000-1000-0000-000000011121</countyRefId>
            </address>
        </addressList>
        <phoneNumberList />
        <schoolEmailList />
	    <personRoleId>00000000-0000-1000-0000-000000526589</personRoleId>
		<paymentResponsibleId>53465435621</paymentResponsibleId>
		<lmsBlocked>true</lmsBlocked>
    </unoStudent>
</unoStudentList>

Respuesta

Code Block

language	xml

<updateResponse>
	<updates>
		<update id="00000000-0000-1000-0000-000001696160" statusCode="200" />
		<update id="00000000-0000-1000-0000-000001696161" statusCode="200" />
		<update id="00000000-0000-1000-0000-000001696162" statusCode="200" />
	</updates>
</updateResponse>

Version	Old Version 19	New Version Current
Changes made by	Samara Carmona. CCORP	Mauro Romero
Saved on	Jan 18, 2017	Mar 01, 2021

Versions Compared

Key

Situación actual