Son los servicios que el SGI expone en su propio ESB pero que tienen que implementar las Universidades que implanten el SGI. Además de exponerlos, el propio SGI consume estos servicios para ofrecer toda la funcionalidad. De forma general el SGI consume todos los métodos que expone en su ESB de tal forma que todos ellos son necesarios para su funcionamiento, solo en algunos casos que se detallan a continuación hay algunos métodos que no son necesarios por el SGI y que los comentamos a continuación agrupados por funcionalidad.
Modifica un periodo de amortización. Se pasa por url el identificador del periodo de amortización.
DELETE
/periodos-amortizacion/{id}
Elimina un periodo de amortización. Se pasa por url el identificador del periodo de amortización.
Calendario facturación
Método
URL
Parámetros
Respuesta
Descripción
SGI - SGE
GET
/facturas-emitidas/columnas
q+s (query + sort)
La query estará formada por:
proyectoId
reducida
fechaFactura
El campo reducida puede tomar los siguientes valores:
true: sólo se envían las columnas a mostrar en la pantalla principal
false: se envían todas las columnas (para su exportación)
Si no esta informado el campo reducida se considera false.
Lista[Columna]
Listado con las columnas que va a devolver la llamada /facturas-emitidas
Por cada columna se indica un id, nombre, si es una columna acumulable (se va a hacer una suma de ella en el SGI)
Ver el apartado "Columnas Factura Emitida" para ver que columnas se deben de mostrar.
GET
/facturas-emitidas
q+s (query + sort)
La query estará formada por:
proyectoId
reducida
fechaFactura
El campo reducida puede tomar los siguientes valores:
true: sólo se envían las columnas a mostrar en la pantalla principal
false: se envían todas las columnas (para su exportación)
Si no esta informado el campo reducida se considera false.
Lista[FacturaEmitida]
Listado con las facturas emitidas del SGE. Por cada factura emitida se devolverán los siguientes campos:
Identificador de la factura emitida
Identificador del proyecto SGE
Anualidad
Número de factura
Mapa de columnas de clave - valor (donde la clave será los id definidos en la llamada /facturas-emitidas/columnas y el valor será el valor de la columna. El valor será un String salvo en aquellas columnas que sean acumulables,se tenga que hacer sumas sobre ellas, donde será de tipo Numérico (sin separador de miles y como separador decimal el punto)). Ver el apartado "Columnas Factura Emitida" para ver los id de la columnas que se deben de mostrar.
GET
/facturas-previstas-emitidas
q+s (query + sort)
La query estará formada por:
proyectoIdSGI
numeroPrevision
numeroFactura
proyectoIdSGI: identificador del proyecto en el SGI
Lista[FacturaPrevistaEmitida]
Listado con las facturas emitidas del SGE. Por cada factura emitida se devolverán los siguientes campos:
Identificador de la factura emitida
Identificador del proyecto SGI
Número factura
Número previsión
GET
/facturas-emitidas/{id}
FacturaEmitidaDetalle
Detalle de la factura emitida con todas sus columnas.
Identificador de la factura emitida
Identificador del proyecto SGE
Anualidad
Listado de campos con su nombre y valor (Ver el apartado "Campos Detalle factura emitida" para ver que campos se deben de mostrar. En el detalle se muestran todos la columnas o campos.)
Listado de documentos (identificador, nombre del documento y nombre del fichero, sin el contenido)
GET
/documentos/{id}/archivo
Binario (en la cabecera ira el contentType)
Devuelve el binario del documento
SGE - SGI
GET
/facturas-previstas
q+s (query + sort)
La query estará formada por:
proyectoIdSGI
numeroPrevision
proyectoIdSGI: identificador del proyecto en el SGI
Lista[FacturaPrevista]
Listado de todas las facturas previstas, registradas en el SGI validadas por el IP y con fecha de conformidad (tanto si ya tienen la factura emitida creada en el SGE como sino).
La relación entre el calendario de facturación del SGI y facturas emitidas se establecerá en el SGE.
Este servicio será el utilizado en el SGE en la pantalla de creación de factura emitida para mostrar el listado de items del calendario de facturación creados en el SGI (tendrán que eliminar aquellos items del calendario del SGI que ya tienen factura emitida relacionada o creada). La relación factura emitida (SGE) - número previsión (SGI) se almacenará en el SGE.
Por cada factura prevista se devolverán los siguientes campos:
Número previsión (identificador de la factura prevista en el SGI)