HomeProdottiPEC Massiva API Flat

PEC Massiva API Flat

0,05 € + IVA

Invia tramite API in modo massivo fino a 30.000 Messaggi di Posta Elettronica Certificata (PEC) al mese e sino a 100 MB per messaggio, con la possibilità di allegare file e personalizzare l’estensione.

Evasione

In 24 ore

Disponibile in
  • eu

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, CRM tramite API. Non richiede l'attivazione di alcun software e consente di inviare, in maniera sicura e secondo normativa AGID, l'invio di messaggi PEC massivamente e direttamente tramite API.

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

Con PEC Massiva Flat è possibile inviare fino a 30.000 PEC al mese, 100 MB a messaggio e allegare dei file. A differenza della soluzione Standard, la Flat include il dominio personalizzato e nessun costo per singolo invio. È previsto un pagamento solo per il canone annuale, pari a 1.500€ in offerta invece che 3.000€.

Attualmente l'attivazione della PEC Massiva Flat è completamente gestita tramite il sito www.pecmassiva.com.

Una volta completata l'attivazione, sarà possibile inviare i  messaggi, accedere allo storico invii e verificare i consumi direttamente tramite API.

Di seguito vediamo nel dettaglio i singoli endpoint; i primi 4  (verifica indirizzo, registrazione, attivazione e verifica stato PEC) fanno riferimento all'API PEC, mentre gli ultimi 3 (invio,  accesso ai messaggi, verifica utilizzo) all'API PEC Massiva.

Verifica Indirizzo PEC

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

ESEMPIO RICHIESTA

GET /verifica_pec

Questo è un esempio di richiesta per verificare la disponibilità dell'indirizzo PEC impresa@pecmassiva.com

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

ESEMPIO RISPOSTA

GET /verifica_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 Flat

ESEMPIO RICHIESTA

POST /pec

Dopo aver accertato la disponibilità della PEC, si può 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": "yourpec@pecmassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "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": "yourpec@postamassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "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": "mail@domain.com",
    "timestamp": {
      "registrazione": 1614865504,
      "ultima_modifica": 1614868403,
    },
    "cellulare": "",
    "comune_nascita_richiedente": "",
    "cod_attivazione": "10173956",
    "uid": "MA177987",
    "conservazione": false,
    "data_scadenza": "",
    "descrizione": "yourpec@postamassiva.com",
    "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 Flat

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": "yourpec@pecamassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "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": "mail@domain.com",
    "timestamp": {
      "registrazione": 1614865504,
      "ultima_modifica": 1614868403,
    },
    "cellulare": "",
    "comune_nascita_richiedente": "",
    "cod_attivazione": "10173956",
    "uid": "MA177987",
    "conservazione": false,
    "data_scadenza": "",
    "descrizione": "yourpec@testcert.legalmail.it",
    "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 Flat

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à:

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

ESEMPIO RISPOSTA

GET /pec/{id}

Questo è un esempio di risposta in cui la casella risulta in stato di registrazione:

{
  "data": {
    "casella_pec": "yourpec@pecmassiva.com",
    "tipo_casella": "PECMASSIVA",
    "tipo_cliente": "PV",
    "sottotipo_cliente": "",
    "sottotipo_cliente_altro": "",
    "nome_richiedente": "mario",
    "cognome_richiedente": "rossi",
    "email": "mail@domain.com",
    "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": "mail@domain.com",
    "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": "yourpec@pecmassiva.com",
    "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
}

Invio di Messaggi PEC

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

ESEMPIO RICHIESTA

POST /send

Questo è un esempio di richiesta:

{
  "sender": "dev-api@pecmassiva.com",
  "recipient": "dev-api@pecmassiva.com",
  "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

Dopo l'invio, la risposta restituisce un codice identificativo della spedizione che può essere utilizzato per avere informazioni sulla conferma di ricezione e le email di consegna.

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

Accesso ai messaggi inviati

GET /inbox

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

{
 "data":[
   {
    "sender": "dev-api@pecmassiva.com",
    "recipient": "dev-api@pecmassiva.com",
    "date": "Wed, 26 Aug 2020 10:00:35 +0200",
    "object": "ACCETTAZIONE: Invio di prova pec massiva 2020082610003492",
    "id": 1
   },
   {
    "sender": "\"Per conto di: dev-api@pecmassiva.com\" ",
    "recipient": "dev-api@pecmassiva.com",
    "date": "Wed, 26 Aug 2020 10:00:35 +0200",
    "object": "POSTA CERTIFICATA: Invio di prova pec massiva 2020082610003492",
    "id": 2
   },
   {
    "sender": "posta-certificata@pecmassiva.com",
    "recipient": "dev-api@pecmassiva.com",
    "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 dell'utilizzo PEC

ESEMPIO RICHIESTA

GET /pec.openapi.it/quota/{mailbox}

È possibile verificare in qualsiasi momento 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": "",
  }

Il servizio di PEC Massiva è utilizzato 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 Flat permette di inviare messaggi PEC in modo massivo, sicuro e secondo normativa AGID.

Non richiede l'attivazione di nessun software e permette di inviare fino a 30.000 PEC al mese, fino a 100 MB per messaggio.

Con l'acquisto della PEC Massiva Flat è inclusa l'attivazione di una casella PEC con dominio @pecmassiva.com e si ha la possibilità di allegare dei file ma anche - su richiesta - di certificare un dominio specifico e personalizzare l'estensione (ad es. con il nome azienda).

Si tenga presente che la PEC Massiva FLAT è attualmente attivabile esclusivamente dal sito https://www.pecmassiva.com/pec-massiva-api

Che cos'è il servizio PEC Massiva Flat?

La principale differenze tra la PEC Massiva Standard e PEC Massiva Flat è nel limite di Invio: infatti la PEC Massiva Standard permette di inviare fino a 3.500 messaggi PEC al giorno, mentre la PEC Massiva Flat consente di inviare fino a 30.000 messaggi PEC al mese.

In entrambi i casi è possibile allegare dei file ed è inclusa l'attivazione di una casella PEC con dominio @pecmassiva.com.

Nel caso della PEC Massiva FLAT è possibile anche - su richiesta - certificare un dominio specifico e personalizzare l'estensione (ad es. con il nome azienda).

NOTA BENE: PEC Massiva FLAT è attualmente attivabile esclusivamente dal sito https://www.pecmassiva.com/pec-massiva-api

Quali sono le differenze tra PEC Massiva Standard e Flat?

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?

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 canone annuo è di €1.500 + IVA. Oltre al canone, per la PEC Massiva Flat è previsto un addebito per singolo invio.

Quali sono i costi del servizio PEC Massiva Flat?