Interrogazione Commesse

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:

  • commesse metodo che consente di estrarre i dati delle commesse
  • tipologieCommesse metodo che consente di estrarre tutte le tipologie delle commesse
  • tipologieAttivita metodo che consente di estrarre tutte le tipologie di attività


commesse POST

application/json

{
    "filtri":
    {
        "ID":"1368",
        "dataInizioDa":"2024-01-01",
        "dataInizioA":"2024-12-31",
        "dataFineDa":"2024-01-01",
        "dataFineA":"2024-12-31",
        "stato":"A",
        "idTipoAttivita":"13",
        "idTipologia":"29",
        "descrizione":"manute"
    }, 
    "pagina":1,
    "recordPerPagina":200
}

descrizione dei parametri

parametro descrizione default obbligatorio
ID Identificativo della commessa
dataInizioDa Data di inizio della commessa da
dataInizioA Data di inizio della commessa a 8
stato Data di finedella commessa da
dataFineA Data di fine della commessa a
stato Stato della commessa: A = Aperta, C=Chiusa, S=Standby, I = In chiusura
descrizione Descrizione della commessa
idTipoAttivita Tipo dell'attività della commessa recuperabile con il metodo tipologieAttivita
idTipologia Tipo della commessa recuperabile con il metodo tipologieCommesse
pagina numero di pagina richiesto 1
recordPerPagina numero record per pagina di ritorno 50



In caso di successo:

{
    "parametriDiRicerca": {
        "filtri": {
            "id": 1368,
            "descrizione": "manute",
            "idTipologia": 29,
            "idTipoAttivita": 13,
            "stato": "A",
            "dataInizioDa": "2024-01-01T00:00:00",
            "dataInizioA": "2024-12-31T00:00:00",
            "dataFineDa": null,
            "dataFineA": null
        },
        "pagina": 1,
        "recordPerPagina": 50
    },
    "totaleRecordRicerca": 1,
    "totaleRecord": 1,
    "commesse": [
        {
            "id": 1368,
            "descrizione": "Manutenzione Cash In e MyStore",
            "stato": "A",
            "dataInizio": "2024-04-01T00:00:00",
            "dataFineEffettiva": null,
            "dataFinePrevista": null,
            "tipologia": {
                "id": 29,
                "descrizione": "FBK_AM_PRJ"
            },
            "capoProgetto": {
                "id": 1158,
                "cognome": "FRANZETTI",
                "nome": "ALESSANDRO DAVIDE"
            },
            "responsabileDiStruttura": {
                "id": 1325,
                "cognome": "TENIVELLA",
                "nome": "EUGENIO"
            },
            "unitaOrganizzative": [
                {
                    "id": 183,
                    "codice": "FK0078",
                    "nome": "FK0078 - FBK IN STORE SOLUTIONS",
                    "dallaData": "2024-04-30T00:00:00"
                }
            ],
            "cliente": {
                "id": 90,
                "descrizione": "Fabrick Spa"
            },
            "tipoAttivita": {
                "id": 13,
                "descrizione": "Manutenzione Corr.ed Evo. Progetto"
            },
            "attivita": [
                {
                    "id": 8130,
                    "descrizione": "ANALISI E DOCUMENTAZIONE PRD - FBK POS",
                    "percentualeCostoCapitabizzabile": 0.0,
                    "tipoAttivita": {
                        "id": 12,
                        "descrizione": "Manutenzione  Evolutive  Prodotto"
                    }
                },
                {
                    "id": 8131,
                    "descrizione": "ANALISI E DOCUMENTAZIONE PRD - FBK Cash-In",
                    "percentualeCostoCapitabizzabile": 0.0,
                    "tipoAttivita": {
                        "id": 12,
                        "descrizione": "Manutenzione  Evolutive  Prodotto"
                    }
                },
              ...
            ],
            "prodotti": [
                {
                    "id": 145,
                    "codice": "FBK_API_ACTIVE_ENGINE_CORE",
                    "nome": "Active Engine - Core"
                },
                {
                    "id": 6068,
                    "codice": "FBK_PROD_POS",
                    "nome": "FBK POS"
                },
              ...
            ]
        }
    ]
}


In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore"
}
METODO HTTP Verb PARAMETRI RISULTATO
presenze POST

application/json

{
  "anno":2020,
  "mese":"1",
  "applicativoEsterno":"TeamSystem",
  "tipoRisorsa":"dipendente"
}

descrizione dei parametri

parametro descrizione default obbligatorio
anno Anno di estrazione SI
mese Mese di estrazione SI
applicativoEsterno nome applicativo Esterno di si cui è configurata la transcodifica in Cometa
tipoRisorsa valori possibili: dipendente, collaboratore, esterno



In caso di successo:

{
  "risorse": [
  {
   "id": 84,
   "codice": "99",
   "matricola": "XXX",
   "nome": "Paolo",
   "cognome": "Rossi",
   "codiceFiscale": "XXX",
   "email": "xxx@gmail.com",
   "nominativo": "Rossi Paolo",
   "giorni": [
    {
     "data": "2020-01-01T00:00:00",
     "giustificativi": [
      {
       "id": 3,
       "codice": "MAL",
       "descrizione": "Malattia",
       "minuti": 480
      }
     ],
     "timbrature": [
      {
       "ingresso": "2020-01-01T09:00:00",
       "uscita": "2020-01-01T12:45:00",
       "approvata": true,
       "minuti": 225
      },
      {
       "ingresso": "2020-01-01T14:00:00",
       "uscita": "2020-01-01T18:00:00",
       "approvata": false,
       "minuti": 240
      }
     ],
     "minutiOrdinari": 300,
     "minutiStraordinari": 20,
     "minutiStraordinariNotturni": 0,
     "minutiStraordinariFestivi": 0,
     "minutiStraordinariFestiviNotturni": 0,
     "minutiStraordinariFestiviDiurni": 0,
     "minutiReperibilita": 0,
     "minutiReperibilitaFestiva": 0
    },
     ...
   ]
  },
 ...
 ]
}

Il valore del campo codice della risorsa e della timbratura è il codice di transcodifica dell'applicativo impostato nei parametri e configurato in Cometa.

Le timbrature si popolano se la rirosa effettua le timbrature.

I campi dei minuti si popolano se la Risorsa compila il timesheet.

I giustificativi di popolano se si utilizza la funzionalità di gestione dei giustificativi in cometa.

In caso di errore:

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