Especificacion de Uso WSSIGE v3.0

Especificaciones WS SIGE Versión 3.0 13/09/2012

Especificación de Servicios Web SIGE Servicios Web Externos API Servicios SIGE V-0.3

Coordinación Nacional de Tecnología Información e Innovación Ministerio de Educación de Chile Fecha: 13/ Septiembre/ 2012

Página 1 de 40

CONTROL DE CAMBIOS Cambios 13/09/2012 Se agrega descripciones de los servicios web, de los parámetros de salida y reglas de validación. Se presenta en un documento separado la especificación del servicio web Obtención de Semilla. Se actualizan anexos: tablas Códigos Tipos de Enseñanza y Códigos Grados de Enseñanza.

CONTROL DE CAMBIOS Cambios 13/09/2012 Se agrega descripciones de los servicios web, de los parámetros de salida y reglas de validación. Se presenta en un documento separado la especificación del servicio web Obtención de Semilla. Se actualizan anexos: tablas Códigos Tipos de Enseñanza y Códigos Grados de Enseñanza.


INTRODUCCIÓN Como parte del proyecto de interoperabilidad entre el sistema de información general de estudiantes SIGE y las distintas plataformas de software de gestión educacional, se dispone del siguiente documento que permitirá describir la interacción con el sistema SIGE a través 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 Educación, se debe utilizar WSDL (Web Services Definition Language). WSDL es un lenguaje descriptor, descriptor, basado en en XML, que permite permite conocer en forma abstracta, la gramática de los componentes de un Web Service (ubicación, formato, tipos de datos, servicios, funciones, parámetros de entrada, salida, etc.) Respecto a la Autenticación, para poder realizar consultas hacia cualquiera de los WS que se pondrán a disposición, los clientes deben estar previamente registrados en la base de datos de “convenios”. A través de la GENERACIÓN 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 generación de semillas es un servicio genérico el cual se debe utilizar para cada uno de los servicios que disponga MINEDUC. Para preguntas o sugerencias se ha habilitado la casilla [email protected],, a la cual pueden dirigir sus consultas en caso [email protected] de requerir información adicional a lo entregado en estos documentos.

Página 3 de 40

1

OBJETIVOS Y CARACTERISTICAS GENERALES

El propósito de los servicios de interoperabilidad con SIGE, es permitir a los establecimientos educacionales que cuentan con sistemas de gestión educacional propietarios el intercambio, validación y actualización de información entre estos sistemas y el sistema SIGE, evitando de esta manera la doble digitalización por parte de los establecimientos, de la información 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 definirán documentos XML de entrada (parámetros) y salida (respuesta de servicio), los que son intercambiados como mensajes SOAP. Estos documentos XML están definidos mediante “Esquemas” . Todas las operaciones deben ser invocadas enviando (según el esquema definido para cada documento de entrada), un parámetro llamado “semilla”, la cual se obtiene también a través de un servicio, cuyo documento de entrada contiene como parámetros el identificador del cliente, el identificador del convenio y la contraseña 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 duración equivalente al de una sesión 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 operación efectuada contra un servicio, responderá un documento XML indicando que la semilla se encuentra en estado inválido, de acuerdo al esquema de salida definido salida definido para ese servicio en particular.


2

GLOSARIO

SOAP: Simple Object Access Protocol , es el protocolo base de comunicación de Web Services. Este protocolo está basado en XML y no se encuentra sujeto a ninguna plataforma o lenguaje de programación en particular. Web Service: Estándar de comunicación entre procesos y/o componentes, diseñado 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 serán accesibles y utilizables por otras aplicaciones desarrolladas en otras plataformas o lenguajes de programación. WSDL: Web Services Description Language, es un documento XML que se utiliza para describir los mensajes SOAP y cómo estos mensajes son intercambiados. Describe una interfaz pública a los servicios web. Está basado en XML y describe la forma de comunicación, 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 después al protocolo de red y al formato del mensaje.

Página 5 de 40

3

URL DE LOS ESQUEMAS DE DOCUMENTOS XML

Las URL de los esquemas de definición XML están publicados en: Consulta de Validación de Alumno SIGE http://wwwfs.mineduc.cl/Archivos/Schemas/EntradaValidaAlumnoSige.xsd http://wwwfs.mineduc.cl/Archivos/Schemas/SalidaValidaAlumnoSige.xsd Ingresar Tipos de Enseñanza 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


4

DEFINICION DE SERVICIOS

En la actualidad se dispone de los siguientes servicios con sus respectivas operaciones y definiciones. 1. 2. 3. 4. 5.

SemillaServicios ValidaAlumnoSige TipoEnsenanzaSige CursoSige AsistenciaSige

Además, se espera la incorporación de nuevos servicios cuyas especificaciones se documentarán en su oportunidad. Cualquier otro servicio expuesto en el content root actual no debe ser considerado. Se espera que para el paso a producción de los servicios se entregue una URL final con los servicios válidos. A continuación se describe en detalle cada uno de los servicios implementados, la forma de llamar sus operaciones y los documentos xml de entrada y salida.

Página 7 de 40

4.1 Web Service Obtención de Semilla (Servicio SemillaServicios) Todas operaciones o WS deben ser invocadas enviando (según el esquema definido para cada documento de entrada), un parámetro llamado “semilla” . La descripción de este servicio se presenta en el documento: Especificación_de_Uso_WSAUTORIZACION_V0.1.pdf


4.2 Web Service Consulta de Validación de Alumno SIGE (Servicio ValidaAlumnoSige) Este WS tiene como finalidad validar que la información personal básica de un alumno se encuentre registrada en el sistema. La validación de datos enviados es contrastada con la información registrada en SIGE (desde el año 2008 en adelante).

URL Esquema de definición de documento xml de entrada: http://wwwfs.mineduc.cl/Archivos/Schemas/EntradaValidaAlumnoSige.xsd Este esquema define XML de parámetros para el consumo del servicio de validación de alumnos SIGE.

URL Esquema de definición de documento xml de salida: http://wwwfs.mineduc.cl/Archivos/Schemas/SalidaValidaAlumnoSige.xsd Este esquema define el documento XML de respuesta del servicio.

Descripción Campos XML entrada: Nombre numero dv Nombres ApellidoPaterno ApellidoMaterno

Página 9 de 40

Descripción Corresponde al valor del RUN ingresado Dígito verificador del RUN ingresado. Nombres del alumno a validar. Apellido Paterno del alumno Apellido Materno del alumno

Tipo de Dato Int

Validación -Mayor a 0

String

-Valor entre el 0-9 o el carácter "K" -Distinto de Blanco

String

-Distinto de Blanco

String

-Distinto de Blanco

String

Nombre Semilla

Descripción Token de autenticación para consumo y traza del servicio.

Tipo de Dato

Validación

String

-Distinto de Blanco -Semilla Valida

XML de Entrada (Ejemplo) 12345678 k PEDRO PEREZ GONZALEZ O9EmfQXpQc9fAQPnungwmZTidBr8qORt

Descripción Campos XML Salida: 

ExisteFichaAlumno: corresponde a un entero que representa el estado de respuesta del servicio, según la siguiente tabla:

Valor 1 2

3 4 5 6 7

Glosa RUN de entrada tiene Ficha SIGE y la identificación proporcionada es correcta. RUN de entrada tiene Ficha SIGE, pero la identificación proporcionada no corresponde a la registrada en SIGE. Este código de retorno no está operativo por el momento. RUN de entrada NO tiene Ficha SIGE. RUN de entrada NO válido. Semilla de operación NO válida o ha caducado. (renovar semilla) Error interno de servicio.

Especificaciones WS SIGE Versión 3.0 13/09/2012 XML de salida (Ejemplo) 1

URL del descriptor de servicio (WSDL): http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/ValidaAlumnoSigeSoapPor t.wsdl

Nombre de método final (Nombre de operación): Nombre Operación

: getValidacion

Método que retorna documento XML con el valor de retorno definido anteriormente. El método recibe el número de RUN, digito verificador del RUN, Nombres, Apellidos del alumno y el valor de una semilla de operación válida.

Página 11 de 40

4.3 Web Service Ingresar TipoEnsenanzaSige)

Tipos

de

Enseñanza

SIGE

(Servicio

Este WS permite crear nuevos tipos de enseñanza en SIGE para el año definido de trabajo.

URL Esquema de definición de documento xml de entrada: http://dido.mineduc.cl/Archivos/Schemas/EntradaAddTipoEnsenanzaSige.xs d Este esquema define XML de parámetros para el consumo del servicio de gestión de tipos de enseñanza SIGE.

URL Esquema de definición de documento xml de salida: http://dido.mineduc.cl/Archivos/Schemas/SalidaAddTipoEnsenanzaSige.xsd Este esquema define el documento XML de respuesta del servicio.

Descripción Campos XML entrada: Nombre

AnioEscolar

RBD

CodigoTipoEnsenanza

Descripción

Tipo de Dato

Validación

Año escolar

Int

- Mayor a 0 - Debe corresponder al año de proceso

Identificador del establecimiento.

Int

- Mayor a 0

Int

- Tipos de enseñanza habilitados para el año de trabajo

Código de tipo de enseñanza.

Especificaciones WS SIGE Versión 3.0 13/09/2012 Nombre

Descripción

Tipo de Dato

Validación ( ver anexo)

EstadoTipoEnsenanza

NumeroAutorizacion

FechaAutorizacion

TieneCentroPadres

TienePersonalidadJuridica

Estado del tipo de enseñanza. Número de resolución de autorización del tipo de enseñanza (podría ser idéntica a la de RO del establecimiento). Fecha de resolución de autorización del tipo de enseñanza (podría ser idéntica a la de RO del establecimiento). indica si establecimiento tiene centro de padres Indica si establecimiento tiene personalidad jurídica

corresponde al número de grupos diferenciales NumeroGruposDiferenciales que maneja el establecimiento horario de inicio de la HorarioInicioManana jornada de la mañana

Int

- Valor igual a 1

Int

-Mayor a 0

-Distinto de Blanco Fecha -Fecha en formato yyyymm-dd -Valor true ó Booleano false -Valor true ó false Booleano -Aplica solo si Centro de padres igual true Int

String

HorarioTerminoManana

Horario de término de la jornada de la mañana.

String

HorarioInicioTarde

Horario de término de la jornada de la tarde.

String

HorarioTerminoTarde

Horario de término de la jornada de la tarde.

String

Horario de inicio de la jornada de la mañana-

String

HorarioInicioMananaTarde Página 13 de 40

-Valor mayor o igual 0 -Valor en formato 00:00:00-03:00 -Valor en formato 00:00:00-03:00 - Hora mayor a jornada inicio -Valor en formato 00:00:00-03:00 - Hora mayor a jornada inicio -Valor en formato 00:00:00-03:00 - Hora mayor a jornada inicio -Valor en formato 00:00:00-03:00

Nombre

Descripción

Tipo de Dato

tarde.

Horario de término de la jornada mañana-tarde.

String

Horario de inicio de la jornada vespertino.

String

HorarioTerminoVespertino

Horario de término de la jornada vespertino.

String

Semilla

Token de autenticación para consumo y traza del servicio.

String

HorarioTerminoMananaTarde

HorarioInicioVespertino

Validación - Hora mayor a jornada inicio -Valor en formato 00:00:00-03:00 - Hora mayor a jornada inicio -Valor en formato 00:00:00-03:00 - Hora mayor a jornada inicio -Valor en formato 00:00:00-03:00 - Hora mayor a jornada inicio -Distinto de Blanco -Semilla Valida

XML de Entrada (Ejemplo) 2011 1 110 1 50 2003-04-20 true false 0

Especificaciones WS SIGE Versión 3.0 13/09/2012 XML de Entrada (Ejemplo) 08:30-03:00 12:4503:00 00:00-03:00 00:00-03:00 00:0003:00 00:0003:00 00:0003:00 00:0003:00 O9EmfQXpQc9fAQPnungwmZTidBr8qORt


CodigoRespuestaTipoEnsenanza: corresponde a un entero que representa el estado de respuesta del servicio, según la siguiente tabla: Valor 1 2 3 4 5 6 7 

Glosa Operación/Acción ejecutada exitosamente. Error(es) de Validación(es) de Negocio. RBD NO tiene Servicio Disponible. Convenio NO tiene asociado el RBD. Servicio NO Disponible. Semilla de operación NO válida o ha caducado. (renovar semilla) Error Interno de servicio.

ListadoMensajes: corresponde a un listado con título y mensajes descriptivos de validaciones efectuadas.

XML de salida (Ejemplo)
XML de salida (Ejemplo) 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/SalidaAddTipoEnsenanza Sige.xsd"> 2 LISTADO DE ERRORES DE VALIDACION DE NEGOCIO RBD (1) YA TIENE TIPO ENSEÑANZA (110) PARA AÑO ESCOLAR (2011). SI NO TIENE CENTRO DE PADRES NO PUEDE TENER PERSONALIDAD JURIDICA.

URL del descriptor de servicio (WSDL): http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/TipoEnsenanzaSigeSoapPo rt.wsdl Nombre de método final (Nombre de operación): Nombre Operación

: addTipoEnsenanza

Método que retorna documento XML con el valor de retorno definido anteriormente. El método recibe el año escolar, RBD, código de tipo enseñanza, el estado de tipo enseñanza, el número de autorización, la fecha de autorización, si tiene centro de padres, si tiene personalidad jurídica, el número de grupos diferenciales, el horario de inicio mañana, el horario de termino mañana, el horario de inicio tarde, el horario de termino de tarde, el horario de inicio de mañana tarde, el horario de termino de mañana tarde, el horario de inicio de vespertino, el horario de termino de vespertino y el valor de una semilla de operación válida.


4.4 Web Service Ingresar Cursos SIGE (Servicio CursoSige) Este WS permite crear nuevos cursos en SIGE para el año definido de trabajo.

URL Esquema de definición de documento xml de entrada: http://dido.mineduc.cl/Archivos/Schemas/EntradaAddCursoSige.xsd Este esquema define XML de parámetros para el consumo del servicio de gestión de cursos SIGE.

URL Esquema de definición de documento xml de salida: http://dido.mineduc.cl/Archivos/Schemas/SalidaAddCursoSige.xsd Este esquema define el documento XML de respuesta del servicio.

Descripción Campos XML entrada: Nombre AnioEscolar

RBD CodigoTipoEnsenanza

CodigoGrado

LetraCurso Página 17 de 40

Descripción Año escolar

Tipo de Dato Int

Identificador del establecimiento. Código de tipo de enseñanza.

Int

Código de grado

Int

Letra del curso

Int

String

Validación - Mayor a 0 - Debe corresponder al año de proceso - Mayor a 0 - Tipos de enseñanza habilitados para el año de trabajo ( ver anexo) - Grados habilitados para el año de trabajo (ver anexo) -Distinto de

Nombre

numero

Dv

CursoCombinado

NumeroCursoCombinado

CodigoTipoJornada

CodigoSectorEconomico

CodigoEspecialidad

Descripción

Tipo de Dato

Validación Blanco -Mayor a 0

Corresponde al Int valor del RUN del profesor jefe Digito String -Distinto de verificador del Blanco profesor jefe Indica si es Booleano -Valor true ó false curso combinado Numero que Int -Mayor a 0 agrupa el curso combinado Indica en qué Int -Tipo de Jornada tipo de jornada habilitada para el se realiza el Tipo de enseñanza curso asociado. - 1 MAÑANA - 2 TARDE - 3 MAÑANA Y TARDE - 4 VESPERTINA/ NOCTURNA Tag optativo si el grado no posee especialidad. Indica el sector económico de los cursos TécnicoProfesional Tag optativo si el grado no posee especialidad. Indica la especialidad de los cursos

Int

- Sectores económicos habilitados para el año de trabajo ( ver anexo)

Int

- Especialidades habilitadas para el año de trabajo ( ver anexo)

Especificaciones WS SIGE Versión 3.0 13/09/2012 Nombre

Descripción

TécnicoProfesional CodigoAlternativaDesarrolloCurricular Tag optativo si el grado no posee especialidad. Indica la alternativa de desarrollo curricular que aplica al curso TécnicoProfesional TieneInfraestructuraEspecialidad Tag optativo si el grado no posee especialidad. Indica si el curso posee infrestructura para la especialidad Semilla Token de autenticación para consumo y traza del servicio.

Tipo de Dato

Validación

Int

-1 Tradicional (Solo Establecimiento) -2 Formación Dual (Establecimiento y Empresa) - 3 Otra

Booleano -Valor true ó false

String


XML de Entrada (Ejemplo) 2011 1 510 Página 19 de 40

XML de Entrada (Ejemplo) 3 A 10230147 1 false 0 1 510 51001 1 false O9EmfQXpQc9fAQPnungwmZTidBr8qORt


CodigoRespuestaCurso: corresponde a un entero que representa el estado de respuesta del servicio, según la siguiente tabla:

Valor 1 2 3 4 5 6 7

Glosa Operación/Acción ejecutada exitosamente. Error(es) de Validación(es) de Negocio. RBD NO tiene Servicio Disponible. Convenio NO tiene asociado el RBD. Servicio NO Disponible. Semilla de operación NO válida o ha caducado. (renovar semilla) Error Interno de servicio.

Especificaciones WS SIGE Versión 3.0 13/09/2012 

ListadoMensajes: corresponde a un listado con título y mensajes de validaciones.

XML de salida (Ejemplo) 2 LISTADO DE ERRORES DE VALIDACION DE NEGOCIO RBD (1) YA TIENE CURSO (A) PARA CODIGO DE ENSEÑANZA (510) Y GRADO (3) EN EL AÑO ESCOLAR (2011). SI ES CURSO COMBINADO (true) EL NUMERO DEL CURSO COMBINADO (0) DEBE SER MAYOR A CERO. TIPO ENSEÑANZA (510) NO PERMITE CURSO COMBINADO (true). TIPO ENSEÑANZA (510) NO TIENE SECTOR ECONOMICO (500). SECTOR ECONOMICO (500) NO TIENE ESPECIALIDAD (51000).

URL del descriptor de servicio (WSDL): http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/CursoSigeSoapPort.wsdl


: addCurso

Método que retorna documento XML con el valor de retorno definido anteriormente. El método recibe el año escolar, RBD, código de tipo enseñanza, código de grado, letra del curso, RUN del profesor jefe, curso Página 21 de 40

combinado, número del curso combinado, código del tipo de jornada, código del sector económico, código de la especialidad, código de la alternativa de desarrollo curricular y el valor de una semilla de operación válida.


4.5 Web Service Ingresar Asistencias SIGE (Servicio AsistenciaSige)

Este WS permite ingresar la asistencia diaria a nivel de grado en SIGE para el año definido de trabajo y mes de declaración de asistencia. El servicio solo recibe información de asistencia del año y mes escolar de trabajo en curso, no permitiéndose trabajar con asistencias de meses rezagados.

URL Esquema de definición de documento xml de entrada: http://dido.mineduc.cl/Archivos/Schemas/EntradaAddAsistenciaSige.xsd Este esquema define XML de parámetros para el consumo del servicio de asistencia SIGE.

URL Esquema de definición de documento xml de salida: http://dido.mineduc.cl/Archivos/Schemas/SalidaAddAsistenciaSige.xsd Este esquema define el documento XML de respuesta del servicio.

Descripción Campos XML entrada: Nombre AnioEscolar RBD

Descripción Año escolar

Int


Int

Código de tipo de CodigoTipoEnsenanza enseñanza.

Página 23 de 40

Tipo de Dato

Int

Validación - Mayor a 0 - Debe corresponder al año de proceso - Mayor a 0 - Tipos de enseñanza habilitados para el año de trabajo ( ver anexo)

CodigoGrado FechaAsistencia Cursos LetraCurso Presentes numero Dv Ausentes numero Dv Semilla

Código de grado Fecha de asistencia a informar Listado de cursos a enviar Letra del curso Listado de alumnos presentes Corresponde al valor del RUN del alumno Digito verificador del alumno Listado de alumnos ausentes Corresponde al valor del RUN del alumno Digito verificador del alumno Token de autenticación para consumo y traza del servicio.

Int

- Grados habilitados para el año de trabajo (ver anexo)

Fecha

-Distinto de Vacío

Lista String

-Distinto de Vacío -Distinto de Blanco -Distinto de Vacio si elemento Ausentes no presenta información

Lista Int

-Mayor a 0

String

-Distinto de Blanco

Lista

-Distinto de Vacio SI elemento presente no presenta información

Int

-Mayor a 0

String

-Distinto de Blanco

String


XML de Entrada (Ejemplo) 2011 519 110 3 2011-05-03

Especificaciones WS SIGE Versión 3.0 13/09/2012 XML de Entrada (Ejemplo) A 15166706 6 15166707 4 19358721 6 20458780 9 20738153 5 O9EmfQXpQc9fAQPnungwmZTidBr8qORt


CodigoRespuestaAsistencia: corresponde a un entero que representa el estado de respuesta del servicio, según la siguiente tabla:

Valor 1

Glosa Operación/Acción ejecutada exitosamente.

Página 25 de 40

Valor 2 3 4 5 6 7 



Glosa Error(es) de Validación(es) de Negocio. RBD NO tiene Servicio Disponible. Convenio NO tiene asociado el RBD. Servicio NO Disponible. Semilla de operación NO válida o ha caducado. (renovar semilla) Error Interno de servicio.

CodigoEnvioAsistencia: corresponde a un string que representa el identificador de envió con el que será procesada la asistencia de modo off-line. ListadoMensajes: corresponde a un listado con título y mensajes de validaciones.

XML de salida (Ejemplo) 1 20110620153716655362000000

URL del descriptor de servicio (WSDL): http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/AsistenciaSigeSoapPort.w sdl


: addAsistencia


Método que retorna documento XML con el valor de retorno definido anteriormente. El método recibe el año escolar, RBD, código de tipo enseñanza, código de grado, fecha de asistencia, Listado de cursos, Letra de curso, Listado de alumnos presentes y ausentes y el valor de una semilla de operación válida.

Página 27 de 40

4.6 Web Service Ver Reporte del Envío de Asistencia SIGE.

Este WS permite consultar por el estado de procesamiento de la asistencia enviada a SIGE.

URL Esquema de definición de documento xml de entrada: http://dido.mineduc.cl/Archivos/Schemas/EntradaGetReporteEnvioAsistenci aSige.xsd Este esquema define XML de parámetros para el consumo del servicio de asistencia SIGE.

URL Esquema de definición de documento XML de salida: http://dido.mineduc.cl/Archivos/Schemas/SalidaGetReporteEnvioAsistenciaS ige.xsd Este esquema define el documento XML de respuesta del servicio.

Descripción Campos XML entrada: Nombre

Descripción

RBD


Tipo de Dato Int

CodigoEnvioAsistencia Código de envió de asistencia

String

Token de autenticación para consumo y traza del servicio.

String

Semilla

Validación - Mayor a 0 -Distinto de Blanco -Distinto de Blanco -Semilla Valida

Especificaciones WS SIGE Versión 3.0 13/09/2012 XML de Entrada (Ejemplo) 519 20110616205416481645000000 O9EmfQXpQc9fAQPnungwmZTidBr8qORt


CodigoRespuestaReporteEnvioAsistencia: corresponde a un entero que representa el estado de respuesta del servicio, según la siguiente tabla:

Valor 1 2 3 4 5 6 7 8 9 10 

Glosa Asistencia procesada Exitosamente. Asistencia procesada con Observaciones. Asistencia procesada con Errores. Asistencia aun no ha sido procesada. Parámetros no corresponden. RBD NO tiene Servicio Disponible. Convenio NO tiene asociado el RBD. Servicio NO Disponible. Semilla de operación NO válida o ha caducado. (renovar semilla) Error Interno de servicio.

ListadoMensajes: corresponde a un listado con título y mensajes de validaciones.

XML de salida (Ejemplo)
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/ http://dido.mineduc.cl/Archivos/Schemas/SalidaGetReporteEnvioAsistenciaSige.xsd"> 3 LISTADO DE ERRORES LETRA CURSO (A) RECHAZADO, FALTA INFORMAR ASISTENCIA DE 2 ALUMNO(S). LETRA CURSO (A) RUN 21090989 FALTANTE. LETRA CURSO (A) RUN 21121694 FALTANTE.

URL del descriptor de servicio (WSDL): http://dido.mineduc.cl:9080/WsApiMineduc/wsdl/AsistenciaSigeSoapPort.w sdl


: getReporteEnvioAsistencia

Método que retorna documento XML con el valor de retorno definido anteriormente. El método recibe el RBD, código de envió de asistencia y el valor de una semilla de operación válida.


5

RESUMEN

En general, para probar el flujo de operación de los servicios, el flujo es: 1. Obtener semilla desde servicio SemillaServicios con datos de autenticación. 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 autenticación (credenciales genéricas):   

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 gestión escolar), se pueden utilizar credenciales particulares.

Página 31 de 40

6

ANEXOS

6.1 Códigos Tipos de Enseñanza Vigentes 2011-2012 Código Tipo Enseñanza 10 110 165 167 211 212 213 214 215 216 217 299 310 360 363 410 463 510 563 610 663 710 763 810 863 910 963

Descripción Tipo Enseñanza Educación Parvularia Enseñanza Básica Educación Básica Adultos Sin Oficios Educación Básica Adultos Con Oficios Educación Especial Discapacidad Auditiva Educación Especial Discapacidad Intelectual Educación Especial Discapacidad Visual Educación Especial Trastornos Específicos del Lenguaje Educación Especial Trastornos Motores Educación Especial Autismo Educación Especial Discapacidad Graves Alteraciones en la Capacidad de Relación y Comunicación Programa Integración Escolar(PIE) Opción 4 Enseñanza Media Humanista-Científica niños y jóvenes Educación Media Humanista-Científica Adultos Vespertina y Nocturno Educación Media H-C Adultos Enseñanza Media Técnico-Profesional Comercial niños Educación Media T-P Adultos Comercial Enseñanza Media Técnico-Profesional Industrial niños Educación Media T-P Adultos Industrial Enseñanza Media Técnico-Profesional Técnica niños Educación Media T-P Adultos Técnica Enseñanza Media Técnico-Profesional Agrícola niños Educación Media T-P Adultos Agrícola Enseñanza Media Técnico-Profesional Marítima niños Educación Media T-P Adultos Marítima Enseñanza Media Artística Niños y Jóvenes Enseñanza Media Artística Adultos


6.2 Códigos Grados de Enseñanza Vigentes 2011-2012 Código Tipo Enseñanza 10 10 10 10 10 110 110 110 110 110 110 110 110 165 165 165 167 167 211 211 211 211 211 211 211 211 211 211 211 211 211 211 211 211 211 212 Página 33 de 40

Código Grado 1 2 3 4 5 1 2 3 4 5 6 7 8 1 2 3 2 3 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 1

Descripción Grado Sala Cuna Nivel Medio Menor Nivel Medio Mayor 1er nivel de Transición (Pre-kinder) 2° nivel de Transición (Kinder) 1° básico 2° básico 3° básico 4° básico 5° básico 6° básico 7° básico 8° básico Nivel Básico 1(1° a 4° básico) Nivel Básico 2(5° y 6° básico) Nivel Básico 3(7° y 8° básico) Nivel Básico 2(5° y 6° básico) Nivel Básico 3(7° y 8° básico) Prebásico Materno 1° Prebásico 1° - 1 Prebásico 1° - 2 Prebásico 1° - 3 Prebásico 2° - 4 Prebásico 2° - 5 Básico 1° - 1 Básico 1° - 2 Básico 1° - 3 Básico 1° - 4 Básico 2° - 5 Básico 2° - 6 Básico 2° - 7 Básico 2° - 8 Laboral 1 Laboral 2 Laboral 3 Prebásico 1° - 1

Código Tipo Enseñanza 212 212 212 212 212 212 212 212 212 212 212 212 213 213 213 213 213 213 213 213 213 213 213 213 213 213 213 213 213 213 214 214 214 214 215 215 215

Código Grado 2 3 4 5 6 7 8 9 10 11 12 13 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 1 2 3 4 1 2 3

Descripción Grado Prebásico 1° - 2 Prebásico 2° - 3 Prebásico 2° - 4 Básico 1° - 5 Básico 1° - 6 Básico 1° - 7 Básico 2° - 8 Básico 2° - 9 Básico 2° - 10 Laboral 1 Laboral 2 Laboral 3 Estimulación Temprana 1° - 1 Estimulación Temprana 1° - 2 Prebásico 1° - 1 Prebásico 1° - 2 Prebásico 1° - 3 Prebásico 2° - 4 Básico 1° - 1 Básico 1° - 2 Básico 1° - 3 Básico 1° - 4 Básico 2° - 5 Básico 2° - 6 Básico 2° - 7 Básico 2° - 8 Laboral 1° - 1 Laboral 1° - 2 Laboral 2° - 3 Laboral 2° - 4 Medio Menor Medio Mayor Primer Nivel de Transición 2º Nivel de transición Estimulación Temprana 1° - 1 Estimulación Temprana 1° - 2 Prebásico 1° - 1

Especificaciones WS SIGE Versión 3.0 13/09/2012 Código Tipo Enseñanza 215 215 215 215 215 215 215 215 215 215 215 215 215 215 215 215 216 216 216 216 217 217 217 217 217 217 217 217 217 217 217 217 217 217 299 299 299 299 Página 35 de 40

Código Grado 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 1 2 3 4 1 2 3 4 5 6 7 8 9 10 11 12 13 14 1 2 3 4

Descripción Grado Prebásico 1° - 2 Prebásico 1° - 3 Prebásico 2° - 4 Prebásico 2° - 5 Básico 1° - 1 Básico 1° - 2 Básico 1° - 3 Básico 1° - 4 Básico 2° - 5 Básico 2° - 6 Básico 2° - 7 Básico 2° - 8 Laboral 1° - 1 Laboral 1° - 2 Laboral 2° - 3 Laboral 2° - 4 Nivel de trabajo de 1° Nivel de trabajo de 2 Nivel de trabajo de 3° Nivel de trabajo de 4 Prebásico 1° - 1 Prebásico 1° - 2 Prebásico 2° - 3 Prebásico 2° - 4 Básico 1° - 5 Básico 1° - 6 Básico 1° - 7 Básico 2° - 8 Básico 2° - 9 Básico 2° - 10 Laboral 1 Laboral 2 Laboral 3 Prebásico Materno 1° (Estimulación Temprana) Prebásico 1 Prebásico 2 Prebásico 3 Prebásico 4

Código Tipo Enseñanza 299 299 299 299 299 299 299 299 299 299 299 299 299 299 299 310 310 310 310 360 360 363 363 410 410 410 410 463 463 463 510 510 510 510 563 563 563

Código Grado 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 1 2 3 4 3 4 1 3 1 2 3 4 1 3 4 1 2 3 4 1 3 4

Descripción Grado Prebásico 5 Básico 1 Básico 2 Básico 3 Básico 4 Básico 5 Básico 6 Básico 7 Básico 8 Básico 9 Básico 10 Laboral 1 Laboral 2 Laboral 3 Laboral 4 1° medio 2° medio 3° medio 4° medio 3° medio 4° medio 1er nivel (1° y 2° medio) 2do nivel (3° y 4° medio) 1° medio 2° medio 3° medio 4° medio 1er nivel (1° y 2° medio) 2do nivel (3° medio) 3er nivel (4° medio) 1° medio 2° medio 3° medio 4° medio 1er nivel (1° y 2° medio) 2do nivel (3° medio) 3er nivel (4° medio)

Especificaciones WS SIGE Versión 3.0 13/09/2012 Código Tipo Enseñanza 610 610 610 610 663 663 663 710 710 710 710 763 763 763 810 810 810 810 863 863 863 910 910 910 910 963 963 910 910 910 963 963

Página 37 de 40

Código Grado 1 2 3 4 1 3 4 1 2 3 4 1 3 4 1 2 3 4 1 3 4 1 2 3 4 3 4 2 3 4 3 4

Descripción Grado 1° medio 2° medio 3° medio 4° medio 1er nivel (1° y 2° medio) 2do nivel (3° medio) 3er nivel (4° medio) 1° medio 2° medio 3° medio 4° medio 1er nivel (1° y 2° medio) 2do nivel (3° medio) 3er nivel (4° medio) 1° medio 2° medio 3° medio 4° medio 1er nivel (1° y 2° medio) 2do nivel (3° medio) 3er nivel (4° medio) 1° medio 2° medio 3° medio 4° medio 2do nivel (3° medio) 3er nivel (4° medio) 2° medio 3° medio 4° medio 2do nivel (3° medio) 3er nivel (4° medio)

6.3 Códigos Sectores Económicos vigentes Código Sector Económico 410 510 520 530 540 550 560 570 610 620 630 710 720 810 910 920 930

Descripción Sector Económico Administración y Comercio Construcción Metalmecánico Electricidad Minero Gráfica Químico Confección Alimentación Programas y Proyectos Sociales Hotelería y Turismo Maderero Agropecuario Marítimo Artes Visuales Artes Escénicas Teatro Artes Escénicas Danza

Código Rama 400 500 500 500 500 500 500 500 600 600 600 700 700 800 900 900 900


6.4 Códigos Especialidades de Sector Económico Vigentes Código Sector Económico 410 410 410 410 510 510 510 510 510 510 520 520 520 520 520 530 530 530 540 540 540 550 550 560 560 570 570 570 570 610 610 620 620 620 620 630 630 710 Página 39 de 40

Código Especialidad 41001 41002 41003 41004 51001 51002 51003 51004 51005 51006 52008 52009 52010 52011 52012 53014 53015 53016 54018 54019 54020 55022 55023 56025 56026 57028 57029 57030 57031 61001 61002 62004 62005 62006 62007 63009 63010 71001

Descripción Especialidad Administración Contabilidad Secretariado Ventas Edificación Terminaciones de Construcción Montaje Industrial Obras Viales y de Infraestructura Instalaciones Sanitarias Refrigeración y Climatización Mecánica Industrial Construcciones Metálicas Mecánica Automotriz Matricería Mecánica de Mantención de Aeronaves Electricidad Electrónica Telecomunicaciones Explotación Minera Metalurgia Extractiva Asistencia en Geología Gráfica Dibujo Técnico Operación de Planta Química Laboratorio Químico Tejido Textil Vestuario y Confección Textil Productos del Cuero Elaboración Industrial de Alimentos Servicio de Alimentación Colectiva Atención de Párvulos Atención de Adultos Mayores Atención de Enfermería Atención Social y Recreativa Servicio de Turismo Servicio de Hotelería Forestal

Aplica Adulto 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1

Especificacion de Uso WSSIGE v3.0

Recommend Documents