Ejecución económica de invenciones
Entidades
Hay entidades que se reutilizan del modelo de Ejecución económica del SGE y pero se repiten aquí por claridad aunque ya están descritas en el API del SGE: SGI - ESB - SGE - Ejecución económica.
| 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. |
| 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 |
Invencion | Entidad que representa a la invención cara a poder ser presentada en listas de valores con su título. |
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
Hay objetos que se reutilizan del modelo de Ejecución económica del SGE y por tanto no se repiten aquí, están descritos en el API del SGE: UM - SGI - ESB - SGE - Ejecución económica.
Invencion
| Nombre | Tipo | Descripción |
| id | String | Identificador único de la invención. |
| titulo | String | Título de la invención. |
TipoProteccion
| Nombre | Tipo | Descripción |
| id | String | Identificador único del tipo de protección. |
| tipoPropiedad | String | Tipo de propiedad del tipo de protección. Tendrá dos posibles valores: INDUSTRIAL o INTELECTUAL. |
| nombre | String | Nombre descriptivo del tipo de protección. |
| descripción | String | Descripción del tipo de protección. |
| padreId | String | Identificador del padre del tipo de protección. Solo estará informado en el caso de tratarse de un subtipo. |
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. |
| documentos | Lista[Documento] | Lista de documentos asociados al gasto (sin el contenido binario del fichero). |
Documento (se reutilizaría el mismo que el definido en UM - SGI - ESB - SGE - Ejecución económica)
| 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
Hay servicios a los que no se hace mención en este API porque la funcionalidad que los precisa, por ejemplo, la recuperación del binario de cada documento asociado a un gasto, ha de reutilizar los que ya están definidos en el modelo de Ejecución económica del SGE y por tanto no se repiten aquí, están descritos en el API del SGE: UM - SGI - ESB - SGE - Ejecución económica.
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. (A implementar por Treelogic) | |
| GET | /invenciones | q+s (query + sort) La query estará formada por:
| Lista[Invencion] | Listado de todas las invenciones registradas en el SGI. (A implementar por Treelogic) Ejemplo: invencionId=in=(150,151,152) |
| 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. El identificador de proyecto a enviar al SGE ha de ser el del proyecto económico en Justo. 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 en el SGI se realizará a través de contratos de CSP (proyectos) y el identificador de proyecto a enviar al SGE ha de ser el del proyecto económico en Justo. Los ingresos devueltos se corresponderán con las facturas emitidas asociadas a la invención a través del contrato. Para cada ingreso se devolverán los siguientes datos:
|
Columnas Gastos
| id | nombre | acumulable | descripción |
|---|---|---|---|
| 1 | Fecha | false | Fecha de emisión |
| 2 | Referencia | false | Nº / año factura |
| 3 | Concepto | false | Descripción de factura |
| 4 | Tipo (Honorarios, Tasa, ...) | false | Tipo de gasto |
| 5 | Importe | true | Base imponible |
Columnas Ingresos
| id | nombre | acumulable | descripción |
|---|---|---|---|
| 1 | Fecha | false | Fecha de emisión |
| 2 | Referencia | false | Serie-Nº factura / año factura |
| 3 | Importe | true | Base imponible |
| 3 | Nº interno de contrato | false | Identificador del contrato del SGI asociado al ingreso |
| 4 | Entidad pagadora | false | Nombre del tercero pagador de la factura emitida |
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"
}
]