Timesheet

Da CometaSoftware Wiki.
Jump to navigation Jump to search

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


{
    "contratto": {
        "IDFigura": 93,
        "OreGiornaliere": "07:30:00",
        "LunediLavorativo": true,
        "MartediLavorativo": true,
        "MercolediLavorativo": true,
        "GiovediLavorativo": true,
        "VenerdiLavorativo": true,
        "SabatoLavorativo": false,
        "DomenicaLavorativo": false
    },
    "giorni": [
        {
            "bloccato": true,
            "attivita": [   {
                    "idCliente": "4NsAaujLgCCq%2fCAmAF3GUQ%3d%3d",
                    "id": "qaPz4VPKVs55J%2fgZ%2bA%2fQLw%3d%3d",
                    "commessa": "ATTIVITA' COMMERCIALE",
                    "idCommessa": "yl7v1I7ONjBwBWa64%2fN9mQ%3d%3d",
                    "codiceCommessa": 697,
                    "descrizioneAttivita": "commerciale",
                    "daFatturare": false,
                    "trasferta": false,
                    "cliente": "AC&D Solutions",
                    "tipoAttivita": "Interna",
                    "note": "",
                    "totaleOre": "07:30:00",
                    "oreOrdinarie": "07:30: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": [],
            "tasks": [],
            "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": "2022-01-01T00:00:00",
            "oreGiustificateTimbrature": "00:00:00",
            "totaleOreRecuperate": 0.0,
            "totaleOre": 0.0,
            "totaleOreGustificativi": 0.0,
            "totaleOreGustificativiApprovateRichieste": 0.0,
            "totaleOreLavorate": 0.0,
            "totaleOreTasks": 0.0,
            "totaleOreOrdinarie": 0.0,
            "totaleOredaRecuperareTask": "00:00:00",
            "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,
            "totaleOreOrdinarieConTasks": "00:00:00",
            "totaleOreOrdinarieTasks": "00:00:00",
            "totaleOreInterventoReperibilitaTasks": "00:00:00",
            "totaleOreInterventoReperibilitaNotturnaTasks": "00:00:00",
            "totaleOreReperibilitaTasks": "00:00:00",
            "totaleOreStraordinarioNotturnoTasks": "00:00:00",
            "totaleOreStraordinarioTasks": "00:00:00"
        },
        
    ],
    "giorniFestivi": [
        "2022-01-01T00:00:00",
        "2022-01-02T00:00:00",
        "2022-01-06T00:00:00",
        "2022-01-09T00:00:00",
        "2022-01-16T00:00:00",
        "2022-01-23T00:00:00",
        "2022-01-30T00:00:00"
    ],
    "giorniFestiviCompleti": [
        {
            "giorno": "2022-01-01T00:00:00",
            "descrizione": "1 Gennaio"
        },
        {
            "giorno": "2022-01-02T00:00:00",
            "descrizione": ""
        },
        {
            "giorno": "2022-01-06T00:00:00",
            "descrizione": "Epifania"
        },
        {
            "giorno": "2022-01-09T00:00:00",
            "descrizione": ""
        },
        {
            "giorno": "2022-01-16T00:00:00",
            "descrizione": ""
        },
        {
            "giorno": "2022-01-23T00:00:00",
            "descrizione": ""
        },
        {
            "giorno": "2022-01-30T00:00:00",
            "descrizione": ""
        }
    ],
    "giorniLavorativi": [
        "2022-01-03T00:00:00",
        "2022-01-04T00:00:00",
        "2022-01-05T00:00:00",
        "2022-01-06T00:00:00",
        "2022-01-07T00:00:00",
        "2022-01-10T00:00:00",
        "2022-01-11T00:00:00",
        "2022-01-12T00:00:00",
        "2022-01-13T00:00:00",
        "2022-01-14T00:00:00",
        "2022-01-17T00:00:00",
        "2022-01-18T00:00:00",
        "2022-01-19T00:00:00",
        "2022-01-20T00:00:00",
        "2022-01-21T00:00:00",
        "2022-01-24T00:00:00",
        "2022-01-25T00:00:00",
        "2022-01-26T00:00:00",
        "2022-01-27T00:00:00",
        "2022-01-28T00:00:00",
        "2022-01-31T00:00:00"
    ],
    "risorsa": "Allasia Edoardo",
    "dataInzio": "2022-01-01T00:00:00",
    "dataFine": "2022-01-31T00:00:00",
    "timbratureAbilitate": false,
    "oreDaRecuperare": "00:00:00",
    "oreRecuperate": "00:00:00",
    "oreDaRecuperareRimanenti": "00:00:00",
    "totaleOre": 150.0,
    "totaleOreTasks": 0.0,
    "totaleOreOrdinarie": 120.0,
    "totaleOreDaRecuperare": 0.0,
    "totaleOreRecuperate": 0.0,
    "totaleOreStraordinario": 0.0,
    "totaleOreStraordinarioFestivo": 0.0,
    "totaleOreInterventoReperibilitaFestiva": 0.0,
    "totaleOreInterventoReperibilita": 0.0,
    "totaleOreInterventoReperibilitaNotturne": 0.0,
    "totaleOreReperibilita": 0.0,
    "totaleOreReperibilitaFestiva": 0.0,
    "totaleOreStraordinarioNotturno": 0.0,
    "totaleOreLavorate": 120.0,
    "totaleTrasferte": 0,
    "totaleOreGiustificativi": 30.0,
    "totaleDiarie": 0
}

In caso di errore:

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