Page Comparison

...

Panel

title	Estado

<

Status

colour	Green
title	En uso

>

Info

title	En Uso

Cuando un requisito de sistema software tenga el estado En Uso significa que está disponible para su uso.

Este servicio será consultado utilizado por las aplicaciones que necesiten sincronizar actualizar datos de alumnos con la BDC.

...

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 existirser correcto manda mensaje de error.

<unoStudent refId

DescripcionEjemploADP4A.14

Campo	Descripción	Reglas de Negocio
unoStudent refId	Identificador único en la BDC alumno.alumno_id Obligatorio	El identificador debe existir, sino entrega 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>	1003549	studentId	Clave del alumno	Obligatorio varchar(50)	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

XML Payload

Obligatorio

En caso de no indicar valor entrega el siguiente mensaje:
<update id="" statusCode="400" >
<error id="00000000-0000-1000-0000-

000001003549

000004036006" >

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
<personRefId>00000000-0000-1000-0000-000001003674</personRefId> Tipo de dirección (

<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 En caso de 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>PIAV020218MDFXRLB2</curp> CURP
<addressList> Lista de domicilios
<address addressType="Physical">

curp	Curp
addressType	Tipo domicilio Valores: Physical, Mailing, Shipping

)

<street>
<line1>CALLE 8 DE MAYO</line1>


line1	Calle

</street>
<city>MEXICO</city> Ciudad
<neighborhood>PLANETARIO LINDAVISTA</neighborhood> Colonia
<postalCode>07300</postalCode> Código Postal
<buildingSiteNumber>2</buildingSiteNumber>
<county>GUSTAVO A MADERO</county>
<stateProvince>Distrito Federal</stateProvince>
<countyRefId>00000000-0000-1000-0000-000000011302</countyRefId>
</address>
<address addressType="Mailing">
<street>
<line1>CALLE 10 DE ABRIL</line1>
</street>
<city>IRAPUATO</city>
<neighborhood>TABACHINES</neighborhood>
<postalCode>07500</postalCode>
<buildingSiteNumber>22</buildingSiteNumber>
<county>IRAPUATO</county>
<stateProvince>Guanajuato</stateProvince>


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">
    <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-000003149709</personRefId>
    <curp></curp>
    <addressList>
        <address addressType="Physical">
            <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-

000000008126<

000000015248</countyRefId>


        </address>


    </addressList>

<phoneNumberList>
<phoneNumber


    <phoneNumberList>
        <phoneNumber phoneNumberType="Home">


            <number>53956782</number>


        </phoneNumber>

<phoneNumber


        <phoneNumber phoneNumberType="Mobile">


            <number>5537651829</number>


        </phoneNumber>


    </phoneNumberList>

<schoolEmailList>
<schoolEmail>
<email>correo@correo.com</email>
</schoolEmail>
</schoolEmailList>
</unoStudent>

Respuesta

<unoStudent


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

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

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>

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


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

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