SGI: Servicios de terceros que consume

Son los servicios que el SGI expone en su propio ESB pero que tienen que implementar las Universidades que implanten el SGI. Además de exponerlos, el propio SGI consume estos servicios para ofrecer toda la funcionalidad. De forma general el SGI consume todos los métodos que expone en su ESB de tal forma que todos ellos son necesarios para su funcionamiento, solo en algunos casos que se detallan a continuación hay algunos métodos que no son necesarios por el SGI y que los comentamos a continuación agrupados por funcionalidad.

El SGI consume todos los métodos expuestos en:

Sistema de gestión económica

Amortización fondos

Método	URL	Parámetros	Descripción
POST	/periodos-amortizacion	PeriodoAmortizacion	Crea un periodo de amortización
PUT	/periodos-amortizacion/{id}	PeriodoAmortizacion	Modifica un periodo de amortización. Se pasa por url el identificador del periodo de amortización.
DELETE	/periodos-amortizacion/{id}		Elimina un periodo de amortización. Se pasa por url el identificador del periodo de amortización.

Calendario facturación

Método	URL	Parámetros	Respuesta	Descripción
SGI - SGE
GET	/facturas-emitidas/columnas	q+s (query + sort) La query estará formada por: proyectoId reducida fechaFactura El campo reducida puede tomar los siguientes valores: true: sólo se envían las columnas a mostrar en la pantalla principal false: se envían todas las columnas (para su exportación) Si no esta informado el campo reducida se considera false.	Lista[Columna]	Listado con las columnas que va a devolver la llamada /facturas-emitidas Por cada columna se indica un id, nombre, si es una columna acumulable (se va a hacer una suma de ella en el SGI) Ver el apartado "Columnas Factura Emitida" para ver que columnas se deben de mostrar.
GET	/facturas-emitidas	q+s (query + sort) La query estará formada por: proyectoId reducida fechaFactura El campo reducida puede tomar los siguientes valores: true: sólo se envían las columnas a mostrar en la pantalla principal false: se envían todas las columnas (para su exportación) Si no esta informado el campo reducida se considera false.	Lista[FacturaEmitida]	Listado con las facturas emitidas del SGE. Por cada factura emitida se devolverán los siguientes campos: Identificador de la factura emitida Identificador del proyecto SGE Anualidad Número de factura Mapa de columnas de clave - valor (donde la clave será los id definidos en la llamada /facturas-emitidas/columnas y el valor será el valor de la columna. El valor será un String salvo en aquellas columnas que sean acumulables,se tenga que hacer sumas sobre ellas, donde será de tipo Numérico (sin separador de miles y como separador decimal el punto)). Ver el apartado "Columnas Factura Emitida" para ver los id de la columnas que se deben de mostrar.
GET	/facturas-previstas-emitidas	q+s (query + sort) La query estará formada por: proyectoIdSGI numeroPrevision numeroFactura proyectoIdSGI: identificador del proyecto en el SGI	Lista[FacturaPrevistaEmitida]	Listado con las facturas emitidas del SGE. Por cada factura emitida se devolverán los siguientes campos: Identificador de la factura emitida Identificador del proyecto SGI Número factura Número previsión
GET	/facturas-emitidas/{id}		FacturaEmitidaDetalle	Detalle de la factura emitida con todas sus columnas. Identificador de la factura emitida Identificador del proyecto SGE Anualidad Listado de campos con su nombre y valor (Ver el apartado "Campos Detalle factura emitida" para ver que campos se deben de mostrar. En el detalle se muestran todos la columnas o campos.) Listado de documentos (identificador, nombre del documento y nombre del fichero, sin el contenido)

GET	/documentos/{id}/archivo		Binario (en la cabecera ira el contentType)	Devuelve el binario del documento
SGE - SGI
GET	/facturas-previstas	q+s (query + sort) La query estará formada por: proyectoIdSGI numeroPrevision proyectoIdSGI: identificador del proyecto en el SGI	Lista[FacturaPrevista]	Listado de todas las facturas previstas, registradas en el SGI validadas por el IP y con fecha de conformidad (tanto si ya tienen la factura emitida creada en el SGE como sino). La relación entre el calendario de facturación del SGI y facturas emitidas se establecerá en el SGE. Este servicio será el utilizado en el SGE en la pantalla de creación de factura emitida para mostrar el listado de items del calendario de facturación creados en el SGI (tendrán que eliminar aquellos items del calendario del SGI que ya tienen factura emitida relacionada o creada). La relación factura emitida (SGE) - número previsión (SGI) se almacenará en el SGE. Por cada factura prevista se devolverán los siguientes campos: Número previsión (identificador de la factura prevista en el SGI) Identificador del proyecto en el SGI Fecha de emisión Importe base Comentario

Ejecución económica

Método	URL	Parámetros	Respuesta	Descripción
GET	/ejecucion-economica/columnas	q+s (query + sort) La query estará formada por: proyectoId anualidad tipoOperacion reducida fechaPago fechaDevengo fechaContabilizacion El campo reducida puede tomar los siguientes valores: true: sólo se envían las columnas a mostrar en la pantalla principal false: se envían todas las columnas (para su exportación) Si no esta informado el campo reducida se considera false. El tipoOperacion puede tomar los siguientes valores: EPA (Ejecución presupestaria - Estado actual) EPG (Ejecución presupestaria - Gastos) EPI (Ejecución presupestaria - Ingresos) FJF (Facturas y justificantes - Facturas y gastos) FJV (Facturas y justificantes - Viajes y dietas FJP (Facturas y justificantes - Personal contratado) DOG (Detalle de operaciones - Gastos) DOI (Detalle de operaciones - Ingresos) DOM (Detalle de operaciones - Modificaciones)	Lista[Columna]	Listado con las columnas que va a devolver la llamada /ejecucion-economica Por cada columna se indica un id, nombre, si es una columna acumulable (se va a hacer una suma de ella en el SGI) Ver el apartado "Columnas Ejecución económica" para ver que columnas se deben de mostrar dependiendo del tipo de operación (campo tipoOperacion) y si es reducida o no
GET	/ejecucion-economica	q+s (query + sort) La query estará formada por: proyectoId anualidad tipoOperacion reducida fechaPago fechaDevengo fechaContabilizacion El campo reducida puede tomar los siguientes valores: true: sólo se envían las columnas a mostrar en la pantalla principal false: se envían todas las columnas (para su exportación) Si no esta informado el campo reducida se considera false. El tipoOperacion puede tomar los siguientes valores: EPA (Ejecución presupestaria - Estado actual) EPG (Ejecución presupestaria - Gastos) EPI (Ejecución presupestaria - Ingresos) FJF (Facturas y justificantes - Facturas y gastos) FJV (Facturas y justificantes - Viajes y dietas FJP (Facturas y justificantes - Personal contratado) DOG (Detalle de operaciones - Gastos) DOI (Detalle de operaciones - Ingresos) DOM (Detalle de operaciones - Modificaciones)	Lista[DatoEconomico]	Listado con los datos económicos pedidos según el campo tipoOperacion. Por cada dato económico se devolverán los siguientes campos: Identificador del dato económico Identificador del proyecto SGE Anualidad Partida presupuestaria Fecha de devengo Clasificación SGE Código económico Tipo (si es Gasto o Ingreso) Mapa de columnas de clave - valor (donde la clave será los id definidos en la llamada /ejecucion-economica/columnas y el valor será el valor de la columna. El valor será un String salvo en aquellas columnas que sean acumulables,se tenga que hacer sumas sobre ellas, donde será de tipo Numérico (sin separador de miles y como separador decimal el punto)). Ver el apartado "Columnas Ejecución económica" para ver los id de la columnas que se deben de mostrar dependiendo del tipo de operación (campo tipoOperacion) y si es reducida o no
GET	/ejecucion-economica/{id}	tipoOperacion El tipoOperacion puede tomar los siguientes valores (cuando estamos en la llamada de detalle de dato económico): FJF (Facturas y justificantes - Facturas y gastos) FJV (Facturas y justificantes - Viajes y dietas FJP (Facturas y justificantes - Personal contratado)	DatoEconomicoDetalle	Detalle del dato económico con todas sus columnas. Identificador del dato económico Identificador del proyecto SGE Anualidad Partida presupuestaria Fecha de devengo Clasificación SGE Código económico Listado de campos con su nombre y valor (Ver el apartado "Campos Detalle dato económico" para ver que campos se deben de mostrar dependiendo del tipo de operación (campo tipoOperacion). En el detalle se muestran todos la columnas o campos.) Listado de documentos (identificador, nombre del documento y nombre del fichero, sin el contenido) El listado de campos a mostrar dependerá de que dato económico sea, si es una factura o gasto, un viaje o dieta o un personal contratado.
Validación de gastos
GET	/gastos/columnas	q+s (query + sort) La query estará formada por: proyectoId fecha id estado reducida Si no esta informado el campo reducida se considera false. El campo estado puede tomar dos valores: Pendiente Validado El campo reducida puede tomar los siguientes valores: true: sólo se envían las columnas a mostrar en la pantalla principal false: se envían todas las columnas (para su exportación)	Lista[Columna]	Listado con las columnas que va a devolver la llamada /gastos Por cada columna se indica un id, nombre, si es una columna acumulable (se va a hacer una suma de ella en el SGI) Ver el apartado "Columnas Validación de gastos" para ver que columnas se deben de mostrar dependiendo de si es reducida o no
GET	/gastos	q+s (query + sort) La query estará formada por: proyectoId fecha id estado reducida El campo estado puede tomar dos valores: Pendiente Validado El campo reducida puede tomar los siguientes valores: true: sólo se envían las columnas a mostrar en la pantalla principal false: se envían todas las columnas (para su exportación) Si no esta informado el campo reducida se considera false.	Lista[DatoEconomico]	Listado de gastos pendientes de pasar por la "Validación de gastos" si en el campo del filtrado estado = 'Pendiente' o listado de gastos que ya han sido validados (han pasado por la "Validación de gastos") si en el campo del filtrado estado = 'Validado' Para cada gasto se devolverán los siguientes datos: Identificador del gasto Identificador del proyecto SGE Partida presupuestaria a la que esta asignado el gasto Fecha de devengo Clasificación SGE Código económico asignado al gasto Anualidad Tipo: Gasto Mapa de columnas de clave - valor (donde la clave será los id definidos en la llamada /gastos/columnas y el valor será el valor de la columna. El valor será un String salvo en aquellas columnas que sean acumulables,se tenga que hacer sumas sobre ellas, donde será de tipo Numérico (sin separador de miles y como separador decimal el punto)). Ver el apartado "Columnas Validación de gastos" para ver los id de la columnas que se deben de mostrar dependiendo de si es reducida o no
GET	/gastos/{id}		DatoEconomicoDetalle	Detalle de un gasto. Para cada gasto se devolverán los siguientes datos: Identificador del gasto Identificador del proyecto SGE Partida presupuestaria a la que esta asignado el gasto Fecha de devengo Clasificación SGE Código económico asignado al gasto Anualidad Listado de campos con su nombre y valor (Ver el apartado "Campos Detalle dato económico" para ver que campos se deben de mostrar dependiendo del tipo de operación (campo tipoOperacion). En el detalle se muestran todos la columnas o campos.) Listado de documentos (identificador, nombre del documento y nombre del fichero, sin el contenido)
PATCH	/gastos/{id}/validar	Comentario		Se valida el gasto y recibe como parámetro el comentario en caso de que lo tuviese.
PATCH	/gastos/{id}/rechazar	Comentario		Se rechaza el gasto y recibe como parámetro el comentario en caso de que lo tuviese.
PENDIENTE				Se necesita un servicio que reciba como parámetros la lista de identificadores del gasto y devuelve las columnas a mostrar en la validación de gastos con la suma ya realizada, en este caso "Importe validado" e "Importe pagado" (realiza la sumas de esos importes de todos los gastos pasados como parámetro) Se necesitará primero la función que devuelva el nombre de las columnas?
PENDIENTE				Se necesita un servicio que reciba como parámetro la lista de códigos económicos usados en el proyecto (en elegibilidad) y devuelva para cada código económico la suma del importe de todos los gastos pendientes para ese código económico Se necesitará primero la función que devuelva el nombre de las columnas?

GET	/documentos/{id}		Documento	Devuelve el detalle del documento
GET	/documentos/{id}/archivo		Binario (en la cabecera ira el contentType)	Devuelve el binario del documento

Proyecto SGE y presupuesto

Método	URL	Parámetros	Respuesta	Descripción
GET	/proyectos	q+s (query + sort) La query estará formada por: id titulo fechaInicio fechaFin	Lista[Proyecto]	Búsqueda de proyectos económicos, se puede buscar por el identificador del proyecto económico, por el título (o parte del título), entre un rango de fechas en las que se incluye la fecha de inicio o entre un rango de fechas entras lasque se incluye la fecha de fin del proyecto. Devuelve un listado de Proyectos económicos que cumplen los criterios de búsqueda. Los parámetros q y s están explicados en: Consultas filtradas y paginadas
GET	/proyectos/{id}	id	Proyecto	Detalle de los datos generales de un proyecto económico
GET	/proyectos/formly/create		Formly	Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta proyecto
GET	/proyectos/formly/update		Formly	Devuelve el formulario (formly) a pintar para la pantalla de solicitar nueva relación con el proyecto económico (para relacionar un nuevo proyecto SGI con el proyecto SGE)
POST	/proyectos/formly	JSON	id Vendrá relleno si la creación es síncrona y no vendrá si es asíncrona.	Recibe como parámetro la respuesta del usuario del formulario de alta proyecto (formly) con los campos necesarios para crear un proyecto en el SGE
PUT	/proyectos/formly/{id}	JSON		Recibe como parámetro la respuesta del usuario del formulario de modificación proyecto (formly) con los campos necesarios para crear una nueva relación de un proyecto SGI con el proyecto SGE

GET	/codigos-economicos-gastos		Lista[CodigoEconomicoGasto]	Listado de CodigoEconomicoGasto de tipo gasto
GET	/codigos-economicos-gastos/{id}		CodigoEconomicoGasto	Detalle de CodigoEconomicoGasto
GET	/codigos-economicos-ingresos		Lista[CodigoEconomicoIngreso]	Listado de CodigoEconomicoIngreso de tipo ingreso
GET	/codigos-economicos-ingresos/{id}		CodigoEconomicoIngreso	Detalle de CodigoEconomicoIngreso

POST	/proyectos/anualidades/	Lista[ProyectoAnualidadPartida]		Recibe como parámetro el listado partidas presupuestarias para una anualidad y un proyecto.

Además de los siguientes bloques consume casi todos los métodos salvo los indicados a continuación:

Sistema de gestión de personas


Métodos donde el SGI solo hace de pasarela entre Universidad y CVN (No son necesarios para el funcionamiento del SGI)
GET	/personas/modificadas-ids

GET	/sexenios/persona/{id}

GET	/formacion/modificados-ids
GET	/formacion/{id}

GET	/actividad-docente/modificados-ids
GET	/actividad-docente/{id}

Sistema de gestión de empresas


Métodos donde el SGI solo hace de pasarela entre Universidad y CVN (No son necesarios para el funcionamiento del SGI)
GET	/empresas/modificadas-ids

En la siguiente página se detalla un ejemplo concreto de los servicios implementados por la Universidad de Murcia para permitir el funcionamiento del SGI.

Árbol de páginas

SGI: Servicios de terceros que consume