Árbol de páginas

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

DocumentoEntidad que representa los documentos que pueda tener relacionados un dato económico (en este caso los gastos).

Enumerados

EntidadDescripción
TipoDatoEconomico

Puede tomar los siguientes valores:

  • Ingreso
  • Gasto

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

Dos valores:

  • Gasto
  • Ingreso
columnasMap[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

NombreTipoDescripción
idStringIdentificador del dato económico. Tiene que ser un identificador único.
camposLista[Campo]

Lista de campos, por cada campo se define el nombre y el valor del campo

Columna

NombreTipoDescripción
idStringIdentificador de la columna.
nombreStringNombre de la columna.
acumulableBoolean

Indica si se puede manejar como un importe y hacer operaciones numéricas con ella en el SGI.

Dos valores:

  • true
  • false

Documento

NombreTipoDescripción
idStringIdentificador único del documento
nombreStringNombre del documento a mostrar

nombreFichero

StringNombre del fichero con extensión

Método

URL

Parámetros

Respuesta

Descripción
Gastos
GET/gastos-pii/columnas

q+s (query + sort)

La query estará formada por:

  • numeroInvencion

Lista[Columna]



Listado con las columnas que va a devolver la llamada /gastos-pii.

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:

  • Fecha
  • Referencia
  • Concepto
  • Tipo (Honorarios, Tasa, ...)
  • Importe (acumulable = Sí)
GET/gastos-pii

q+s (query + sort)

La query estará formada por:

  • numeroInvencion

Lista[DatoEconomico]


Listado de todos los gastos asociados a una invención.

Para cada gasto se devolverán los siguientes datos:

  • Identificador del gasto
  • Mapa de columnas de clave - valor (donde la clave será los id definidos en la llamada /gastos-pii/columnas y el valor será el valor de la columna. El valor será un String salvo en aquellas columnas que sean acumulables, esto es, se puedan manejar como un importe y hacer operaciones numéricas con ella en el SGI, donde será de tipo Numérico (sin separador de miles y como separador decimal el punto).
GET/gastos-pii/{id}

DatoEconomicoDetalle



Detalle de un gasto.

Para cada gasto se devolverán los siguientes datos:

  • Identificador del gasto
  • Listado de documentos (identificador, nombre del documento y nombre del fichero, sin el contenido)
Ingresos



GET/ingresos-pii/columnas

q+s (query + sort)

La query estará formada por:

  • numeroInvencion
  • proyectoId

Lista[Columna]



Listado con las columnas que va a devolver la llamada /ingresos-pii.

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:

  • Fecha
  • Referencia
  • Importe (acumulable = Sí)
  • Nº interno de contrato
  • Entidad pagadora
GET/ingresos-pii

q+s (query + sort)

La query estará formada por:

  • numeroInvencion
  • proyectoId

Lista[DatoEconomico]


Listado de todos los ingresos asociados a una invención.

Para cada ingreso se devolverán los siguientes datos:

  • Identificador del ingreso
  • Mapa de columnas de clave - valor (donde la clave será los id definidos en la llamada /ingresos-pii/columnas y el valor será el valor de la columna. El valor será un String salvo en aquellas columnas que sean acumulables, esto es, se puedan manejar como un importe y hacer operaciones numéricas con ella en el SGI, donde será de tipo Numérico (sin separador de miles y como separador decimal el punto).

GET/documentos/{id}
DocumentoDevuelve el detalle del documento
GET/documentos/{id}/archivo
Binario (en la cabecera ira el contentType)Devuelve el binario del documento

Columnas Gastos

idnombreacumulabledescripción
1

Fecha

falseA completar con UMU
2Referenciafalse
3Conceptofalse
4Tipo (Honorarios, Tasa, ...)false
5Importetrue

Columnas Ingresos

idnombreacumulabledescripción
1

Fecha

falseA completar con UMU
2Referenciafalse
3Importetrue
3Nº interno de contratofalse
4Entidad pagadorafalse

Ejemplos

Columnas de gastos (/gastos-pii/columnas)

Respuesta
[
 {
   "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-pii)

Respuesta
[
{
	"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-pii/{id})

Respuesta
"id":"2",
"documentos":[
  {
   "id": "11",  
   "nombre":"Factura",
   "nombreFichero":"factura.pdf"
  },
  {
    "id": "12", 
    "nombre":"Otro documento",
    "nombreFichero":"otroDocumento.pdf"
  }
]



  • Sin etiquetas