Vai al contenuto principale

L'export CSV dei dati di presenza

A cosa serve e cosa contiene l'export CSV dei dati di presenza

Scritto da Valentina Ariano

A seconda delle autorizzazioni, è possibile esportare i propri dati di presenza o di altre persone in diversi formati. Ad esempio, il formato CSV consente di ottenere un file testuale con i dati grezzi mensili delle presenze. 

Questo tipo di export è pensato per l’analisi e l’elaborazione dei dati tramite fogli di calcolo o programmi dedicati, e permette anche lo scambio di informazioni con altri software (ad esempio i software paghe) in grado di importare i dati di presenza in formato CSV.

💡 Per poter esportare i dati di presenza in formato CSV, è necessario che in azienda sia attiva l'estensione gratuita Export CVS Presenze. Leggi questo articolo per saperne di più sull'attivazione, configurazione e disattivazione delle estensioni.

Consulta la guida per sapere come esportare i dati di presenza.

Cosa contiene il file

Il file CSV riporta i dati di presenza mensili delle persone selezionate.

La struttura del file prevede una riga per ogni giorno di calendario esportato (e per ciascun giustificativo associato). Ogni riga è composta da più colonne, ciascuna dedicata a una specifica informazione. Di seguito, viene descritta nel dettaglio l’organizzazione del file.

Esempio di export CSV dei dati

di presenza mensili di un utente

Organizzazione delle colonne

Il file è strutturato in colonne fisse, che identificano le informazioni principali di ciascun record:

Codice azienda

L'ID esterno che identifica l’azienda per cui sono stati esportati i dati.

Codice utente

L'ID esterno che identifica la persona a cui si riferisce la riga.

Codice giustificativo

L'ID esterno che identifica la tipologia di presenza o assenza. Per le ore di lavoro ordinario viene utilizzato il valore 01.

Durata

Indica la quantità di tempo associata al giustificativo, espressa in minuti (es: 480 per 8 ore).

Data

Rappresenta il giorno di calendario a cui si riferisce il dato, espresso nel formato YYYYMMDD (es: 20250501 per l'1 maggio 2025).

Codice turno

L'ID esterno che identifica il turno previsto per quella giornata.

Organizzazione delle righe

Il file include una riga per ogni evento di presenza o assenza registrato nel calendario.

Per una stessa persona e nella stessa giornata possono quindi essere presenti più righe, ad esempio in caso di presenza ordinaria, lavoro extra o assenze.

I codici identificativi nell'export CSV

Nel file CSV, aziende, utenti e giustificativi sono identificati tramite codici (ID esterni) configurabili in Fluida. Se non sono già stati definiti per altre integrazioni, possono essere impostati liberamente, per rendere più chiaro e comprensibile il file esportato. Ad esempio:

Se il tuo consulente del lavoro utilizza un altro software in cui ha già inserito i codici identificativi di azienda, dipendenti e giustificativi, puoi chiedergli di comunicarteli per poterli usare anche in Fluida.

Nel file esportato, nel caso in cui alcuni elementi non abbiano un codice identificativo impostati, le relative colonne risulteranno vuote.

Esempio di file esportato

Per chiarire come si presenta il file dei dati di presenza mensili in formato CSV, ecco un esempio pratico basato sul calendario mensile reale di un dipendente.

Screenshot del calendario mensile del dipendente,

così come visibile da Fluida

🕒 Orario settimanale del dipendente

Il dipendente ha un orario di lavoro full-time, dal lunedì al venerdì, strutturato come segue:

  • Orario giornaliero: 09:00 – 18:00 (con 1 ora di pausa)

  • Ore settimanali attese: 40h

📌 Giustificativi inseriti nel calendario

Durante il mese esportato (maggio) sono stati inseriti i seguenti eventi di presenza/assenza:

Data

Giustificativo

Durata

Dettaglio

12–13–14 maggio

Malattia

24h

3 giorni completi

19 maggio

Permesso

4h

Mezza giornata

21 maggio

Straordinario

1h

1 ora extra

28 maggio

Ferie

8h

1 giorno completo

🔢 Codici ID

I codici ID impostati nel pannello di configurazione Fluida sono i seguenti:

Giustificativo

ID esterno

Ferie

FE

Malattia

MA

Permesso

PF

Straordinario

ST

Il codice azienda è LIMEWORK SRL.

Il codice dipendente è MARCO ALTENI.

📄 File esportato

Qui sotto è allegato l'export CSV dei dati di presenza del mese di maggio per l'utente:

Hai ricevuto la risposta alla tua domanda?