Con l'API Legalmail Certified Mail (PEC) verifichi, attivi, gestisci e rinnovi le caselle PEC Legalmail di InfoCert direttamente dal tuo software. Puoi attivarle per la tua azienda o per conto di terzi, ad esempio integrando la vendita e l'attivazione di caselle PEC per privati, professionisti e aziende nel tuo portale o gestionale.
La PEC ha lo stesso valore legale di una raccomandata con ricevuta di ritorno: certifica invio e consegna, garantisce l'integrità del contenuto e attesta data e ora di trasmissione. Con un'unica integrazione gestisci tutte le tipologie di casella Legalmail, dalla Standard alla Gold.
Tutte le caselle Legalmail includono:
La soluzione di base per chi non ha bisogno di inviare o ricevere grandi quantità di messaggi PEC. È adatta a privati, liberi professionisti e PMI.
Più spazio per chi usa la PEC con regolarità, sempre senza grandi volumi di invio. È adatta a privati, liberi professionisti e PMI.
Per chi ha bisogno di più spazio e vuole gestire in modo semplificato le fatture elettroniche ricevute via PEC.
La soluzione più completa, per chi ha bisogno di grandi spazi di archiviazione e alti livelli di sicurezza. Include tutte le funzionalità della Silver.
Il processo di attivazione è lo stesso per tutte le caselle: cambia solo il valore del parametro tipo_casella.
Il primo passo è verificare che l'indirizzo PEC desiderato sia disponibile, tramite l'endpoint GET /verifica_pec/{pec}.
GET /verifica_pec/{pec}
GET https://pec.openapi.it/verifica_pec/[email protected]
GET /verifica_pec/{pec}
Se l'indirizzo è disponibile, il campo available restituisce true:
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}
Dopo aver verificato la disponibilità, registri la casella tramite l'endpoint POST /pec. Nel body della richiesta vanno inclusi:
Per scegliere la casella da attivare, inserisci nel parametro tipo_casella uno di questi valori:
Con il parametro facoltativo "autorinnovo" impostato a true attivi anche il rinnovo automatico (di default è false).
POST /pec
Questo è un esempio sintetico di payload per una casella Standard. L'elenco completo dei campi è disponibile nella documentazione.
{
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"tipo_cliente": "PV",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"provincia_titolare": "rm",
"autorinnovo": true,
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data"
}
}
POST /pec
La risposta riepiloga le caratteristiche della casella e ne indica lo stato e l'ID. L'ID ti servirà per completare l'attivazione, verificare lo stato e gestire la casella nel tempo.
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "STANDARD",
"dominio": "legalmail.it",
"cod_attivazione": "10173956",
"stato": "registrata",
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": true
},
"success": true,
"message": "",
"error": null
}
Per completare l'attivazione scarichi la modulistica tramite GET /pec/{id}/modulo_attivazione. Poi invii il modulo compilato e firmato, insieme al documento di identità del richiedente, tramite PATCH /pec/{id}/attivazione, usando l'ID ottenuto in fase di registrazione.
PATCH /pec/{id}/attivazione
La casella passa in stato in_evasione e la risposta riporta i documenti di attivazione caricati:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"stato": "in_evasione",
"documenti_attivazione": [
"6040e4613a716838dc4eee0e_0_attivazione.pdf",
"6040e4613a716838dc4eee0e_1_attivazione.pdf"
],
"id": "6040e4613a716838dc4eee0e"
},
"success": true,
"message": "",
"error": null
}
Completata l'attivazione, è InfoCert a inviare direttamente al richiedente le credenziali di accesso alla nuova casella PEC.
Puoi verificare in qualsiasi momento lo stato della casella tramite l'endpoint GET /pec/{id}.
GET /pec/{id}
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e
GET /pec/{id}
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"stato": "registrata",
"data_attivazione": "04/03/2021",
"timestamp": {
"registrazione": 1614865504,
"evasione": 1614865504,
"scadenza": 1614868403,
"revoca": null
},
"spazio_disco": 1024,
"spazio_storico": 1024,
"conservazione": false,
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": true
},
"success": true,
"message": "",
"error": null
}
Dopo l'attivazione puoi far crescere la casella insieme alle tue esigenze con un unico endpoint: PATCH /pec/{id}. Con questa chiamata puoi:
In alternativa, il rinnovo può avvenire in automatico se in fase di registrazione hai impostato il parametro "autorinnovo" a true.
Tramite il Service PEC sono inoltre disponibili:
L'API Legalmail Certified Mail (PEC) è utilizzata da software house, banche e istituti finanziari, portali per commercialisti, Pubbliche Amministrazioni e grandi aziende. È pensata per chi vuole offrire ai propri clienti l'attivazione di qualsiasi tipologia di casella PEC, o gestire le caselle della propria organizzazione in modo automatizzato, sicuro e certificato.
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
L’API PEC permette di verificare, attivare, gestire, rinnovare e ampliare via API le caselle PEC Legalmail di InfoCert, lo strumento che consente di inviare messaggi e documenti in modo sicuro e con lo stesso valore legale di una raccomandata con ricevuta di ritorno. Tramite l’API puoi attivare caselle PEC per la tua azienda o per conto di terzi, ad esempio offrendo l’attivazione PEC ai tuoi clienti direttamente dal tuo portale o gestionale.
Tramite l’API PEC puoi attivare quattro tipologie di casella Legalmail, dalla più semplice alla più completa:
La PEC Legalmail Standard è la soluzione di base, pensata per chi non ha bisogno di inviare o ricevere grandi quantità di messaggi PEC. È adatta a privati, liberi professionisti e PMI. Offre 2 GB di spazio complessivo (1 GB di spazio inbox e 1 GB di archivio di sicurezza) e include:
La PEC Legalmail Bronze offre più spazio rispetto alla Standard, per chi usa la PEC con regolarità ma senza grandi volumi di invio. È adatta a privati, liberi professionisti e PMI. Offre 5 GB di spazio complessivo (2 GB di spazio inbox e 3 GB di archivio di sicurezza), non prevede costi per singolo invio e include tutte le funzionalità della Standard.
Quali sono le caratteristiche della PEC Legalmail Silver?
La PEC Legalmail Silver è pensata per chi ha bisogno di più spazio e vuole gestire in modo semplificato le fatture elettroniche ricevute via PEC. Offre 8 GB di spazio complessivo (2 GB di spazio inbox e 6 GB di archivio di sicurezza). Oltre alle funzionalità della Bronze, include:
La PEC Legalmail Gold è la soluzione più completa, per chi gestisce grandi volumi di messaggi e ha bisogno di ampi spazi di archiviazione e alti livelli di sicurezza. Offre 18 GB di spazio complessivo (5 GB di spazio inbox e 13 GB di archivio di sicurezza). Include tutte le funzionalità della Silver e in più i servizi di cyber security Phishing Protection e Password Protection.
L’archivio di Sicurezza è il backup automatico dei messaggi della casella. Salva una copia dei messaggi in arrivo e in uscita, insieme ad allegati e ricevute, così non perdi nulla anche se elimini un messaggio dalla casella o la casella si riempie. Dalla webmail puoi scegliere quali tipologie di messaggi archiviare, cercare i messaggi salvati e, se serve, ripristinarne una copia in casella.
La funzionalità Invii Massivi permette di inviare lo stesso messaggio PEC a molti destinatari in un’unica operazione, direttamente dalla webmail Legalmail. Basta caricare la lista dei destinatari da un file CSV, personalizzare il messaggio per ognuno e ricevere al termine un report con l’esito di ogni invio. Ogni messaggio mantiene il pieno valore legale della PEC.
Tutte le caselle PEC Legalmail, dalla Standard alla Gold, si attivano per un anno e possono essere rinnovate ogni volta per un periodo da 1 a 3 anni. Il rinnovo si effettua tramite l'endpoint PATCH /pec/{id}, indicando l'ID ottenuto in fase di registrazione. In alternativa puoi attivare il rinnovo automatico già al momento della registrazione, così la casella resta attiva senza doverlo richiedere ogni volta.
Sì. Una volta attivata, puoi modificare la casella in qualsiasi momento tramite l’endpoint PATCH /pec/{id}, indicando l’ID ottenuto in fase di registrazione. Con un’unica chiamata puoi:
Oltre alle funzionalità incluse, puoi potenziare le caselle Legalmail con alcune opzioni aggiuntive:
Sì, la PEC ha piena valenza legale e ha lo stesso valore di una raccomandata con ricevuta di ritorno. Vale per tutte le caselle Legalmail, dalla Standard alla Gold. I messaggi PEC garantiscono:
Sì. Tramite il Service PEC puoi attivare un dominio certificato personalizzato, così gli indirizzi PEC della tua organizzazione riportano il nome della tua azienda. Sono disponibili due tipi di personalizzazione:
La casella PEC Legalmail può essere attivata sia da cittadini e aziende italiane sia stranieri, purché questi ultimi siano in possesso di un codice fiscale italiano oppure di una partita IVA italiana.
Sì, tutte le caselle PEC Legalmail (Standard, Bronze, Silver e Gold) sono già predisposte per l’aggiornamento gratuito ai nuovi standard europei.
L’API PEC è pensata per software house, banche e istituti finanziari, portali per commercialisti, Pubbliche Amministrazioni e grandi aziende. Permette di attivare qualsiasi tipologia di casella PEC Legalmail, per gestire le comunicazioni in modo sicuro e certificato, per sé o per i propri clienti.
Il servizio viene evaso in 2 ore per tutte le tipologie di casella PEC Legalmail.
Il costo dipende dalla tipologia di casella: