€17.36 + MwSt
Verwalten Sie die Aktivierung und Verlängerung eines oder mehrerer PEC-Postfächer Legalmail per API. Ideal für Privatpersonen und Freiberufler, die keine großen Mengen an PEC-Nachrichten senden oder empfangen müssen.
Mit der API Legalmail Elektronisches Einschreiben (REM) prüfen, aktivieren, verwalten und verlängern Sie Legalmail-Postfächer von InfoCert direkt aus Ihrer Software. Legalmail ist die italienische zertifizierte E-Mail (PEC), die nun dem europäischen REM-Standard entspricht. Sie können Postfächer für Ihr eigenes Unternehmen oder im Auftrag Dritter aktivieren, zum Beispiel indem Sie den Verkauf und die Aktivierung von REM-Postfächern für Privatpersonen, Freiberufler und Unternehmen in Ihr Portal oder Ihre Verwaltungssoftware integrieren.
REM hat denselben Rechtswert wie ein Einschreiben mit Rückschein: Es bestätigt Versand und Zustellung, garantiert die Integrität des Inhalts und belegt Datum und Uhrzeit der Übermittlung. Mit einer einzigen Integration verwalten Sie alle Legalmail-Postfachtypen, von Standard bis Gold.
Alle Legalmail-Postfächer beinhalten:
Die Basislösung für alle, die keine großen Mengen zertifizierter Nachrichten senden oder empfangen müssen. Geeignet für Privatpersonen, Freiberufler und KMU.
Mehr Speicherplatz für die regelmäßige Nutzung, weiterhin ohne große Versandvolumen. Geeignet für Privatpersonen, Freiberufler und KMU.
Für alle, die mehr Speicherplatz benötigen und per zertifizierter E-Mail empfangene E-Rechnungen einfacher verwalten möchten.
Die umfassendste Lösung für alle, die viel Speicherplatz und ein hohes Sicherheitsniveau benötigen. Enthält alle Funktionen von Silver.
Der Aktivierungsprozess ist für alle Postfächer gleich: Nur der Wert des Parameters tipo_casella ändert sich.
Im ersten Schritt prüfen Sie über den Endpunkt GET /verifica_pec/{pec}, ob die gewünschte Adresse verfügbar ist.
GET /verifica_pec/{pec}
GET https://pec.openapi.it/verifica_pec/[email protected]
GET /verifica_pec/{pec}
Ist die Adresse verfügbar, gibt das Feld available den Wert true zurück:
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}
Nach der Verfügbarkeitsprüfung registrieren Sie das Postfach über den Endpunkt POST /pec. Der Request-Body muss Folgendes enthalten:
Um das zu aktivierende Postfach auszuwählen, geben Sie im Parameter tipo_casella einen dieser Werte an:
Wenn Sie den optionalen Parameter "autorinnovo" auf true setzen, aktivieren Sie zusätzlich die automatische Verlängerung (Standardwert ist false).
POST /pec
Dies ist ein vereinfachtes Payload-Beispiel für ein Standard-Postfach. Die vollständige Liste der Felder finden Sie in der Dokumentation.
{
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"tipo_cliente": "PV",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"provincia_titolare": "rm",
"autorinnovo": true,
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data"
}
}
POST /pec
Die Antwort fasst die Merkmale des Postfachs zusammen und gibt dessen Status und ID an. Die ID benötigen Sie, um die Aktivierung abzuschließen, den Status zu prüfen und das Postfach langfristig zu verwalten.
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "STANDARD",
"dominio": "legalmail.it",
"cod_attivazione": "10173956",
"stato": "registrata",
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": true
},
"success": true,
"message": "",
"error": null
}
Um die Aktivierung abzuschließen, laden Sie die erforderlichen Formulare über GET /pec/{id}/modulo_attivazione herunter. Anschließend senden Sie das ausgefüllte und unterschriebene Formular zusammen mit dem Ausweisdokument des Antragstellers über PATCH /pec/{id}/attivazione, unter Angabe der bei der Registrierung erhaltenen ID.
PATCH /pec/{id}/attivazione
Das Postfach wechselt in den Status in_evasione (in Bearbeitung), und die Antwort listet die hochgeladenen Aktivierungsdokumente auf:
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"stato": "in_evasione",
"documenti_attivazione": [
"6040e4613a716838dc4eee0e_0_attivazione.pdf",
"6040e4613a716838dc4eee0e_1_attivazione.pdf"
],
"id": "6040e4613a716838dc4eee0e"
},
"success": true,
"message": "",
"error": null
}
Nach Abschluss der Aktivierung sendet InfoCert die Zugangsdaten für das neue Postfach direkt an den Antragsteller.
Sie können den Status des Postfachs jederzeit über den Endpunkt GET /pec/{id} prüfen.
GET /pec/{id}
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e
GET /pec/{id}
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"stato": "registrata",
"data_attivazione": "04/03/2021",
"timestamp": {
"registrazione": 1614865504,
"evasione": 1614865504,
"scadenza": 1614868403,
"revoca": null
},
"spazio_disco": 1024,
"spazio_storico": 1024,
"conservazione": false,
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": true
},
"success": true,
"message": "",
"error": null
}
Nach der Aktivierung wächst Ihr Postfach mit Ihren Anforderungen, und zwar über einen einzigen Endpunkt: PATCH /pec/{id}. Mit diesem Aufruf können Sie:
Alternativ kann die Verlängerung automatisch erfolgen, wenn Sie bei der Registrierung den Parameter "autorinnovo" auf true gesetzt haben.
Der REM-Service bietet außerdem:
Die API Legalmail Elektronisches Einschreiben (REM) wird von Softwarehäusern, Banken und Finanzinstituten, Portalen für Steuerberater, öffentlichen Verwaltungen und Großunternehmen genutzt. Sie richtet sich an alle, die ihren Kunden die Aktivierung jedes Legalmail-Postfachtyps anbieten oder die Postfächer der eigenen Organisation automatisiert, sicher und zertifiziert verwalten möchten.
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!