Passa al contenuto principale

Attivita

GET​

GET {base_url}/api/v1/attivita

Restituisce l'elenco delle attività (interventi su commessa e fase) registrate dai terminali o inserite manualmente.

Payload risposta​

CampoTipoFormatoDescrizione
badge*integer-Badge dell'utente a cui è associata l'attività
inizio*stringYYYY-MM-DD HH:mm:ssData e ora di inizio dell'attività
finestringYYYY-MM-DD HH:mm:ssData e ora di fine dell'attività, se conclusa
codice_commessa*string-Codice della commessa
specifica_commstring-Specifica della commessa
codice_fase*string-Codice della fase
specifica_fasestring-Specifica della fase
terminaleinteger-Identificativo del terminale su cui è stata registrata l'attività
tipo_attivita*string"0" | "1" | "2" | "3"Origine del dato: 0 rilevata in tempo reale da terminale, 1 rapportino in bozza, 2 rapportino salvato, 3 inserita manualmente

Esempio​

[
    {
        "badge": 12345,
        "inizio": "2026-08-31 08:30:00",
        "fine": "2026-08-31 12:00:00",
        "codice_commessa": "COMM01",
        "specifica_comm": null,
        "codice_fase": "01",
        "specifica_fase": null,
        "terminale": 1,
        "tipo_attivita": "0"
    }
]

POST​

POST {base_url}/api/v1/attivita

Registra un'attività svolta da un utente

su una commessa e una fase. Con tipo_attivita 0 si registra un transito: se manca la fine, l'attività resta aperta fino al transito successivo dell'utente. Con tipo_attivita 2 l'attività va indicata con inizio e fine. L'attività non è disponibile immediatamente: viene acquisita dalla successiva importazione automatica delle timbrature, di norma entro qualche minuto.

Payload richiesta​

CampoTipoFormatoDescrizione
badge*integer-Badge dell'utente; l'utente deve esistere ed essere abilitato alle attività
inizio*stringYYYY-MM-DD HH:mm:ssData e ora di inizio dell'attività; non può essere precedente all'assunzione dell'utente né oltre il periodo di storico gestito
finestringYYYY-MM-DD HH:mm:ssData e ora di fine dell'attività, obbligatoria con tipo_attivita 2; deve essere successiva all'inizio, non nel futuro e non successiva al licenziamento dell'utente
codice_commessa*string-Codice della commessa; deve essere aperta, valida nelle date dell'attività e associata all'utente. Le commesse di presenza 0000 e 9999 non sono ammesse
specifica_commstring-Specifica della commessa, massimo 50 caratteri, senza ; né a capo
codice_fase*string-Codice della fase; deve essere aperta, valida nelle date dell'attività e associata all'utente e alla commessa. Le fasi di presenza 0000 e 9999 non sono ammesse
specifica_fasestring-Specifica della fase, massimo 50 caratteri, senza ; né a capo
terminaleinteger-Identificativo del terminale da associare all'attività. Se omesso viene usato 9996
tipo_attivita*string"0" | "2"Origine del dato: 0 transito da terminale, 2 rapportino salvato

Payload risposta​

202 Accepted

CampoTipoFormatoDescrizione
message*string-Messaggio di conferma

Esempio​

{ "message": "Attività ricevuta, verrà importata a breve" }