Indicatori massivi (ISEE) - CSV Input/Output

La funzionalità Indicatori massivi consente di eseguire verifiche ISEE in modalità batch caricando un file CSV contenente una lista di codici fiscali. Il sistema elabora una richiesta per ciascun soggetto e restituisce un file CSV di output con l’esito (valore ISEE oppure errore) per ogni codice fiscale.

Prerequisiti

Per avviare una lavorazione massiva è necessario:

  • selezionare una Organizzazione abilitata ai servizi ISEE

  • selezionare un Tipo indicatore

  • compilare il campo Motivo richiesta / protocollo

  • caricare un file CSV conforme al tracciato di input

Tracciato di input (CSV)

Il file CSV di input deve contenere una sola colonna obbligatoria:

No

Nome colonna

Descrizione

1

codFiscale

Codice fiscale del soggetto

Regole di compilazione

  • Intestazione obbligatoria: la prima riga deve contenere il nome colonna codFiscale.

  • Una riga = un soggetto: ogni riga successiva rappresenta una richiesta di indicatore ISEE.

  • Formato: CSV standard (separatori coerenti con il template fornito dall’interfaccia).

  • Validazione: valori mancanti/vuoti o formalmente non validi possono generare errore per la singola riga in output.

Esempio input

codFiscale
RSSMRA80A01H501U
VRDLGI85C10F205X
BNCLCU90D22L219Z

Supporto nella compilazione

Dal pulsante “Supporto nella compilazione” è possibile visualizzare il tracciato di input ufficiale e scaricare/riutilizzare il template CSV proposto dal sistema.

Tracciato di output (CSV)

Al termine dell’elaborazione, la piattaforma produce un file CSV di output che riporta, per ciascun codice fiscale in input, l’esito della richiesta.

No

Nome colonna

Descrizione

1

codiceFiscale

Codice fiscale del soggetto consultato

2

dataElaborazione

Data di elaborazione della richiesta

3

valoreIsee

Valore ISEE (Indicatore della Situazione Economica Equivalente)

4

errore

Eventuale errore riscontrato durante l’elaborazione

Logica di valorizzazione

  • Se la lavorazione va a buon fine: - valoreIsee è valorizzato - errore è vuoto o non valorizzato

  • Se la lavorazione fallisce per il singolo soggetto: - valoreIsee può essere vuoto / non valorizzato - errore contiene la descrizione dell’anomalia riscontrata

Esempio output

codiceFiscale,dataElaborazione,valoreIsee,errore
RSSMRA80A01H501U,2026-03-02,13452.77,
VRDLGI85C10F205X,2026-03-02,,Soggetto non trovato
BNCLCU90D22L219Z,2026-03-02,,Codice fiscale non valido

Note operative

  • L’output è riga-correlato all’input: ogni riga rappresenta l’esito associato al soggetto.

  • La presenza di errori su alcune righe non blocca necessariamente l’elaborazione delle altre (best effort per soggetto).

  • La colonna errore è un campo diagnostico utile per re-invio selettivo dei soli record falliti.