Ejecución económica
Entidades
Entidad | Descripció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 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 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 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. |
DatoEconomicoDetalle | Entidad que representa el detalle de un dato económico con todos sus campos para mostrarlo en una pantalla de consulta del dato económico. Tendrá unos campos fijos (identificador único, identificador del proyecto al que pertenece, anualidad, partida presupuestaria y un código económico) 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 dato económico. Por cada campo se tendrá el el nombre y el valor del campo |
Documento | Entidad que representa los documentos que pueda tener relacionados un dato económico (en este caso los gastos). |
Enumerados
Entidad | Descripción |
---|---|
TipoDatoEconomico | Puede tomar los siguientes valores:
|
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. |
tipo | String | Dos valores:
|
columnas | Map[clave,valor] | Mapa de propiedades. El valor será un String salvo en aquellas columnas que sean acumulables (se puede manejar como un importe y hacer operaciones numéricas con ella en el SGI). |
DatoEconomicoDetalle
Nombre | Tipo | Descripción |
id | String | Identificador del dato económico. Tiene que ser un identificador único. |
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 puede manejar como un importe y hacer operaciones numéricas con ella en el 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 |
Método | URL | Parámetros | Respuesta | Descripción |
---|---|---|---|---|
Invención | ||||
HEAD | /invenciones/{id} | HTTP 200 / HTTP 204 | Comprueba la existencia de la invención con el id indicado en el SGI. | |
Gastos | ||||
GET | /gastos-invencion/columnas | q+s (query + sort) La query estará formada por:
| Lista[Columna] | Listado con las columnas que va a devolver la llamada /gastos-invencion. Por cada columna se indica un id, nombre, si es una columna acumulable (se puede manejar como un importe y hacer operaciones numéricas con ella en el SGI). Por defecto, devolverá las siguientes columnas:
|
GET | /gastos-invencion | q+s (query + sort) La query estará formada por:
| Lista[DatoEconomico] | Listado de todos los gastos asociados a una invención. Para cada gasto se devolverán los siguientes datos:
|
GET | /gastos-invencion/{id} | DatoEconomicoDetalle | Detalle de un gasto. Para cada gasto se devolverán los siguientes datos:
| |
Ingresos | ||||
GET | /ingresos-invencion/columnas | q+s (query + sort) La query estará formada por:
| Lista[Columna] | Listado con las columnas que va a devolver la llamada /ingresos-invencion. Por cada columna se indica un id, nombre, si es una columna acumulable (se puede manejar como un importe y hacer operaciones numéricas con ella en el SGI). Por defecto, devolverá las siguientes columnas:
|
GET | /ingresos-invencion | q+s (query + sort) La query estará formada por:
| Lista[DatoEconomico] | Listado de todos los ingresos asociados a una invención (la asociación se realizará a través de contratos de CSP), que se corresponderán con las facturas emitidas. Para cada ingreso se devolverán los siguientes datos:
|
GET | /documentos/{id} | Documento | Devuelve el detalle del documento | |
GET | /documentos/{id}/archivo | Binario (en la cabecera ira el contentType) | Devuelve el binario del documento |
Columnas Gastos
id | nombre | acumulable | descripción |
---|---|---|---|
1 | Fecha | false | A completar con UMU |
2 | Referencia | false | |
3 | Concepto | false | |
4 | Tipo (Honorarios, Tasa, ...) | false | |
5 | Importe | true |
Columnas Ingresos
id | nombre | acumulable | descripción |
---|---|---|---|
1 | Fecha | false | A completar con UMU |
2 | Referencia | false | |
3 | Importe | true | |
3 | Nº interno de contrato | false | |
4 | Entidad pagadora | false |
Ejemplos
Columnas de gastos (/gastos-invencion/columnas)
[ { "id": "1" "nombre":"Fecha" "acumulable": "false" }, { "id":"2", "nombre":"Referencia", "acumulable": "false" }, { "id":"3", "nombre":"Concepto", "acumulable": "false" }, { "id":"4", "nombre":"Tipo", "acumulable": "false" }, { "id":"5", "nombre":"Importe", "acumulable": "true" } ]
Gastos (/gastos-invencion)
[ { "id":"1", "tipo":"Gasto", "columnas": { "1":, "2":"F123456", "3":"Informe de patentabilidad", "4":"Honorarios", "5":55.99 } }, { "id":"2", "tipo":"Gasto", "columnas": { "1":, "2":"F123457", "3":"Solicitud de patente", "4":"Tasa", "5":99.99 } } ]
Detalle gasto (/gastos-invencion/{id})
"id":"2", "documentos":[ { "id": "11", "nombre":"Factura", "nombreFichero":"factura.pdf" }, { "id": "12", "nombre":"Otro documento", "nombreFichero":"otroDocumento.pdf" } ]