Fasi

GET

GET {base_url}/api/v1/attivita/fasi

Payload risposta

Campo	Tipo	Formato	Descrizione
codice*	string	-	Codice della fase
descrizione*	string	-	Descrizione della fase
codice_esteso	string	-	Codice esteso alternativo
codice_qr	string	-	Codice associato al QR code per la timbratura di attività
dal	string	YYYY-MM-DD	Data di inizio validità
al	string	YYYY-MM-DD	Data di fine validità
chiusa*	boolean	-	Se true la fase è chiusa e non può essere utilizzata
arrotondamento*	string	HH:mm	Valore di arrotondamento dei tempi
tolleranza*	string	HH:mm	Tolleranza applicata insieme all'arrotondamento
gestione_secondi*	string	"1" | "2" | "3"	Modalità di gestione dei secondi nel calcolo del tempo: 1 approssimati, 2 sempre arrotondati per eccesso, 3 sempre arrotondati per difetto
tempo_minimo	string	HH:mm:ss	Tempo minimo atteso per lo svolgimento della fase
simbolo_tempo_minimo*	string	"0" | "1" | "2"	Simbolo mostrato se la fase è stata svolta in un tempo inferiore a tempo_minimo: 0 positivo, 1 negativo, 2 nessun simbolo
tempo_massimo	string	HH:mm:ss	Tempo massimo atteso per lo svolgimento della fase
simbolo_tempo_massimo*	string	"0" | "1" | "2"	Simbolo mostrato se la fase è stata svolta in un tempo superiore a tempo_massimo: 0 positivo, 1 negativo, 2 nessun simbolo
soglia_minima	string	HH:mm:ss	Se il totale del tempo lavorato non supera questa soglia, viene considerato a 00:00:00
soglia_massima	string	HH:mm:ss	Il tempo lavorato che supera questa soglia non viene considerato
specifica	string	-	Etichetta del campo aggiuntivo richiesto in fase di timbratura
specifica_obbligatoria*	boolean	-	Se true il campo specifica è obbligatorio in fase di timbratura
lista_specifica*	string[]	-	Elenco dei valori ammessi per specifica, se configurata come lista a scelta invece che campo libero
postazioni_disabilitate*	string[]	-	Codici dei terminali su cui questa fase non può essere utilizzata
causale_presenza	string	-	Giustificativo Il giustificativo classifica e motiva quantitativi orari o fasce di tempo, lavorate o non lavorate, attribuite al cartellino di un utente nel corso del mese, concorrendo al calcolo dei totalizzatori mensili. Alcuni esempi possono essere ferie, permesso, malattia, straordinario, ecc... associato alla fase: timbrando la fase viene inserita automaticamente una timbratura di presenza La timbratura di presenza è l'evento di entrata/uscita rilevato per un utente (da terminale, badge, online o altra fonte). Questo dato grezzo viene poi elaborato per calcolare risultati specifici per l'utente nel giorno. causalizzata con questo giustificativo Il giustificativo classifica e motiva quantitativi orari o fasce di tempo, lavorate o non lavorate, attribuite al cartellino di un utente nel corso del mese, concorrendo al calcolo dei totalizzatori mensili. Alcuni esempi possono essere ferie, permesso, malattia, straordinario, ecc...

Esempio

[
    {
        "codice": "FAS01",
        "descrizione": "Montaggio",
        "codice_esteso": null,
        "codice_qr": null,
        "dal": null,
        "al": null,
        "chiusa": false,
        "arrotondamento": "00:05",
        "tolleranza": "00:02",
        "gestione_secondi": "1",
        "tempo_minimo": null,
        "simbolo_tempo_minimo": "2",
        "tempo_massimo": null,
        "simbolo_tempo_massimo": "2",
        "soglia_minima": null,
        "soglia_massima": null,
        "specifica": null,
        "specifica_obbligatoria": false,
        "lista_specifica": [],
        "postazioni_disabilitate": [],
        "causale_presenza": null
    }
]

PUT

PUT {base_url}/api/v1/attivita/fasi/{codice}

Payload richiesta

Campo	Tipo	Formato	Descrizione
descrizione*	string	-	Descrizione della fase
codice_esteso	string	-	Codice esteso alternativo
codice_qr	string	-	Codice associato al QR code per la timbratura di attività
dal	string	YYYY-MM-DD	Data di inizio validità
al	string	YYYY-MM-DD	Data di fine validità
chiusa	boolean	-	Se true la fase è chiusa e non può essere utilizzata. Default false
arrotondamento	string	"00:00" | "00:01" | "00:05" | "00:10" | "00:15" | "00:20" | "00:30" | "01:00"	Valore di arrotondamento dei tempi. Default 00:00
tolleranza	string	"00:00" | "00:02" | "00:03" | "00:04" | "00:05" | "00:10" | "00:15" | "00:20" | "00:30" | "01:00"	Tolleranza applicata insieme all'arrotondamento. Default 00:00
gestione_secondi	integer	"1" | "2" | "3"	Modalità di gestione dei secondi: 1 approssimati, 2 sempre in eccesso, 3 sempre in difetto. Default 1
tempo_minimo	string	HH:mm o HH:mm:ss	Tempo minimo atteso per lo svolgimento della fase
simbolo_tempo_minimo	integer	"0" | "1" | "2"	Simbolo da mostrare se il tempo è inferiore a tempo_minimo: 0 positivo, 1 negativo, 2 nessuno. Default 0
tempo_massimo	string	HH:mm o HH:mm:ss	Tempo massimo atteso per lo svolgimento della fase
simbolo_tempo_massimo	integer	"0" | "1" | "2"	Simbolo da mostrare se il tempo è superiore a tempo_massimo: 0 positivo, 1 negativo, 2 nessuno. Default 0
soglia_minima	string	HH:mm o HH:mm:ss	Soglia minima di conteggio del tempo lavorato
soglia_massima	string	HH:mm o HH:mm:ss	Soglia massima di conteggio del tempo lavorato
specifica	string	-	Etichetta del campo aggiuntivo richiesto in fase di timbratura
specifica_obbligatoria	boolean	-	Se true il campo specifica è obbligatorio in fase di timbratura. Default false
lista_specifica	string[]	-	Elenco dei valori ammessi per specifica, per proporla come lista a scelta invece che campo libero
postazioni_disabilitate	string[]	-	Codici dei terminali su cui questa fase non può essere utilizzata (devono esistere)
causale_presenza	string	-	Codice di un giustificativo Il giustificativo classifica e motiva quantitativi orari o fasce di tempo, lavorate o non lavorate, attribuite al cartellino di un utente nel corso del mese, concorrendo al calcolo dei totalizzatori mensili. Alcuni esempi possono essere ferie, permesso, malattia, straordinario, ecc... automatico esistente da associare alla fase

Payload risposta

200 OK | 201 Created

Campo	Tipo	Formato	Descrizione
message*	string	-	Messaggio di conferma

Esempio

{ "message": "Fase aggiornata con successo" }

DELETE

DELETE {base_url}/api/v1/attivita/fasi/{codice}

Payload risposta

200 OK

Campo	Tipo	Formato	Descrizione
message*	string	-	Messaggio di conferma

Esempio

{ "message": "Fase eliminata con successo" }