Utenti

GET

GET {base_url}/api/v1/utenti

Restituisce l'elenco degli utenti

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.

, inclusi quelli cancellati. I campi relativi ai dati anagrafici aggiuntivi (residenza, domicilio, dati di nascita, sesso, stato civile, nazionalità, telefono, cellulare, IBAN) sono presenti solo se l'azienda ha abilitato il modulo "dati aggiuntivi": se il modulo non è abilitato, questi campi non compaiono nella risposta.

Payload risposta

Campo	Tipo	Formato	Descrizione
azienda*	string	-	Nome dell'azienda a cui appartiene l'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.
sede*	string	-	Sede di lavoro 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.
reparto*	string	-	Reparto di appartenenza 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.
qualifica	string	-	Qualifica 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.
centro_di_costo	string	-	Centro di costo a cui è associato l'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.
gruppo_orario*	string	-	Gruppo orario Il gruppo orario definisce la programmazione ciclica che assegna un orario di lavoro a ciascun giorno della settimana, considerando anche i festivi, al cartellino degli utenti associati. assegnato all'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.
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.
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.
codice_fiscale	string	-	Codice fiscale 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.
email	string	-	Indirizzo email 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.
username	string	-	Nome 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. usato per l'accesso
note	string	-	Note libere sull'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.
assunzione*	string	YYYY-MM-DD	Data di assunzione
licenziamento	string	YYYY-MM-DD	Data di cessazione del rapporto di lavoro, se presente
codice_paghe	string	-	Codice identificativo 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. nel sistema paghe
ultimo_accesso	string	YYYY-MM-DD HH:mm:ss	Data e ora dell'ultimo accesso 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.
commento_cartellino	string	-	Commento visibile sul cartellino 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.
commento_foglio	string	-	Commento visibile sul foglio presenze Il foglio ore presenze è un report che riporta, per ogni dipendente, le ore lavorate, i permessi, le ferie, la malattia e le ore di straordinario, con il dettaglio giornaliero e il totale mensile. Costituisce la base di calcolo per generare il LUL, cioè il Libro Unico del Lavoro, e per gestire la contabilità del personale. 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.
residenza	string	-	Indirizzo di residenza
citta_residenza	string	-	Città di residenza
provincia_residenza	string	-	Provincia di residenza
cap_residenza	string	-	CAP di residenza
domicilio	string	-	Indirizzo di domicilio
citta_domicilio	string	-	Città di domicilio
provincia_domicilio	string	-	Provincia di domicilio
cap_domicilio	string	-	CAP di domicilio
luogo_nascita	string	-	Luogo di nascita
data_nascita	string	YYYY-MM-DD	Data di nascita
sesso*	string	"Maschio" | "Femmina" | "Altro"	Sesso 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. . Restituito come "Maschio" quando il dato non è impostato
stato_civile	string	-	Stato civile 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.
nazionalita	string	-	Nazionalità 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.
telefono	string	-	Numero di telefono fisso
cellulare	string	-	Numero di cellulare
iban	string	-	IBAN 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.

Esempio

[
    {
        "azienda": "Azienda Demo",
        "sede": "Sede Centrale",
        "reparto": "Produzione",
        "qualifica": "Operaio",
        "centro_di_costo": "CDC01",
        "gruppo_orario": "Orario Standard",
        "badge": 12345,
        "cognome": "Rossi",
        "nome": "Mario",
        "codice_fiscale": "RSSMRA80A01H501U",
        "email": "mario.rossi@example.com",
        "username": "mrossi",
        "note": null,
        "assunzione": "2020-01-15",
        "licenziamento": null,
        "codice_paghe": "0001",
        "ultimo_accesso": "2026-08-30 08:15:00",
        "commento_cartellino": null,
        "commento_foglio": null,
        "residenza": "Via Roma 1",
        "citta_residenza": "Milano",
        "provincia_residenza": "MI",
        "cap_residenza": "20100",
        "domicilio": null,
        "citta_domicilio": null,
        "provincia_domicilio": null,
        "cap_domicilio": null,
        "luogo_nascita": "Milano",
        "data_nascita": "1980-01-01",
        "sesso": "Maschio",
        "stato_civile": "Coniugato/a",
        "nazionalita": "Italiana",
        "telefono": null,
        "cellulare": "3331234567",
        "iban": "IT60X0542811101000000123456"
    }
]