Especificacion de Uso WSSIGE v3.0

Especificaciones WS SIGE
Versin 3.0 13/09/2012
Especificacin de Servicios Web SIGE
Servicios Web Externos

API Servicios SIGE V-0.3
Coordinacin Nacional de Tecnologa

Informacin e Innovacin
Ministerio de Educacin de Chile
Fecha: 13/ Septiembre/ 2012
Pgina 1 de 40
CONTROL DE CAMBIOS
Cambios 13/09/2012
Se agrega descripciones de los servicios web, de los parmetros de salida y

reglas de validacin.
Se presenta en un documento separado la especificacin del servicio web

Obtencin de Semilla.
Se actualizan anexos: tablas Cdigos Tipos de Enseanza y Cdigos Grados de

Enseanza.
Versin 3.0 13/09/2012
INTRODUCCIN
Como parte del proyecto de interoperabilidad entre el sistema de

informacin general de estudiantes SIGE y las distintas plataformas de
software de gestin educacional, se dispone del siguiente documento que
permitir describir la interaccin con el sistema SIGE a travs de una serie de
servicios web en adelante WS.
Este documento est dirigido a quienes necesiten utilizar y probar los

servicios mencionados anteriormente.
Como requisito de uso para utilizar este manual es necesario tener previo
conocimiento de XML y Web Services.
Para acceder a los servicios que ofrece el Ministerio de Educacin, se debe

utilizar WSDL (Web Services Definition Language).
WSDL es un lenguaje descriptor, basado en XML, que permite conocer en

forma abstracta, la gramtica de los componentes de un Web Service
(ubicacin, formato, tipos de datos, servicios, funciones, parmetros de
entrada, salida, etc.)
Respecto a la Autenticacin, para poder realizar consultas hacia cualquiera

de los WS que se pondrn a disposicin, los clientes deben estar previamente
registrados en la base de datos de convenios. A travs de la GENERACIN
DE SEMILLAS con las credenciales otorgadas al efectuarse el registro del
convenio, el cliente obtiene permisos temporales para el consumo de los
servicios. Cabe mencionar que el servicio de generacin de semillas es un
servicio genrico el cual se debe utilizar para cada uno de los servicios que
disponga MINEDUC.
Para preguntas o sugerencias se ha habilitado la casilla

interoperabilidad@mineduc.cl, a la cual pueden dirigir sus consultas en caso
de requerir informacin adicional a lo entregado en estos documentos.
Pgina 3 de 40
1 OBJETIVOS Y CARACTERISTICAS GENERALES
El propsito de los servicios de interoperabilidad con SIGE, es permitir a los

establecimientos educacionales que cuentan con sistemas de gestin
educacional propietarios el intercambio, validacin y actualizacin de
informacin entre estos sistemas y el sistema SIGE, evitando de esta manera
la doble digitalizacin por parte de los establecimientos, de la informacin
que deben manejar en sus sistemas como la que deben ingresar en SIGE para
cumplir con los distintos procesos de MINEDUC.
Para cada servicio se definirn documentos XML de entrada (parmetros) y

salida (respuesta de servicio), los que son intercambiados como mensajes
SOAP. Estos documentos XML estn definidos mediante Esquemas.
Todas las operaciones deben ser invocadas enviando (segn el esquema

definido para cada documento de entrada), un parmetro llamado semilla,
la cual se obtiene tambin a travs de un servicio, cuyo documento de
entrada contiene como parmetros el identificador del cliente, el
identificador del convenio y la contrasea establecida para el convenio.
Mediante el uso de la semilla, se registran las operaciones efectuadas por el
convenio del cliente, permitiendo efectuar la traza de uso de los servicios.
Cada semilla tiene un tiempo de duracin equivalente al de una sesin web
de navegador, por lo que cuando stas expiran, se debe obtener una nueva
semilla para seguir operando. Al momento de expirar una semilla, cada
consulta u operacin efectuada contra un servicio, responder un
documento XML indicando que la semilla se encuentra en estado invlido, de
acuerdo al esquema de salida definido para ese servicio en particular.
Versin 3.0 13/09/2012
2 GLOSARIO
SOAP: Simple Object Access Protocol, es el protocolo base de comunicacin

de Web Services. Este protocolo est basado en XML y no se encuentra
sujeto a ninguna plataforma o lenguaje de programacin en particular.
Web Service: Estndar de comunicacin entre procesos y/o componentes,

diseado para ser multiplataforma y multilenguaje, es decir, no importa en
qu lenguaje est programado un Web Service (Java, Visual, .Net) o en qu
plataforma est corriendo, ya sea Windows o Linux, stos sern accesibles y
utilizables por otras aplicaciones desarrolladas en otras plataformas o
lenguajes de programacin.
WSDL: Web Services Description Language, es un documento XML que se

utiliza para describir los mensajes SOAP y cmo estos mensajes son
intercambiados. Describe una interfaz pblica a los servicios web. Est
basado en XML y describe la forma de comunicacin, es decir, los requisitos
del protocolo y los formatos de los mensajes necesarios para interactuar con
los servicios listados en su catalogo. Las operaciones que definen se
describen en abstracto y se ligan despus al protocolo de red y al formato del
mensaje.
Pgina 5 de 40
3 URL DE LOS ESQUEMAS DE DOCUMENTOS XML
Las URL de los esquemas de definicin XML estn publicados en:
Consulta de Validacin de Alumno SIGE

http://wwwfs.mineduc.cl/Archivos/Schemas/EntradaValidaAlumnoSige.xsd
http://wwwfs.mineduc.cl/Archivos/Schemas/SalidaValidaAlumnoSige.xsd
Ingresar Tipos de Enseanza SIGE

http://dido.mineduc.cl/Archivos/Schemas/EntradaAddTipoEnsenanzaSige.xs
d
http://dido.mineduc.cl/Archivos/Schemas/TiposTipoEnsenanzaSige.xsd
http://dido.mineduc.cl/Archivos/Schemas/SalidaAddTipoEnsenanzaSige.xsd
Ingresar Cursos SIGE

http://dido.mineduc.cl/archivos/schemas/EntradaAddCursoSige.xsd
http://dido.mineduc.cl/archivos/schemas/TiposCursoSige.xsd
http://dido.mineduc.cl/Archivos/Schemas/SalidaAddCursoSige.xsd
Ingresar Asistencias SIGE

http://dido.mineduc.cl/Archivos/Schemas/EntradaAddAsistenciaSige.xsd
http://dido.mineduc.cl/Archivos/Schemas/TiposAsistenciaSige.xsd
http://dido.mineduc.cl/Archivos/Schemas/SalidaAddAsistenciaSige.xsd
Ver Reporte del Envi de Asistencia SIGE

http://dido.mineduc.cl/Archivos/Schemas/EntradaGetReporteEnvioAsistenci
aSige.xsd
http://dido.mineduc.cl/Archivos/Schemas/SalidaGetReporteEnvioAsistenciaS
ige.xsd
Versin 3.0 13/09/2012
4 DEFINICION DE SERVICIOS
En la actualidad se dispone de los siguientes servicios con sus respectivas

operaciones y definiciones.
1. SemillaServicios
2. ValidaAlumnoSige
3. TipoEnsenanzaSige
4. CursoSige
5. AsistenciaSige
Adems, se espera la incorporacin de nuevos servicios cuyas

especificaciones se documentarn en su oportunidad.
Cualquier otro servicio expuesto en el content root actual no debe ser
considerado. Se espera que para el paso a produccin de los servicios se
entregue una URL final con los servicios vlidos.
A continuacin se describe en detalle cada uno de los servicios

implementados, la forma de llamar sus operaciones y los documentos xml de
entrada y salida.
Pgina 7 de 40
4.1 Web Service Obtencin de Semilla (Servicio SemillaServicios)
Todas operaciones o WS deben ser invocadas enviando (segn el esquema

definido para cada documento de entrada), un parmetro llamado semilla.
La descripcin de este servicio se presenta en el documento:
Especificacin_de_Uso_WSAUTORIZACION_V0.1.pdf
Versin 3.0 13/09/2012
4.2 Web Service Consulta de Validacin de Alumno SIGE (Servicio

ValidaAlumnoSige)
Este WS tiene como finalidad validar que la informacin personal bsica de

un alumno se encuentre registrada en el sistema. La validacin de datos
enviados es contrastada con la informacin registrada en SIGE (desde el ao
2008 en adelante).
URL Esquema de definicin de documento xml de entrada:
http://wwwfs.mineduc.cl/Archivos/Schemas/EntradaValidaAlumnoSige.xsd
Este esquema define XML de parmetros para el consumo del servicio de

validacin de alumnos SIGE.
URL Esquema de definicin de documento xml de salida:
http://wwwfs.mineduc.cl/Archivos/Schemas/SalidaValidaAlumnoSige.xsd
Este esquema define el documento XML de respuesta del servicio.
Descripcin Campos XML entrada:
Nombre Descripcin Tipo de Dato Validacin

Corresponde al valor del
numero Int -Mayor a 0
RUN ingresado
-Valor entre el 0-9 o
Dgito verificador del
dv String el carcter "K"
RUN ingresado.
-Distinto de Blanco
Nombres del alumno a
Nombres String -Distinto de Blanco
validar.
Apellido Paterno del
ApellidoPaterno String -Distinto de Blanco
alumno
Apellido Materno del
ApellidoMaterno String
alumno
Pgina 9 de 40
Nombre Descripcin Tipo de Dato Validacin
Token de autenticacin
-Distinto de Blanco
Semilla para consumo y traza del String
-Semilla Valida
servicio.
XML de Entrada (Ejemplo)
<?xml version="1.0" encoding="UTF-8"?>

<EntradaValidaAlumnoSige xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://wwwfs.mineduc.cl/Archivos/Schemas/
EntradaValidaAlumnoSige.xsd" xmlns="http://wwwfs.mineduc.cl/Archivos/Schemas/">
<Run>
<numero>12345678</numero>
<dv>k</dv>
</Run>
<Nombres>PEDRO</Nombres>
<ApellidoPaterno>PEREZ</ApellidoPaterno>
<ApellidoMaterno>GONZALEZ</ApellidoMaterno>
<Semilla>O9EmfQXpQc9fAQPnungwmZTidBr8qORt </Semilla>
</EntradaValidaAlumnoSige>
Descripcin Campos XML Salida:
ExisteFichaAlumno: corresponde a un entero que representa el estado

de respuesta del servicio, segn la siguiente tabla:
Valor Glosa
1 RUN de entrada tiene Ficha SIGE y la identificacin proporcionada es correcta.
2 RUN de entrada tiene Ficha SIGE, pero la identificacin proporcionada no
corresponde a la registrada en SIGE.
3 Este cdigo de retorno no est operativo por el momento.

4 RUN de entrada NO tiene Ficha SIGE.
5 RUN de entrada NO vlido.
6 Semilla de operacin NO vlida o ha caducado. (renovar semilla)
7 Error interno de servicio.
Versin 3.0 13/09/2012
XML de salida (Ejemplo)

<SalidaValidaAlumnoSige xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://wwwfs.mineduc.cl/Archivos/Schemas/
SalidaValidaAlumnoSige.xsd" xmlns="http://wwwfs.mineduc.cl/Archivos/Schemas/">
<ExisteFichaAlumno>1</ExisteFichaAlumno>
</SalidaValidaAlumnoSige>
URL del descriptor de servicio (WSDL):
http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/ValidaAlumnoSigeSoapPor
t.wsdl
Nombre de mtodo final (Nombre de operacin):
Nombre Operacin : getValidacion
Mtodo que retorna documento XML con el valor de retorno definido

anteriormente. El mtodo recibe el nmero de RUN, digito verificador del
RUN, Nombres, Apellidos del alumno y el valor de una semilla de operacin
vlida.
Pgina 11 de 40
4.3 Web Service Ingresar Tipos de Enseanza SIGE (Servicio
TipoEnsenanzaSige)
Este WS permite crear nuevos tipos de enseanza en SIGE para el ao

definido de trabajo.
http://dido.mineduc.cl/Archivos/Schemas/EntradaAddTipoEnsenanzaSige.xs
d

gestin de tipos de enseanza SIGE.
http://dido.mineduc.cl/Archivos/Schemas/SalidaAddTipoEnsenanzaSige.xsd
Tipo de
Nombre Descripcin Validacin
Dato
- Mayor a 0
- Debe
AnioEscolar Ao escolar Int
corresponder al
ao de proceso
Identificador del
RBD Int - Mayor a 0
establecimiento.
- Tipos de
Cdigo de tipo de enseanza
CodigoTipoEnsenanza Int
enseanza. habilitados para
el ao de trabajo
Versin 3.0 13/09/2012
Tipo de
Dato
( ver anexo)
Estado del tipo de
EstadoTipoEnsenanza Int - Valor igual a 1
enseanza.
Nmero de resolucin de
autorizacin del tipo de
enseanza (podra ser
NumeroAutorizacion Int -Mayor a 0
idntica a la de RO del
establecimiento).
Fecha de resolucin de -Distinto de

autorizacin del tipo de Blanco
FechaAutorizacion enseanza (podra ser Fecha -Fecha en
idntica a la de RO del formato yyyy-
establecimiento). mm-dd
indica si establecimiento -Valor true
TieneCentroPadres Booleano
tiene centro de padres false
-Valor true
Indica si establecimiento false
TienePersonalidadJuridica tiene personalidad Booleano -Aplica solo si
jurdica Centro de padres
igual true
corresponde al nmero
de grupos diferenciales -Valor mayor o
NumeroGruposDiferenciales Int
que maneja el igual 0
establecimiento
horario de inicio de la -Valor en formato
HorarioInicioManana String
jornada de la maana 00:00:00-03:00
-Valor en formato
Horario de trmino de la 00:00:00-03:00
HorarioTerminoManana String
jornada de la maana. - Hora mayor a
jornada inicio
-Valor en formato
HorarioInicioTarde String
jornada de la tarde. - Hora mayor a
jornada inicio
-Valor en formato
HorarioTerminoTarde String
jornada de la tarde. - Hora mayor a
jornada inicio
Horario de inicio de la -Valor en formato
HorarioInicioMananaTarde String
jornada de la maana- 00:00:00-03:00
Pgina 13 de 40
Tipo de
Dato
tarde. - Hora mayor a
jornada inicio
-Valor en formato
HorarioTerminoMananaTarde String
jornada maana-tarde. - Hora mayor a
jornada inicio
-Valor en formato
Horario de inicio de la 00:00:00-03:00
HorarioInicioVespertino String
jornada vespertino. - Hora mayor a
jornada inicio
-Valor en formato
HorarioTerminoVespertino String
jornada vespertino. - Hora mayor a
jornada inicio
Token de autenticacin -Distinto de
Semilla para consumo y traza del String Blanco
servicio. -Semilla Valida

<mine:EntradaAddTipoEnsenanzaSige
xmlns:mine="http://dido.mineduc.cl/Archivos/Schemas/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://dido.mineduc.cl/Archivos/Schemas/EntradaAddTipoEnsenanz
aSige.xsd">
<mine:RecordTipoEnsenanzaSige>
<mine:PKTipoEnsenanzaSige>
<mine:AnioEscolar>2011</mine:AnioEscolar>
<mine:RBD>1</mine:RBD>
<mine:CodigoTipoEnsenanza>110</mine:CodigoTipoEnsenanza>
</mine:PKTipoEnsenanzaSige>
<mine:EstadoTipoEnsenanza>1</mine:EstadoTipoEnsenanza>
<mine:NumeroAutorizacion>50</mine:NumeroAutorizacion>
<mine:FechaAutorizacion>2003-04-20</mine:FechaAutorizacion>
<mine:TieneCentroPadres>true</mine:TieneCentroPadres>
<mine:TienePersonalidadJuridica>false</mine:TienePersonalidadJuridica>
<mine:NumeroGruposDiferenciales>0</mine:NumeroGruposDiferenciales>
Versin 3.0 13/09/2012

<mine:HorarioInicioManana>08:30-03:00</mine:HorarioInicioManana>
<mine:HorarioTerminoManana>12:45-
03:00</mine:HorarioTerminoManana>
<mine:HorarioInicioTarde>00:00-03:00</mine:HorarioInicioTarde>
<mine:HorarioTerminoTarde>00:00-03:00</mine:HorarioTerminoTarde>
<mine:HorarioInicioMananaTarde>00:00-
03:00</mine:HorarioInicioMananaTarde>
<mine:HorarioTerminoMananaTarde>00:00-
03:00</mine:HorarioTerminoMananaTarde>
<mine:HorarioInicioVespertino>00:00-
03:00</mine:HorarioInicioVespertino>
<mine:HorarioTerminoVespertino>00:00-
03:00</mine:HorarioTerminoVespertino>
</mine:RecordTipoEnsenanzaSige>
<Semilla>O9EmfQXpQc9fAQPnungwmZTidBr8qORt </Semilla>
</mine:EntradaAddTipoEnsenanzaSige>
CodigoRespuestaTipoEnsenanza: corresponde a un entero que representa el

estado de respuesta del servicio, segn la siguiente tabla:
Valor Glosa
1 Operacin/Accin ejecutada exitosamente.
2 Error(es) de Validacin(es) de Negocio.
3 RBD NO tiene Servicio Disponible.
4 Convenio NO tiene asociado el RBD.
5 Servicio NO Disponible.
7 Error Interno de servicio.
ListadoMensajes: corresponde a un listado con ttulo y mensajes

descriptivos de validaciones efectuadas.

<mine:SalidaAddTipoEnsenanzaSige
Pgina 15 de 40
xsi:schemaLocation="http://dido.mineduc.cl/Archivos/Schemas/SalidaAddTipoEnsenanza
Sige.xsd">
<mine:CodigoRespuestaTipoEnsenanza>2</mine:CodigoRespuestaTipoEnsenanza>
<mine:ListadoMensajes>
<mine:Titulo>LISTADO DE ERRORES DE VALIDACION DE
NEGOCIO</mine:Titulo>
<mine:Mensaje>RBD (1) YA TIENE TIPO ENSEANZA (110) PARA AO
ESCOLAR (2011).</mine:Mensaje>
<mine:Mensaje>SI NO TIENE CENTRO DE PADRES NO PUEDE TENER
PERSONALIDAD JURIDICA.</mine:Mensaje>
</mine:ListadoMensajes>
</mine:SalidaAddTipoEnsenanzaSige>
http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/TipoEnsenanzaSigeSoapPo
rt.wsdl
Nombre Operacin : addTipoEnsenanza

anteriormente. El mtodo recibe el ao escolar, RBD, cdigo de tipo
enseanza, el estado de tipo enseanza, el nmero de autorizacin, la fecha
de autorizacin, si tiene centro de padres, si tiene personalidad jurdica, el
nmero de grupos diferenciales, el horario de inicio maana, el horario de
termino maana, el horario de inicio tarde, el horario de termino de tarde, el
horario de inicio de maana tarde, el horario de termino de maana tarde, el
horario de inicio de vespertino, el horario de termino de vespertino y el valor
de una semilla de operacin vlida.
Versin 3.0 13/09/2012
4.4 Web Service Ingresar Cursos SIGE (Servicio CursoSige)
Este WS permite crear nuevos cursos en SIGE para el ao definido de trabajo.
http://dido.mineduc.cl/Archivos/Schemas/EntradaAddCursoSige.xsd

gestin de cursos SIGE.
http://dido.mineduc.cl/Archivos/Schemas/SalidaAddCursoSige.xsd
Nombre Descripcin Tipo de Validacin

Dato
AnioEscolar Ao escolar Int - Mayor a 0
- Debe
corresponder al
ao de proceso
RBD Identificador del Int - Mayor a 0
establecimiento.
CodigoTipoEnsenanza Cdigo de tipo Int - Tipos de
de enseanza. enseanza
habilitados para el
ao de trabajo (
ver anexo)
CodigoGrado Cdigo de grado Int - Grados
habilitados para el
ao de trabajo
(ver anexo)
LetraCurso Letra del curso String -Distinto de
Pgina 17 de 40
Dato
Blanco
numero Corresponde al Int -Mayor a 0
valor del RUN
del profesor jefe
Dv Digito String -Distinto de
verificador del Blanco
profesor jefe
CursoCombinado Indica si es Booleano -Valor true false
curso
combinado
NumeroCursoCombinado Numero que Int -Mayor a 0
agrupa el curso
combinado
CodigoTipoJornada Indica en qu Int -Tipo de Jornada
tipo de jornada habilitada para el
se realiza el Tipo de enseanza
curso asociado.
- 1 MAANA
- 2 TARDE
- 3 MAANA Y
TARDE
- 4 VESPERTINA/
NOCTURNA
CodigoSectorEconomico Tag optativo si Int - Sectores

el grado no econmicos
posee habilitados para el
especialidad. ao de trabajo (
Indica el sector ver anexo)
econmico de
los cursos
Tcnico-
Profesional
CodigoEspecialidad Tag optativo si Int - Especialidades
el grado no habilitadas para el
posee ao de trabajo (
especialidad. ver anexo)
Indica la
especialidad de
los cursos
Versin 3.0 13/09/2012

Dato
Tcnico-
Profesional
CodigoAlternativaDesarrolloCurricular Tag optativo si Int -1 Tradicional
el grado no (Solo
posee Establecimiento)
especialidad. -2 Formacin Dual
Indica la (Establecimiento y
alternativa de Empresa)
desarrollo - 3 Otra
curricular que
aplica al curso
Tcnico-
Profesional
TieneInfraestructuraEspecialidad Tag optativo si Booleano -Valor true false
el grado no
posee
especialidad.
Indica si el curso
posee
infrestructura
para la
especialidad
Semilla Token de String -Distinto de
autenticacin Blanco
para consumo y -Semilla Valida
traza del
servicio.

<mine:EntradaAddCursoSige xmlns:mine="http://dido.mineduc.cl/Archivos/Schemas/"
xsi:schemaLocation="http://dido.mineduc.cl/Archivos/Schemas/
http://dido.mineduc.cl/Archivos/Schemas/EntradaAddCursoSige.xsd">
<mine:RecordCursoSige>
<mine:PKCursoSige>
Pgina 19 de 40
<mine:CodigoGrado>3</mine:CodigoGrado>
<mine:LetraCurso>A</mine:LetraCurso>
</mine:PKCursoSige>
<mine:Run>
<mine:numero>10230147</mine:numero>
<mine:dv>1</mine:dv>
</mine:Run>
<mine:CursoCombinado>false</mine:CursoCombinado>
<mine:NumeroCursoCombinado>0</mine:NumeroCursoCombinado>
<mine:CodigoTipoJornada>1</mine:CodigoTipoJornada>
<mine:CodigoSectorEconomico>510</mine:CodigoSectorEconomico>
<mine:CodigoEspecialidad>51001</mine:CodigoEspecialidad>
<mine:CodigoAlternativaDesarrolloCurricular>1</mine:CodigoAlternativaDesarrolloCurric
ular>
<mine:TieneInfraestructuraEspecialidad>false</mine:TieneInfraestructuraEspecialidad
CodigoInfraestEspe >
</mine:RecordCursoSige>
<mine:Semilla>O9EmfQXpQc9fAQPnungwmZTidBr8qORt </mine:Semilla>
</mine:EntradaAddCursoSige>
CodigoRespuestaCurso: corresponde a un entero que representa el

estado de respuesta del servicio, segn la siguiente tabla:
Valor Glosa
Versin 3.0 13/09/2012
ListadoMensajes: corresponde a un listado con ttulo y mensajes de

validaciones.

<mine:SalidaAddCursoSige xmlns:mine="http://dido.mineduc.cl/Archivos/Schemas/"
http://dido.mineduc.cl/Archivos/Schemas/SalidaAddCursoSige.xsd">
<mine:CodigoRespuestaCurso>2</mine:CodigoRespuestaCurso>
<mine:Titulo>LISTADO DE ERRORES DE VALIDACION DE
NEGOCIO</mine:Titulo>
<mine:Mensaje>RBD (1) YA TIENE CURSO (A) PARA CODIGO DE ENSEANZA
(510) Y GRADO (3) EN EL AO ESCOLAR (2011).</mine:Mensaje>
<mine:Mensaje>SI ES CURSO COMBINADO (true) EL NUMERO DEL CURSO
COMBINADO (0) DEBE SER MAYOR A CERO.</mine:Mensaje>
<mine:Mensaje>TIPO ENSEANZA (510) NO PERMITE CURSO COMBINADO
(true).</mine:Mensaje>
<mine:Mensaje>TIPO ENSEANZA (510) NO TIENE SECTOR ECONOMICO
(500).</mine:Mensaje>
<mine:Mensaje>SECTOR ECONOMICO (500) NO TIENE ESPECIALIDAD
(51000).</mine:Mensaje>
</mine:SalidaAddCursoSige>
http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/CursoSigeSoapPort.wsdl
Nombre Operacin : addCurso

enseanza, cdigo de grado, letra del curso, RUN del profesor jefe, curso
Pgina 21 de 40
combinado, nmero del curso combinado, cdigo del tipo de jornada, cdigo
del sector econmico, cdigo de la especialidad, cdigo de la alternativa de
desarrollo curricular y el valor de una semilla de operacin vlida.
Versin 3.0 13/09/2012
4.5 Web Service Ingresar Asistencias SIGE (Servicio AsistenciaSige)
Este WS permite ingresar la asistencia diaria a nivel de grado en SIGE para el

ao definido de trabajo y mes de declaracin de asistencia.
El servicio solo recibe informacin de asistencia del ao y mes escolar de

trabajo en curso, no permitindose trabajar con asistencias de meses
rezagados.
http://dido.mineduc.cl/Archivos/Schemas/EntradaAddAsistenciaSige.xsd

asistencia SIGE.
http://dido.mineduc.cl/Archivos/Schemas/SalidaAddAsistenciaSige.xsd
Tipo de
Dato
- Mayor a 0
AnioEscolar Ao escolar Int - Debe corresponder al
ao de proceso
Identificador del - Mayor a 0
RBD Int
establecimiento.
- Tipos de enseanza
Cdigo de tipo de
CodigoTipoEnsenanza Int habilitados para el ao
enseanza.
de trabajo ( ver anexo)
Pgina 23 de 40
- Grados habilitados para
CodigoGrado Cdigo de grado Int el ao de trabajo (ver
anexo)
Fecha de asistencia a
FechaAsistencia Fecha -Distinto de Vaco
informar
Cursos Listado de cursos a enviar Lista -Distinto de Vaco
LetraCurso Letra del curso String -Distinto de Blanco
-Distinto de Vacio si
Listado de alumnos
Presentes Lista elemento Ausentes no
presentes
presenta informacin
RUN del alumno
Digito verificador del
Dv String -Distinto de Blanco
alumno
-Distinto de Vacio SI
Listado de alumnos
Ausentes Lista elemento presente no
ausentes
presenta informacin
RUN del alumno
Digito verificador del
Dv String -Distinto de Blanco
alumno
Token de autenticacin
-Distinto de Blanco
Semilla para consumo y traza del String
-Semilla Valida
servicio.

<mine:EntradaAddAsistenciaSige
http://dido.mineduc.cl/Archivos/Schemas/EntradaAddAsistenciaSige.xsd">
<mine:RecordAsistenciaSige>
<mine:CodigoGrado>3</mine:CodigoGrado>
<mine:FechaAsistencia>2011-05-03</mine:FechaAsistencia>
<mine:Cursos>
Versin 3.0 13/09/2012

<mine:Curso>
<mine:LetraCurso>A</mine:LetraCurso>
<mine:Presentes>
<mine:Run>
</mine:Run>
<mine:Run>
</mine:Run>
<mine:Run>
</mine:Run>
<mine:Run>
</mine:Run>
</mine:Presentes>
<mine:Ausentes>
<mine:Run>
</mine:Run>
</mine:Ausentes>
</mine:Curso>
</mine:Cursos>
</mine:RecordAsistenciaSige>
<mine:Semilla>O9EmfQXpQc9fAQPnungwmZTidBr8qORt </mine:Semilla>
</mine:EntradaAddAsistenciaSige>
CodigoRespuestaAsistencia: corresponde a un entero que representa

el estado de respuesta del servicio, segn la siguiente tabla:
Valor Glosa
Pgina 25 de 40
Valor Glosa
CodigoEnvioAsistencia: corresponde a un string que representa el

identificador de envi con el que ser procesada la asistencia de modo
off-line.

validaciones.

<mine:SalidaAddAsistenciaSige xmlns:mine="http://dido.mineduc.cl/Archivos/Schemas/"
http://dido.mineduc.cl/Archivos/Schemas/SalidaAddAsistenciaSige.xsd">
<mine:CodigoRespuestaAsistencia>1</mine:CodigoRespuestaAsistencia>
<mine:CodigoEnvioAsistencia>20110620153716655362000000</mine:CodigoEnvi
oAsistencia>
</mine:SalidaAddAsistenciaSige>
http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/AsistenciaSigeSoapPort.w
sdl
Nombre Operacin : addAsistencia

Versin 3.0 13/09/2012

enseanza, cdigo de grado, fecha de asistencia, Listado de cursos, Letra de
curso, Listado de alumnos presentes y ausentes y el valor de una semilla de
operacin vlida.
Pgina 27 de 40
4.6 Web Service Ver Reporte del Envo de Asistencia SIGE.
Este WS permite consultar por el estado de procesamiento de la asistencia

enviada a SIGE.
http://dido.mineduc.cl/Archivos/Schemas/EntradaGetReporteEnvioAsistenci
aSige.xsd

asistencia SIGE.
URL Esquema de definicin de documento XML de salida:
http://dido.mineduc.cl/Archivos/Schemas/SalidaGetReporteEnvioAsistenciaS
ige.xsd
Tipo de
Dato
RBD Identificador del establecimiento. Int - Mayor a 0
-Distinto de
CodigoEnvioAsistencia Cdigo de envi de asistencia String
Blanco
-Distinto de
Token de autenticacin para
Semilla String Blanco
consumo y traza del servicio.
-Semilla Valida
Versin 3.0 13/09/2012

<mine:EntradaGetReporteEnvioAsistenciaSige
http://dido.mineduc.cl/Archivos/Schemas/EntradaGetReporteEnvioAsistenciaSige.xsd">
<mine:CodigoEnvioAsistencia>20110616205416481645000000</mine:CodigoEnvi
oAsistencia>
<mine:Semilla> O9EmfQXpQc9fAQPnungwmZTidBr8qORt </mine:Semilla>
</mine:EntradaGetReporteEnvioAsistenciaSige>
CodigoRespuestaReporteEnvioAsistencia: corresponde a un entero

que representa el estado de respuesta del servicio, segn la siguiente
tabla:
Valor Glosa
1 Asistencia procesada Exitosamente.
2 Asistencia procesada con Observaciones.
3 Asistencia procesada con Errores.
4 Asistencia aun no ha sido procesada.
5 Parmetros no corresponden.

validaciones.

<mine:SalidaGetReporteEnvioAsistenciaSige
Pgina 29 de 40
http://dido.mineduc.cl/Archivos/Schemas/SalidaGetReporteEnvioAsistenciaSige.xsd">
<mine:CodigoRespuestaReporteEnvioAsistencia>3</mine:CodigoRespuestaReport
eEnvioAsistencia>
<mine:Titulo>LISTADO DE ERRORES</mine:Titulo>
<mine:Mensaje>LETRA CURSO (A) RECHAZADO, FALTA INFORMAR
ASISTENCIA DE 2 ALUMNO(S).</mine:Mensaje>
<mine:Mensaje>LETRA CURSO (A) RUN 21090989
FALTANTE.</mine:Mensaje>
<mine:Mensaje>LETRA CURSO (A) RUN 21121694
FALTANTE.</mine:Mensaje>
</mine:SalidaGetReporteEnvioAsistenciaSige>
http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/AsistenciaSigeSoapPort.w
sdl
Nombre Operacin : getReporteEnvioAsistencia

anteriormente. El mtodo recibe el RBD, cdigo de envi de asistencia y el
valor de una semilla de operacin vlida.
Versin 3.0 13/09/2012
5 RESUMEN
En general, para probar el flujo de operacin de los servicios, el flujo es:
1. Obtener semilla desde servicio SemillaServicios con datos de

autenticacin.
2. Usar la semilla obtenida para invocar uno o varios servicios descritos
en este documento.
3. Si la respuesta del servicio es 6, obtener nueva semilla con servicio y
reintentar llamada.
Para entorno de desarrollo, utilizar los siguientes datos de autenticacin

(credenciales genricas):
Id de Cliente : 3
Id de Convenio : 4
Token Convenio : TESTSIGE
Una vez realizadas pruebas iniciales, para que haya una traza de las
transacciones realizadas a nivel de proveedor de servicios (software de
gestin escolar), se pueden utilizar credenciales particulares.
Pgina 31 de 40
6 ANEXOS
6.1 Cdigos Tipos de Enseanza Vigentes 2011-2012
Cdigo Tipo
Descripcin Tipo Enseanza
Enseanza
10 Educacin Parvularia
110 Enseanza Bsica
165 Educacin Bsica Adultos Sin Oficios
167 Educacin Bsica Adultos Con Oficios
211 Educacin Especial Discapacidad Auditiva
212 Educacin Especial Discapacidad Intelectual
213 Educacin Especial Discapacidad Visual
214 Educacin Especial Trastornos Especficos del Lenguaje
215 Educacin Especial Trastornos Motores
216 Educacin Especial Autismo
Educacin Especial Discapacidad Graves Alteraciones en la Capacidad
217
de Relacin y Comunicacin
299 Programa Integracin Escolar(PIE) Opcin 4
310 Enseanza Media Humanista-Cientfica nios y jvenes
360 Educacin Media Humanista-Cientfica Adultos Vespertina y Nocturno
363 Educacin Media H-C Adultos
410 Enseanza Media Tcnico-Profesional Comercial nios
463 Educacin Media T-P Adultos Comercial
510 Enseanza Media Tcnico-Profesional Industrial nios
563 Educacin Media T-P Adultos Industrial
610 Enseanza Media Tcnico-Profesional Tcnica nios
663 Educacin Media T-P Adultos Tcnica
710 Enseanza Media Tcnico-Profesional Agrcola nios
763 Educacin Media T-P Adultos Agrcola
810 Enseanza Media Tcnico-Profesional Martima nios
863 Educacin Media T-P Adultos Martima
910 Enseanza Media Artstica Nios y Jvenes
963 Enseanza Media Artstica Adultos
Versin 3.0 13/09/2012
6.2 Cdigos Grados de Enseanza Vigentes 2011-2012
Cdigo Tipo Enseanza Cdigo Grado Descripcin Grado

10 1 Sala Cuna
10 2 Nivel Medio Menor
10 3 Nivel Medio Mayor
10 4 1er nivel de Transicin (Pre-kinder)
10 5 2 nivel de Transicin (Kinder)
110 1 1 bsico
110 2 2 bsico
110 3 3 bsico
110 4 4 bsico
110 5 5 bsico
110 6 6 bsico
110 7 7 bsico
110 8 8 bsico
165 1 Nivel Bsico 1(1 a 4 bsico)
165 2 Nivel Bsico 2(5 y 6 bsico)
211 1 Prebsico Materno 1
211 2 Prebsico 1 - 1
211 7 Bsico 1 - 1
211 8 Bsico 1 - 2
211 9 Bsico 1 - 3
211 10 Bsico 1 - 4
211 11 Bsico 2 - 5
211 12 Bsico 2 - 6
211 13 Bsico 2 - 7
211 14 Bsico 2 - 8
211 15 Laboral 1
211 16 Laboral 2
211 17 Laboral 3
Pgina 33 de 40
212 5 Bsico 1 - 5
212 6 Bsico 1 - 6
212 7 Bsico 1 - 7
212 8 Bsico 2 - 8
212 9 Bsico 2 - 9
212 10 Bsico 2 - 10
212 11 Laboral 1
212 12 Laboral 2
212 13 Laboral 3
213 1 Estimulacin Temprana 1 - 1
213 7 Bsico 1 - 1
213 8 Bsico 1 - 2
213 9 Bsico 1 - 3
213 10 Bsico 1 - 4
213 11 Bsico 2 - 5
213 12 Bsico 2 - 6
213 13 Bsico 2 - 7
213 14 Bsico 2 - 8
213 15 Laboral 1 - 1
213 16 Laboral 1 - 2
213 17 Laboral 2 - 3
213 18 Laboral 2 - 4
214 1 Medio Menor
214 2 Medio Mayor
214 3 Primer Nivel de Transicin
214 4 2 Nivel de transicin
Versin 3.0 13/09/2012

215 8 Bsico 1 - 1
215 9 Bsico 1 - 2
215 10 Bsico 1 - 3
215 11 Bsico 1 - 4
215 12 Bsico 2 - 5
215 13 Bsico 2 - 6
215 14 Bsico 2 - 7
215 15 Bsico 2 - 8
215 16 Laboral 1 - 1
215 17 Laboral 1 - 2
215 18 Laboral 2 - 3
215 19 Laboral 2 - 4
216 1 Nivel de trabajo de 1
217 5 Bsico 1 - 5
217 6 Bsico 1 - 6
217 7 Bsico 1 - 7
217 8 Bsico 2 - 8
217 9 Bsico 2 - 9
217 10 Bsico 2 - 10
217 11 Laboral 1
217 12 Laboral 2
217 13 Laboral 3
217 14 Prebsico Materno 1 (Estimulacin Temprana)
299 1 Prebsico 1
299 2 Prebsico 2
299 3 Prebsico 3
299 4 Prebsico 4
Pgina 35 de 40
299 5 Prebsico 5
299 6 Bsico 1
299 7 Bsico 2
299 8 Bsico 3
299 9 Bsico 4
299 10 Bsico 5
299 11 Bsico 6
299 12 Bsico 7
299 13 Bsico 8
299 14 Bsico 9
299 15 Bsico 10
299 16 Laboral 1
299 17 Laboral 2
299 18 Laboral 3
299 19 Laboral 4
310 1 1 medio
310 2 2 medio
310 3 3 medio
310 4 4 medio
360 3 3 medio
360 4 4 medio
363 1 1er nivel (1 y 2 medio)
363 3 2do nivel (3 y 4 medio)
410 1 1 medio
410 2 2 medio
410 3 3 medio
410 4 4 medio
463 3 2do nivel (3 medio)
463 4 3er nivel (4 medio)
510 1 1 medio
510 2 2 medio
510 3 3 medio
510 4 4 medio
Versin 3.0 13/09/2012

610 1 1 medio
610 2 2 medio
610 3 3 medio
610 4 4 medio
710 1 1 medio
710 2 2 medio
710 3 3 medio
710 4 4 medio
810 1 1 medio
810 2 2 medio
810 3 3 medio
810 4 4 medio
910 1 1 medio
910 2 2 medio
910 3 3 medio
910 4 4 medio
910 2 2 medio
910 3 3 medio
910 4 4 medio
Pgina 37 de 40
6.3 Cdigos Sectores Econmicos vigentes
Cdigo Sector Econmico Descripcin Sector Econmico Cdigo Rama

410 Administracin y Comercio 400
510 Construccin 500
520 Metalmecnico 500
530 Electricidad 500
540 Minero 500
550 Grfica 500
560 Qumico 500
570 Confeccin 500
610 Alimentacin 600
620 Programas y Proyectos Sociales 600
630 Hotelera y Turismo 600
710 Maderero 700
720 Agropecuario 700
810 Martimo 800
910 Artes Visuales 900
920 Artes Escnicas Teatro 900
930 Artes Escnicas Danza 900
Versin 3.0 13/09/2012
6.4 Cdigos Especialidades de Sector Econmico Vigentes
Cdigo Sector Cdigo Aplica

Descripcin Especialidad
Econmico Especialidad Adulto
410 41001 Administracin 1
410 41002 Contabilidad 1
410 41003 Secretariado 1
410 41004 Ventas 1
510 51001 Edificacin 1
510 51002 Terminaciones de Construccin 1
510 51003 Montaje Industrial 1
510 51004 Obras Viales y de Infraestructura 1
510 51005 Instalaciones Sanitarias 1
510 51006 Refrigeracin y Climatizacin 1
520 52008 Mecnica Industrial 1
520 52009 Construcciones Metlicas 1
520 52010 Mecnica Automotriz 1
520 52011 Matricera 1
520 52012 Mecnica de Mantencin de Aeronaves 1
530 53014 Electricidad 1
530 53015 Electrnica 1
530 53016 Telecomunicaciones 1
540 54018 Explotacin Minera 1
540 54019 Metalurgia Extractiva 1
540 54020 Asistencia en Geologa 1
550 55022 Grfica 1
550 55023 Dibujo Tcnico 1
560 56025 Operacin de Planta Qumica 1
560 56026 Laboratorio Qumico 1
570 57028 Tejido 1
570 57029 Textil 1
570 57030 Vestuario y Confeccin Textil 1
570 57031 Productos del Cuero 1
610 61001 Elaboracin Industrial de Alimentos 1
610 61002 Servicio de Alimentacin Colectiva 1
620 62004 Atencin de Prvulos 1
620 62005 Atencin de Adultos Mayores 1
620 62006 Atencin de Enfermera 1
620 62007 Atencin Social y Recreativa 1
630 63009 Servicio de Turismo 1
630 63010 Servicio de Hotelera 1
710 71001 Forestal 1
Pgina 39 de 40
Cdigo Sector Cdigo Aplica
Descripcin Especialidad
Econmico Especialidad Adulto
710 71002 Procesamiento de la Madera 1
710 71003 Productos de la Madera 1
710 71004 Celulosa y Papel 1
720 72006 Agropecuaria 1
810 81001 Naves Mercantes y Especiales 1
810 81002 Pesquera 1
810 81003 Acuicultura 1
810 81004 Operacin Portuaria 1
910 91001 Artes Visuales 1
910 91002 Artes Audiovisuales 1
910 91003 Diseo 1
920 92004 Interpretacin Teatral 1
920 92005 Diseo Escnico 1
Interpretacin en Danza de Nivel
930 93006 1
Intermedio
930 93007 Monitora de Danza 1

Especificacion de Uso WSSIGE v3.0

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Especificacion de Uso WSSIGE v3.0

Transféré par

Droits d'auteur :

Formats disponibles

Especificaciones WS SIGE

Versin 3.0 13/09/2012

Especificacin de Servicios Web SIGE

Servicios Web Externos

Coordinacin Nacional de Tecnologa

Fecha: 13/ Septiembre/ 2012

Se agrega descripciones de los servicios web, de los parmetros de salida y

Se presenta en un documento separado la especificacin del servicio web

Se actualizan anexos: tablas Cdigos Tipos de Enseanza y Cdigos Grados de

Como parte del proyecto de interoperabilidad entre el sistema de

Este documento est dirigido a quienes necesiten utilizar y probar los

Para acceder a los servicios que ofrece el Ministerio de Educacin, se debe

WSDL es un lenguaje descriptor, basado en XML, que permite conocer en

Respecto a la Autenticacin, para poder realizar consultas hacia cualquiera

Para preguntas o sugerencias se ha habilitado la casilla

El propsito de los servicios de interoperabilidad con SIGE, es permitir a los

Para cada servicio se definirn documentos XML de entrada (parmetros) y

Todas las operaciones deben ser invocadas enviando (segn el esquema

SOAP: Simple Object Access Protocol, es el protocolo base de comunicacin

Web Service: Estndar de comunicacin entre procesos y/o componentes,

WSDL: Web Services Description Language, es un documento XML que se

Las URL de los esquemas de definicin XML estn publicados en:

Consulta de Validacin de Alumno SIGE

Ingresar Tipos de Enseanza SIGE

Ingresar Cursos SIGE

Ingresar Asistencias SIGE

Ver Reporte del Envi de Asistencia SIGE

En la actualidad se dispone de los siguientes servicios con sus respectivas

Adems, se espera la incorporacin de nuevos servicios cuyas

A continuacin se describe en detalle cada uno de los servicios

Todas operaciones o WS deben ser invocadas enviando (segn el esquema

4.2 Web Service Consulta de Validacin de Alumno SIGE (Servicio

Este WS tiene como finalidad validar que la informacin personal bsica de

URL Esquema de definicin de documento xml de entrada:

Este esquema define XML de parmetros para el consumo del servicio de

URL Esquema de definicin de documento xml de salida:

Este esquema define el documento XML de respuesta del servicio.

Descripcin Campos XML entrada:

Nombre Descripcin Tipo de Dato Validacin

XML de Entrada (Ejemplo)

<?xml version="1.0" encoding="UTF-8"?>

Descripcin Campos XML Salida:

ExisteFichaAlumno: corresponde a un entero que representa el estado

3 Este cdigo de retorno no est operativo por el momento.

XML de salida (Ejemplo)

<?xml version="1.0" encoding="UTF-8"?>

URL del descriptor de servicio (WSDL):

Nombre de mtodo final (Nombre de operacin):

Nombre Operacin : getValidacion

Mtodo que retorna documento XML con el valor de retorno definido

Este WS permite crear nuevos tipos de enseanza en SIGE para el ao

URL Esquema de definicin de documento xml de entrada:

Este esquema define XML de parmetros para el consumo del servicio de

URL Esquema de definicin de documento xml de salida:

Este esquema define el documento XML de respuesta del servicio.

Descripcin Campos XML entrada:

Fecha de resolucin de -Distinto de

XML de Entrada (Ejemplo)

<?xml version="1.0" encoding="UTF-8"?>

XML de Entrada (Ejemplo)

Descripcin Campos XML Salida:

CodigoRespuestaTipoEnsenanza: corresponde a un entero que representa el

ListadoMensajes: corresponde a un listado con ttulo y mensajes

XML de salida (Ejemplo)