Integrazione JIRA

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:

  • jira/commesse Consente di recuperare la lista delle commesse da indicare nella creazione del task
  • jira/task consenti di inserire/modificare i task


METODO HTTP Verb PARAMETRI RISULTATO
jira/commesse POST

application/json

{
    "filtri":
    {
        "stato":"A",
        "descrizione":"XXX",
        "id":"234"
    },
    "pagina":"1",
    "recordPerPagina":"100"

    
}

descrizione dei parametri

parametro descrizione default obbligatorio
stato stato della commessa. Può assumere i seguneti valori: A (Aperta), C (Chiusa), S (StandBy)
descrizione descrizione della commessa
id id della commessa/span>

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",
        "escludiDatiEconomici":"false",
	"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",
	"CodiceUnitaOrganizzativa":"UO123",
	"UnitaOrganizzativa":"Impianti",
        "inviaMailCredenziali":"true"
}

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 dipendente in modifica se non specificato non viene variato
contratto contratto della risorsa SI in inserimento
gruppi gruppi di COMETA a cui associare la risorsa
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
codiceUnitaOrganizzativa codice dell'Unità Organizzativa
unitaOrganizzativa nome dell'Unità Organizzativa
inviaMailCredenziali Indica se inviare le credenziali all'utente in fase di inserimento false

La data è nel fomato ISO yyyy-mm-dd
Date valide possono essere:

  • 2017-12-5
  • 2020-01-25

In seguito all'inserimento di una nuova risorsa viene inviata automaticamente all'utente una mail con le credenziali e il link per l'accesso al sistema.


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
}
notespesa POST

application/json

{
	"matricola":"AAA",
	"data":"2020-01-04",
	"id":"XXXX",
	"causale":"Pranzo",
	"importoUnitario":12.5,
	"quantita": 1,
	"aziendale":false
}

descrizione dei parametri

parametro descrizione default obbligatorio
matricola matricola della risorsa SI
data data della spesa SI
id identificativo della spesa SI
causale causale della spesa SI
importoUnitario importo unitario della spesa SI
quantita quantità oggetto della spesa SI
aziendale spesa già sostenuta dall'azienda

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
}


In caso di errore:

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