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

PutPUT

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-

000001003549

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.

<unoStudent

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 alumnoOpcional
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 Opcional
userId	ObligatorioUsername 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 Opcional	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_idOpcional
curp	Opcional	Curp
addressType	Tipo de dirección 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
number
email

Ejemplo XML Payload

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-

000001003549"> Identificador único en la BDC alumno.alumno_id
<studentId>ADP4A.14</studentId> Clave del Alumno
<name>
<firstName>VALERIA MICHELLE</firstName> Nombre
<middleName>PIÑEIRO</middleName> Apellido paterno
<lastName>ARENAS</lastName> Apellido materno
</name>
<birthDate>2012-12-11</birthDate> Fecha de nacimiento (aaaa/mm/dd)
<sex>Female</sex> (Male, Female, Not selected)
<userId>valeria.pineiro</userId> username
<password>dmFsZXJpYS5w</password> contraseña

000004036006">
    <studentId>JMAV</studentId>
    <name>
        <firstName>Joel Maximiliano</firstName>
        <middleName>Aguilar</middleName>
        <lastName>Valdez</lastName>
    </name>
    <birthDate>2008-12-04</birthDate>
    <sex>Male</sex>
    <userId>joelmaximiliano.aguilar.9</userId>
    <password>dmFsZXJpYS5w</password>
    <language>ES</language>
    <personRefId>00000000-0000-1000-0000-

000001003674</personRefId> Identificador único en la BDC persona.persona_id
<curp>PIAV020218MDFXRLB2</curp> CURP
<addressList> Lista de domicilios
<address

000003149709</personRefId>
    <curp></curp>
    <addressList>
        <address addressType="Physical">

Tipo de dirección (Physical, Mailing, Shipping)
<street>
<line1>CALLE 8 DE MAYO</line1> Calle
</street>
<city>MEXICO</city> Ciudad
<neighborhood>PLANETARIO LINDAVISTA</neighborhood> Colonia
<postalCode>07300</postalCode> Código Postal
<buildingSiteNumber>2</buildingSiteNumber> Número
<county>GUSTAVO A MADERO</county> Municipio
<stateProvince>Distrito Federal</stateProvince> Estado


            <street>
                <line1>Rosas 101</line1>
            </street>
            <city>QUINTANA ROO</city>
            <neighborhood>SM 223 MZA 6 LTE 15..</neighborhood>
            <postalCode>CANCUN</postalCode>
            <buildingSiteNumber>41</buildingSiteNumber>
            <county>BENITO JUAREZ</county>
            <stateProvince>Quintana Roo</stateProvince>
            <countyRefId>00000000-0000-1000-0000-

000000011302</countyRefId> Identificador único en la BDC municipio.municipio_id
</address>
<address addressType="Mailing">Tipo de dirección (Physical, Mailing, Shipping)
<street>
<line1>CALLE 10 DE ABRIL</line1> Calle
</street>
<city>IRAPUATO</city> Ciudad
<neighborhood>TABACHINES</neighborhood> Colonia
<postalCode>07500</postalCode> Código Postal
<buildingSiteNumber>22</buildingSiteNumber> Número
<county>IRAPUATO</county> Municipio
<stateProvince>Guanajuato</stateProvince> Estado

000000015248</countyRefId>
        </address>
    </addressList>
    <phoneNumberList>
        <phoneNumber phoneNumberType="Home">
            <number>53956782</number>
        </phoneNumber>
        <phoneNumber phoneNumberType="Mobile">
            <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-

000000008126</countyRefId> Identificador único en la BDC municipio.municipio_id
</address>
</addressList>
<phoneNumberList>
<phoneNumber phoneNumberType="Home">
<number>53956782</number>
</phoneNumber>
<phoneNumber phoneNumberType="Mobile">
<number>5537651829</number>
</phoneNumber>
</phoneNumberList>
<schoolEmailList>
<schoolEmail>
<email>correo@correo.com</email>
</schoolEmail>
</schoolEmailList>
</unoStudent>

Respuesta

<unoStudent

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-

000001003549" > Identificador único en la BDC
<studentId>ADP4A.14</studentId> Clave del alumno
<name>
<firstName>VALERIA MICHELLE</firstName> Nombre
<middleName>PIÑEIRO</middleName> Primer apellido
<lastName>ARENAS</lastName> Segundo apellido
</name>
<birthDate>2002-02-18</birthDate> Fecha de nacimiento
<sex>Female</sex> (Male, Female, Not selected)
<userId>valeria.pineiro</userId> Username
<language>ES</language> Idioma

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-

000001003674</personRefId> persona.persona_id (Identificador único en la BDC)
<curp>PIAV020218MDFXRLB2</curp> CURP
<addressList> Listado de domicilios
<address addressType="Physical"> Tipo de dirección (Physical, Mailing, Shipping)
<street>
<line1>CALLE 8 DE MAYO </line1> Calle
</street>
<city>MEXICO</city> Ciudad
<neighborhood>PLANETARIO LINDAVISTA</neighborhood> Colonia
<postalCode>07300</postalCode> Código postal
<buildingSiteNumber>3</buildingSiteNumber> Número
<county>GUSTAVO A. MADERO</county> Municipio
<stateProvince>Distrito Federal</stateProvince> Estado

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-

000000011292</countyRefId> Identificador único en la BDC
</address>
</addressList>
<phoneNumberList></phoneNumberList> Listado de teléfonos
<schoolEmailList></schoolEmailList> Listado de correos electrónicos
</unoStudent>

¿Quién lo utiliza y cómo?

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 14	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