Scadenze

GET

GET {base_url}/api/v1/scadenze

Restituisce l'elenco delle scadenze.

Payload risposta

Campo	Tipo	Formato	Descrizione
badge*	integer	-	Badge dell'utente L'utente è la persona fisica (dipendente/risorsa) associata a un'anagrafica identificata da badge, cognome e nome. È l'entità di riferimento a cui il sistema collega timbrature, cartellini, turni e giustificativi. a cui è assegnata la scadenza
cognome*	string	-	Cognome dell'utente L'utente è la persona fisica (dipendente/risorsa) associata a un'anagrafica identificata da badge, cognome e nome. È l'entità di riferimento a cui il sistema collega timbrature, cartellini, turni e giustificativi.
nome*	string	-	Nome dell'utente L'utente è la persona fisica (dipendente/risorsa) associata a un'anagrafica identificata da badge, cognome e nome. È l'entità di riferimento a cui il sistema collega timbrature, cartellini, turni e giustificativi.
scadenza*	string	-	Nome/descrizione della scadenza (es. "Visita medica")
data*	string	YYYY-MM-DD	Data di scadenza
ciclo*	string	"Annuale" | "Mensile" | "Nessuno" | "Personalizzato" | "Sconosciuto"	Tipo di ricorrenza della scadenza
stato*	string	"vistata" | "scaduta" | "in_scadenza"	Calcolato dal server: vistata se la scadenza è già stata presa in visione (vistato_il valorizzato); altrimenti scaduta se la data è nel passato, in_scadenza altrimenti
vistato_da	string	-	Nome di chi ha preso visione della scadenza
vistato_il	string	YYYY-MM-DD	Data in cui la scadenza è stata vistata
note	string	-	Note libere sulla scadenza
inserita_il*	string	YYYY-MM-DD	Data di inserimento della scadenza

Esempio

[
    {
        "badge": 12345,
        "cognome": "Rossi",
        "nome": "Mario",
        "scadenza": "Visita medica",
        "data": "2026-09-15",
        "ciclo": "Annuale",
        "stato": "in_scadenza",
        "vistato_da": null,
        "vistato_il": null,
        "note": null,
        "inserita_il": "2026-08-01"
    }
]

POST

POST {base_url}/api/v1/scadenze

Crea una nuova scadenza collegata a un utente

L'utente è la persona fisica (dipendente/risorsa) associata a un'anagrafica identificata da badge, cognome e nome. È l'entità di riferimento a cui il sistema collega timbrature, cartellini, turni e giustificativi.

. Se il nome scadenza indicato non esiste ancora nel catalogo interno, viene creato automaticamente con ciclo "Nessuno" — quel valore è solo il default del catalogo: il ciclo che conta per l'occorrenza appena creata è quello indicato nel body (o, se omesso, quello già presente nel catalogo per quel nome).

Payload richiesta

Campo	Tipo	Formato	Descrizione
data*	string	YYYY-MM-DD	Data di scadenza, non può essere nel passato
badge*	string	-	Badge dell'utente L'utente è la persona fisica (dipendente/risorsa) associata a un'anagrafica identificata da badge, cognome e nome. È l'entità di riferimento a cui il sistema collega timbrature, cartellini, turni e giustificativi. a cui collegare la scadenza (accetta anche una stringa numerica)
scadenza*	string	-	Nome della scadenza; se non esiste nel catalogo, viene creata
ciclo	string	"annuale" | "mensile"	Ciclo di ricorrenza. Se omesso, viene usato il ciclo già presente nel catalogo per quel nome scadenza (o "Nessuno" se il nome è nuovo)

Payload risposta

201 Created

Campo	Tipo	Formato	Descrizione
message*	string	-	Messaggio di conferma

Esempio

{ "message": "Scadenza creata con successo" }