€3.90 + IVA
Gestisci l’attivazione e il rinnovo di una o più caselle PEC Domicilio Digitale via API. Servizio ideale per privati che non necessitano di inviare/ricevere grandi quantitativi di messaggi PEC e desiderano avere la casella PEC con estensione domiciliodigitale.com.
Il Service PEC consente di verificare, attivare, gestire e rinnovare le caselle Domicilio Digitale e tutte le soluzioni PEC Legalmail. L'API PEC può essere utilizzata per attivare PEC per la propria azienda o per terzi, come ad esempio per la realizzazione di un sito di vendita ed attivazione PEC per privati, professionisti ed aziende.
La casella PEC Domicilio Digitale è la soluzione per chi non necessita di inviare / ricevere grandi quantitativi di messaggi PEC.
Può essere la soluzione ideale per privati, liberi professionisti e PMI.
La casella PEC Domicilio Digitale prevede:
Con Openapi è possibile certificare un dominio personalizzato da utilizzare per le caselle PEC Domicilio Digitale. La richiesta di attivazione del dominio certificato può essere effettuata direttamente tramite API, senza dover utilizzare procedure esterne. Per avviare la certificazione è disponibile l'endpoint POST /dominio, che consente di specificare il dominio da certificare, il provider, la durata del servizio e il numero di caselle PEC associate. Per alcuni provider sono inoltre richiesti i dati del titolare e del richiedente.
Per procedere all'attivazione di una PEC Domicilio Digitale è necessario effettuare le seguenti richieste API.
Il primo endpoint utile per l'attivazione della PEC Domicilio Digitale è GET/verifica_pec/{pec}, infatti tramite questo sarà possibile verificare la disponibilità dell'indirizzo PEC desiderato.
GET/verifica_pec/{pec}
Questo è un esempio di chiamata per la verifica della disponibilità dell'indirizzo PEC [email protected].
GET https://pec.openapi.it/verifica_pec/[email protected]
GET/verifica_pec/{pec}
Questo è un esempio di risposta dove si indica che l'indirizzo è disponibile (avalaible:true):
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}
Dopo aver accertato la disponibilità della PEC sarà possibile procedere alla registrazione tramite l'endpoint POST/pec.
POST/pec
Questo è un esempio di Richiesta:
POST https://pec.openapi.it/pec
Nel body della richiesta dovranno essere inclusi i seguenti valori:
In fase di registrazione è inoltre possibile configurare alcune opzioni della casella, tra cui il servizio multiutenza e lo spazio iniziale dedicato alla Inbox, all'Archivio di Sicurezza e alla Conservazione.
Questo è un esempio di Payload:
{
"casella_pec": "[email protected]",
"tipo_casella": "DOMICILIODIGITALE",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data"
},
"spazio_disco": 1024,
"spazio_storico": 1024,
"spazio_conservazione": 0,
"multiutenza": true,
"autorinnovo": true
}
In questo caso la richiesta riguarda una PEC Domicilio Digitale ed è stato passato nel parametro tipo_casella il valore DOMICILIODIGITALE. Sono inoltre stati configurati lo spazio iniziale per Inbox e Archivio di Sicurezza, il servizio multiutenza e il rinnovo automatico della casella.
In fase di richiesta si potrà anche attivare il rinnovo automatico aggiungendo al body il parametro facoltativo "autorinnovo" con valore 'true' (attualmente è di default 'false').
POST/pec
La risposta conterrà una serie di informazioni tra cui il riepilogo delle caratteristiche della PEC, lo stato di attivazione e l'ID. L'ID sarà fondamentale per i prossimi passaggi di attivazione, per verificarne lo stato e per il rinnovo.
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "DOMICILIODIGITALE",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"dominio": "domiciliodigitale.com",
"owner": "[email protected]",
"timestamp": {
"registrazione": 1614865504,
"ultima_modifica": 1614868403,
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10173956",
"uid": "MA177987",
"conservazione": false,
"data_scadenza": "",
"descrizione": "[email protected]",
"sms": false,
"spazio_conservazione": 0,
"spazio_disco": 0,
"spazio_storico": 0,
"stato": "registrata",
"storico": false,
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}
PATCH/pec/{id}/attivazione
Per completare l'attivazione sarà necessario effettuare il download della modulistica richiesta (GET/pec/{id}/modulo_attivazione) e procedere ad inviare il modulo, correttamente compilato e firmato, oltre al documento di identità del richiedente tramite l'endpoint PATCH /pec/{id}/attivazione.L'id è quello ottenuto nella risposta precedente.
PATCH/pec/{id}/attivazione
La risposta sarà la seguente:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "DOMICILIODIGITALE",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"dominio": "domiciliodigitale.com",
"owner": "[email protected]",
"timestamp": {
"registrazione": 1614865504,
"ultima_modifica": 1614868403,
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10173956",
"uid": "MA177987",
"conservazione": false,
"data_scadenza": "",
"descrizione": "[email protected]",
"sms": false,
"spazio_conservazione": 0,
"spazio_disco": 1024,
"spazio_storico": 1024,
"stato": "in_evasione",
"storico": false,
"documenti_attivazione": [
"6040e4613a716838dc4eee0e_0_attivazione.pdf",
"6040e4613a716838dc4eee0e_1_attivazione.pdf"
],
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}
Sarà possibile verificare lo stato della propria PEC in qualsiasi momento tramite l'endpoint GET/pec/{id}.
GET/pec/{id}
La chiamata per verificare lo stato della PEC precedente attivata con id 6040e4613a716838dc4eee0e sarà:
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e
GET/pec/{id}
Questo è un esempio di risposta:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "DOMICILIODIGITALE",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"dominio": "domiciliodigitale.com",
"owner": "[email protected]",
"timestamp": {
"registrazione": 1614865504,
"ultima_modifica": 1614868403,
"evasione": 1614865504,
"scadenza": 1614868403,
"revoca": ,
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10173956",
"uid": "MA177987",
"conservazione": false,
"data_scadenza": "",
"descrizione": "[email protected]",
"sms": false,
"spazio_conservazione": 0,
"spazio_disco": 1024,
"spazio_storico": 1024,
"stato": "registrata",
"storico": true,
"documenti_attivazione": [
"6040e4613a716838dc4eee0e_0_attivazione.pdf",
"6040e4613a716838dc4eee0e_1_attivazione.pdf"
],
"data_attivazione": "04/03/2021",
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}
A completamento dell'attivazione verranno invate le modalità di accesso alla nuova casella PEC al richiedente.
Il servizio Multiutenza consente di permettere a più utenti di utilizzare la stessa casella PEC Domicilio Digitale. L'opzione può essere attivata direttamente in fase di registrazione della casella tramite il parametro multiutenza oppure, per le caselle già esistenti, è possibile aggiungere nuovi utenti tramite l'endpoint POST/pec/{id}/multiutenza.
Per le caselle gestite da InfoCert, l'endpoint consente di aggiungere un utente alla casella PEC esistente. Per le caselle Namirial, invece, il richiamo dell'endpoint attiva o disattiva la modalità multiutente; in questo caso il corpo della richiesta non viene considerato e deve essere inviato vuoto.
POST/pec/{id}/multiutenza
Questo è un esempio di richiesta per aggiungere un nuovo utente alla casella PEC:
{
"nome": "luca",
"cognome": "bianchi",
"descrizione": "prima utenza",
"email_gestione_password": "[email protected]"
}
POST/pec/{id}/multiutenza
La risposta conterrà le informazioni relative alla casella PEC e all'utente appena aggiunto:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "BRONZE",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php"
},
"dominio": "testcert.legalmail.it",
"owner": "[email protected]",
"timestamp": {
"registrazione": 1614865504,
"ultima_modifica": 1614868403,
"evasione": 1614868312,
"scadenza": 1646391493
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10173956",
"uid": "MA177987",
"conservazione": true,
"data_scadenza": "04/03/2022",
"descrizione": "[email protected]",
"sms": true,
"spazio_conservazione": 512,
"spazio_disco": 3072,
"spazio_storico": 3072,
"stato": "evasa",
"storico": true,
"documenti_attivazione": [
"6040e4613a716838dc4eee0e_0_attivazione.pdf",
"6040e4613a716838dc4eee0e_1_attivazione.pdf"
],
"data_attivazione": "04/03/2021",
"documenti_conservazione": [
"6040e4613a716838dc4eee0e_0_conservazione.pdf",
"6040e4613a716838dc4eee0e_1_conservazione.pdf"
],
"multiutenza": [
{
"nome": "luca",
"cognome": "bianchi",
"descrizione": "prima utenza",
"email_gestione_password": "[email protected]",
"id_utenza": "6040e4613a716838dc4eee0e_0",
"timestamp": {
"attivazione": 1614868138
},
"userid": "MA177993"
}
],
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}
È possibile recuperare gli utenti secondari associati a una casella PEC tramite l'endpoint GET/pec/{id}/multiutenza.
L'endpoint restituisce gli utenti secondari del servizio multiutente di una casella PEC. È applicabile alle caselle InfoCert e non è disponibile per le caselle Namirial (Domicilio Digitale e PEC Massiva), per le quali il parametro multiutenza è gestito come valore booleano.
È inoltre possibile specificare il parametro opzionale id_subset per recuperare esclusivamente uno specifico utente secondario.
GET/pec/{id}/multiutenza
Per recuperare gli utenti associati a una casella PEC è sufficiente specificare l'id della casella:
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e/multiutenza
In caso di esito positivo, la risposta restituisce l'elenco degli utenti associati alla casella:
{
"data": [
{
"nome": "luca",
"cognome": "bianchi",
"descrizione": "prima utenza",
"email_gestione_password": "[email protected]",
"id_utenza": "6040e4613a716838dc4eee0e_0",
"timestamp": {
"attivazione": 1614868138
},
"userid": "MA177993"
}
],
"success": true,
"message": "",
"error": null
}
Il servizio è già largamente utilizzato da chi vuole rivendere a terzi il servizio di attivazione e rinnovo della PEC Domicilio Digitale, per la gestione semplice, rapida e sicura delle proprie comunicazioni (anche con la PA).
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
Il servizio PEC Domicilio Digitale fa riferimento all’API PEC di Openapi e permette di verificare, attivare, gestire e rinnovare le caselle Domicilio Digitale per l’invio e la ricezione in tutta sicurezza di messaggi di posta elettronica certificati verso privati e Pubblica Amministrazione.
La Casella PEC Domicilio Digitale è la soluzione più adatta per i privati, a differenza delle altre soluzioni PEC (come Legalmail Standard, Bronze, Silver e Gold) pensate soprattutto per società, PMI, ditte individuali e liberi professionisti.
Le diverse soluzioni PEC hanno inoltre dimensioni e funzionalità diverse l’una dall’altra.
Nel caso della casella PEC Domicilio Digitale, è previsto uno spazio di 2 GB, di cui 1 GB spazio inbox più 1 GB di archivio di sicurezza.
Al costo di una sola raccomandata A/R, la PEC Domicilio Digitale permette di inviare quante comunicazioni legali si desidera, senza limiti e senza costi aggiuntivi.
Sì, la PEC Domicilio Digitale ha piena validità legale e ha lo stesso valore di una Raccomandata A/R.
La PEC utilizza il sistema di Posta Elettronica Certificata e garantisce:
PEC Domicilio Digitale via API è ideale per chi vuole rivendere a terzi il servizio di attivazione e rinnovo della PEC Domicilio Digitale, così da poter gestire le proprie comunicazioni (anche con la PA) in modo semplice, rapido e sicuro.
Sì, è possibile configurare il servizio multiutenza per una casella PEC Domicilio Digitale. L'opzione può essere attivata direttamente in fase di registrazione della casella. Per le caselle già attive, è inoltre possibile gestire la multiutenza tramite API. Il servizio consente di associare più utenti alla stessa casella PEC, in base alla configurazione prevista dal provider
Sì, è possibile configurare lo spazio della casella in base alle proprie esigenze. In fase di registrazione è possibile specificare lo spazio iniziale dedicato alla Inbox, all'Archivio di Sicurezza e alla Conservazione. Per le caselle già attive, è inoltre possibile modificare lo spazio tramite API. Gli incrementi di spazio devono rispettare i valori previsti dal servizio e, per lo spazio di Conservazione, è necessario che il relativo servizio sia attivo.
Sì, con Openapi è possibile certificare un dominio personalizzato da utilizzare per le caselle PEC Domicilio Digitale. La richiesta di attivazione del dominio certificato può essere effettuata direttamente tramite API, specificando il dominio e il provider. In base al provider e alla configurazione richiesta, possono essere necessari anche i dati del titolare e del richiedente.
Sì, è possibile gestire il rinnovo e diverse modifiche della casella direttamente tramite API. Il rinnovo può essere configurato già in fase di registrazione tramite l'opzione di autorinnovo. Per una casella esistente, l'endpoint PATCH /pec/{id} consente di effettuare, tra le altre operazioni, il rinnovo, l'upgrade della casella, la modifica dello spazio disponibile e la gestione della multiutenza.
Il servizio viene erogato in 2 ore lavorative.
Il costo di partenza del servizio è di €4,50 per singola richiesta.