Differenze tra le versioni di "Interrogazione Commesse"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
Riga 245: Riga 245:
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
  
<b>presenze</b></td>
+
<b>tipologieAttivita</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;'>POST</td>
  
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                  <b>application/json</b>
 
                  <b>application/json</b>
                    <pre>
+
                 
{
 
  "anno":2020,
 
  "mese":"1",
 
  "applicativoEsterno":"TeamSystem",
 
  "tipoRisorsa":"dipendente"
 
}
 
 
 
</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 di estrazione</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 di estrazione</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>applicativoEsterno</b></td>
 
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>nome applicativo Esterno di si cui è configurata la transcodifica in Cometa</span></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>
 
                        </tr>
 
                        <tr>
 
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>tipoRisorsa</b></td>
 
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>valori possibili: dipendente, collaboratore, esterno</span></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>
 
                        </tr>
 
                    </table>
 
 
 
 
 
           
 
 
 
 
                 </td>
 
                 </td>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top; width:400px'>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top; width:400px'>
Riga 303: Riga 256:
  
 
                     <pre>
 
                     <pre>
{
+
[
  "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",
+
        "id": 6,
    "giustificativi": [
+
        "descrizione": "Business Development",
      {
+
        "capitabizzabile": false,
      "id": 3,
+
        "diProdotto": false
      "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
 
 
     },
 
     },
    ...
+
    {
  ]
+
        "id": 1,
  },
+
        "descrizione": "Cloud Service",
...
+
        "capitabizzabile": false,
]
+
        "diProdotto": false
}
+
    },
 
+
    {
Il valore del campo codice della risorsa e della timbratura è il codice di transcodifica dell'applicativo impostato nei parametri e configurato in Cometa.
+
        "id": 7,
 
+
        "descrizione": "Consulting",
Le timbrature si popolano se la rirosa effettua le timbrature.
+
        "capitabizzabile": false,
 +
        "diProdotto": false
 +
    },
 +
...
 +
]
  
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.
 
 
</pre>
 
</pre>
 
                     <p>In caso di errore:</p>
 
                     <p>In caso di errore:</p>

Versione delle 12:08, 9 mag 2024

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à


METODO HTTP Verb PARAMETRI RISULTATO
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"
}
tipologieAttivita POST

application/json

In caso di successo:

[
    {
        "id": 6,
        "descrizione": "Business Development",
        "capitabizzabile": false,
        "diProdotto": false
    },
    {
        "id": 1,
        "descrizione": "Cloud Service",
        "capitabizzabile": false,
        "diProdotto": false
    },
    {
        "id": 7,
        "descrizione": "Consulting",
        "capitabizzabile": false,
        "diProdotto": false
    },
...
]


In caso di errore:

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