HomeProdottiPEC Massiva API Standard

PEC Massiva API Standard

11,00 € + IVA

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

Evasione

In 24 ore

API

PEC

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 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 consente di ottenere in tempo reale le PEC di qualsiasi azienda italiana.

Con la soluzione PEC Massiva Standard si possono inviare fino a 3.500 messaggi al giorno, sino a 100 MB, con la possibilità di allegare file.

L'estensione dell'indirizzo è @pecmassiva.com, tuttavia è possibile - su richiesta - certificare un dominio specifico e personalizzare l'estensione, ad esempio con il nome dell'azienda.

Il costo della PEC Massiva Standard prevede un canone annuale pari a 150€ (ora in OFFERTA a 99€) più 0,05€ per singolo messaggio.

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 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@pecmassiva.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 Standard

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": "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 Standard

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 Standard

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 essere stata correttamente registrata:

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

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

Se per registrare ed attivare la PEC Massiva Standard è 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": "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

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": "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 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 Standard 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 3500 messaggi al giorno, sino a 100 MB.

Con l'acquisto della PEC Standard è inclusa l'attivazione di una casella PEC con dominio @pecmassiva.com e si ha la possibilità di allegare dei file.

Che cos'è il servizio PEC Massiva Standard?

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

Si tenga presente che la 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 €99 + IVA.

Oltre al canone, per la PEC Massiva Standard è previsto un addebito per singolo invio di €0,05.

Quali sono i costi del servizio PEC Massiva Standard?