Come si utilizza il servizio Massivo PEC?
Il servizio Massivo PEC consente di recuperare in modo automatico le caselle di posta elettronica certificata (PEC) delle imprese italiane, partendo da un file CSV contenente un elenco di Partite IVA.
Tracciato CSV di Input
Il file CSV deve rispettare la codifica UTF-8 e contenere le seguenti colonne obbligatorie:
No |
Nome colonna |
Descrizione |
|---|---|---|
1 |
codiceFiscale |
Codice fiscale dell’impresa da interrogare. Deve contenere una sola voce per riga. |
2 |
denominazione |
Denominazione o ragione sociale dell’impresa (opzionale). |
3 |
siglaProvincia |
Sigla della provincia (2 caratteri). Obbligatoria se viene indicato il numero REA. |
4 |
numeroRea |
Numero REA (9 cifre). Richiede anche la sigla provincia. |
5 |
dataRichiesta |
Data della richiesta, formati ammessi: DD/MM/YYYY, YYYY/MM/DD, YYYY-MM-DD, DD-MM-YYYY. |
Il servizio è pensato per utilizzi massivi da parte delle Pubbliche Amministrazioni, ad esempio per l’invio di comunicazioni ufficiali o notifiche digitali.
Qual è il flusso logico del servizio Massivo PEC?
L’utente carica il file CSV nel modulo dedicato.
GovDesk esegue l’elaborazione massiva, interrogando il servizio di Ricerca Impresa per ogni Partita IVA.
Il sistema aggrega i risultati e genera un file CSV di output contenente i dati richiesti.
L’utente può scaricare il file con le PEC associate alle imprese trovate.
Tracciato CSV di Output
Il file CSV generato dal sistema contiene per ogni riga i seguenti campi:
No |
Nome colonna |
Descrizione |
|---|---|---|
1 |
codiceFiscale |
Codice fiscale dell’impresa interrogata. |
2 |
denominazione |
Denominazione o ragione sociale. |
3 |
siglaProvincia |
Sigla della provincia associata. |
4 |
numeroRea |
Numero REA indicato o individuato. |
5 |
motivation |
Motivazione dell’interrogazione. |
6 |
pec |
Casella PEC risultante dal Registro Imprese. |
7 |
ragioneSociale |
Ragione sociale normalizzata. |
8 |
stato |
Stato dell’impresa (attiva, cessata, sospesa, ecc.). |
9 |
errore |
Eventuale messaggio di errore restituito dal servizio. |
Quali controlli vengono effettuati prima dell’elaborazione?
Il file deve rispettare il formato CSV UTF-8.
Ogni riga deve contenere una singola Partita IVA valida (11 cifre).
In caso di errori di formato o dati mancanti, il sistema genera un log di validazione e scarta le righe non conformi.