PEC

Attiva e gestisci servizi di Posta Elettronica Certificata direttamente tramite API

Su Openapi è possibile attivare, rinnovare, estendere lo spazio della Casella di Posta Elettronica InfoCert Legalmail, Domicilio Digitale, Pecmassiva

No. Per la normativa AgID, non possono essere presenti contemporaneamente due certificazioni attive sullo stesso dominio. Inoltre, il semplice cambio dei record DNS (MX) non è sufficiente per completare il trasferimento.
Per trasferire un dominio certificato da un gestore a un altro, è necessario completare i seguenti passaggi:

1) De-certificazione presso il precedente gestore
Il titolare del dominio, o il legale rappresentante, deve inviare al precedente gestore una richiesta scritta tramite PEC per richiedere la chiusura della certificazione attiva.

2) Rimozione dal registro IGPEC
Il precedente gestore deve rimuovere il dominio dal registro nazionale dei domini certificati (IGPEC) gestito da AgID.

3) Nuova certificazione con noi
Una volta che il dominio è stato rimosso da IGPEC, puoi procedere con la nuova certificazione e l'acquisto del servizio tramite DominiCertificati.com, completando successivamente la configurazione DNS richiesta (record MX e TXT SPF).

4) Migrazione dei contenuti della casella
La migrazione dei messaggi e degli altri contenuti della vecchia casella deve essere gestita separatamente. In genere, il precedente gestore mantiene la casella disponibile per un periodo limitato, ad esempio 60 giorni, durante il quale è possibile accedere ai contenuti e salvarli.

Con l'API PEC è possibile completare secondo le normi vigenti la Comunicazione dell'Iscrizione e delle Variazioni PEC Azienda e Comunicare la PEC Amministratore.
E' necessario inizializzare la richiesta tramite l'endpoint POST /comunica_pec (nella cui risposta sarà disponibile l'id), caricare il documento di delega con l'endpoint /comunica_pec/{id}/procura_registro_imprese ed inviare e finalizzare la richiesta con l'endpoint dedicato GET /comunica_pec/{id}.

Per completare correttamente la richiesta di comunicazione sarà necessario:

  • disporre di una casella PEC attiva (anche se non attivata con Openapi)
  • essere in possesso di una firma digitale valida
  • essere il rappresentante legale dell’azienda o un intermediario delegato

Un dominio certificato è un dominio per cui il gestore PEC ha verificato il controllo da parte del titolare (azienda o professionista) e che può essere usato per caselle PEC personalizzate. Con Openapi tramite l’endpoint GET /domini_pec/{dominio} è possibile verificare non solo se un indirizzo email include il dominio di uno dei gestori PEC (ad es. @legalmail.com o @pec.it), ma anche se è associato ad uno degli oltre 250.000 domini certificati.

Prima di procedere con qualsiasi richiesta di attivazione è necessario verificare la disponibilità di un indirizzo PEC tramite il metodo: GET /verifica_pec/{pec}.

Per effettuare una richiesta all’endpoint GET /verifica_pec/{pec} e quindi verificare la disponibilità di un indirizzo PEC è necessario passare nel body della richiesta come valore l’indirizzo completo della PEC, ad esempio: [email protected].

Attualmente è possibile verificare solo la disponibilità delle PEC Legalmail e Domicilio Digitale.

È possibile verificare l’elenco completo delle PEC registrate tramite lo stesso account Openapi con l’endpoint GET /pec.

È possibile registrare le seguenti tipologie di caselle PEC:

Non è necessario nessun parametro o valore nel body della richiesta.

La risposta alla richiesta indicherà informazioni quali ad esempio indirizzo PEC, tipologia casella, stato, data scadenza, registrazione.

Per completare l'attivazione di una PEC è necessario inviare tramite il metodo PATCH /pec/{id}/attivazione:

  • documento d'identità valido 
  • modulo di attivazione compilato e firmato

Per le caselle di tipo DOMICILIODIGITALE e PECMASSIVA è necessario creare un unico documento composto dal modulo di attivazione firmato e dal documento di identità.

I documenti devono essere in PDF.

Il modulo di attivazione è disponibile utilizzando il metodo GET/pec/{id}/modulo_attivazione. 

È possibile procedere alla registrazione di un indirizzo PEC tramite l'endpoint POST /pec.

Ricordiamo che la registrazione non prevede automaticamente l'attivazione della casella PEC che deve essere completata tramite l'invio della documentazione necessaria tramite l'endpoint PATCH/pec/{id}/attivazione. L'id è presente nella risposta alla richiesta POST /pec . 

Il modulo di attivazione è disponibile utilizzando il metodo GET/pec/{id}/modulo_attivazione. 

L'id è presente nella risposta alla richiesta POST /pec . 

Lo stato di una casella PEC può essere:

  • registrata
  • in_evasione
  • evasa
  • revocata
  • chiusa

Lo stato “registrata” indica che l’indirizzo PEC è stato registrato tramite l’endpoint POST /pec, ma la casella non è ancora attiva: per attivarla è necessario inviare la documentazione richiesta, cioè il modulo di attivazione compilato e firmato e il documento d’identità del richiedente. Il modulo si scarica con GET /pec/{id}/modulo_attivazione e la documentazione si invia con PATCH /pec/{id}/attivazione.

Lo stato “in_evasione” indica che la documentazione è stata inviata correttamente e la richiesta di attivazione è in lavorazione. Una volta completata l’attivazione, lo stato passerà a “evasa”.

Puoi verificare in qualsiasi momento lo stato di una casella con GET /pec/{id}.

Sì, puoi modificare le caratteristiche di una PEC già attiva. In particolare puoi:

  • aumentare la dimensione della casella (inbox) con PATCH /pec/{id}/modifica
  • aumentare la dimensione dell’archivio di sicurezza con PATCH /pec/{id}/modifica
  • attivare la conservazione con PATCH /pec/{id}/conservazione

Solo per le caselle Legalmail puoi anche effettuare l’upgrade da una tipologia di casella a un’altra, ad esempio da Bronze a Silver, con PATCH /pec/{id}/trasformazione

Puoi rinnovare una PEC per uno o più anni con l’endpoint GET /pec/{id}/rinnovo?anni=N, dove N indica il numero di anni di rinnovo.

Nella richiesta va indicato l’ID della casella, che ricevi nella risposta alla POST /pec in fase di registrazione. Se non lo hai a portata di mano, puoi recuperare i dati di tutte le PEC attivate, ID compreso, con GET /pec.

Una casella in stato “revocata” può essere rinnovata entro 6 mesi dalla scadenza per la linea Legalmail ed entro 1 mese per la linea Domicilio Digitale.