Importazione dati

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

Metodi presenti un questa sezione:

• timbrature metodo per inserire le timbrature e in generale le ore della risorsa comprese quindi anche le ore giustificate
• risorse metodo per inserire/aggiornare le risorse. COMETA capisce in automatico quando inserire o aggiornare una risorsa in base alla matricola.

METODO	HTTP Verb	PARAMETRI	RISULTATO
timbrature	POST	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: { "successo": true, "messaggio": null } In caso di errore: { "successo": false, "messaggio": "Descrizione dell'errore" }
risorse	POST	application/json { "matricola":"AAA", "nome":"Mimmo", "cognome":"Tartaglia", "mailAziendale":"test@outlook.it", "tipo":"dipendente", "contratto": "Dipendente in prova", "gruppi":["gruppo1", "gruppo2"], "sede":"Bari", "retribuzioneAnnualeLorda":"50000", "rimborsoKmMensile":"1000", "indennitaTrasfertaMensile":"1000", "altroMensile":"1500", "rimborsoFissoAnnuale":"5000", "codiceFiscale":"prnmnl87l34ifhg7", "indirizzo":"via di casa sua", "civico":"14", "comune":"Modena", "provincia": "MO", "cap":"41122", "luogoDiNascita":"Sassuolo", "dataAssunzione":"2017-01-01", "dataLicenziamento":"2021-01-01", "dataDiNascita":"1990-02-11", "buoniPasto":"false", "cellulareAziendale":"2342342342", "cellularePersonale":"62345235323", "mailPec":"test@test.it", "mailPersonale":"test@test.it" } descrizione dei parametri parametro descrizione default obbligatorio matricola matricola della risorsa SI nome nome della risorsa SI in inserimento cognome cognome della risorsa SI in inserimento mailAziendale mail aziendale della risorsa SI in inserimento tipo tipologia risorsa: dipendente, collaboratore, esterno SI in inserimento contratto contratto della risorsa SI in inserimento gruppi gruppi di COMETA a cui associare la risorsa SI in inserimento sede sede della risorsa SI in inserimento retribuzioneAnnualeLorda retribuzione annuale lorda della risorsa rimborsoKmMensile rimborso Km mensile della risorsa indennitaTrasfertaMensile indennità di trasferta mensile della risorsa altroMensile altro mensile lorda della risorsa rimborsoFissoAnnuale rimborso fisso annuale lorda della risorsa codiceFiscale codice fiscale della risorsa indirizzo indirizzo della risorsa indirizzo indirizzo della risorsa civico civico della risorsa comune comune della risorsa provincia provincia della risorsa cap cap della risorsa luogoDiNascita luogo di nascita della risorsa dataAssunzione data assunzione della risorsa dataLicenziamento data licenziamento della risorsa dataDiNascita data di nascita della risorsa buoniPasto buoni pasto spettanti cellulareAziendale cellulare aziendale della risorsa cellularePersonale cellulare personale della risorsa mailPec PEC della risorsa mailPersonale mail personale della risorsa La data è nel fomato ISO yyyy-mm-dd Date valide possono essere: 2017-12-5 2020-01-25	In caso di successo: { "successo": true, "messaggio": null, "operazioneEseguita": "INSERIMENTO", "username": null, "mailCredenzialiInviata": false } Il campo operazioneEseguita può avere i seguenti valori: "INSERIMENTO", "AGGIORNAMENTO". Nel caso l'operazione eseguita sia "INSERIMENTO" il campo mailCredenzialiInviata a false indica che c'è stato un problema nell'invio della mail. In caso di errore: { "successo": false, "messaggio": "Descrizione dell'errore", "operazioneEseguita": null, "username": null, "mailCredenzialiInviata": false }