Differenze tra le versioni di "Importazione dati"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
Riga 156: Riga 156:
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                     <p>  In caso di successo:</p>
 
                     <p>  In caso di successo:</p>
 +
<nowrap>
 
                     <pre>
 
                     <pre>
 
{
 
{
Riga 170: Riga 171:
 
}
 
}
 
</pre>
 
</pre>
 
+
</nowrap>
 
                 </td>
 
                 </td>
  

Versione delle 15:38, 24 mar 2020

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

Metodi presenti un questa sezione:

  • timbrature/inserimento metodo per inserire le timbrature e in generale le ore della risorsa compresi quindi anche le ore giustificate

METODO HTTP Verb PARAMETRI RISULTATO
timbrature/inserimento POST, GET

application/json

{
   "data":"2020-03-02",
   "matricola":"200",
   "timbrature":[
      {
         "causale":"FERIE",
         "descrizione":"Ferie",
         "minuti":"120"
      },
      {
         "causale":"ORD",
         "descrizione":"Ore ordinarie",
         "minuti":"180"
      },
      {
         "causale":"STRA",
         "descrizione":"Ore straordinario",
         "minuti":"3"
      },
      {
         "ingresso":"true",
         "minuti":"1000"
      },
      {
         "uscita":"true",
         "minuti":"1123"
      }
   ]
}

                   descrizione dei parametri
parametro descrizione default obbligatorio
data Data di riferimento della timbratura/ore SI
matricola matricola della risorsa SI
timbrature array di oggetti ti tipo timbratura SI

La data è nel fomato ISO yyyy-mm-dd
Date valide possono essere:
  • 2017-12-5
  • 2020-01-25
                   
L'oggetto timbratura contiene i seguenti campi:
parametro descrizione default obbligatorio
causale Codice che identifica la tipologia di ore SI
descrizione descrizione della tipologia di ore
minuti numero di minuti SI
entrata identifica un timbratura di ingresso
uscita identifica un timbratura in uscita
                   

L'oggetto timbratura può essere utilizzato per passare le timbrature così come sono state ricevute dal sistema di rilevamento delle presente, ossia indicando "ingresso", "uscita". Il numero di timbrature in ingresso deve essere uguale al numero di timbrature in uscita. In questo caso si può omettere la causale in quanto sarà COMETA ad associare le ore alla causale configurata come marcatura.
Le ore saranno calcolare come differenza tra i minuti di uscita e i minuti di ingresso.

Più in generale se non si vuole utilizzare il sistema di ingresso e uscita, e per tutte le ore che non possono essere gestite da un sistema di rilevamento delle presenze come ad esempio i giustificativi occorre specificare la causale con la relativa descrizione e in questo caso le ore saranno calcolatre sulla base dei minuti.

Attenzione!
Tutte le causali che non sono presenti in COMETA saranno aggiunte in automatico e impostate come ore ordinarie.
Il consiglio è quindi quello di andare a configurare correttamente ogni causale in COMETA al termine della prima importazione o comunque verificare che in COMETA siano configurate bene tutte le causali.


In caso di successo:

<nowrap>

{
  "successo": true,
  "messaggio": null
}

In caso di errore:

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

</nowrap>