Historial de página

...

Modelo lógico

Image Removed

API

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

• Consultas filtradas y paginadas
• Formatos de datos API

Definición de los objetos

DatoEconomico

...

Dos valores:

• Gasto
• Ingreso

...

Columna

...

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

Dos valores:

• true
• false

...

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

Dos valores:

• true
• false

Documento

...

mimeType

...

Método

...

URL

...

Parámetros

...

Respuesta

...

q+s (query + sort)

La query estará formada por:

• proyectoId

• anualidad

• tipoEjecucionPrespuestaria

El tipoOperacion puede tomar los siguientes valores:

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

Enumerados

Modelo lógico

Image Added

API

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

• Consultas filtradas y paginadas
• Formatos de datos API

Definición de los objetos

DatoEconomico

DatoEconomicoDetalle

Columna

Documento

Comentario

ClasificacionSGE

Servicios

Columnas Ejecución económica

Ejecución presupuestaria  - Estado actual

Cuando tipoOperacion=='EPA'  y (reducida =='true' o reducida =='false')  (independientemente del campo reducida, ya que siempre se mandan todas las columnas) las columnas

Lista[Columna]

[
 {
   "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-economica

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

...

a devolver en la Universidad de Murcia serán:

...

Ejecución presupuestaria  - Gastos

...

Cuando tipoOperacion=='

...

EPG'  y (reducida =='true' o reducida =='false')  (independientemente del campo reducida, ya que siempre se mandan todas las columnas) las columnas a devolver en la Universidad de Murcia serán:

id	nombre	acumulable
1

-

Importe presupuestado

- Es totalizadora - Es visible

	true
2

-

Importe definitivo

- Es totalizadora - Es visible

	true
3

-

Gastos pagados

- Es totalizadora - Es visible

	true
4

-

Gastos en tramitación

- Es totalizadora - Es visible

5 -Crédito disponible - Es totalizadora - Es visible

6 -

	true
5	Crédito disponible	true
6	Retenciones personal contratado y expedientes

- Es totalizadora - Es visible

	true
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 tipoOperacion=='EP: 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-economica

q+s (query + sort)

La query estará formada por:

• proyectoId
• anualidad
• tipoEjecucionPrespuestaria

El tipoOperacion puede tomar los siguientes valores:

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

Lista[DatoEconomico]

	true
8	Gastos pendientes de pago	true
9	Pagos a justificar	true

Ejecución presupuestaria  - Ingresos

Cuando tipoOperacion=='EPI' y (reducida =='true' o reducida =='false')  (independientemente del campo reducida, ya que siempre se mandan todas las columnas) las columnas a devolver en la Universidad de Murcia serán:

Facturas y justificantes  - Facturas y gastos

Cuando tipoOperacion=='FJF' y reducida = "true" las columnas a devolver en la Universidad de Murcia serán:

Cuando tipoOperacion=='FJF' y reducida = "false" las columnas a devolver en la Universidad de Murcia serán:

Facturas y justificantes  - Viajes y dietas

Cuando tipoOperacion=='FJV'  y redudida == "true" las columnas a devolver en la Universidad de Murcia serán:

El campo Perceptor/proveedor será el nombre y apellidos del perceptor o proveedor

Cuando tipoOperacion=='FJV'  y redudida == "false" las columnas a devolver en la Universidad de Murcia serán:

El campo "Perceptor/proveedor" será el nombre y apellidos del perceptor o proveedor

El campo "Identificador Perceptor/proveedor" será el NIF/NIE/CIF del perceptor o proveedor

Facturas y justificantes  - Personal contratado

Cuando tipoOperacion=='FJP'  y reducida == "true" las columnas a devolver en la Universidad de Murcia serán:

El campo "Nº documento identificación" se refiere al NIF/NIE del contratado

El campo "Nombre  apellidos" se refiere al nombre y apellidos del contratado

Cuando tipoOperacion=='FJP'  y reducida == "false" las columnas a devolver en la Universidad de Murcia serán:

El campo "Nº documento identificación" se refiere al NIF/NIE del contratado

El campo "Nombre  apellidos" se refiere al nombre y apellidos del contratado

Detalle operaciones  - Gastos

Cuando tipoOperacion=='DOG' y (reducida =='true' o reducida =='false')  (independientemente del campo reducida, ya que siempre se mandan todas las columnas) las columnas a devolver en la Universidad de Murcia serán:

Detalle operaciones  - Ingresos

Cuando tipoOperacion=='DOI'  y(reducida =='true' o reducida =='false')  (independientemente del campo reducida, ya que siempre se mandan todas las columnas) l las columnas a devolver en la Universidad de Murcia serán:

El campo "Tercero" NIF/NIE/CIF de la persona

Detalle operaciones  - Modificaciones

Cuando tipoOperacion=='DOM' y (reducida =='true' o reducida =='false')  (independientemente del campo reducida, ya que siempre se mandan todas las columnas) l  las columnas a devolver en la Universidad de Murcia serán:

Columnas Validación de gastos

Cuando reducida = "true" las columnas a devolver en la Universidad de Murcia serán:

Cuando reducida = "false" las columnas a devolver en la Universidad de Murcia serán:

Campos Detalle dato económico

Facturas y justificantes  - Facturas y gastos

Cuando tipoOperacion=='FJF'  (el campo reducida dará igual porque en el detalle siempre se muestran todos los campos) los campos a devolver en la Universidad de Murcia serán:

• Nº de registro
• Tipo de operación
• Proveedor
• Nº de registro del proveedor
• Concepto de la Fac/Gasto
• Importe
• Importe IVA
• Fecha contabilización
• Fecha pago
• Nº de documento de gasto
• Nº de señalamiento

Facturas y justificantes  - Viajes y dietas

Cuando tipoOperacion=='FJV' (el campo reducida dará igual porque en el detalle siempre se muestran todos los campos) los campos a devolver en la Universidad de Murcia serán:

• Nº de factura
• Nº de comisión de servicio
• Perceptor/Proveedor
• Identificador Perceptor/Proveedor
• Concepto/ Motivo del viaje
• Fecha contabilización
• Fecha pago
• Itinerario viaje
• Destino
• Fecha salida - Fecha vuelta
• Medio de locomoción
• Importe locomoción
• Importe alojamiento
• Importe dietas
• Otros gastos
• Importe total
• Observaciones locomoción
• Observaciones alojamiento
• Observaciones dietas

Facturas y justificantes  - Personal contratado

Cuando tipoOperacion=='FJP' (el campo reducida dará igual porque en el detalle siempre se muestran todos los campos) los campos a devolver en la Universidad de Murcia serán:

• Nº documento identificación
• Nombre y apellidos
• Concepto
• Fecha contabilización
• Fecha pago
• Importe
• Fecha inicio del contrato
• Fecha fin del contrato
• Categoría laboral
• Jornada semanal o diaria

Campos Detalle dato económico - Validación de gastos

Los campos a devolver en la Universidad de Murcia serán:

• Tipo documento
• Nº documento
• Importe imputado
• Importe total
• Descripción
• Proveedor

Ejemplos

Ejecución presupuestaria - Estado actual - Columnas (/ejecucion-economica/columnas)

proyectoId=="123456";anualidad=in=("2020","2021");tipoOperacion=="EPA"

[
 {
   "id": "1"
   "nombre":"Importe presupuestado"
   "acumulable": "true"
  },
  {
   "id":"2",
   "nombre":"Importe actual",
   "acumulable": "true"
  },
  {
   "id":"3",
   "nombre":"Importe disponible para gastos",
   "acumulable": "true"
  },
  {
   "id":"4",
   "nombre":"Derechos",
   "acumulable": "true"
  },
  {
   "id":"5",
   "nombre":"Cobros",
   "acumulable": "true"
  }

]

Ejecución presupuestaria - Estado actual  (/ejecucion-economica)

proyectoId=="123456";anualidad=in=("2020","2021");tipoOperacion=="EPA"

[
{
	"proyectoId":"123456",
	"partidaPresupuestaria": "8002B541A64406"
	"anualidad":"2020",
	"tipo":"Gasto",
	"columnas": {
     	"1":2000,
     	"2":500,
     	"3":1000.50,
     	"4":1000.50,
     	"5":1000.50
     	}
 
},
{
	"proyectoId":"123456",
	"partidaPresupuestaria": "8002B541A64406"
	"anualidad":"2021",
	"tipo":"Gasto",
	"columnas": {
        "1":2000,
     	"2":500.50,
     	"3":1000.50,
     	"4":1000.50,
     	"5":1000.50
         }
}
]

Facturas y justificantes - Facturas y gastos - Columnas (reducida false) (/ejecucion-economica/columnas)

proyectoId=="123456";anualidad=in=("2020","2021");fechaPago=bt=("2020-12-01T00:00:00Z","2021-01-31T23:59:59Z");tipoOperacion=="FJF";reducida=="false"

[
 {
   "id": "1"
   "nombre":"Nº de registro"
   "acumulable": "false"
   
  },
  {
   "id":"2",
   "nombre":"Tipo de operación",
   "acumulable": "false"
  
  },
  {
   "id":"3",
   "nombre":"Proveedor",
   "acumulable": "false"
  
  },
  {
   "id":"4",
   "nombre":"Nº de registro del proveedor",
   "acumulable": "false"
  },
  {
   "id":"5",
   "nombre":"Concepto de la Fac./Gasto",
   "acumulable": "false"
  },
  {
   "id":"6",
   "nombre":"Importe",
   "acumulable": "true"
  },
  {
   "id":"7",
   "nombre":"Importe IVA",
   "acumulable": "true"
  },
  {
   "id":"8",
   "nombre":"Fecha contabilización",
   "acumulable": "false"
  },
  {
   "id":"9",
   "nombre":"Fecha pago",
   "acumulable": "false"
  },
  {
   "id":"10",
   "nombre":"Nº documento de gasto",
   "acumulable": "false"
  },
  {
   "id":"11",
   "nombre":"Nº de señalamiento",
   "acumulable": "false"
  }

]

Facturas y justificantes - Facturas y gastos (reducida a false) (/ejecucion-economica)

proyectoId=="123456";anualidad=in=("2020","2021");fechaPago=bt=("2020-12-01","2021-01-31");ttipoOperacion=="FJF";reducida=="false"

[
{
	"id":"11-2020-Factura"
	"proyectoId":"123456",
	"partidaPresupuestaria": "8002B541A64406",
    "fechaDevengo": "20/12/2020",
    "clasificacionSGE": {
        "id": "1",
        "nombre": "Fungible",
     } ,
     "codigoEconomico": {
   	 	"id": "FU",
    	"nombre": "Fungible",
    	"tipo": "Gasto"
		}
	"anualidad":"2020",
	"tipo":"Gasto",
	"columnas": {
     	"1":"1243",
  		"2":"Factura",
 		"3":"Proveedor1",
  		"4":"24555",
  		"5":"Gasto de material inventariable",
 		"6":500.00,
  		"7":0.00,
  		"8":"20/12/2020",
  		"9":"20/12/2020",
 		"10":"11222",
  		"11":"4567"
  		}
},
{
	"id":"12-2020-Factura"
	"proyectoId":"123456",
	"partidaPresupuestaria": "8002B541A64406",
    "fechaDevengo": "20/12/2020",
    "clasificacionSGE": {
        "id": "1",
        "nombre": "Fungible",
     } ,   
    "codigoEconomico": {
    	"id": "FU",
    	"nombre": "Fungible",
    	"tipo": "Gasto"
		}
	"anualidad":"2020",
	"tipo":"Gasto",
	"columnas":{
     	"1":"1243",
  		"2":"Factura",
 		"3":"Proveedor1",
  		"4":"24555",
  		"5":"Gasto de material inventariable",
 		"6":500.00,
  		"7":0.00,
  		"8":"20/12/2020",
  		"9":"20/12/2020",
 		"10":"11222",
  		"11":"4567"
  		}
}
]

Facturas y justificantes - Facturas y gastos - Detalle (/ejecucion-economica/{id})

tipoOperacion=="FGF"

{
    "id":"11-2020-Factura"
    "proyectoId":"123456",
    "partidaPresupuestaria": "8002B541A64406",
    "fechaDevengo": "20/12/2020",
    "clasificacionSGE": {
        "id": "1",
        "nombre": "Fungible",
     } , 
     "codigoEconomico": {
        "id": "FU",
        "nombre": "Fungible",
        "tipo": "Gasto"
        }
    "anualidad":"2020",
    "tipo":"Gasto",
    "campos":[
        {
            "nombre":"Nº registro",
            "valor":"1243"
        },
        {
            "nombre":"Tipo operación",
            "valor":"Factura"
        },
        {
            "nombre":"Proveedor",
            "valor":"Proveedor1"
        },
        {
            "nombre":"Nº de registro del proveedor",
            "valor":"24555"
        },
        {
            "nombre":"Concepto de la Fac/Gasto",
            "valor":"Gasto de material inventariable"
        },
        {
            "nombre":"Importe",
            "valor":"500.00"
        },
        {
            "nombre":"Importe IVA",
            "valor":"0.00"
        },
        {
            "nombre":"Fecha contabilización",
            "valor":"20/12/2020"
        },
        {
            "nombre":"Fecha pago",
            "valor":"20/12/2020"
        },
        {
            "nombre":"Nº documento de gasto",
            "valor":"11222"
        },
        {
            "nombre":"Nº de señalamiento",
            "valor":"4567"
        }
    ]
     
}

Validaciones de gastos pendientes - Columnas (con reducida a true) (/gastos/columnas)

proyectoId=="123456";estado=="Pendiente";reducida=="true"

[
 {
   "id": "1"
   "nombre":"Tipo documento"
   "acumulable": "false"
  },
  {
   "id":"2",
   "nombre":"Importe imputado",
   "acumulable": "true"
  },
  {
   "id":"3",
   "nombre":"Proveedor",
   "acumulable": "false"
  }
  
]

Validaciones de gastos pendientes - Columnas (con reducida a false) (/gastos/columnas)

proyectoId=="123456";estado=="Pendiente";reducida=="false"

[
 {
   "id": "1"
   "nombre":"Tipo documento"
   "acumulable": "false"
  },
  {
   "id":"2",
   "nombre":"Nº documento",
   "acumulable": "false"
  },
  {
   "id":"3",
   "nombre":"Importe imputado",
   "acumulable": "true"
  },
  {
   "id":"4",
   "nombre":"Importe total",
   "acumulable": "true"
  },
  {
   "id":"5",
   "nombre":"Descripción",
   "acumulable": "false"
  },
  {
   "id":"6",
   "nombre":"Proveedor",
   "acumulable": "false"
  }
  
]

Validaciones de gastos pendientes (con reducida a true) (/gastos)

proyectoId=="123456";estado=="Pendiente";reducida=="true"

...

...

[
{
	"

...

id":"

...

1",
	"

...

proyectoId":

...

"

...

123456",
	"

...

partidaPresupuestaria": "

...

08002B541A64406",
    "

...

fechaDevengo": "

...

10/11/2021",
    "

...

clasificacionSGE":

...

 {
   

...

     "id": "1",
        "

...

nombre": "

...

Fungible",
     } ,

...

...

    "

...

codigoEconomico":

...

 {
    	"

...

id": "

...

VI"

...

,
  

...

...

	"

...

nombre": "

...

Viajes y dietas",
    	"

...

tipo": "

...

Gasto"

...

		},

...

	"anualidad":"

...

2021",
    "

...

tipo":"

...

Gasto",
	"columnas": 

...

{
   		"

...

1":"

...

Factura",
  

...

		"

...

2":"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-economica/columnas) indicando el id y el valor

...

q+s (query + sort)

La query estará formada por:

• proyectoId
• fecha
• id
• estado

El campo estado puede tomar dos valores:

• Pendiente
• Validado

Lista[Columna]

[
 {
   "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

,
  		"3":"Empresa S.A"
  		}
},
{
	"id":"2",
	"proyectoId":"123456",
	"partidaPresupuestaria": "08002B541A64406",
    "fechaDevengo": "07/11/2021",
    "clasificacionSGE": {
        "id": "1",
        "nombre": "Fungible",
     } ,
    "codigoEconomico": {
    	"id": "VI",
    	"nombre": "Viajes y dietas",
    	"tipo": "Gasto"
		}
	"anualidad":"2021",
    "tipo":"Gasto",
	"columnas" {
   		"1":"Factura",
  		"2":"1000.50",
  		"3":"Empresa S.A"
  		}
}
]

Validaciones de gastos pendientes (con reducida a false) (/gastos)

proyectoId=="123456";estado=="Pendiente";reducida=="false"

[
{
	"id":"1",
	"proyectoId":"123456",
	"partidaPresupuestaria": "08002B541A64406",
    "fechaDevengo": "10/11/2021",
    "clasificacionSGE": {
        "id": "1",
        "nombre": "Fungible",
     } ,  
    "codigoEconomico": {
    	"id": "VI",
    	"nombre": "Viajes y dietas",
    	"tipo": "Gasto"
		},
	"anualidad":"2021",
    "tipo":"Gasto",
	"columnas": {
   		"1":"Factura",
  		"2":"122-45",
  		"3":"700.00",
        "4":"800.50",
        "5":"Descripción del gasto",
        "6":"Empresa S.A"
  		}
},
{
	

...

q+s (query + sort)

La query estará formada por:

• proyectoId
• fecha
• id
• estado

El campo estado puede tomar dos valores:

• Pendiente
• Validado

Lista[DatoEconomico]

...

...

"id":"2",

...

	"

...

proyectoId":"

...

123456",

...

	"partidaPresupuestaria": "08002B541A64406",
   

...

 "fechaDevengo": "

...

10/11/2021",
    "

...

clasificacionSGE":

...

 {
   

...

...

   "id": "

...

1",

...

        "nombre": "

...

Fungible",

...

     } ,  
  "codigoEconomico": {
    	"id": "VI",
    	"nombre": "Viajes y dietas",
    	"tipo": "Gasto"
		}
	"anualidad":"2021",

...

...

...

"

...

tipo":"

...

Gasto",

...

	"columnas" {
   		"

...

1":"

...

Factura",
  

...

		"

...

2":"

...

122-46",
  

...

		"3":"

...

600.00",
    

...

...

...

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

"4":"1800.50",
        "5":"Descripción del gasto",
        "6":"Empresa S.A"
  		}
}
]

Detalle gasto (/gastos/{id})

...

DatoEconomico

...

"id":"

...

2",
"proyectoId":"123456",
"partidaPresupuestaria": "08002B541A64406",
"fechaDevengo": "10/11/2021",
 "clasificacionSGE": {
        "id": "1",

...

        "nombre": "Fungible",
     } ,  
 "codigoEconomico": {
    "id": "VI",
    "nombre": "Viajes y dietas",
    "tipo": "Gasto"
    }
"anualidad":"2021",
"

...

tipo":"

...

Gasto",

...

"

...

campos":[
  {

...

   "nombre":"

...

Tipo documento",
   "valor":"

...

Factura"
  },
  {
   "

...

nombre":"

...

Nº documento",
   "valor":"

...

122-46"
  }

...

,
  {
   "nombre":"

...

Importe imputado",
   "

...

valor":"

...

600.00"
  },
  {
   "nombre":"Importe total",
   "valor":"

...

1800.50"
  },
  {
   "

...

nombre":"

...

Descripción",
  

...

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)

...

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

...

 "valor":"Descripción del gasto"
  },
  {
   "nombre":"Proveedor",
   "valor":"Empresa S.A"
  }
]
"documentos":[
  {
   "id": "11",  
   "nombre":"Factura",
   "nombreFichero":"factura.pdf"
  },
  {
    "id": "12", 
    "nombre":"Otro documento",
    "nombreFichero":"otroDocumento.pdf"
  }
]