Árbol de páginas

Estás viendo una versión antigua de esta página. Ve a la versión actual.

Comparar con el actual Ver el historial de la página

« Anterior Versión 19 Siguiente »


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:

Amortización fondos

Método

URL

Parámetros

Respuesta

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}/validarComentario
Se valida el gasto y recibe como parámetro el comentario  en caso de que lo tuviese.
PATCH/gastos/{id}/rechazarComentario
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}
DocumentoDevuelve 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

Permisos

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:

GET/proyectos/{id}idProyecto
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/formlyJSON

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.

Sistema de gestión económica de protección industrial e intelectual

Método

URL

Parámetros

Respuesta

Descripción
Gastos
GET/gastos-invencion/columnas

q+s (query + sort)

La query estará formada por:

  • invencionId

Lista[Columna]



Listado con las columnas que va a devolver la llamada /gastos-invencion.

Por cada columna se indica un id, nombre, si es una columna acumulable (se puede manejar como un importe y hacer operaciones numéricas con ella en el SGI).

Por defecto, devolverá las siguientes columnas:

  • Fecha
  • Referencia
  • Concepto
  • Tipo
  • Importe (acumulable = Sí SOLO para una de las columnas)

El tipo de operación

GET/gastos-invencion

q+s (query + sort)

La query estará formada por:

  • invencionId
  • tipoOperacion

El tipo de operación puede tomar los siguientes valores:

  • GAS (Ejecución económica - Gastos)
  • REP (Ejecución económica - Repartos - Gastos a deducir)

Lista[DatoEconomico]


Listado de todos los gastos asociados a una invención.

Para cada gasto se devolverán los siguientes datos:

  • Identificador del gasto
  • Mapa de columnas de clave - valor (donde la clave será los id definidos en la llamada /gastos-invencion/columnas y el valor será el valor de la columna. El valor será un String salvo en aquellas columnas que sean acumulables, esto es, se puedan manejar como un importe y hacer operaciones numéricas con ella en el SGI, donde será de tipo Numérico (sin separador de miles y como separador decimal el punto).

Si el tipo de operación se informa con el valor GAS, se han de devolver todos los gastos asociados a la invención.

Si por el contrario el tipo de operación es REP, se han de devolver del conjunto de gastos asociados a la invención únicamente aquellos que se deban tener en cuenta para el reparto de regalías.

GET/gastos-invencion/{id}

DatoEconomicoDetalle



Detalle de un gasto.

Para cada gasto se devolverán los siguientes datos:

  • Identificador del gasto
  • Listado de documentos (identificador, nombre del documento y nombre del fichero, sin el contenido)
Ingresos



GET/ingresos-invencion/columnas

q+s (query + sort)

La query estará formada por:

  • proyectoId

Lista[Columna]



Listado con las columnas que va a devolver la llamada /ingresos-invencion.

El identificador de proyecto a enviar al SGE ha de ser el del proyecto económico en Justo.

Por cada columna se indica un id, nombre, si es una columna acumulable (se puede manejar como un importe y hacer operaciones numéricas con ella en el SGI).

Por defecto, devolverá las siguientes columnas:

  • Fecha
  • Referencia
  • Importe (acumulable = Sí)
  • Nº interno de contrato
  • Entidad pagadora
GET/ingresos-invencion

q+s (query + sort)

La query estará formada por:

  • proyectoId

Lista[DatoEconomico]


Listado de todos los ingresos asociados a una invención. La asociación en el SGI se realizará a través de contratos de CSP (proyectos) y el identificador de proyecto a enviar al SGE ha de ser el del proyecto económico en Justo.

Los ingresos devueltos se corresponderán con las facturas emitidas asociadas a la invención a través del contrato.

Para cada ingreso se devolverán los siguientes datos:

  • Identificador del ingreso
  • Mapa de columnas de clave - valor (donde la clave será los id definidos en la llamada /ingresos-pii/columnas y el valor será el valor de la columna. El valor será un String salvo en aquellas columnas que sean acumulables, esto es, se puedan manejar como un importe y hacer operaciones numéricas con ella en el SGI, donde será de tipo Numérico (sin separador de miles y como separador decimal el punto).

Sistema de la gestión de la estructura orgánica

Método

URL

Parámetros

Respuesta

Permisos

Descripción

GET/areas-conocimiento

q+s (query + sort)

La query estará formada por:

  • padreId
Lista[AreaConocimiento]


Listado de áreas de conocimiento.

Nota: en el caso de no recibirse un padreId en la query, se devolverán todas las áreas de conocimiento y en caso de indicarse en la query que se quieren solo las que tengan un padreId con valor "null" se devolverán únicamente las de primer nivel o nivel raíz.

Ejemplo de query para obtener solo áreas de conocimiento raíz (su padre es null):

padreId=na=

GET/areas-conocimiento/{id}idAreaConocimiento
Detalle del área de conocimiento cuyo identificador se indica por parámetro.

GET/departamentos
Lista[Departamento]
Listado de departamentos.

GET/paises
Lista[Pais]
Listado de países del SGI.
GET/paises/{id}
Pais
Detalle del país cuyo identificador se indica por parámetro.

GET/comunidades-autonomas

q+s (query + sort)

La query estará formada por:

  • paisId
Lista[ComunidadAutonoma]

Listado de comunidades autónomas.

Nota: en el caso de recibirse un país como parámetro se devolverán todas las comunidades autónomas de ese país.

GET/comunidades-autonomas/{id}
ComunidadAutonoma
Detalle de la comunidad autónoma cuyo identificador se indica por parámetro.

GET/provincias


q+s (query + sort)

La query estará formada por:

  • comunidadAutonomaId
Lista[Provincia]

Listado de provincias. 

Nota: en el caso de recibirse una comunidad autónoma como parámetro se devolverán todas las provincias de esa comunidad autónoma.

GET/provincias/{id}
Provincia
Detalle de la provincia cuyo identificador se indica por parámetro.

GET/clasificaciones

q+s (query + sort)

La query estará formada por:

  • tipoClasificacion
  • padreId
Lista[Clasificacion]

Listado de clasificaciones.

Nota: en el caso de no recibirse un padreId en la query, se devolverán todas las clasificaciones y en caso de indicarse en la query que se quieren solo las que tengan un padreId con valor "null" se devolverán únicamente las de primer nivel o nivel raíz. Sobre estas clasificaciones se aplicará además el filtro indicado en tipoClasificacion (en caso de venir informado).

Ejemplo de query para obtener sólo las clasificaciones raíz (su padre es null) del tipo de clasificación "Sectores Industriales":

tipoClasificacion==(SECTORES_INDUSTRIALES);padreId=na=

GET/clasificaciones/{id}idClasificacion


Detalle de la clasificación cuyo identificador se indica por parámetro.

POST

/palabras-clave

Lista[String]

Crea palabras clave si no existen previamente.

GET/palabras-clave

q+s (query + sort)

La query estará formada por:

  • palabra

Lista[String]



Busca/Lista palabras clave.






GET/centros
Lista[Centro]
Listado de centros.
GET/centros/{id}
Centro
Detalle del centro cuyo identificador se indica por parámetro.


Además de los siguientes bloques consume casi todos los métodos salvo los indicados al final de cada una de las tablas (Métodos donde el SGI solo hace de pasarela entre Universidad):

Sistema de gestión de personas

Método

URL

Parámetros

Respuesta

Permisos

Descripción

GET/personasFast
  • búsqueda (cadena a buscar en nombre / apellidos / email).
  • colectivoId (uno o varios colectivos sobre los que realizar la búsqueda).

Lista[Persona]


Listado de Persona.

Ejemplo:

[mailto:busqueda=skarmeta@um.es&colectivoId=]busqueda=skarmeta@um.es&colectivoId=(1,2,3,4)

busqueda=jorge carrillo&colectivoId=(2)

NOTA:

La búsqueda no es sensible a mayúsculas ni minúsculas. Los parámetros no deben ir entrecomillados.

Si no se indica el parámetro colectivoId, se buscará en todos los colectivos.

Se devuelven como máximo 11 registros, al devolver más de 10 registros el buscador indicará que existen más registros y se puede refinar la búsqueda.

GET/personas

q+s (query + sort)

La query estará formada por:

  • id
  • tipoColectivo
  • colectivoId
  • nombre
  • apellidos
  • email
  • nombreApellidos

Lista[Persona]


Listado de Persona.

Ejemplo:

colectivoId=in=(refPAS,refPDI);(nombre=like=jim,apellidos=like=jim,email=like=jim,nombreApellidos=like=jim)

colectivoId=in=(refPAS,refPDI);(nombre=like=nombre.apellido@um.es,apellidos=like=nombre.apellido@um.es,email=like=nombre.apellido@um.es,nombreApellidos=like=nombre.apellido@um.es)

Nota: tipoColetivo y colectivoId son mutuamente excluyentes. En el caso se recibir un tipoColectivo se traducirá a los colectivos que lo formen.

GET/personas/{id}idPersona
Detalle de los datos generales de una persona (este la persona activo o no)
POST/personasJSON

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 datos de alta (formly) con los campos necesarios para crear una persona.
PUT/personasJSON

Recibe como parámetro la respuesta del usuario del formulario de datos de modificación (formly) con los campos necesarios para actualizar una persona.
GET/personas/formly/{id}
JSON
Devuelve los datos a pintar en el formulario de Ver Detalle/Actualizar en el SGI (formly).
GET/personas/formly/create 
Formly

Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta persona. Ver  IU-GEN-0061- Solicitar alta de persona.

GET/personas/formly/update
Formly
Devuelve el formulario (formly) a pintar para la pantalla de solicitar modificar persona.
GET/personas/formly/view
Formly
Devuelve el formulario (formly) a pintar para la pantalla de ver detalle de persona.

GET/datos-personales/persona/{id}id

DatosPersonales


Detalle de los datos personales de una persona independientemente de que este activa o no la persona (datos de dirección, nacimiento, etc).

GET/datos-contacto/persona/{id}idDatosContacto
Contiene la lista de emails, incluido si cada uno es principal o no, y/o de teléfonos de una persona (independientemente de que este activa o no la persona)

GET/vinculaciones/persona/{id}


Vinculacion

Detalle de los datos de vinculación vigentes de una persona (independientemente de que esté activa o no la persona).

Ver UM - SGI - ESB - SGP - Adaptaciones integración para su implementación en el SGI.

GET/vinculaciones/persona/{id}/vinculaciones-categorias-profesionales

q+s (query + sort)

La query estará formada por:

  • fechaObtencion
  • fechaFin
VinculacionCategoriaProfesional

Si no se especifica ningún filtrado, deberá recuperar la categoría profesional a la que está asociada la persona y que sea vigente.

Para recuperar la vinculación activa a una FECHA determinada se generaría una consulta RSQL del tipo:

q=fechaObtencion<=FECHA;fechaFin>=FECHA,fechaFin=na=

Devolver la vinculación asociada a la persona con identificador {id} donde el objeto que viene en la  vinculacionCategoriaProfesional de esa vinculación debe cumplir que su atributo fechaObtencion sea menor o igual que una FECHA dada y su atributo fechaFin sea mayor o igual que una FECHA dada o no debe tener valor.

Ver UM - SGI - ESB - SGP - Adaptaciones integración para su implementación en el SGI.


GET/datos-academicos/persona/{id}idDatosContacto
Contiene el nivel académico de la persona (independientemente de que este activa o no la persona)






GET/colectivos
Lista[Colectivo]

Listado de colectivos ordenados alfabéticamente de forma ascendente.







GET/tipos-documento
Lista[TipoDocumento]
Listado de tipos de documento de identificación personal ordenados alfabéticamente de forma ascendente.

GET/sexos
Lista[Sexo]
Listado de sexos ordenados alfabéticamente de forma ascendente.






GET/categorias-profesionales
Lista[CategoriaProfesional]
Listado de categorías profesionales ordenadas alfabéticamente de forma ascendente.
GET/categorias-profesionales/{id}
CategoriaProfesional
Detalle de la categoría profesional cuyo identificador se indica por parámetro.

GET/niveles-academicos
Lista[NivelAcademico]
Listado de niveles académicos ordenados alfabéticamente de forma ascendente.
GET/niveles-academicos/{id}
NivelAcademico
Detalle del nivel académico cuyo identificador se indica por parámetro.

GET/personas/{id}/fotografiaidFotografia
Detalle de la fotografía digital de la persona (independientemente de que este activa o no la persona)

GET/sexeniosfechaLista[Sexenio]

Devuelve una lista de identificadores de persona con el número de sexenios en la fecha pasada por parámetro.

En caso de que la fecha se envíe vacía se enviará el número de sexenios en el momento actual

Se tendrá que mirar para la fecha pasada por parámetro el número de sexenios de cada PDI de la Universidad.

Si no tiene sexenios no se enviarán

Ejemplo:

  • fecha="2021-12-31T23:00:00Z"
GET/direccion-tesisanioDefensaLista[DireccionTesis]

Devuelve la lista de Direcciones de tesis (incluida la personaRef indicando la persona que es el director de la tesis) cuya fecha de defensa sea en el año que se le pasa por parámetro

Si se le pasa el parámetro del año de la fecha de defensa.

Ejemplo:

  • anioDefensa="2019"

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

q+s

La query estará formada por:

  • fechaModificacion
Lista[String]

Listado de los identificadores de personas que han sufrido cambios en los datos identificativos (nombre, apellidos, sexo, número de documento y tipo de documento) y/o en los datos personales (fecha de nacimiento, país de nacimiento, comunidad autónoma de nacimiento y ciudad de nacimiento) y/o en datos de contacto (país de contacto, comunidad autónoma de contacto, provincia de contacto, ciudad de contacto, dirección de contacto, código postal, listado de teléfonos y listado de emails) y/o en la fotografía a partir de la fecha de modificación pasada por parámetro y/o en los sexenios.


GET/sexenios/persona/{id}

fecha

Sexenio

Devuelve el número de sexenios de la persona. Si se le pasa el parámetro de la fecha devuelve el número de sexenios en esa fecha, sino se devuelve el número de sexenios a la fecha actual.

Ejemplo:

  • fecha="2021-08-18T22:00:00Z"

GET/formacion/modificados-ids

q+s

La query estará formada por:

  • fechaModificacion
  • tipoFormacion
Lista[Long]

Listado de identificadores de las personas que han tenido modificaciones en formación realizada.

Se utilizarán los siguientes parámetros en la llamada al servicio:

  • fechaModificacion: se le pasará la fecha a partir de la cual se quieren ver los cambios
  • tipoFormacion: se le pasa el tipo de formación que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • /formacion/modificados-ids?q=fechaModificacion=ge="2022-01-01T00:00:00Z";tipoFormacion="020.010.020.000"
GET/formacion/{id}tipoFormacion

Lista[Formación (del tipo solicitado)]

Ver entidades en https://confluence.um.es/confluence/pages/viewpage.action?pageId=397534658


Detalle sobre los datos de la Formación Recibida, dependiendo del ID de la persona y el tipo de formación.

Se utilizará el siguiente parámetro en la llamada al servicio:

  • tipoFormacion: se le pasa el tipo de formación que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • /formacion/22468643?tipoFormacion="020.050.000.000"

GET/actividad-docente/modificados-ids

q+s

La query estará formada por:

  • fechaModificacion
  • tipoActividad
Lista[Long]

Listado de identificadores de las personas que han tenido modificaciones en la actividad docente.

Se utilizarán los siguientes parámetros en la llamada al servicio:

  • fechaModificacion: se le pasará la fecha a partir de la cual se quieren ver los cambios
  • tipoActividad: se le pasa el tipo de actividad docente que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • actividad-docente/modificados-ids?q=fechaModificacion=ge="2022-01-01T00:00:00Z";tipoActividad="030.040.000.000"
GET/actividad-docente/{id}tipoActividad

Lista[Actividad docente (del tipo solicitado)]

Ver entidades en https://confluence.um.es/confluence/display/HERCULES/Actividad+docente+-+CVN


Detalle sobre los datos de la Actividad Docente, dependiendo del ID de la persona y el tipo de actividad.

Se utilizará el siguiente parámetro en la llamada al servicio:

  • tipoActividad: se le pasa el tipo de actividad docente que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • actividad-docente/23019512?tipoActividad="030.040.000.000"

Sistema de gestión de empresas

Método

URL

Parámetros

Respuesta

Descripción

GET/empresas

q+s (query + sort)

La query estará formada por:

  • id
  • nombre
  • razonSocial
  • numeroIdentificacion

Lista[Empresa]

Listado de Empresa.

Ejemplo:

nombre=like=(Tree);(razonSocial=like=SL)

GET/empresas/{id}idEmpresaDetalle de los datos generales de una empresa.
GET/empresas/formly/create 
Formly

Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta empresa, pestaña "Datos generales". Ver IU-GEN-0081 - Solicitar alta de empresa.

POST/empresasJSON
Recibe como parámetro la respuesta del usuario del formulario de datos de alta (formly) con los campos necesarios para crear una empresa.
PUT/empresasJSON

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 datos de modificación (formly) con los campos necesarios para actualizar una empresa.
GET/empresas/formly/{id}
JSONDevuelve los datos a pintar en el formulario de Ver Detalle/Actualizar en el SGI (formly).

GET/datos-contacto/empresa/{id}idDatosContactoContiene los datos de contacto de una empresa.

GET/tipos-identificador
Lista[TipoIdentificador]Listado de tipos de identificador fiscal para las empresas ordenados alfabéticamente de forma ascendente.

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

q+s

La query estará formada por:

  • fechaModificacion
Lista[String]Listado de los identificadores de empresas que han sufrido cambios en los datos de identificativos de la empresa o en sus datos de contacto.


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.


Requisitos de despliegue

El listado completo de módulos del SGI que es necesario tener en cuenta para el despliegue del mismo se recoge en la siguiente tabla.

ComponenteDescripción
CSPMódulo de convocatorias, ayudas, solicitudes, proyectos y contratos. Incluye además los grupos de investigación.
EERMódulo de Empresas de explotación de resultados.
ETIMódulo de Ética.
PIIMódulo de Propiedad industrial e intelectual.
PRCMódulo de producción científica.
CNFMódulo de configuración cross al resto de módulos del SGI.
COMMódulo de comunicados cross al resto de módulos del SGI.
KEYCLOAKMódulo de control de acceso al SGI.
SGISGDOCMódulo del sistema de gestión de la documentación cross al resto de módulos del SGI.
SGISGOMódulo del sistema de gestión de la organización cross al resto de módulos del SGI.
RELMódulo de relaciones cross al resto de módulos del SGI.
REPMódulo de reporting cross al resto de módulos del SGI.
TPMódulo del sistema de gestión de tareas programadas cross al resto de módulos del SGI.
USRMódulo para la autenticación de usuarios
ESBEnterprise Service Bus (Bus de integración)
SGESistema de gestión económica de CSP.
SGEMPSistema de gestión de empresas.
SGEPIISistema de gestión económica de PII.
SGOSistema de gestión de la organización.
SGPSistema de gestión de personas.

Y a continuación se recogen las dependencias entre dichos módulos.


Módulo a desplegarMódulos adicionales que es necesario desplegar
CSPEERETIPIIPRCCNFCOMKEYCLOAKRELREPTPUSRESBSGDOCSGESGEMPSGEPIISGISGDOCSGISGORESTO SGICSP ...?
SGOSGP
CSP






















EER






















ETI






















PII






















PRC






















CNF






















COM






















KEYCLOAK






















REL






















REP






















TP






















USR






















ESB






















SGDOC



























SGE






















SGEMP






















SGEPII






















SGISGDOC






















SGISGO






















SGO






















SGP























Servicios a desarrollar

A continuación se recoge la lista de servicios que un tercero deberá desarrollar para poder implantar el SGI en función del módulo o módulos que quiera activar.

Todos los módulos

/personasFast

/personas

/personas/{id}

/datos-personales/persona/{id}

/datos-contacto/persona/{id}

/vinculaciones/persona/{id}

/vinculaciones/persona/{id}/vinculaciones-categorias-profesionales

/datos-academicos/persona/{id}

/colectivos

/tipos-documento

/sexos

/categorias-profesionales
/categorias-profesionales/{id}

/niveles-academicos
/niveles-academicos/{id}

/personas/{id}/fotografia

/sexenios

/direccion-tesis

    • Métodos únicamente necesarios si se requiere gestionar personas desde el SGI (Alta, Baja, Modificación y Detalle).

/personas
/personas/formly/{id}
/personas/formly/create 
/personas/formly/update
/personas/formly/view

Módulo Convocatorias, Solicitudes, Ayudas y Proyectos (CSP)

Módulo Ética (ETI)

  • No es necesario desarrollar ningún servicio específico más allá de los identificados como requeridos para todos los módulos en el apartado Todos los módulos.

Módulo Protección Industrial e Intelectual (PII)

Módulo Producción Científica (PRC)

  • No es necesario desarrollar ningún servicio específico más allá de los identificados como requeridos para todos los módulos en el apartado Todos los módulos.

Módulo Empresas de Explotación de Resultados (EER)

  • Sin etiquetas