PEC Massiva via API

  • Openapi Attivazione : 24 Ore
  • Openapi a partire da € 99,00 + iva

Invia grossi quantitativi di Messaggi di Posta Elettronica Certificata ai tuoi contatti tramite API

Semplice, sicuro e affidabile, PEC Massiva permette di passare ad una gestione digitale più efficiente delle comunicazioni via PEC e garantisce il pieno rispetto della normativa.

Vai alla Documentazione
Esempio PEC Massiva via API

PEC Massiva API è la soluzione perfetta per chi deve gestire un elevato numero di comunicazioni a valore legale e vuole integrare il servizio direttamente alla propria piattaforma tramite API.  PEC Massiva non prevede l'attivazione di alcun software e consente di inviare, in maniera sicura e secondo normativa AGID, messaggi PEC massivamente.

La PEC Massiva API prevede un canone annuo ed un importo pari a 0,05€ per singolo messaggio per la versione standard. Con le soluzioni in abbonamento è possibile invece inviare fino a 1,2 mln di messaggi certificati all'anno a partire da 0,002€.

La PEC Massiva ha come estensione @pecmassiva.com, è possibile però su richiesta personalizzare anche il dominio ad esempio con il nome della propria azienda. 

1) VERIFICA INDIRIZZO PEC
GET /pec.openapi.it/verifica_pec/{pec}

Il primo endpoint utile per l'attivazione della PEC Massiva API standard è il GET pec.openapi.it/verifica_pec/{pec}, infatti tramite questo sarà possibile verificare la disponibilità dell'indirizzo PEC desiderato.

ESEMPIO RICHIESTA  GET /verifica_pec

Questo è un esempio di chiamata per la verifica della disponibilità dell'indirizzo PEC [email protected]

https://pec.openapi.it/verifica_pec/impresa%40pecmassiva.com

 

ESEMPIO RISPOSTA GET /verifica_pec

Questo è un esempio di risposta dove si indica che l’indirizzo è disponibile (avalaible:true):

{
    "data": {
      "available": true
    },
    "success": true,
    "message": "",
    "error": null
  }


2) REGISTRAZIONE PEC MASSIVA STANDARD
POST /pec.openapi.it/pec

Dopo aver accertato la disponibilità della PEC sarà possibile procedere alla registrazione tramite l’endpoint POST /pec.openapi.it/pec dove il body della richiesta includerà i seguenti valori:

{
    "casella_pec": "[email protected]",
    "tipo_casella": "PECMASSIVA",
    "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"
    }
}

 

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').

ESEMPIO RISPOSTA POST /pec.openapi.it/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": "PECMASSIVA",
    "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": "postamassiva.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
}


3) ATTIVAZIONE PEC MASSIVA STANDARD
PATCH /pec.openapi.it/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.

ESEMPIO RISPOSTA PATCH /pec/{id}/attivazione

La risposta sarà la seguente:

{
  "data": {
    "casella_pec": "[email protected]",
    "tipo_casella": "PECMASSIVA",
    "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": "postamassiva.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
}


4) VERIFICA STATO PEC MASSIVA STANDARD
GET/pec.openapi.it/pec/{id}

Sarà possibile verificare lo stato della propria PEC in qualsiasi momento tramite l'endpoint GET /pec/{id}.

ESEMPIO DI CHIAMATA /pec/{id}

La chiamata per verificare lo stato della PEC precedente attivata con id 6040e4613a716838dc4eee0e sarà: 

https://pec.openapi.it/pec/6040e4613a716838dc4eee0e


ESEMPIO DI RISPOSTA /pec/{id}

Questo è un esempio di risposta:

{
  "data": {
    "casella_pec": "[email protected]",
    "tipo_casella": "PECMASSIVA",
    "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": "postamassiva.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
}

 

NOTA BENE: Attualmente la verifica è possibile solo per i clienti che hanno attivato tramite API e non tramite il sito www.pecmassiva.com

5) INVIO MESSAGGI PEC 
POST/pec.openapi.it/send

Tramite PEC Massiva si possono inviare messaggi PEC ad uno o più destinatari con l'aggiunta di allegati.

ESEMPIO DI CHIAMATA  POST /SEND

{
  "sender": "[email protected]",
  "recipient": "[email protected]",
  "subject": "Invio di prova pec massiva",
  "body": "Salve, questa rappresenta una prova di invio, che prevede un corpo in html",
  "attachments": [
    {
      "name": "allegato1.png",
      "file": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIAAAAyCAYAAAAeP4ixAAAAGX="
    }
  ],
  "username": "your_pec_username",
  "password": "your_pec_password"
}

 

In caso di più destinatari si tratterà di un array di destinatari.

ESEMPIO DI RISPOSTA POST /send

La risposta all'invio è un codice identificativo della spedizione che può essere utilizzato per restituire le informazioni sulla conferma di ricezione e le email di consegna. 

{
  "success": true,
  "sent": 1,
  "message": "",
  "message_id": "2020082610003492"
}


6) ACQUISIZIONE LISTA DEI MESSAGGI INVIATI
GET/pec.openapi.it/INBOX

Attraverso il GET /inbox è possibile ottenere la lista di di tutte le email presenti nell'inbox.

{
 "data":[
   {
    "sender": "[email protected]",
    "recipient": "[email protected]",
    "date": "Wed, 26 Aug 2020 10:00:35 +0200",
    "object": "ACCETTAZIONE: Invio di prova pec massiva 2020082610003492",
    "id": 1
   },
   {
    "sender": "\"Per conto di: [email protected]\" ",
    "recipient": "[email protected]",
    "date": "Wed, 26 Aug 2020 10:00:35 +0200",
    "object": "POSTA CERTIFICATA: Invio di prova pec massiva 2020082610003492",
    "id": 2
   },
   {
    "sender": "[email protected]",
    "recipient": "[email protected]",
    "date": "Wed, 26 Aug 2020 10:00:36 +0200",
    "object": "CONSEGNA: Invio di prova pec massiva 2020082610003492",
    "id": 3
  },
 ],
 "success": true,
  "message": "",
  "total": 981,
  "page": 39,
  "n_of_pages": 39
 }


7) VERIFICA UTILIZZO PEC
GET /pec.openapi.it/quota/{mailbox}

In qualsiasi momento si potrà verificare la quota di utilizzo della PEC e il limite tramite GET /quota/{mailbox}. I parametri necessari per effettuare la richiesta sono: username e password.

ESEMPIO DI RISPOSTA GET /quota/{mailbox}

La risposta indicherà l'utilizzo (usage) e quali sono le dimensioni totali (limit) dell'Inbox. I dati sono espressi in megabyte.

{
    "data": {
    "usage": 171012,
    "limit": 1048576
    },
    "success": true,
    "message": "",
  }

 

Le nostre tariffe

Listino prezzi a chiamata

  • PEC Massiva API Standard € 99,00 + iva
  • Costo Singolo Invio (PEC Massiva Standard) € 0,05 + iva
  • Registrati gratis

Abbonati e risparmia

  • PEC MASSIVA
  • 1.200.000 Certified Email Messages (pay annually) € 0,002 + iva
  • 365.000 Certified Email Messages (pay annually) € 0,004 + iva
  • Abbonati ora