Differenze tra le versioni di "Timesheet"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
Riga 152: Riga 152:
  
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
<p>Ricerca delle risorse</p>
+
<p>Riepilogo giornaliero</p>
 
<b>application/json</b>
 
<b>application/json</b>
 
<pre>
 
<pre>
 
{
 
{
     "giorno": "yyyy-mm-dd"  
+
     "giorno": "yyyy-mm-dd",
 +
    "idRisorsa": "sfhsifgsigfsfs"
 
}
 
}
 
</pre>
 
</pre>
Riga 170: Riga 171:
 
                             <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;'><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;'>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>
 +
<tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>idRisorsa</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>ID della risorsa recuperato tramite l'api risorse/ricerca</td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></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>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
Riga 336: Riga 343:
  
 
             </tr>     
 
             </tr>     
 +
  <tr>
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 +
 +
<b>timesheet/riepilogomensile</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>Riepilogo mensile</p>
 +
<b>application/json</b>
 +
<pre>
 +
{
 +
    "anno": "2017",
 +
    "mese": "10",
 +
    "idRisorsa": "xxxxxx",
 +
}
 +
</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>anno</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Anno del timesheet</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>mese</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Mese del timesheet</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>idRisorsa</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>ID della risorsa recuperato tramite l'api risorse/ricerca</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>
 +
{
 +
    "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
 +
    }
 +
}
 +
</pre>
 +
                    <p>In caso di errore:</p>
 +
 +
                    <pre>
 +
{
 +
  "successo": false,
 +
  "messaggio": "Descrizione dell'errore"
 +
}
 +
</pre>
 +
 +
                </td>
  
 +
            </tr>
 
            
 
            
 
         </table>
 
         </table>

Versione delle 09:58, 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

Riepilogo giornaliero

application/json

{
    "giorno": "yyyy-mm-dd",
    "idRisorsa": "sfhsifgsigfsfs"
}

descrizione dei parametri

parametro descrizione default obbligatorio
giorno Giorno da esaminare SI
idRisorsa ID della risorsa recuperato tramite l'api risorse/ricerca 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"
}
timesheet/riepilogomensile POST

Riepilogo mensile

application/json

{
    "anno": "2017",
    "mese": "10",
    "idRisorsa": "xxxxxx",
}

descrizione dei parametri

parametro descrizione default obbligatorio
anno Anno del timesheet SI
mese Mese del timesheet SI
idRisorsa ID della risorsa recuperato tramite l'api risorse/ricerca SI


{
    "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"
}