Hércules

Árbol de páginas

  • Creado por Usuario desconocido (lorena.alvarez), modificado por última vez en may 13, 2021

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 68 Siguiente »


Ejecución económica

Entidades

EntidadDescripción
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

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.
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 a 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

Documento

NombreTipoDescripción
nombreStringNombre del documento

mimeType

StringmimeType del documento

Método

URL

Parámetros

Respuesta

Descripción
GET/ejecucion-economica/columnas

q+s (query + sort)

La query estará formada por:

  • proyectoId

  • anualidad

  • tipoOperacion
  • fechaPago
  • fechaDevengo
  • fechaContabilizacion

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[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 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 tipoOperacion=='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 tipoOperacion=='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 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]



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
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]



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]


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


DatoEconomico 
"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?


Ejemplos

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


Parámetros
proyectoId=="123456";anualidad=in=("2020","2021");tipoOperacion=="EJ: Estado actual"
Respuesta 
[
 {
   "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"
  }

]


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


Parámetros
proyectoId=="123456";anualidad=in=("2020","2021");tipoOperacion=="EJ: Estado actual"
Respuesta
[
{
"proyectoId":"123456",
"partidaPresupuestaria": "8002B541A64406"
"anualidad":"2020",
"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"
  }
},
{
"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"
  }
}
]


Validaciones de gastos pendientes - Columnas (/gastos/columnas)


Parámetros
proyectoId=="123456";estado=="Pendiente"
Respuesta
[
 {
   "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"
  }
  
]


Validaciones de gastos pendientes (/gastos)


Parámetros
proyectoId=="123456";estado=="Pendiente"
Respuesta
[
{
"id":"1",
"proyectoId":"123456",
"partidaPresupuestaria": "08002B541A64406",
"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": "08002B541A64406",
"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"
  }
  ]
}
]


Detalle gasto (/gastos/{id})

Respuesta
"id":"1",
"proyectoId":"123456",
"partidaPresupuestaria": "08002B541A64406",
"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"
  }
  ]



  • Sin etiquetas