Mitteilung der PEC-Adresse an das Handelsregister

Die PEC-API ermöglicht die Überprüfung, Aktivierung, Verwaltung, Kommunikation und Erneuerung aller Legalmail-PECs sowie des digitalen Domizils. Über diese API kann auch das PEC-Postfach Postamassiva aktiviert werden, das für den Massenversand zertifizierter Nachrichten konzipiert ist. Die PEC-API kann sowohl zur Aktivierung von PECs für das eigene Unternehmen und seine Mitarbeiter als auch für den Weiterverkauf an Dritte genutzt werden.

PEC-Mitteilung an die Handelskammer

Die PEC-Mitteilung an die Handelskammer ist der exklusive Service von Openapi, der es ermöglicht, den Mitteilungsprozess der zertifizierten E-Mail-Adresse (PEC) an die Handelskammer zu automatisieren – unerlässlich für neue Eintragungen, Unternehmensänderungen und Mitteilungen zu Geschäftsführern. Alles erfolgt direkt über API und in wenigen Sekunden.

Die unterstützten Mitteilungsarten sind:

Der Dienst unterstützt jede Art von PEC-Postfach, auch solche, die nicht über Openapi aktiviert wurden, und garantiert maximale Flexibilität.

Um die Mitteilung der PEC durchzuführen, müssen folgende API-Anfragen gestellt werden.

PEC-Mitteilungsanfrage

Der erste nützliche Endpoint für die PEC-Mitteilung ist POST /comunica_pec. Über diesen kann die Anfrage initialisiert werden.

BEISPIELANFRAGE

POST/comunica_pec/

Dies ist ein Beispiel für eine Mitteilungsanfrage der PEC-Adresse [email protected]

https://pec.openapi.it/comunica_pec

Im Body der Anfrage müssen folgende Werte enthalten sein:

Dies ist ein Beispiel für ein Payload:

{
    "casella_pec": "[email protected]",
    "cf": "RSSXXXXXXXX56E",
    "nome": "mario",
    "cognome": "rossi",
    "qualifica": "GESCHÄFTSFÜHRER",
    "email": "[email protected]",
    "cellulare": "roma",  
    "ragione_sociale": "roma",  
    "cf_piva": "12345678910",
    "comune": "roma",
    "pec_amministratore": true,
    "provincia": "rm",
}

In diesem Fall betrifft die Anfrage die Mitteilung einer PEC-Adresse des Domicilio Digitale, und das Feld „pec_amministratore“ wurde auf true gesetzt, um anzugeben, dass es sich um die PEC-Mitteilung des Geschäftsführers handelt und nicht um die Anmeldung oder Änderung der PEC-Adresse des Unternehmens. In dieser Phase kann auch ein Callback gesetzt werden, um über den Statuswechsel der Anfrage (z. B. Abschluss) benachrichtigt zu werden.

BEISPIELANTWORT

POST /comunica_pec

Die Antwort enthält verschiedene Informationen, insbesondere den Aktivierungsstatus und die ID. Die ID ist wichtig, um den Status und den Abschluss der Anfrage zu überprüfen.

{
      "casella_pec": "[email protected]",
      "cf": "RSSXXXXXXXX56E",
      "nome": "mario",
      "cognome": "rossi",
      "qualifica": "GESCHÄFTSFÜHRER",
      "email": "[email protected]",
      "cellulare": "roma",  
      "ragione_sociale": "roma",  
      "cf_piva": "12345678910",
      "comune": "roma",
      "provincia": "rm",
      "callbak": "false",  
      "stato": "codice_in_richiesta",  
      "codice_registro_imprese": "openapi",
      "documenti_registro_imprese": [],
      "owner": "[email protected]",
      "timestamp": "1621955739",
      "id": "60ad149c3a7168084f1d2b68",
  }

Die verfügbaren Statuswerte für die Anfrage sind: codice_in_richiesta, in_attesa_di_documenti, documenti_caricati, comunicazione_evasa.

Mitteilungsformular herunterladen

GET/comunica_pec/{id}/procura_registro_imprese

Nach der Initialisierung der Anfrage muss das Vollmachtsformular für die Mitteilung heruntergeladen werden. Die Antwort wird das PDF-Dokument sein

Abschluss der Anfrage zur Kommunikation

GET /comunica_pec/{id}

Um die Aktivierung abzuschließen, muss das Formular, korrekt ausgefüllt und digital signiert im p7m-Format, zusammen mit dem Ausweis des Antragstellers über den Endpoint /comunica_pec/{id} gesendet werden. Die ID ist diejenige, die in der vorherigen Antwort erhalten wurde.

ANFRAGEBEISPIEL

https://pec.openapi.it/comunica_pec/60ad149c3a7168084f1d2b68

Im Payload muss die Datei (base64_encode) p7m übermittelt werden.

ANTWORTBEISPIEL

Die Antwort wird wie folgt sein:

{
      "casella_pec": "[email protected]",
      "cf": "RSSXXXXXXXX56E",
      "nome": "mario",
      "cognome": "rossi",
      "qualifica": "AMMINISTRATORE",
      "email": "[email protected]",
      "cellulare": "roma",  
      "ragione_sociale": "roma",  
      "cf_piva": "12345678910",
      "comune": "roma",
      "provincia": "rm",
      "callbak": "false",  
      "stato": "documenti_caricati",  
      "codice_registro_imprese": "openapi",
      "documenti_registro_imprese": [
          "60dc8da86c8b04624536bbb2_0_registro_imprese.p7m",
      ],
      "owner": "[email protected]",
      "timestamp": "1621955739",
      "id": "60ad149c3a7168084f1d2b68",
  }

Überprüfung des Status der Kommunikation der PEC-Anfrage

Der Status der PEC-Kommunikation kann jederzeit über den Endpoint GET /comunica_pec/{id} überprüft werden.

ANFRAGEBEISPIEL

GET /comunica_pec/{id}

Die Anfrage zur Überprüfung des Status der zuvor aktivierten PEC mit der ID 60ad149c3a7168084f1d2b68 lautet:

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

ANTWORTBEISPIEL

GET /comunica_pec/{id}

Dies ist ein Beispiel für eine Antwort:

{
      "casella_pec": "[email protected]",
      "cf": "RSSXXXXXXXX56E",
      "nome": "mario",
      "cognome": "rossi",
      "qualifica": "AMMINISTRATORE",
      "email": "[email protected]",
      "cellulare": "roma",  
      "ragione_sociale": "roma",  
      "cf_piva": "12345678910",
      "comune": "roma",
      "provincia": "rm",
      "callbak": "false",  
      "stato": "documenti_caricati",  
      "codice_registro_imprese": "openapi",
      "documenti_registro_imprese": [
          "60dc8da86c8b04624536bbb2_0_registro_imprese.p7m",
      ],
      "owner": "[email protected]",
      "timestamp": "1621955739",
      "id": "60ad149c3a7168084f1d2b68",
  }

Die PEC-API wird von Softwarehäusern, Banken, Finanzinstituten, Steuerberatern, öffentlichen Verwaltungen und großen Unternehmen genutzt. Sie ermöglicht den Kunden die Aktivierung jeglicher Art von PEC-Postfächern, sodass sie ihre Kommunikation sicher und zertifiziert verwalten und die Kommunikationsprozesse mit dem Handelsregister automatisieren können.