Differenze tra le versioni di "Timesheet"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
Riga 145: Riga 145:
 
             </tr>
 
             </tr>
  
        
+
        <tr>
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 +
 
 +
<b>timesheet/riepilogo</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>Ricerca delle risorse</p>
 +
<b>application/json</b>
 +
<pre>
 +
{
 +
    "giorno": "yyyy-mm-dd"   
 +
}
 +
</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>giorno</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Giorno da esaminare</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>
 +
{
 +
  "bloccato": "false",
 +
  "attivita": [
 +
    {
 +
       "id": "Ts3JgRhcs%2bmugYGWKZGYXQ%3d%3d",
 +
      "commessa": "offera test",
 +
      "codiceCommessa": "775",
 +
      "idCommessa": "ZVPqzPA0lsl%2fJds9NC%2fxbQ%3d%3d",
 +
      "descrizioneAttivita": "aaaa",
 +
      "daFatturare": false,
 +
      "trasferta": false,
 +
      "cliente": "AAA",
 +
      "idCliente": "xiqfS2TmC14Zo5n8YLDTGw%3d%3d",
 +
      "tipoAttivita": "Insurance",
 +
      "note": "",
 +
      "totaleOre": "04:00:00",
 +
      "oreOrdinarie": "04:00:00",
 +
      "oreDaRecuperare": "00:00:00",
 +
      "oreStraordinario": "00:00:00",
 +
      "totaleOreStraordinarioFestivo": "00:00:00",
 +
      "oreStraordinarioFestivoDiurno": "00:00:00",
 +
      "oreStraordinarioFestivoNotturno": "00:00:00",
 +
      "oreReperibilitaFestiva": "00:00:00",
 +
      "totaleOreInterventoReperibilitaFestiva": "00:00:00",
 +
      "oreInterventoReperibilitaFestivaDiurne": "00:00:00",
 +
      "oreInterventoReperibilitaFestivaNotturne": "00:00:00",
 +
      "oreReperibilita": "00:00:00",
 +
      "oreStraordinarioNotturno": "00:00:00",
 +
      "oreInterventoReperibilita": "00:00:00",
 +
      "oreInterventoReperibilitaNotturne": "00:00:00"
 +
    },
 +
    {
 +
      "id": "VNGzkOTegrEK1OicyHWquw%3d%3d",
 +
      "commessa": "Rinnovo annuale manutenzione licenze prodotti Adobe (ex Jetform)",
 +
      "codiceCommessa": "795",
 +
      "idCommessa": "ZVPbzPA0Csl%2fJds9NC%2fxbQ%3d%3d",
 +
      "descrizioneAttivita": "attività 2",
 +
      "daFatturare": false,
 +
      "trasferta": false,
 +
      "cliente": "BNL",
 +
      "tipoAttivita": "Finance & bankingtt",
 +
      "note": "",
 +
      "totaleOre": "01:00:00",
 +
      "oreOrdinarie": "01:00:00",
 +
      "oreDaRecuperare": "00:00:00",
 +
      "oreStraordinario": "00:00:00",
 +
      "totaleOreStraordinarioFestivo": "00:00:00",
 +
      "oreStraordinarioFestivoDiurno": "00:00:00",
 +
      "oreStraordinarioFestivoNotturno": "00:00:00",
 +
      "oreReperibilitaFestiva": "00:00:00",
 +
      "totaleOreInterventoReperibilitaFestiva": "00:00:00",
 +
      "oreInterventoReperibilitaFestivaDiurne": "00:00:00",
 +
      "oreInterventoReperibilitaFestivaNotturne": "00:00:00",
 +
      "oreReperibilita": "00:00:00",
 +
      "oreStraordinarioNotturno": "00:00:00",
 +
      "oreInterventoReperibilita": "00:00:00",
 +
      "oreInterventoReperibilitaNotturne": "00:00:00"
 +
    }
 +
  ],
 +
  "giustificativi": [
 +
    {
 +
      "riposoCompensativo": false,
 +
      "descrizione": "Ferie",
 +
      "stato": "R",
 +
      "ore": "02:00:00"
 +
    },
 +
    {
 +
      "riposoCompensativo": false,
 +
      "descrizione": "Infortunio",
 +
      "stato": "A",
 +
      "ore": "01:00:00"
 +
    }
 +
  ],
 +
"tasks": [
 +
    {
 +
        "oreOrdinarie": "00:30:00",
 +
        "oreDaRecuperare": "00:00:00",
 +
        "oreStraordinario": "00:00:00",
 +
        "oreStraordinarioFestivoDiurno": "00:00:00",
 +
        "oreStraordinarioFestivoNotturno": "00:00:00",
 +
        "oreReperibilita": "00:00:00",
 +
        "oreReperibilitaFestiva": "00:00:00",
 +
        "oreInterventoReperibilita": "00:00:00",
 +
        "oreInterventoReperibilitaNotturne": "00:00:00",
 +
        "oreInterventoReperibilitaFestivaDiurne": "00:00:00",
 +
        "oreInterventoReperibilitaFestivaNotturne": "00:00:00",
 +
        "oreInterventoReperibilitaFestiva": "00:00:00",
 +
        "oreStraordinarioNotturno": "00:00:00",
 +
        "idCommessa": "v6xRKZueM380vgbG%2bwriew%3d%3d",
 +
        "idAttivita": "UCcxUOC9qr8sOvqKuQ9rlg%3d%3d",
 +
        "numero":43,
 +
        "id": "t2%2b81zYVmguR43bqt5Zvqg%3d%3d",
 +
        "titoloCompleto": "Task #6: cia bello (52 - La rustica)",
 +
        "titolo": "cia bello",
 +
        "cliente": "EDS",
 +
        "totaleOre": 128.0,
 +
        "commessa": "La rustica",
 +
        "descrizione": ""
 +
    }
 +
    ...
 +
    ],
 +
  "timbratura": {
 +
    "giustificativi": [],
 +
    "oreOrdinarie": "00:00:00",
 +
    "oreStraordinario": "00:00:00",
 +
    "oreGiustificate": "00:00:00",
 +
    "convalidato": false,
 +
    "presente": false,
 +
    "codiceTurnoOrdinario": null,
 +
    "codiceCausaleOrdinario": null,
 +
    "descrizioneCausaleOrdinario": null,
 +
    "descrizioneTurnoOrdinario": null,
 +
    "codiceTurnoStraOrdinario": null,
 +
    "codiceCausaleStraOrdinario": null,
 +
    "descrizioneCausaleStraOrdinario": null,
 +
    "descrizioneTurnoStraOrdinario": null,
 +
    "totaleOre": "00:00:00"
 +
  },
 +
  "data": "2017-10-03T00:00:00",
 +
  "oreGiustificateTimbrature": "00:00:00",
 +
  "totaleOreRecuperate": 0.0,
 +
  "totaleOre": 12.0,
 +
  "totaleOreGustificativi": 3.0,
 +
  "totaleOreGustificativiApprovateRichieste": 3.0,
 +
  "totaleOreLavorate": 9.0,
 +
  "totaleOreOrdinarie": 5.0,
 +
  "totaleOreTasks": 0.0,
 +
  "totaleOreDaRecuperare": 0.0,
 +
  "totaleOreStraordinario": 0.0,
 +
  "totaleOreStraordinarioFestivo": 0.0,
 +
  "totaleOreStraordinarioFestivoDiurno": 0.0,
 +
  "totaleOreStraordinarioFestivoNotturno": 0.0,
 +
  "totaleOreReperibilitaFestiva": 0.0,
 +
  "totaleOreInterventoReperibilitaNotturne": 0.0,
 +
  "totaleOreInterventoReperibilita": 0.0,
 +
  "totaleOreInterventoReperibilitaFestivaDiurne": 0.0,
 +
  "totaleOreInterventoReperibilitaFestivaNotturne": 0.0,
 +
  "totaleOreInterventoReperibilitaFestiva": 0.0,
 +
  "totaleOreReperibilita": 0.0,
 +
  "totaleOreStraordinarioNotturno": 0.0
 +
}
 +
</pre>
 +
                    <p>In caso di errore:</p>
 +
 
 +
                    <pre>
 +
{
 +
  "successo": false,
 +
  "messaggio": "Descrizione dell'errore"
 +
}
 +
</pre>
 +
 
 +
                </td>
 +
 
 +
            </tr>   
  
 
            
 
            
 
         </table>
 
         </table>

Versione delle 09:28, 21 mar 2022

Per eseguire i servizi presenti in questa sezione è necessario utilizzare un utente che abbia il permesso Accesso API

Metodi presenti un questa sezione:

  • risorse/ricerca consente di ricercare una risorsa
  • timesheet/riepilogo consente recuperare il dettaglio giornaliero delle ore
  • timesheet/riepilogomensile consente di recuperare il dettaglio mensile delle ore


METODO HTTP Verb PARAMETRI RISULTATO
risorse/ricerca POST

Ricerca delle risorse

application/json

{
  "nome":"mario",
  "cognome":"rossi",
  "email":"mario.rossi@info.it",
  "codiceFiscale":"xxx",
  "matricola":"xxx",
  "collaboratore":"false",
  "esterno":"false",
  "dipendente":"true"
}

descrizione dei parametri

parametro descrizione default obbligatorio
nome Nome della risorsa
cognome Cognome della risorsa
email Email della risorsa
codiceFiscale Codice fiscale della risorsa
matricola Matricola della risorsa
collaboratore Tipologia di risorsa 'collaboratore'
esterno Tipologia di risorsa 'esterno'
dipendente Tipologia di risorsa 'dipendente'


{
    "risorse": [
        {
            "id": "2v8V%2byD%2bZxmgQ3RrZzCXZg%3d%3d",
            "cognome": "Rossi",
            "nome": "Mario",
            "matricola": "",
            "codiceFiscale": "",
            "email": "email@email.com",
            "collaboratore": false,
            "esterno": false,
            "dipendente": true
        }
    ],
    "filtri": {
        "cognome": null,
        "nome": "mario",
        "email": null,
        "codiceFiscale": null,
        "matricola": null,
        "collaboratore": false,
        "esterno": false,
        "dipendente": false
    }
}

In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore"
}
timesheet/riepilogo POST

Ricerca delle risorse

application/json

{
    "giorno": "yyyy-mm-dd"    
}

descrizione dei parametri

parametro descrizione default obbligatorio
giorno Giorno da esaminare SI


{
  "bloccato": "false",
  "attivita": [
    {
      "id": "Ts3JgRhcs%2bmugYGWKZGYXQ%3d%3d",
      "commessa": "offera test",
      "codiceCommessa": "775",
      "idCommessa": "ZVPqzPA0lsl%2fJds9NC%2fxbQ%3d%3d",
      "descrizioneAttivita": "aaaa",
      "daFatturare": false,
      "trasferta": false,
      "cliente": "AAA",
      "idCliente": "xiqfS2TmC14Zo5n8YLDTGw%3d%3d",
      "tipoAttivita": "Insurance",
      "note": "",
      "totaleOre": "04:00:00",
      "oreOrdinarie": "04:00:00",
      "oreDaRecuperare": "00:00:00",
      "oreStraordinario": "00:00:00",
      "totaleOreStraordinarioFestivo": "00:00:00",
      "oreStraordinarioFestivoDiurno": "00:00:00",
      "oreStraordinarioFestivoNotturno": "00:00:00",
      "oreReperibilitaFestiva": "00:00:00",
      "totaleOreInterventoReperibilitaFestiva": "00:00:00",
      "oreInterventoReperibilitaFestivaDiurne": "00:00:00",
      "oreInterventoReperibilitaFestivaNotturne": "00:00:00",
      "oreReperibilita": "00:00:00",
      "oreStraordinarioNotturno": "00:00:00",
      "oreInterventoReperibilita": "00:00:00",
      "oreInterventoReperibilitaNotturne": "00:00:00"
    },
    {
      "id": "VNGzkOTegrEK1OicyHWquw%3d%3d",
      "commessa": "Rinnovo annuale manutenzione licenze prodotti Adobe (ex Jetform)",
      "codiceCommessa": "795",
      "idCommessa": "ZVPbzPA0Csl%2fJds9NC%2fxbQ%3d%3d",
      "descrizioneAttivita": "attività 2",
      "daFatturare": false,
      "trasferta": false,
      "cliente": "BNL",
      "tipoAttivita": "Finance & bankingtt",
      "note": "",
      "totaleOre": "01:00:00",
      "oreOrdinarie": "01:00:00",
      "oreDaRecuperare": "00:00:00",
      "oreStraordinario": "00:00:00",
      "totaleOreStraordinarioFestivo": "00:00:00",
      "oreStraordinarioFestivoDiurno": "00:00:00",
      "oreStraordinarioFestivoNotturno": "00:00:00",
      "oreReperibilitaFestiva": "00:00:00",
      "totaleOreInterventoReperibilitaFestiva": "00:00:00",
      "oreInterventoReperibilitaFestivaDiurne": "00:00:00",
      "oreInterventoReperibilitaFestivaNotturne": "00:00:00",
      "oreReperibilita": "00:00:00",
      "oreStraordinarioNotturno": "00:00:00",
      "oreInterventoReperibilita": "00:00:00",
      "oreInterventoReperibilitaNotturne": "00:00:00"
    }
  ],
  "giustificativi": [
    {
      "riposoCompensativo": false,
      "descrizione": "Ferie",
      "stato": "R",
      "ore": "02:00:00"
    },
    {
      "riposoCompensativo": false,
      "descrizione": "Infortunio",
      "stato": "A",
      "ore": "01:00:00"
    }
  ],
 "tasks": [
    {
        "oreOrdinarie": "00:30:00",
        "oreDaRecuperare": "00:00:00",
        "oreStraordinario": "00:00:00",
        "oreStraordinarioFestivoDiurno": "00:00:00",
        "oreStraordinarioFestivoNotturno": "00:00:00",
        "oreReperibilita": "00:00:00",
        "oreReperibilitaFestiva": "00:00:00",
        "oreInterventoReperibilita": "00:00:00",
        "oreInterventoReperibilitaNotturne": "00:00:00",
        "oreInterventoReperibilitaFestivaDiurne": "00:00:00",
        "oreInterventoReperibilitaFestivaNotturne": "00:00:00",
        "oreInterventoReperibilitaFestiva": "00:00:00",
        "oreStraordinarioNotturno": "00:00:00",
        "idCommessa": "v6xRKZueM380vgbG%2bwriew%3d%3d",
        "idAttivita": "UCcxUOC9qr8sOvqKuQ9rlg%3d%3d",
        "numero":43,
        "id": "t2%2b81zYVmguR43bqt5Zvqg%3d%3d",
        "titoloCompleto": "Task #6: cia bello (52 - La rustica)",
        "titolo": "cia bello",
        "cliente": "EDS",
        "totaleOre": 128.0,
        "commessa": "La rustica",
        "descrizione": ""
    }
    ...
    ],
  "timbratura": {
    "giustificativi": [],
    "oreOrdinarie": "00:00:00",
    "oreStraordinario": "00:00:00",
    "oreGiustificate": "00:00:00",
    "convalidato": false,
    "presente": false,
    "codiceTurnoOrdinario": null,
    "codiceCausaleOrdinario": null,
    "descrizioneCausaleOrdinario": null,
    "descrizioneTurnoOrdinario": null,
    "codiceTurnoStraOrdinario": null,
    "codiceCausaleStraOrdinario": null,
    "descrizioneCausaleStraOrdinario": null,
    "descrizioneTurnoStraOrdinario": null,
    "totaleOre": "00:00:00"
  },
  "data": "2017-10-03T00:00:00",
  "oreGiustificateTimbrature": "00:00:00",
  "totaleOreRecuperate": 0.0,
  "totaleOre": 12.0,
  "totaleOreGustificativi": 3.0,
  "totaleOreGustificativiApprovateRichieste": 3.0,
  "totaleOreLavorate": 9.0,
  "totaleOreOrdinarie": 5.0,
  "totaleOreTasks": 0.0,
  "totaleOreDaRecuperare": 0.0,
  "totaleOreStraordinario": 0.0,
  "totaleOreStraordinarioFestivo": 0.0,
  "totaleOreStraordinarioFestivoDiurno": 0.0,
  "totaleOreStraordinarioFestivoNotturno": 0.0,
  "totaleOreReperibilitaFestiva": 0.0,
  "totaleOreInterventoReperibilitaNotturne": 0.0,
  "totaleOreInterventoReperibilita": 0.0,
  "totaleOreInterventoReperibilitaFestivaDiurne": 0.0,
  "totaleOreInterventoReperibilitaFestivaNotturne": 0.0,
  "totaleOreInterventoReperibilitaFestiva": 0.0,
  "totaleOreReperibilita": 0.0,
  "totaleOreStraordinarioNotturno": 0.0
}

In caso di errore:

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