Passa al contenuto principale

Commesse

GET​

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

Payload risposta​

CampoTipoFormatoDescrizione
codice*string-Codice della commessa
descrizione*string-Descrizione della commessa
codice_estesostring-Codice esteso alternativo
codice_qrstring-Codice associato al QR code per la timbratura di attività
dalstringYYYY-MM-DDData di inizio validità
alstringYYYY-MM-DDData di fine validità
chiusa*boolean-Se true la commessa è chiusa e non può essere utilizzata
arrotondamento*stringHH:mmValore di arrotondamento dei tempi
tolleranza*stringHH:mmTolleranza 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
specificastring-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 commessa non può essere utilizzata
gruppo_fase*string[]-Codici dei gruppi fase a cui questa commessa è associata

Esempio​

[
{
"codice": "COMM01",
"descrizione": "Cliente Rossi",
"codice_esteso": null,
"codice_qr": null,
"dal": null,
"al": null,
"chiusa": false,
"arrotondamento": "00:05",
"tolleranza": "00:02",
"gestione_secondi": "1",
"specifica": null,
"specifica_obbligatoria": false,
"lista_specifica": [],
"postazioni_disabilitate": [],
"gruppo_fase": [
"GFAMM"
]
}
]

PUT​

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

Payload richiesta​

CampoTipoFormatoDescrizione
descrizione*string-Descrizione della commessa
codice_estesostring-Codice esteso alternativo
codice_qrstring-Codice associato al QR code per la timbratura di attività
dalstringYYYY-MM-DDData di inizio validità
alstringYYYY-MM-DDData di fine validità
chiusaboolean-Se true la commessa è chiusa e non può essere utilizzata. Default false
arrotondamentostring"00:00" | "00:01" | "00:05" | "00:10" | "00:15" | "00:20" | "00:30" | "01:00"Valore di arrotondamento dei tempi. Default 00:00
tolleranzastring"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_secondiinteger"1" | "2" | "3"Modalità di gestione dei secondi: 1 approssimati, 2 sempre in eccesso, 3 sempre in difetto. Default 1
specificastring-Etichetta del campo aggiuntivo richiesto in fase di timbratura
specifica_obbligatoriaboolean-Se true il campo specifica è obbligatorio in fase di timbratura. Default false
lista_specificastring[]-Elenco dei valori ammessi per specifica, per proporla come lista a scelta invece che campo libero
postazioni_disabilitatestring[]-Codici dei terminali su cui questa commessa non può essere utilizzata (devono esistere)
gruppo_fasestring[]-Codici dei gruppi fase da associare alla commessa (devono esistere)

Payload risposta​

200 OK | 201 Created

CampoTipoFormatoDescrizione
message*string-Messaggio di conferma

Esempio​

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

DELETE​

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

Payload risposta​

200 OK

CampoTipoFormatoDescrizione
message*string-Messaggio di conferma

Esempio​

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