Aus: €0.02 + MwSt
Senden Sie große Mengen zertifizierter elektronischer Post über API an Ihre Kontakte, unter Einhaltung aller Vorschriften.
Die PEC Massiva API ist die ideale Lösung für alle, die eine große Anzahl von rechtsgültigen Mitteilungen verwalten und diese direkt über eine API in die eigene Plattform, Verwaltungssoftware oder das eigene CRM integrieren möchten.
Die Aktivierung einer Software ist nicht erforderlich: Es genügt die API zum massenhaften Versand von PEC-Nachrichten, sicher und gemäß den AGID-Vorschriften,
Sie wird häufig zusammen mit dem Service API PEC Company verwendet, der es ermöglicht, in Echtzeit die PEC-Adressen jedes italienischen Unternehmens abzurufen.
Der Service sieht eine Jahresgebühr von 99€ und einen Betrag von 0,05€ pro Nachricht vor. Mit den Abonnementlösungen können dagegen bis zu 600.000 zertifizierte Nachrichten pro Jahr versendet werden (auf Anfrage erweiterbar), ab 0,02€.
Die Standard-Domain der PEC Massiva ist @pecmassiva.com. Es ist jedoch möglich, die mit dem Postfach verknüpfte Domain über den entsprechenden Endpoint für die Domainverwaltung zu personalisieren, beispielsweise mit der eigenen Unternehmensdomain.
Um PEC Massiva zu verwenden, muss zunächst das für PEC Massiva vorgesehene Postfach über die PEC API überprüft und aktiviert werden. Wie bereits erwähnt, kann ein Postfach mit der Domain @pecmassiva.com aktiviert oder eine eigene Second-Level-Domain (beispiel.com) oder Third-Level-Domain (pec.beispiel.com) zertifiziert werden.
Um die Verfügbarkeit der gewünschten PEC-Adresse zu überprüfen, muss eine Anfrage an den Endpoint è GET all'endpoint https//pec.openapi.it/verifica_pec/{pec} gestellt werden.
GET/verifica_pec/{pec}
Dies ist ein Beispiel für eine Anfrage zur Überprüfung der Verfügbarkeit der PEC-Adresse [email protected]
GET https://pec.openapi.it/verifica_pec/[email protected]
GET/verifica_pec/{pec}
Die Antwort zeigt an, ob die Adresse verfügbar ist (avalaible:true) oder nicht:
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}
POST/pec
Nach der Überprüfung der Verfügbarkeit der PEC kann die Registrierung über den Endpoint POST/pec vorgenommen werden. Der Body der Anfrage muss folgende Daten enthalten:
Dies ist ein Beispiel für einen Payload mit allen zu übermittelnden Daten:
{
"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"
}
}
Bei der Anfrage kann auch die automatische Verlängerung aktiviert werden, indem der optionale Parameter "autorinnovo" mit dem Wert 'true' zum Body hinzugefügt wird (derzeit ist der Standardwert 'false').
POST/pec
Die Antwort enthält eine Reihe von Informationen, darunter eine Zusammenfassung der Eigenschaften der PEC, den Aktivierungsstatus sowie die ID, die für die nächsten Aktivierungsschritte, zur Überprüfung des Status und künftig für die Verlängerung erforderlich ist.
{
"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
}
PATCH/pec/{id}/attivazione
Um die Aktivierung abzuschließen, müssen die erforderlichen Unterlagen (GET /pec/{id}/modulo_attivazione) heruntergeladen und das ausgefüllte und unterschriebene Formular zusammen mit dem Ausweisdokument des Antragstellers über den Endpoint PATCH/pec/{id}/attivazione. übermittelt werden. Zu verwenden ist die ID aus der vorherigen Antwort.
PATCH/pec/{id}/attivazione
Die Antwort lautet wie folgt:
{
"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
}
GET/pec/{id}
Der Aktivierungsstatus der PEC kann über den Endpoint GET/pec/{id} überprüft werden. Im vorherigen Beispiel muss zur Überprüfung des Postfachs die ID 6040e4613a716838dc4eee0e übermittelt werden, also:
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e
GET/pec/{id}
Dies ist ein Beispiel für eine Antwort, in der das Postfach korrekt registriert wurde:
{
"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
}
WICHTIGER HINWEIS: Derzeit ist die Überprüfung nur für Kunden möglich, die PEC Massiva über die API und nicht über die Website www.pecmassiva.com aktiviert haben.
Die Registrierung und Aktivierung von PEC Massiva erfolgen über die PEC API (https://pec.openapi.it); die Verwaltung des Postfachs, beispielsweise der Versand von Nachrichten und die Überprüfung der Sendungen, erfolgt dagegen über eine weitere spezifische API: API Posta Massiva (https://ws.pecmassiva.com).
Nach der Aktivierung des PEC-Massiva-Postfachs können Nachrichten als einzelne Nachrichten oder über Threads versendet werden.
Der Endpoint POST/send ermöglicht den Versand einer zertifizierten Nachricht an einen oder mehrere Empfänger, wobei auch Anhänge hinzugefügt werden können.
Zum Versand einer PEC-Nachricht müssen im Payload die erforderlichen Daten übermittelt werden: E-Mail-Adresse des Empfängers, Betreff, Text, Anhänge, Benutzername und Passwort
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"
}
Bei mehreren Empfängern muss der Payload ein Array mit den Empfängeradressen enthalten.
POST/send
Die Antwort auf den Versand ist ein Identifikationscode der Sendung, der verwendet werden kann, um Informationen über die Empfangsbestätigung und die Zustell-E-Mails abzurufen.
{
"success": true,
"sent": 1,
"message": "",
"message_id": "2020082610003492"
}
POST/threads
Neben dem Versand einer einzelnen PEC-Nachricht ermöglicht die PEC Massiva API auch die Erstellung eines Threads: einer nachverfolgbaren Konversation, in der die PEC-Nachricht mit den Antworten und nachfolgenden Nachrichten verknüpft wird, die anschließend gemeinsam eingesehen werden können. Um einen Thread zu erstellen und die erste PEC-Nachricht zu versenden, ist der zu verwendende Endpoint POST/threads
POST/threads
Im Payload der Anfrage müssen die E-Mail-Adresse des Empfängers, der Betreff, der Nachrichtentext, gegebenenfalls ein Anhang sowie Benutzername und Passwort übermittelt werden:
{
"recipient": "[email protected]",
"subject": "Invio di prova pec massiva",
"body": "Salve, questa rappresenta una prova di threads, che prevede un corpo in html",
"attachments": [
{
"name": "allegato1.png",
"file": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIAAAAyCAYAAAAeP4ixAAAAGX="
}
],
"username": "your_pec_username",
"password": "your_pec_password"
}
POST/threads
Die Antwort auf die Erstellung des Threads enthält unter anderem die Thread-ID, die Nachrichten-ID und den Versandstatus. Die Thread-ID ist nützlich, um eine bestimmte Konversation und alle damit verbundenen Nachrichten abzurufen (GET /threads/{id}) oder um eine neue Nachricht in einer bereits begonnenen Diskussion zu versenden. Mit der Nachrichten-ID kann dagegen eine bestimmte Nachricht und gegebenenfalls der darin enthaltene Anhang abgerufen werden (GET /threads/{id}/{msgId}).
{
"msgId": "d6650f1a2b3c4d5e6f7081920",
"threadId": "6650f1a2b3c4d5e6f7081920",
"createdAt": "26/08/2026 10:00:35",
"sentAt": "26/08/2026 10:00:35",
"updateAt": "26/08/2026 10:00:35",
"status": "sent",
"subject": "Invio di prova pec massiva",
"sender": "[email protected]",
"recipients": [
"[email protected]",
],
"body": "Salve, questa rappresenta una prova di threads, che prevede un corpo in html",
"attachments"[],
"callback"{}
},
"success": true,
"message": "Operation successful",
"error": null
}
Im Gegensatz zum Versand über eine einzelne Nachricht (/send) ermöglicht der Versand über einen Thread bei Überschreitung des Tageslimits, die Nachricht in eine Warteschlange einzureihen und am folgenden Tag zu bearbeiten.
Um eine bereits begonnene Konversation fortzusetzen, muss der entsprechende Endpoint PATCH /threads/{id} verwendet werden. Dabei ist die ID zu verwenden, die in der Antwort auf die Thread-Erstellung erhalten wurde.
PATCH/threads/{id}
Im Payload müssen der Inhalt der neuen Nachricht sowie Benutzername und Passwort des PEC-Postfachs übermittelt werden
{
"body": "Salve, questa rappresenta una prova di invio, che prevede un corpo in html",
"username": "your_pec_username",
"password": "your_pec_password"
}PATCH/threads/{id}
{
"msgId": "d6650f1a2b3c4d5e6f7081920",
"threadId": "6650f1a2b3c4d5e6f7081920",
"createdAt": "26/08/2026 10:00:35",
"sentAt": "26/08/2026 10:00:35",
"updateAt": "26/08/2026 10:00:35",
"status": "sent",
"subject": "Invio di prova pec massiva",
"sender": "[email protected]",
"recipients": [
"[email protected]",
],
"body": "Salve, questa rappresenta una prova di threads, che prevede un corpo in html",
"attachments"[],
"callback"{},
"accepted": false,
"acceptedAt": null,
"deliveries": []
},
"success": true,
"message": "Operation successful",
"error": null
}
GET/inbox
Über den Endpoint GET/inbox kann die Liste aller im Posteingang vorhandenen empfangenen E-Mails abgerufen werden.
In der Anfrage müssen Benutzername und Passwort des Postfachs im Header übermittelt werden. Außerdem kann angegeben werden, dass die Ergebnisse auf mehrere Seiten aufgeteilt oder über den Parameter "q" eine Suche durchgeführt werden soll.
{
"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
}
GET/inbox/unread
Der Endpoint GET/inbox/unread ermöglicht dagegen den Abruf der Liste aller empfangenen E-Mails im Posteingang, die noch nicht geöffnet wurden.
{
"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
}
Um das Nutzungsvolumen der PEC sowie das absolute oder tägliche Limit zu überprüfen, muss der folgende Endpoint GET/quota verwendet werden. Im Header müssen Benutzername und Passwort des PEC-Massiva-Postfachs übermittelt werden.
GET/quota
Die Antwort gibt die Nutzung (usage) und die Gesamtkapazität (limit) des Posteingangs an. Die Daten werden in Megabyte angegeben.
{
"data": {
"usage": 171012,
"limit": 1048576,
"dailyUsage":{
"used": 120,
"limit": 3500
"remaining": 3380
}
},
"success": true,
"message": "",
"error": null
}Die PEC-Massiva-Dienste werden derzeit von Dutzenden öffentlichen und privaten Unternehmen aus völlig unterschiedlichen Branchen genutzt (wie Energie, Forderungsmanagement, Umweltdienstleistungen, Marketing, Konsortien, Zahlungsinstitute, Steuer- und Vergabestellen sowie Industrieunternehmen), die ein großes Volumen an rechtlich gültigen und nachverfolgbaren Mitteilungen (z. B. offizielle Dokumente und Verträge) verwalten müssen.
Brauchen Sie Hilfe?
Haben Sie die gewünschte Antwort nicht gefunden?
Füllen Sie alle Details aus, wir werden uns so schnell wie möglich bei Ihnen melden!
Zertifizierter Nachrichtenversand ist ein Dienst, der es Ihnen ermöglicht, über eine API rechtsgültige REM-Nachrichten (mit beliebigen Anhängen) auf massive und sichere Weise zu versenden.
Er erfordert keine Aktivierung einer Software und ermöglicht die Verwaltung einer großen Anzahl von Mitteilungen in Übereinstimmung mit den AGID-Vorschriften, zu sehr wettbewerbsfähigen Kosten und mit der Möglichkeit, ein Jahresabonnement zu beantragen, um bei einzelnen Posten zu sparen.
Massen-REM hat die folgenden Dimensionen:
Ja, Sie können die der PEC-Mailbox zugeordnete Domain auswählen und anpassen, indem Sie den speziellen Endpoint für die Domainverwaltung aufrufen. So können Sie beispielsweise die Domain Ihres Unternehmens anstelle der Standarddomain verwenden.
Ja, es ist möglich, eine maßgeschneiderte Domain für Massen-REM zu registrieren.
Ja, es hat volle rechtliche Gültigkeit (gemäß AGID-Vorschriften) und hat denselben Wert wie ein Einschreiben mit Rückschein. Dadurch ist es ein effektives und sicheres Werkzeug für offizielle Kommunikation, wie Benachrichtigungen, Verträge oder formelle Geschäftskommunikation.
Nachrichten, die über das eigene REM-Postfach (zertifizierte E-Mail) gesendet werden, garantieren:
Zertifizierter Nachrichtenversand API wurde für Unternehmen und Organisationen entwickelt, die ein großes Volumen an rechtsgültiger und nachvollziehbarer Kommunikation verwalten müssen, z.B. offizielle Dokumente und Verträge. Die Integration über API ist in diesen Fällen die ideale Lösung, da der Prozess automatisch, schnell und effizient ist. Ohne manuelle Eingriffe kann das Risiko von Fehlern minimiert werden.
Der Endpoint `POST /send` ermöglicht das Senden einer einzelnen Nachricht, ohne eine nachverfolgbare Unterhaltung zu erstellen.
Der Endpoint `POST /threads` hingegen ermöglicht das Erstellen und Verwalten einer nachverfolgbaren Unterhaltung. Über die entsprechenden Thread-Endpoints kann auf die gesamte Unterhaltung, einschließlich gesendeter und empfangener Nachrichten, zugegriffen und der Kommunikationsverlauf gespeichert werden.
Darüber hinaus gibt es einen Unterschied bei der Handhabung des täglichen Versandlimits. Wenn das Limit erreicht wurde:
Ja, standardmäßig erlaubt der Service maximal 3.500 Nachrichten pro Tag.
Wenn Sie ein höheres Limit benötigen, kontaktieren Sie uns gerne, um eine Erhöhung zu prüfen.
Die Dienstleistung wird innerhalb von 24 Stunden erbracht.
Für den Mass-PEC-Service fällt eine jährliche Aktivierungsgebühr von 99 € an.
Bei nutzungsbasierter Abrechnung kostet jeder API-Aufruf 0,05 € pro versendeter Nachricht.
Alternativ stehen Jahresabonnements zur Verfügung, mit denen sich die Kosten pro API-Aufruf – abhängig vom im Tarif enthaltenen Nachrichtenvolumen – auf bis zu 0,02 € pro Aufruf reduzieren lassen.