Tabla de contenidos |
---|
Seguimiento justificación
Entidades
Entidad | Descripción |
---|---|
GastoJustificado | Entidad que representa al gasto que puede ser añadido en una justificación. Tendrá que venir identificado por un identificador único |
y por el proyecto al que pertenece |
. El resto de campos del gasto se tratarán como columnas dinámicas. Se indicará por cada columna el identificador del campo, el nombre del campo y si es una columna sobre la que se tiene que hacer una suma para mostrarlo en el SGI como un campo totalizador. | |
Columna | Contiene el listado de columnas dinámicas que serán mostradas en las pantallas del SGI. Por cada columna se tendrá el identificador del campo, el nombre del campo y si es una columna sobre la que se tiene que hacer una suma para mostrarlo en el SGI como un campo totalizador. |
GastoJustificadoDetalle | Entidad que representa el detalle de un gasto de una justificación con todos sus campos para mostrarlo en una pantalla de consulta del gasto. Tendrá unos campos fijos (identificador único, identificador del proyecto al que pertenece, fecha de devengo,, un código económico, importe gasto e importe presentado en la justificación) y unos campos dinámicos. Por cada campo se detallará el nombre y el valor del campo para mostrarlo en la pantalla del SGI |
Campo | Contiene el listado de campos dinámicos que serán mostradas en las pantallas de detalle de un gasto. Por cada campo se tendrá el el nombre y el valor del campo |
Documento | Entidad que representa los documentos que pueda tener relacionados un gasto |
Modelo lógico
API
Características generales que todas las API REST deben de cumplir:
...
Definición de los objetos
GastoJustificado
Nombre | Tipo | Descripción |
id | String | Identificador del gasto. Tiene que ser un identificador único |
proyectoId | String | Identificador del proyecto económico (SGE) |
justificacionId | String | Identificador justificación (del SGE) |
columnas | Map[clave,valor] | Mapa de propiedades 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). Las fechas vendrán en el formato para mostrarlas por pantalla, es decir, dd/MM/YYYY |
GastoJustificadoDetalle
Nombre | Tipo | Descripción |
id | String | Identificador del gasto. Tiene que ser un identificador único. |
proyectoId | String | Identificador del proyecto económico (SGE) |
justificacionId | String |
Identificador justificación ( |
del |
SGE) |
campos | Lista[Campo] | Lista de campos, por cada campo se define el nombre y el valor del campo |
Columna
Nombre | Tipo | Descripción |
id | String | Identificador de la columna |
nombre | String | Nombre de la columna |
acumulable | Boolean | Indica si se tiene que sumar o no para mostrar los totales en la pantalla del SGI. Dos valores:
|
Documento
Nombre | Tipo | Descripción |
id | String | Identificador único del documento |
nombre | String | Nombre del documento a mostrar |
nombreFichero | String | Nombre del fichero con extensión |
Servicios
Info |
---|
Para componer la URL llamada completa, se debe anteponer a lo indicado en la columna URL lo siguiente: {HOST}/api/sge, donde {HOST} de deberá sustituir el dominio correspondiente al entorno al que se está accediendo y dicho acceso será por http o https según el caso. |
...
Informe de propiedades de página |
---|
...
|
...
|
...
Respuesta
...
|
...
|
...
|
...
|
...
|
...
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
...
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
...
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)
...
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.
...
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
|
Columnas Seguimiento Justificación
Las columnas a devolver en la Universidad de Murcia serán:
id | nombre | acumulable |
1 | Nº de registro | false |
2 | Nº registro proveedor | false |
3 | Desc. factura/gasto | false |
4 | Código económico | false |
5 | Fecha devengo | false |
6 | Fecha pago | false |
7 | Importe gasto | true |
8 | Importe presentado just. | true |
9 | Fecha inicio contrato | false |
10 | Dedicación anual proy. | false |
Los gastos que no sean de personal, tendrán vacías las columnas "Fecha inicio contrato" y "Dedicación anual proy."
Campos Detalle Gasto Justificado
Los campos a devolver en la Universidad de Murcia serán:
- Nº de registro
- Nº de documento de gasto
- Anualidad
- Clasificación SGE
- Aplicación presupuestaria
- Código económico
- Proveedor
- Nº de registro del proveedor
- Descripción de la Fac/Gasto
- Fecha devengo
- Fecha pago
- Fecha contabilización
- Importe
- Importe IVA
- Importe presentado en justificación
Si el gasto es personal también se enviarán los campos:
- Fecha inicio de contrato
- Fecha fin de contrato
- Categoría contrato
- Jornada
- Dedicación anual en timesheet para el proyecto SGI
...
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
...
DatoEconomicoDetalle
...
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)
...