Árbol de páginas

Versiones comparadas

Clave

  • Se ha añadido esta línea.
  • Se ha eliminado esta línea.
  • El formato se ha cambiado.

...

Entidades

EntidadDescripción
CodigoEconomicoSon los códigos económicos definidos en el Sistema de Gestión Económico y con los que se relacionarán los ingresos y gastos del SGE. Son los cṕodigos con los que se deberán relacionar cada uno de los conceptos de gasto/ingreso de investigación  incluidos en convocatorias y proyectos. Los códigos económicos, junto con las partidas presupuestarias y el identificador del proyecto en el SGE serán los parámetros a partir de los que se establecerá la comunicación entre SGI y SGE para disponer en el SGI de todos los detalles económicos de los proyectos
PartidaPresupuestariaPartidas presupuestarias de la Universidad sobre las que se va recoger el detalle de operaciones contables desde el SGE
ProyectoEs la entidad proyecto de investigación en el SGE (el proyecto económico)
DatoEconomico

Contiene los gastos e ingresos económicos. Un gasto/ingreso tendrá que venir identificado por el proyecto al que pertenece, una partida presupuestaria y un código económico. Los datos comunes que se consideran que existen en todas las Universidades (ademas del proyecto, partida presupuestaria y código económico) son:

  • Anualidad
  • Fecha

El resto de campos del gasto/ingreso se tratarán como pares de nombre - valor, es decir, se hará de forma dinámica. Se indicará el nombre del campo y su valor, para poder mostrarlos en el SGI

Campo

Contienen el resto de datos de un gasto/ingreso que no son genéricos a todas las universidades. Se consideran los genéricos:

  • proyectoId
  • partidaPresupuestaria
  • codigoEconomico
  • anualidad
  • fecha

El resto de campos del gasto/ingreso se tratarán como nombre - valor, es decir, se hará de forma dinámica. Se indicará el nombre del campo y su valor, para poder mostrarlos en el SGI

EjecucionPresupuestaria

Almacena el balance de la situación de las aplicaciones presupuestarias del proyecto económico. Este balance de las aplicaciones presupuestarias podrá visualizarse bajo tres bloques distintos:

  • Anualidades
  • Gastos 
  • Ingresos
ColumnaContiene el listado de columnas (nombre y valor de la columna) que serán mostradas por cada aplicación presupuestaria

Modelo lógico

Image Removed

API

Características generales que todas las API REST deben de cumplir:

Definición de los objetos

DatoEconomico

...

Dos valores:

  • Gasto
  • Ingreso

...

DatoEconomico

Entidad que representa cualquier dato económico. Tendrá que venir identificado por un identificador único, por el proyecto al que pertenece, anualidad, partida presupuestaria y un código económico (opcional en algunos de los casos).

El resto de campos del dato económico se tratarán como columnas dinámicas. Se indicará por cada columna el nombre del campo, su valor, si es una columna sobre la que se tiene que hacer una suma para mostrarlo en el SGI como un campo totalizador, y si es visible desde la pantalla principal del SGI (desde la que se hace la búsqueda)

Columna

Contiene el listado de columnas que serán mostradas en las pantallas del SGI dependiendo de la pantalla en la que se esta: Ejecución presupuestaria, detalle de operaciones, validación de gastos, etc...

Por cada columna se tendrá el nombre del campo, su valor, si es una columna sobre la que se tiene que hacer una suma para mostrarlo en el SGI como un campo totalizador, y si es visible desde la pantalla principal del SGI (desde la que se hace la búsqueda)

DocumentoEntidad que representa los documentos que pueda tener relacionados un dato económico (en este caso los gastos).


Modelo lógico

Image Added

API

Características generales que todas las API REST deben de cumplir:

Definición de los objetos

DatoEconomico

NombreTipoDescripción
idStringIdentificador del dato económico. Tiene que ser un identificador único.

EjecucionPresupuestaria

NombreTipoDescripción
proyectoIdStringIdentificador del proyecto económico
partidaPresupuestariaStringCódigo de la Partida presupuestaria
codigoEconomicoCodigoEconomicoContiene la entidad Código económico asignado al gasto/ingreso
anualidadStringAnualidad
tipoString

Dos valores:

  • Gasto
  • Ingreso
columnasLista[Columna]Listado con las columnas de la aplicación presupuestariaa mostrar

Columna

NombreTipoDescripción
idStringIdentificador de la columna
nombreStringNombre de la columna
valorStringValor de la columna
esTotalizadoraBoolean

Indica si se tiene que sumar o no para mostrar los totales en la pantalla del SGI.

Dos valores:

  • true
  • false
esVisibleBoolean

Indica si se tiene que mostrar en la pantalla del listado del SGI o no

Dos valores:

  • true
  • false

...

Método

URL

Parámetros

Respuesta

Descripción
Ejecución presupuestaria
GET/ejecucion-presupuestaria/columnas

q+s (query + sort)

La query estará formada por:

  • proyectoId
  • anualidad

  • tipoEjecucionPrespuestaria

El tipoEjecucionPrespuestaria tipoOperacion puede tomar 3 los siguientes valores:

  • EP: Estado actual
  • EP: Gastos
  • EP: Ingresos
  • VG
  • FJ: Factura
  • FJ: Viajes
  • FJ: Personal contratado
  • DO: Gastos
  • DO: Ingresos
  • DO: Modificaciones

Lista[Columna]

Bloque de código
themeRDark
titleLista[Columnas]Respuesta Ejecución presupuestaria -> Estado actual
collapsetrue
[
 {
   "id": "1"
   "nombre":"Importe presupuestado"
   "esTotalizadora": "true",
   "esVisible": "true" 
  },
  {
   "id":"2",
   "nombre":"Importe actual",
   "esTotalizadora": "true",
   "esVisible": "true"
  },
  {
   "id":"3",
   "nombre":"Importe disponible para gastos",
   "esTotalizadora": "true",
   "esVisible": "true"
  },
  {
   "id":"4",
   "nombre":"Derechos",
   "esTotalizadora": "true",
   "esVisible": "true"
  },
  {
   "id":"5",
   "nombre":"Cobros",
   "esTotalizadora": "true",
   "esVisible": "true"
  }

]



Listado con las columnas que va a devolver la llamada /ejecucion-presupuestaria

Por cada columna se indica un id, nombre, si es una columna totalizadora (se va a hacer una suma de ella en el SGI) y si es visible o no en la pantalla principal del SGI

Cuando tipoEjecucionPrespuestariatipoOperacion=='EP: Estado actual' las columnas a devolver en la Universidad de Murcia serán:

  • 1 - Importe presupuestado - Es totalizadora - Es visible
  • 2 - Importe actual - Es totalizadora - Es visible
  • 3 - Importe disponible para gastos - Es totalizadora - Es visible
  • 4 - Derechos - Es totalizadora - Es visible
  • 5 - Cobros - Es totalizadora - Es visible

Cuando tipoEjecucionPrespuestariatipoOperacion=='EP: Gastos' las columnas a devolver en la Universidad de Murcia serán:

  • 1 - Importe presupuestado - Es totalizadora - Es visible
  • 2 - Importe definitivo - Es totalizadora - Es visible
  • 3 -Gastos pagados - Es totalizadora - Es visible
  • 4 -Gastos en tramitación - Es totalizadora - Es visible
  • 5 -Crédito disponible - Es totalizadora - Es visible
  • 6 -Retenciones personal contratado y expedientes - Es totalizadora - Es visible
  • 7 -Pedidos activos - Es totalizadora - Es visible
  • 8 -Gastos pendientes de pago - Es totalizadora - Es visible
  • 9 -Pagos a justificar - Es totalizadora - Es visible

Cuando tipoEjecucionPrespuestariatipoOperacion=='IngresoslEP: Ingresos' las columnas a devolver en la Universidad de Murcia serán:

  • 1 - Importe presupuestado - Es totalizadora - Es visible
  • 2 - Importe actual - Es totalizadora - Es visible
  • 3 - Derechos - Es totalizadora - Es visible
  • 4 - Cobros - Es totalizadora - Es visible
GET/ejecucion-presupuestaria

q+s (query + sort)

La query estará formada por:

  • proyectoId
  • anualidad
  • tipoEjecucionPrespuestaria

El tipoEjecucionPrespuestaria tipoOperacion puede tomar 3 los siguientes valores:

  • EP: Estado actual
  • EP: Gastos
  • EP: Ingresos
  • VG
  • FJ: Factura
  • FJ: Viajes
  • FJ: Personal contratado
  • DO: Gastos
  • DO: Ingresos
  • DO: Modificaciones

Lista[EjecucionPrespuestariaDatoEconomico]

Bloque de código
themeRDark
titleEjecucionPresupuestariaRespuesta ejecución presupuestaria -> estado actual
collapsetrue
[
{
"proyectoId":"123456",
"partidaPresupuestaria": "8002B541A64406"
"anualidad":"2021",
"tipo":"Gasto",
"columnas":[
  {
   "id": "1"
   "valor":"2000"
  },
  {
   "id":"2",
   "valor":"500"
  },
  {
   "id":"3",
   "valor":"1000.50"
  },
  {
   "id":"4",
   "valor":"1000.50"
  },
  {
   "id":"5",
   "valor":"1000.50"
  }
}
]



Listado con el balance de las partidas presupuestaria del proyecto. Por cada partida presupuestaria se devolverán las columnas a mostrar en el SGI con sus cálculos realizados sobre las operaciones contables.

Por cada partida se devolverá:

  • Identificador del proyecto SGE
  • Partida presupuestaria
  • Anualidad
  • Tipo (si es Gasto o Ingreso)
  • Listado de columnas (definidas en la llamada /ejecucion-presupuestaria/columnas) indicando el id y el valor
Validación de gastos
GET/gastos/columnas

q+s (query + sort)

La query estará formada por:

  • proyectoId
  • fecha
  • id
  • estado

El campo estado puede tomar dos valores:

  • Pendiente
  • Validado

Lista[Columna]

Bloque de código
themeRDark
titleLista[Columnas]
collapsetrue
[
 {
   "id": "1"
   "nombre":"Fecha gasto"
   "esTotalizadora": "false",
   "esVisible": "true" 
  },
  {
   "id":"2",
   "nombre":"Proveedor",
   "esTotalizadora": "false",
   "esVisible": "true"
  },
  {
   "id":"3",
   "nombre":"Importe",
   "esTotalizadora": "false",
   "esVisible": "true"
  }
  
]



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

Por cada columna se indica un id, nombre, si es una columna totalizadora (se va a hacer una suma de ella en el SGI en la pantalla principal) y si es visible o no en la pantalla principal del SGI.

Las columnas a devolver en la Universidad de Murcia serán:

  • 1 - Fecha gasto - No es totalizadora - Es visible
  • 2 - PENDIENTES DE DEFINIR
GET/gastos

q+s (query + sort)

La query estará formada por:

  • proyectoId
  • fecha
  • id
  • estado

El campo estado puede tomar dos valores:

  • Pendiente
  • Validado

Lista[DatoEconomico]

Bloque de código
themeRDark
titleLista[DatoEconomico]
collapsetrue
[
{
"id":"1",
"proyectoId":"123456",
"partidaPresupuestaria": "202008002B541A64406",
"codigoEconomico": {
    "id": "VI",
    "nombre": "Viajes y dietas",
    "tipo": "Gasto"
}
"anualidad":"2021",
"columnas":[
  {
   "id":"1",
   "valor":"2020-11-05"
  },
  {
   "id":"2",
   "valor":"Empresa S.A"
  },
  {
   "id":"3",
   "valor":"1000.50"
  }
  ]
},
{
"id":"2",
"proyectoId":"123456",
"partidaPresupuestaria": "202008002B541A64406",
"codigoEconomico": {
    "id": "VI",
    "nombre": "Viajes y dietas",
    "tipo": "Gasto"
}
"anualidad":"2021",
"columnas":[
  {
   "id":"1",
   "valor":"2020-11-01"
  },
  {
   "id":"2",
   "valor":"Empresa S.A"
  },
  {
   "id":"3",
   "valor":"1000.50"
  }
  ]
}
]

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
  • Código económico asignado al gasto
  • Anualidad
  • Tipo: Gasto
  • Listado de columnas (definidas en la llamada /gastos/columnas) indicando el id y el valor
GET/gastos/{id}

DatoEconomico


Bloque de código
themeRDark
titleDatoEconomico
collapsetrue
"id":"1",
"proyectoId":"123456",
"partidaPresupuestaria": "202008002B541A64406",
"codigoEconomico": {
    "id": "VI",
    "nombre": "Viajes y dietas",
    "tipo": "Gasto"
}
"anualidad":"2021",
"columnas":[
  {
   "id":"1",
   "nombre":"Fecha gasto",
   "valor":"2020-11-05"
  },
  {
   "id":"2",
   "nombre":"Proveedor",
   "valor":"Empresa S.A"
  },
  {
   "id":"3",
   "nombre":"Importe",
   "valor":"1000.50"
  }
  ]
"documentos":[
  {
   "nombre":"Factura",
   "mimeType":"application/pdf"
  },
  {
   "nombre":"Otro documento",
   "mimeType":"application/pdf"
  }
  ]
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
  • Código económico asignado al gasto
  • Anualidad
  • Tipo: Gasto
  • Listado de columnas indicando el id, nombre, valor
  • Listado de documentos (nombre del documento y el mimeType, sin el contenido)
GET/documentos/{id}
????Devuelve el contenido del documento para que desde el navegador se pueda abrir o descargar el documento
PUT/gastos/{id}/validarcomentario
Se valida el gasto y recibe como parámetro el comentario  en caso de que lo tuviese.
PUT/gastos/{id}/rechazarcomentario
Se rechaza el gasto y recibe como parámetro el comentario  en caso de que lo tuviese.




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?





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?

...