HomeProdottiPEC Massiva API

PEC Massiva API

Da: 0,002 € + IVA

Spedisci grossi quantitativi di Messaggi di Posta Elettronica Certificata ai tuoi contatti tramite API, nel pieno rispetto delle normative.

Evasione

In 24 ore

Disponibile in
  • it

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, gestionale o CRM tramite API.

Non richiede l'attivazione di alcun software e consente di inviare, in maniera sicura e secondo normativa AGID, messaggi PEC in modo massivo e direttamente tramite API.

Il servizio è spesso utilizzato insieme al servizio API PEC Company, che permette di ottenere in tempo reale le PEC di qualsiasi azienda italiana.

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

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

Verifica Indirizzo PEC

Il primo endpoint utile per l'attivazione della PEC Massiva è GET/verifica_pec/{pec}, che permette di verificare la disponibilità dell'indirizzo PEC desiderato.

ESEMPIO RICHIESTA

GET/verifica_pec/{pec}

Questo è un esempio di richiesta per verificare la disponibilità dell'indirizzo PEC [email protected]

GET https://pec.openapi.it/verifica_pec/[email protected]

ESEMPIO RISPOSTA

GET/verifica_pec/{pec}

Questo è un esempio di risposta in cui si indica che l'indirizzo è disponibile (avalaible:true):

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

Registrazione PEC Massiva

ESEMPIO RICHIESTA

POST/pec

Dopo aver accertato la disponibilità della PEC, si potrà procedere alla registrazione tramite l'endpoint POST/pec dove il body della richiesta includerà i seguenti valori:

  • nome della casella
  • tipologia cliente (es. PV per privato)
  • dati anagrafici del richiedente (Nome e Cognome o Denominazione, codice fiscale o P.IVA richiedente, data e luogo di nascita, indirizzo residenza o sede legale)

Questo è un esempio di Payload con tutti i dati da passare:

{
    "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 è possibile anche attivare il rinnovo automatico aggiungendo al body il parametro facoltativo "autorinnovo" con valore 'true' (attualmente è di default 'false').

ESEMPIO RISPOSTA

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 ed in futuro per procedere al 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
}

Attivazione PEC Massiva

ESEMPIO RICHIESTA

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.

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
}

Verifica stato PEC Massiva

ESEMPIO RICHIESTA

GET/pec/{id}

Sarà possibile verificare lo stato della PEC registrata in qualsiasi momento tramite l'endpoint GET/pec/{id}La chiamata per verificare lo stato della PEC precedente attivata con 6040e4613a716838dc4eee0e sarà:

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

ESEMPIO RISPOSTA

GET/pec/{id}

Questo è un esempio di risposta in cui la casella risulta essere stata correttamente registrata:

{
  "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 la PEC Massiva tramite API e non tramite il sito www.pecmassiva.com.

Se per registrare ed attivare la PEC Massiva è necessario utilizzare l'API PEC (https://pec.openapi.it), la gestione della PEC, come ad esempio l'invio dei messaggi e la verifica degli invii, è affidata ad un'altra API specifica: API Posta Massiva (https://ws.pecmassiva.com).

Invio di Messaggi PEC

ESEMPIO RICHIESTA

POST/send

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

{
  "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 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"
}

Acquisizione lista dei messaggi inviati

GET/inbox

Attraverso il GET/inbox è possibile ottenere la lista 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
 }

Verifica utilizzo PEC

ESEMPIO RISPOSTA

GET/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 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": "",
  }

I servizi di PEC Massiva ad oggi vengono utilizzati da decide di aziende, pubbliche e private, di settori completamente differenti (come Energia, Recupero Credito, Servizi Ambientali, Marketing, Consorzi, Istituti di Pagamenti, Uffici Gari e appalti, Industrie), che hanno la necessità di gestire un grande volume di comunicazioni valide legalmente e tracciabili (ad es. documenti ufficiali e contratti).

Registrati

Hai bisogno di aiuto?

Non hai trovato la risposta che cercavi?

Compila tutti i campi, ti ricontatteremo al più presto!

Domande frequenti

PEC Massiva è il servizio che permette di inviare - tramite API - messaggi PEC legalmente validi (con eventuali allegati), in modo massivo e sicuro.

Non prevede l'attivazione di alcun software e consente di gestire un elevato numero di comunicazioni secondo normativa AGID, a costi molto competitivi e con la possibilità di attivare l'abbonamento annuale per risparmiare sui singoli invii.

Che cos'è il servizio PEC Massiva?

Sì, ha piena validità legale (secondo normativa AGID) e ha lo stesso valore di una Raccomandata A/R. Questo la rende uno strumento efficace e sicuro per comunicazioni ufficiali, come notifiche, contratti o comunicazioni aziendali formali.

I messaggi inviati tramite la propria casella PEC (Posta Elettronica Certificata) garantiscono:

  • certezza della consegna (viene fornita infatti conferma dell’invio e ricezione del messaggio)
  • integrità del contenuto (viene assicurato che il contenuto non è stato alterato durante la trasmissione)
  • validità temporale (si certifica la data e l'ora in cui il messaggio è stato inviato e ricevuto)
La PEC Massiva ha validità legale?

Sì, la PEC Massiva ha come estensione di partenza @pecmassiva.com, ma - su richiesta - è possibile personalizzare anche il dominio, scegliendo ad esempio il nome della propria azienda.

È possibile personalizzare il dominio della PEC Massiva?

Sì, il servizio PEC Massiva via API consente di allegare file e documenti prima dell’invio.

È possibile includere allegati nelle comunicazioni PEC?

PEC Massiva è pensata per aziende e organizzazioni che hanno bisogno di gestire un grande volume di comunicazioni valide legalmente e tracciabili, ad es. documenti ufficiali e contratti. L’integrazione via API è la soluzione ideale in questi casi in quanto il processo è automatico, veloce, efficiente. Senza intervento manuale infatti è possibile ridurre al minimo il rischio di errori.

Per chi è pensata l’API PEC Massiva?

Il servizio viene erogato in 24ore.

Quali sono i tempi di evasione del servizio?

Il canone annuo è di 99€.

Oltre al canone, il servizio PEC Massiva prevede un costo di 0,05€ per singolo invio.

Sono disponibili anche soluzioni di abbonamento annuale, che consentono di inviare fino a 1.2 mln di messaggi certificati all'anno, a partire da 0,002€ per singolo invio.

Quali sono i costi del servizio PEC Massiva?