proyectoId=="123456";fechaFactura=bt=("2020-12-01T00:00:00Z","2021-01-31T23:59:59Z")

[
 {
   "id": "1"
   "nombre":"Fecha emisión"
   "acumulable": "false"
   
  },
  {
   "id":"2

h1.UM - SGI - ESB - SGE - Calendario facturación
\\
----
* [{color:#0000ee}{+}Ejecución económica+{color}|UMSGIESBSGECalendariofacturación-Ejecucióneconómica] 
** [{color:#0000ee}{+}Entidades+{color}|UMSGIESBSGECalendariofacturación-Entidades]
** [{color:#0000ee}{+}Modelo lógico+{color}|UMSGIESBSGECalendariofacturación-Modelológico]
** [|UMSGIESBSGECalendariofacturación-]
** [{color:#0000ee}{+}API+{color}|UMSGIESBSGECalendariofacturación-API] 
*** [{color:#0000ee}{+}Definición de los objetos+{color}|UMSGIESBSGECalendariofacturación-Definicióndelosobjetos] 
**** [{color:#0000ee}{+}FacturaEmitida+{color}|UMSGIESBSGECalendariofacturación-FacturaEmitida]
**** [{color:#0000ee}{+}FacturaEmitidaDetalle+{color}|UMSGIESBSGECalendariofacturación-FacturaEmitidaDetalle]
**** [{color:#0000ee}{+}Detalle+{color}|UMSGIESBSGECalendariofacturación-Detalle]
**** [{color:#0000ee}{+}Columna+{color}|UMSGIESBSGECalendariofacturación-Columna]
**** [{color:#0000ee}{+}Documento+{color}|UMSGIESBSGECalendariofacturación-Documento]
**** [{color:#0000ee}{+}FacturaPrevista+{color}|UMSGIESBSGECalendariofacturación-FacturaPrevista]
**** [{color:#0000ee}{+}FacturaPrevistaEmitida+{color}|UMSGIESBSGECalendariofacturación-FacturaPrevistaEmitida]
*** [{color:#0000ee}{+}Columnas Facturas emitidas+{color}|UMSGIESBSGECalendariofacturación-ColumnasFacturasemitidas]
*** [{color:#0000ee}{+}Campos Factura emitida+{color}|UMSGIESBSGECalendariofacturación-CamposFacturaemitida]
*** [{color:#0000ee}{+}Ejemplos+{color}|UMSGIESBSGECalendariofacturación-Ejemplos] 
**** [{color:#0000ee}{+}Columnas Facturas emitidas (/facturas-emitidas/columnas)+{color}|UMSGIESBSGECalendariofacturación-ColumnasFacturasemitidas(/facturas-emitidas/columnas)]
**** [{color:#0000ee}{+}Facturas emitidas (/facturas-emitidas)+{color}|UMSGIESBSGECalendariofacturación-Facturasemitidas(/facturas-emitidas)]
**** [{color:#0000ee}{+}Detalle factura emitida (/facturas-emitidas/\{id\})+{color}|UMSGIESBSGECalendariofacturación-Detallefacturaemitida(/facturas-emitidas/{id})]
**** [{color:#0000ee}{+}Facturas previstas   (/facturas-previstas)+{color}|UMSGIESBSGECalendariofacturación-Facturasprevistas(/facturas-previstas)]
**** [{color:#0000ee}{+}Detalle Factura prevista  (/facturas-previstas)+{color}|UMSGIESBSGECalendariofacturación-DetalleFacturaprevista(/facturas-previstas)]
**** [{color:#0000ee}{+}Consulta facturas previstas de emitir  (/facturas-previstas-emitidas)+{color}|UMSGIESBSGECalendariofacturación-Consultafacturasprevistasdeemitir(/facturas-previstas-emitidas)]

h1.Ejecución económica
h2.Entidades
|*Entidad*|*Descripción*|
|FacturaEmitida|Entidad que representa una factura emitida del SGE. Tendrá que venir identificado por un identificador único, por el proyecto al que pertenece y la anualidad. \\
El resto de campos de la factura emitida 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 la pantalla del SGI de Factura emitidas. \\
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.|
|FacturaEmitidaDetalle|Entidad que representa el detalle de una factura emitida con todos sus campos para mostrarlo en una pantalla de consulta de la factura emitida. \\
Tendrá unos campos fijos (identificador único, identificador del proyecto al que pertenece y anualidad) 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 una factura emitida. \\
Por cada campo se tendrá el el nombre y el valor del campo|
|Documento|Entidad que representa los documentos que pueda tener relacionados una factura emitida|
|FacturaPrevista|Listado de facturas previstas en el calendario de facturación de un proyecto. Contiene la información introducida por el gestor en su previsión. El campo "numeroPrevision" es el campo de unión entre el SGI y el SGE. En el SGE al crea una factura se asociará a un "numeroPrevision". El "numeroPrevision" será el identificador interno de los item de calendario de facturación en el SGI.|
|FacturaPrevistaEmitida|Entidad que representa una factura emitida del SGE pero con menos información que la entidad "FacturaEmitida". Únicamente tiene la información sobre el "número de factura del SGE" y del "número de previsión". Es para poder mostrar en la pantalla de Calendario facturación del SGI el número de factura.|
h2.Modelo lógico
!worddavb7909bce1f7b3832336b26bb9474f600.png|height=379,width=468!
h2.API
Características generales que todas las API REST deben de cumplir:
* [{color:#0000ee}{+}Consultas filtradas y paginadas+{color}|https://confluence.treelogic.com/display/HERCULES/Consultas+filtradas+y+paginadas]
* [{color:#0000ee}{+}Formatos de datos API+{color}|https://confluence.treelogic.com/display/HERCULES/Formatos+de+datos+API]

h3.Definición de los objetos
h4.FacturaEmitida
|*Nombre*|*Tipo*|*Descripción*|
|id|String|Identificador de la factura emitida. Tiene que ser un identificador único.|
|proyectoId|String|Identificador del proyecto económico|
|anualidad|String|Anualidad|
|numeroFactura|String|Número de la factura emitida (en el SGE)|
|columnas|Map\[clave,valor\]|Mapa de propiedades \\
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{+})|
h4.FacturaEmitidaDetalle
h4.Detalle
|*Nombre*|*Tipo*|*Descripción*|
|id|String|Identificador de la factura emitida. Tiene que ser un identificador único.|
|proyectoId|String|Identificador del proyecto económico|
|anualidad|String|Anualidad|
|numeroFactura|String|Número de la factura emitida (en el SGE)|
|campos|Lista\[Campo\]|Lista de campos, por cada campo se define el nombre y el valor del campo|
|documentos|Lista\[Documento\]|Lista de documentos asociados a la factura emitida (sin el contenido binario del fichero).|
h4.Columna
|*Nombre*|*Tipo*|*Descripción*|
|id|String|Identificador de la columna|
|nombre|String|Nombre de la columna|
|acumulable|Boolean|Indica si se tiene que sumar o no para mostrar los totales en la pantalla del SGI. \\
Dos valores: \\
* true \\
* false|
h4.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|
h4.FacturaPrevista
|*Nombre*|*Tipo*|*Descripción*|
|numeroPrevision|String|Es el campo que establece la relación entre el ítem del calendario de facturación y las facturas emitidas en el SGE. \\
Junto con el identificador del proyecto SGI identificarán un item del calendario de facturación del SGI.|
|proyectoIdSGI|String|Identificador del proyecto SGI.|
|fechaEmision|String|Fecha en la que debe ser emitida la factura.|
|importeBase|Número|Importe base de la factura.|
|comentario|String|Cualquier comentario que se considere que debe de ser tenido en cuenta por los gestores económicos.|
h4.FacturaPrevistaEmitida
|*Nombre*|*Tipo*|*Descripción*|
|id|String|Identificador de la factura emitida. Tiene que ser un identificador único.|
|proyectoIdSGI|String|Identificador del proyecto SGI.|
|numeroFactura|String|Número de la factura emitida (en el SGE)|
|numeroPrevision|String|Es el campo que establece la relación entre el ítem del calendario de facturación y las facturas emitidas en el SGE. \\
Junto con el identificador del proyecto SGI identificarán un item del calendario de facturación del SGI.|
\\
||*Método*||*URL*||*Parámetros*||*Respuesta*||*Descripción*||
|SGI - SGE (Los debe de implementar Murcia)| | | | | | | | |
|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 (Los debe de implementar Treelogic)| | | | | | | | |
|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) \\
* Identificador del proyecto en el SGI \\
* Fecha de emisión \\
* Importe base \\
* Comentario|
h3.Columnas Facturas emitidas
({*}reducida =='true'* o {*}reducida =='false'){*}  (independientemente del campo reducida, ya que siempre se mandan todas las columnas) las columnas a devolver en la Universidad de Murcia serán:
|*id*|*nombre*|*acumulable*|
|1|Fecha emisión|false|
|2|Entidad|false|
|3|Concepto|false|
|4|Importe base|true|
|5|Porcentaje IVA|false|
|6|Importe total|true|
|7|Estado|false|
|8|Fecha cobro|false|
|9|Importe cobrado|true|
|10|Número previsión|false|
h3.Campos Factura emitida
Los campos a devolver en la Universidad de Murcia serán:
* Fecha emisión
* Entidad
* Concepto
* Importe base
* Porcentaje IVA
* Importe total
* Estado
* Fecha cobro
* Importe cobrado
* Número previsión

h3.Ejemplos
h4.Columnas Facturas emitidas (/facturas-emitidas/columnas)
\\
*Parámetros*
proyectoId=="123456";fechaFactura=bt=("2020-12-01T00:00:00Z","2021-01-31T23:59:59Z")
*Respuesta* 
\[
 \{
   "id": "1"
   "nombre":"Fecha emisión"
   "acumulable": "false"
   \\
  \},
  \{
   "id":"2",
   "nombre":"Entidad",
   "acumulable": "false"
  \\
  \},
  \{
   "id":"3",
   "nombre":"Concepto",
   "acumulable": "false"
  \\
  \},
  \{
   "id":"4",
   "nombre":"Importe base",
   "acumulable": "true"
  \},
  \{
   "id":"5",
   "nombre":"Porcentaje IVA",
   "acumulable": "false"
  \},
  \{
   "id":"6",
   "nombre":"Importe total",
   "acumulable": "true"
  \},
  \{
   "id":"7",
   "nombre":"EstadoEntidad",
   "acumulable": "false"
  
  \},
  \{
   "id":"83",
   "nombre":"Fecha cobroConcepto",
   "acumulable": "false"
  
  \},
  \{
   "id":"94",
   "nombre":"Importe cobradobase",
   "acumulable": "true"
  \},
  \{
   "id":"105",
   "nombre":"NúmeroPorcentaje previsiónIVA",
   "acumulable": "false"
  \}
\\
\]
\\
h4.Facturas emitidas (/facturas-emitidas)
\\
*Parámetros*
proyectoId=="123456";fechaFactura=bt=("2020-12-01T00:00:00Z","2021-01-31T23:59:59Z")
*Respuesta*
\[
\{
 "id":"11-2021"
 "proyectoId":"123456",
 "anualidad":"2021",
 "numeroFactura":"J2021/01",
 "columnas": \{
      "1":"20/05/2021",
    "2":"Entidad1},
  {
   "id":"6",
   "nombre":"Importe total",
   "acumulable": "true"
  },
  {
   "id":"7",
   "nombre":"Estado",
   "acumulable": "false"
  },
  {
   "id":"8",
   "nombre":"Fecha cobro",
   "acumulable": "false"
  },
  {
   "id":"9",
   "3nombre":"Concepto1Importe cobrado",
   "acumulable": "4":1000.00true"
  },
  {
   "5id":"10",
   "6nombre":1100.00"Número previsión",
    "7acumulable": "Pagadafalse",
    "8":"20/08/2021",
    "9":1100.00,
    "10":"1"
    \}
\},
\{
 }

]

proyectoId=="123456";fechaFactura=bt=("2020-12-01T00:00:00Z","2021-01-31T23:59:59Z")

[
{
	"id":"1211-2021"
 	"proyectoId":"123456",
 	"anualidad":"2021",
 	"numeroFactura":"J2021/0201",
 	"columnas": \{
      	"1":"20/0605/2021",
    		"2":"Entidad2Entidad1",
   		"3":"Concepto2Concepto1",
    		"4":1000.00,
    		"5":"10",
   		"6":1100.00,
    		"7":"Pagada",
    		"8":"20/08/2021",
    		"9":1100.00,
    		"10":"2"
    \}
\}
\]
\\
h4.Detalle factura emitida (/facturas-emitidas/\{id\})
\{
*Respueta*
\{
    1"
  		}
},
{
	"id":"12-2021"
 	"proyectoId":"123456",
	"anualidad":"2021",
	"numeroFactura":"J2021/02",
	"columnas": {
     	"anualidad1":"20/06/2021",
  		"numeroFactura2":"J2021/02Entidad2",
 		"3":"Concepto2",
  		"4":1000.00,
  		"5":"10",
 		"6":1100.00,
  		"7":"Pagada",
  		"8":"20/08/2021",
  		"9":1100.00,
  		"10":"2"
  		}
}
]

{
    "id":"12-2021"
	"proyectoId":"123456",
	"anualidad":"2021",
	"numeroFactura":"J2021/02",
    "campos":[   "campos":\[
        \{
            "nombre":"Fecha emisión",
            "valor":"1243"
        \},
        \{
            "nombre":"Entidad",
            "valor":"Entidad1"
        \},
        \{
            "nombre":"Concepto",
            "valor":"Concepto1"
        \},
        \{
            "nombre":"ImporteFecha baseemisión",
            "valor":1000.00"1243"
        \},
        \{
            "nombre":"Porcentaje IVAEntidad",
            "valor":"10Entidad1"
        \},
        \{
            "nombre":"Importe totalConcepto",
            "valor":1100.00"Concepto1"
        \},
        \{
            "nombre":"EstadoImporte base",
            "valor":"Pagada"1000.00
        \},
        \{
            "nombre":"FechaPorcentaje cobroIVA",
            "valor":"20/08/202110"
        \},
        \{
            "nombre":"Importe cobradototal",
            "valor":1100.00
        \},
        \{
            "nombre":"Número previsión",
            "valor":"2
  Estado",
      \}
    \],
   "documentosvalor":\["Pagada"
        \{},
     "id": "11",    {
      "nombre":"Factura",
      "nombreFicheronombre":"factura.pdf"Fecha cobro",
    \}
    \]
     \\
\}
\\
h4.Facturas previstas   (/facturas-previstas)
Las registradas en el SGI y que debe consultar el SGE, listado de facturas pendientes de un proyecto
\\
*Parámetros*
proyectoIdSGI=="11"
*Respuesta*
\[
\{
 "numeroPrevision":"1"
 "proyectoIdSGI":"11",
 "fechaEmision":"01/02/2021",
 "importeBase":1500.50,
    "comentario": "comentario1"
 \\
\},
\{
 "numeroPrevision":"2"
 "proyectoIdSGI":"11",
 "fechaEmision":"01/02/2021",
 "importeBase":1400.70,
    "comentario": "comentario2"
\}
\]
h4.Detalle Factura prevista  (/facturas-previstas)
Las registradas en el SGI y que debe consultar el SGE, detalle de una concreta
\\
*Parámetros*
proyectoIdSGI=="11";numeroPrevision=="1"
*Respuesta*
\[
\{
 "numeroPrevision":"1"
 "proyectoIdSGI":"11",
 "fechaEmision":"01/02/2021",
 "importeBase":1500.50,
    "comentario": "comentario1"
 \\
\}
\]
h4.Consulta facturas previstas de emitir  "valor":"20/08/2021"
        },
        {
            "nombre":"Importe cobrado",
            "valor":1100.00
        },
        {
            "nombre":"Número previsión",
            "valor":"2
        }
    ],
   "documentos":[
        {
  		 "id": "11", 
   		 "nombre":"Factura",
   		 "nombreFichero":"factura.pdf"
  		}
    ]
     
}