Commesse
GET
GET {base_url}/api/v1/attivita/commesse
Payload risposta
| Campo | Tipo | Formato | Descrizione |
|---|---|---|---|
codice* | string | - | Codice della commessa |
descrizione* | string | - | Descrizione della commessa |
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 commessa è 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 |
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 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
| Campo | Tipo | Formato | Descrizione |
|---|---|---|---|
descrizione* | string | - | Descrizione della commessa |
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 commessa è 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 |
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 commessa non può essere utilizzata (devono esistere) |
gruppo_fase | string[] | - | Codici dei gruppi fase da associare alla commessa (devono esistere) |
Payload risposta
200 OK | 201 Created
| Campo | Tipo | Formato | Descrizione |
|---|---|---|---|
message* | string | - | Messaggio di conferma |
Esempio
{ "message": "Commessa aggiornata con successo" }
DELETE
DELETE {base_url}/api/v1/attivita/commesse/{codice}
Payload risposta
200 OK
| Campo | Tipo | Formato | Descrizione |
|---|---|---|---|
message* | string | - | Messaggio di conferma |
Esempio
{ "message": "Commessa eliminata con successo" }