Differenze tra le versioni di "Reportistica"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
 
(4 versioni intermedie di uno stesso utente non sono mostrate)
Riga 5: Riga 5:
 
             <li><b>report/consuntivazione</b> consente di estrarre i dati di consuntivazione</li>
 
             <li><b>report/consuntivazione</b> consente di estrarre i dati di consuntivazione</li>
 
             <li><b>report/fatturatoannuale</b> consente di estrarre i dati di fatturato/maturato di un intero anno per mese e cliente</li>
 
             <li><b>report/fatturatoannuale</b> consente di estrarre i dati di fatturato/maturato di un intero anno per mese e cliente</li>
 +
<li><b>report/uppwise</b> consente di estrarre i dati per integrazione con uppwise</li>
 
       </ul>
 
       </ul>
 
     </p>
 
     </p>
Riga 531: Riga 532:
 
             </tr>
 
             </tr>
 
        
 
        
    
+
   <tr>
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 +
 
 +
<b>report/uppwise</b></td>
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>POST</td>
 +
 
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 +
<p>Dati dei costi per intergazione applicativo uppwise</p>
 +
<b>application/json</b>
 +
<pre>
 +
{
 +
    "dataInizio":"2023-01-01",
 +
    "dataFine":"2023-02-28"
 +
}
 +
</pre>
 +
<p><b>descrizione dei parametri</b></p>
 +
                    <table border="0" style="border:1px solid #999; border-collapse:collapse">
 +
                        <tr>
 +
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>parametro</th>
 +
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>descrizione</th>
 +
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>default</th>
 +
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>obbligatorio</th>
 +
                        </tr>
 +
                        <tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>dataInizio</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Data di inizio estrazione in formato ISO yyyy-MM-dd</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 +
                        </tr>
 +
<tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>dataFine</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Data di fine estrazione in formato ISO yyyy-MM-dd</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 +
                        </tr>
 +
 
 +
 
 +
                     
 +
                    </table>
 +
 
 +
<p>
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top; width:400px'>
 +
 
 +
 
 +
                    <pre>
 +
{
 +
    "parametri": {
 +
        "dataInizio": "2023-01-01T00:00:00",
 +
        "dataFine": "2023-02-28T00:00:00"
 +
    },
 +
    "costi": [
 +
        {
 +
            "anno": 2023,
 +
            "mese": 1,
 +
            "codiceProgetto": "001",
 +
            "codiceVoce": "xxx",
 +
            "importo": 1219780.79
 +
        },
 +
        {
 +
            "anno": 2023,
 +
            "mese": 1,
 +
            "codiceProgetto": "002",
 +
            "codiceVoce": "xxx",
 +
            "importo": 79452.4
 +
        },
 +
        {
 +
            "anno": 2023,
 +
            "mese": 1,
 +
            "codiceProgetto": "002",
 +
            "codiceVoce": "xxx",
 +
            "importo": 4977.59
 +
        },
 +
        {
 +
            "anno": 2023,
 +
            "mese": 2,
 +
            "codiceProgetto": "",
 +
            "codiceVoce": "xxx",
 +
            "importo": 1022879.02
 +
        },
 +
        {
 +
            "anno": 2023,
 +
            "mese": 2,
 +
            "codiceProgetto": "002",
 +
            "codiceVoce": "xxx",
 +
            "importo": 89069.11
 +
        },
 +
        {
 +
            "anno": 2023,
 +
            "mese": 2,
 +
            "codiceProgetto": "002",
 +
            "codiceVoce": "xxx",
 +
            "importo": 5923.64
 +
        }
 +
    ],
 +
    "successo": true,
 +
    "errore": null
 +
}
 +
</pre>
 +
                    <p>In caso di errore:</p>
 +
 
 +
                    <pre>
 +
{
 +
  ...
 +
  "successo": false,
 +
  "errore": "Descrizione dell'errore"
 +
}
 +
</pre>
 +
 
 +
                </td>
 +
 
 +
            </tr>
 
            
 
            
 
         </table>
 
         </table>

Versione attuale delle 14:00, 2 apr 2024

Per eseguire i servizi presenti in questa sezione è necessario utilizzare un utente che abbia il permesso Report->Esecuzione

Metodi presenti un questa sezione:

  • report/consuntivazione consente di estrarre i dati di consuntivazione
  • report/fatturatoannuale consente di estrarre i dati di fatturato/maturato di un intero anno per mese e cliente
  • report/uppwise consente di estrarre i dati per integrazione con uppwise


METODO HTTP Verb PARAMETRI RISULTATO
report/consuntivazione POST

Ricerca delle risorse

application/json

{
  "annoInizio":2022,
  "meseInizio":7,
  "annoFine":2022,
  "meseFine":7
}

descrizione dei parametri

parametro descrizione default obbligatorio
annoInizio Anno inizio estrazione dati SI
meseInizio Mese inizio estrazione dati SI
annoFine Anno fine estrazione dati SI
meseFine Mese fine estrazione dati SI


{
    "datiConsuntivazione": [
        {
            "anno": 2022,
            "mese": 7,
            "commessa": {
                "settoreTipoAttivita": {
                    "id": "06",
                    "descrizione": "XXX"
                },
                "capoProgetto": {
                    "id": 138,
                    "nominativo": {
                        "nome": "XXX",
                        "cognome": "XXX"
                    },
                    "sede": {
                        "id": null,
                        "descrizione": null
                    },
                    "unitaOrganizzativa": {
                        "id": null,
                        "descrizione": null
                    },
                    "fornitore": {
                        "id": null,
                        "codice": null,
                        "descrizione": null
                    },
                    "tipologia": null
                },
                "responsabileDiStruttura": {
                    "id": 138,
                    "nominativo": {
                        "nome": "XXX",
                        "cognome": "XXX"
                    },
                    "sede": {
                        "id": null,
                        "descrizione": null
                    },
                    "unitaOrganizzativa": {
                        "id": null,
                        "descrizione": null
                    },
                    "fornitore": {
                        "id": null,
                        "codice": null,
                        "descrizione": null
                    },
                    "tipologia": null
                },
                "unitaOrganizzativa": {
                    "id": null,
                    "descrizione": null
                },
                "tipologia": {
                    "id": 21,
                    "descrizione": "XXX"
                },
                "cliente": {
                    "id": 90,
                    "descrizione": "XXX"
                },
                "id": 263,
                "descrizione": "XXX"
            },
            "risorsa": {
                "ordine": {
                    "numero": null,
                    "numeroRiga": null
                },
                "id": 780,
                "nominativo": {
                    "nome": "XXX",
                    "cognome": "XXX"
                },
                "sede": {
                    "id": 27,
                    "descrizione": "XXX"
                },
                "unitaOrganizzativa": {
                    "id": 77,
                    "descrizione": "XXX"
                },
                "fornitore": {
                    "id": 72,
                    "codice": "",
                    "descrizione": "XXX"
                },
                "tipologia": "DIPENDENTE"
            },
            "attivita": {
                "prodotto": {
                    "id": 0,
                    "nome": "XXX",
                    "tags": []
                },
                "modelloFinanziario": {
                    "id": 29,
                    "descrizione": "XXX"
                },
                "dettaglioCostiRisorsa": {
                    "retribuzioneOrdinaria": 4202.6,
                    "tfr": 234.11,
                    "ctrOrdinario": 1182.32,
                    "straordinario": 0.0,
                    "ctrStraordinario": 0.0,
                    "inailSuRetribuzione": 8.85,
                    "inailSuStraordinario": 0.0,
                    "reperibilitaLorda": 0.0,
                    "contributiSuIndennita": 0.0,
                    "inailSuIndennita": 0.0
                },
                "settoreTipoAttivita": {
                    "id": "06",
                    "descrizione": "XXX"
                },
                "giorni": 18.0,
                "giorniStraordinario": 0.0,
                "totaleGiorni": 18.0,
                "costoOrdinarioGiornaliero": 312.66,
                "costoStraordinarioGiornaliero": 0.0,
                "giorniTrasferta": 0,
                "costoDiaria": 0.0,
                "costiDiaria": 0.0,
                "spese": 0.0,
                "totaleCosti": 5627.88,
                "rateOrdinarioGiornaliero": 0.0,
                "ricavoDiaria": 0.0,
                "ricaviDiaria": 0.0,
                "totaleRicavi": 0.0,
                "id": 3414,
                "descrizione": "XXX"
            }
        },
       ...
    ],
    "datiCostiFissi": [
        {
            "anno": 2022,
            "mese": 7,
            "id": 26443,
            "risorsa": {
                "id": 0,
                "nominativo": {
                    "nome": "",
                    "cognome": ""
                },
                "sede": {
                    "id": 0,
                    "descrizione": ""
                },
                "unitaOrganizzativa": {
                    "id": 0,
                    "descrizione": ""
                },
                "fornitore": {
                    "id": 0,
                    "codice": null,
                    "descrizione": ""
                },
                "tipologia": null
            },
            "tipoCosto": {
                "id": 1,
                "descrizione": "XXX"
            },
            "commessa": {
                "unitaOrganizzativa": {
                    "id": 77,
                    "descrizione": "XXX"
                },
                "tipologia": {
                    "id": 29,
                    "descrizione": "XXX"
                },
                "cliente": {
                    "id": 63,
                    "descrizione": "XXX"
                },
                "id": 807,
                "descrizione": "XXX"
            },
            "fornitore": {
                "id": 53,
                "descrizione": "XXX"
            },
            "descrizione": "XXX",
            "importo": 1269.97
        },
       ...
    ],
    "dettaglioCosti": [
        {
            "anno": 2022,
            "mese": 7,
            "risorsa": {
                "id": 780,
                "nominativo": {
                    "nome": "XXX",
                    "cognome": "XXX"
                },
                "sede": {
                    "id": 27,
                    "descrizione": "XXX"
                },
                "unitaOrganizzativa": {
                    "id": 77,
                    "descrizione": "XXX"
                },
                "fornitore": {
                    "id": 72,
                    "codice": "",
                    "descrizione": "XXX"
                },
                "tipologia": "DIPENDENTE"
            },
            "commessa": {
                "unitaOrganizzativa": {
                    "id": null,
                    "descrizione": null
                },
                "tipologia": {
                    "id": 21,
                    "descrizione": "XXX"
                },
                "cliente": {
                    "id": 90,
                    "descrizione": "XXX"
                },
                "id": 263,
                "descrizione": "XXX"
            },
            "attivita": {
                "giorni": 18.0,
                "costoGiornaliero": 312.66,
                "totaleCostoGiorni": 5627.88,
                "oreStraordinario": 0.0,
                "costoStraordinario": 0.0,
                "totaleStraordinario": 0.0,
                "oreStraordinarioNotturno": 0.0,
                "costoStraordinarioNotturno": 0.0,
                "totaleStraordinarioNotturno": 0.0,
                "oreStraordinarioPrefestivo": 0.0,
                "costoStraordinarioPrefestivo": 0.0,
                "totaleStraordinarioPrefestivo": 0.0,
                "oreStraordinarioFestivo": 0.0,
                "costoStraordinarioFestivo": 0.0,
                "totaleStraordinarioFestivo": 0.0,
                "oreInterventoInReperibilita": 0.0,
                "costoInterventoInReperibilita": 0.0,
                "totaleInterventoInReperibilita": 0.0,
                "oreInterventoInReperibilitaNotturno": 0.0,
                "costoInterventoInReperibilitaNotturno": 0.0,
                "totaleInterventoInReperibilitaNotturno": 0.0,
                "oreInterventoInReperibilitaPrefestivo": 0.0,
                "costoInterventoInReperibilitaPrefestivo": 0.0,
                "totaleInterventoInReperibilitaPrefestivo": 0.0,
                "oreInterventoInReperibilitaFestivo": 0.0,
                "costoInterventoInReperibilitaFestivo": 0.0,
                "totaleInterventoInReperibilitaFestivo": 0.0,
                "giorniSmartWorking": 0.0,
                "costoGiornalieroSmartWorking": 0.0,
                "totaleCostoGiorniSmartWorking": 0.0,
                "oreStraordinarioSmartWorking": 0.0,
                "costoStraordinarioSmartWorking": 0.0,
                "totaleStraordinarioSmartWorking": 0.0,
                "oreStraordinarioNotturnoSmartWorking": 0.0,
                "costoStraordinarioNotturnoSmartWorking": 0.0,
                "totaleStraordinarioNotturnoSmartWorking": 0.0,
                "oreStraordinarioPrefestivoSmartWorking": 0.0,
                "costoStraordinarioPrefestivoSmartWorking": 0.0,
                "totaleStraordinarioPrefestivoSmartWorking": 0.0,
                "oreStraordinarioFestivoSmartWorking": 0.0,
                "costoStraordinarioFestivoSmartWorking": 0.0,
                "totaleStraordinarioFestivoSmartWorking": 0.0,
                "oreInterventoInReperibilitaSmartWorking": 0.0,
                "costoInterventoInReperibilitaSmartWorking": 0.0,
                "totaleInterventoInReperibilitaSmartWorking": 0.0,
                "oreInterventoInReperibilitaNotturnoSmartWorking": 0.0,
                "costoInterventoInReperibilitaNotturnoSmartWorking": 0.0,
                "totaleInterventoInReperibilitaNotturnoSmartWorking": 0.0,
                "oreInterventoInReperibilitaPrefestivoSmartWorking": 0.0,
                "costoInterventoInReperibilitaPrefestivoSmartWorking": 0.0,
                "totaleInterventoInReperibilitaPrefestivoSmartWorking": 0.0,
                "oreInterventoInReperibilitaFestivoSmartWorking": 0.0,
                "costoInterventoInReperibilitaFestivoSmartWorking": 0.0,
                "totaleInterventoInReperibilitaFestivoSmartWorking": 0.0,
                "reperibilita": 0.0,
                "costoReperibilita": 0.0,
                "totaleReperibilita": 0.0,
                "reperibilitaFestiva": 0.0,
                "costoReperibilitaFestiva": 0.0,
                "totaleReperibilitaFestiva": 0.0,
                "totaleComplessivo": 5627.88,
                "id": 3414,
                "descrizione": "XXX"
            }
        },
      ...
        }
    ]
}

In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore"
}
report/fatturatoannuale POST

Ricerca delle risorse

application/json

{
  "anno":2022,
}

descrizione dei parametri

parametro descrizione default obbligatorio
anno Anno di estrazione dei dati SI


{
    "anno": 0,
    "totaleMaturato": 4164570.17,
    "totaleFatturato": 5099873.82,
    "clienti": [
        {
            "id": 14,
            "nome": "XXX",
            "mesi": [
                {
                    "numero": 1,
                    "fatturato": 11680.0,
                    "maturato": 6565.0,
                    "nome": "gennaio"
                },
                {
                    "numero": 2,
                    "fatturato": 0.0,
                    "maturato": 6200.0,
                    "nome": "febbraio"
                },
                {
                    "numero": 3,
                    "fatturato": 45000.0,
                    "maturato": 8345.0,
                    "nome": "marzo"
                },
                {
                    "numero": 4,
                    "fatturato": 6825.0,
                    "maturato": 6970.0,
                    "nome": "aprile"
                },
                {
                    "numero": 5,
                    "fatturato": 7350.0,
                    "maturato": 7765.0,
                    "nome": "maggio"
                },
                {
                    "numero": 6,
                    "fatturato": 10260.0,
                    "maturato": 7820.0,
                    "nome": "giugno"
                },
                {
                    "numero": 7,
                    "fatturato": 0.0,
                    "maturato": 6920.0,
                    "nome": "luglio"
                },
                {
                    "numero": 8,
                    "fatturato": 0.0,
                    "maturato": 4397.5,
                    "nome": "agosto"
                },
                {
                    "numero": 9,
                    "fatturato": 0.0,
                    "maturato": 0.0,
                    "nome": "settembre"
                },
                {
                    "numero": 10,
                    "fatturato": 0.0,
                    "maturato": 0.0,
                    "nome": "ottobre"
                },
                {
                    "numero": 11,
                    "fatturato": 0.0,
                    "maturato": 0.0,
                    "nome": "novembre"
                },
                {
                    "numero": 12,
                    "fatturato": 0.0,
                    "maturato": 0.0,
                    "nome": "dicembre"
                }
            ],
            "totaleMaturato": 54982.5,
            "totaleFatturato": 81115.0
        },
    ...
    ]
}

In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore"
}
report/uppwise POST

Dati dei costi per intergazione applicativo uppwise

application/json

{
    "dataInizio":"2023-01-01",
    "dataFine":"2023-02-28"
}

descrizione dei parametri

parametro descrizione default obbligatorio
dataInizio Data di inizio estrazione in formato ISO yyyy-MM-dd SI
dataFine Data di fine estrazione in formato ISO yyyy-MM-dd SI


{
    "parametri": {
        "dataInizio": "2023-01-01T00:00:00",
        "dataFine": "2023-02-28T00:00:00"
    },
    "costi": [
        {
            "anno": 2023,
            "mese": 1,
            "codiceProgetto": "001",
            "codiceVoce": "xxx",
            "importo": 1219780.79
        },
        {
            "anno": 2023,
            "mese": 1,
            "codiceProgetto": "002",
            "codiceVoce": "xxx",
            "importo": 79452.4
        },
        {
            "anno": 2023,
            "mese": 1,
            "codiceProgetto": "002",
            "codiceVoce": "xxx",
            "importo": 4977.59
        },
        {
            "anno": 2023,
            "mese": 2,
            "codiceProgetto": "",
            "codiceVoce": "xxx",
            "importo": 1022879.02
        },
        {
            "anno": 2023,
            "mese": 2,
            "codiceProgetto": "002",
            "codiceVoce": "xxx",
            "importo": 89069.11
        },
        {
            "anno": 2023,
            "mese": 2,
            "codiceProgetto": "002",
            "codiceVoce": "xxx",
            "importo": 5923.64
        }
    ],
    "successo": true,
    "errore": null
}

In caso di errore:

{
  ...
  "successo": false,
  "errore": "Descrizione dell'errore"
}