...
Entidades
Entidad | Descripción |
---|---|
CodigoEconomico | Son 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 |
PartidaPresupuestaria | Partidas presupuestarias de la Universidad sobre las que se va recoger el detalle de operaciones contables desde el SGE |
Proyecto | Es 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:
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:
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:
|
Columna | Contiene el listado de columnas (nombre y valor de la columna) que serán mostradas por cada aplicación presupuestaria |
Modelo lógico
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) |
Documento | Entidad que representa los documentos que pueda tener relacionados un dato económico (en este caso los gastos). |
Modelo lógico
API
Características generales que todas las API REST deben de cumplir:
Definición de los objetos
DatoEconomico
Nombre | Tipo | Descripción |
id | String | Identificador del dato económico. Tiene que ser un identificador único. |
EjecucionPresupuestaria
Nombre | Tipo | Descripción |
proyectoId | String | Identificador del proyecto económico |
partidaPresupuestaria | String | Código de la Partida presupuestaria |
codigoEconomico | CodigoEconomico | Contiene la entidad Código económico asignado al gasto/ingreso |
anualidad | String | Anualidad |
tipo | String | Dos valores:
|
columnas | Lista[Columna] | Listado con las columnas de la aplicación presupuestariaa mostrar |
Columna
Nombre | Tipo | Descripción |
id | String | Identificador de la columna |
nombre | String | Nombre de la columna |
valor | String | Valor de la columna |
esTotalizadora | Boolean | Indica si se tiene que sumar o no para mostrar los totales en la pantalla del SGI. Dos valores:
|
esVisible | Boolean | Indica si se tiene que mostrar en la pantalla del listado del SGI o no Dos valores:
|
...
Método | URL | Parámetros | Respuesta | Descripción | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Ejecución presupuestaria | |||||||||||||
GET | /ejecucion-presupuestaria/columnas | q+s (query + sort) La query estará formada por:
El tipoEjecucionPrespuestaria tipoOperacion puede tomar 3 los siguientes valores:
| Lista[Columna]
| 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:
Cuando tipoEjecucionPrespuestariatipoOperacion=='EP: Gastos' las columnas a devolver en la Universidad de Murcia serán:
Cuando tipoEjecucionPrespuestariatipoOperacion=='IngresoslEP: Ingresos' las columnas a devolver en la Universidad de Murcia serán:
| |||||||||
GET | /ejecucion-presupuestaria | q+s (query + sort) La query estará formada por:
El tipoEjecucionPrespuestaria tipoOperacion puede tomar 3 los siguientes valores:
| Lista[EjecucionPrespuestariaDatoEconomico]
| 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á:
| |||||||||
Validación de gastos | |||||||||||||
GET | /gastos/columnas | q+s (query + sort) La query estará formada por:
El campo estado puede tomar dos valores:
| 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 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:
| |||||||||
GET | /gastos | q+s (query + sort) La query estará formada por:
El campo estado puede tomar dos valores:
| 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:
| |||||||||
GET | /gastos/{id} | DatoEconomico
| Detalle de un gasto. Para cada gasto se devolverán los siguientes datos:
| ||||||||||
GET | /documentos/{id} | ???? | Devuelve el contenido del documento para que desde el navegador se pueda abrir o descargar el documento | ||||||||||
PUT | /gastos/{id}/validar | comentario | Se valida el gasto y recibe como parámetro el comentario en caso de que lo tuviese. | ||||||||||
PUT | /gastos/{id}/rechazar | comentario | 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? |
...