Communication de la REM au Registre du Commerce d'Italie

L'API PEC permet de vérifier, activer, gérer, communiquer et renouveler toutes les boîtes PEC Legalmail ainsi que la boîte Domicilio Digitale. Grâce à cette API, il est également possible d’activer la boîte PEC Postamassiva, conçue pour l’envoi massif de messages certifiés. L’API PEC peut être utilisée pour activer des PEC pour sa propre entreprise et ses employés, ou pour la revente à des tiers.

Communication PEC à la Chambre de Commerce

La Communication PEC à la Chambre de Commerce est le service exclusif d’Openapi qui permet d’automatiser le processus de communication de l’adresse de Courrier Électronique Certifié (PEC) à la Chambre de Commerce. Ce service est indispensable pour les nouvelles inscriptions, les modifications statutaires et les communications concernant les administrateurs, le tout directement via API et en quelques secondes.

Les types de communication pris en charge sont :

Le service prend en charge tout type de boîte PEC, y compris celles non activées via Openapi, garantissant une flexibilité maximale.

Pour procéder à la communication de la PEC, il est nécessaire d'effectuer les requêtes API suivantes.

Requête de Communication PEC

Le premier endpoint utile pour la communication de la PEC est POST /comunica_pec. Il permet d’initialiser la demande.

EXEMPLE DE REQUÊTE

POST /comunica_pec/

Voici un exemple de requête pour la communication de l’adresse PEC [email protected]

https://pec.openapi.it/comunica_pec

Le corps de la requête doit inclure les valeurs suivantes :

Voici un exemple de Payload :

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

Dans ce cas, la demande concerne la communication d’une adresse PEC de Domicile Numérique, et le champ "pec_amministratore" a été défini sur true pour indiquer qu’il s’agit d’une communication PEC de l’administrateur de la société, et non d’une inscription ou modification de la PEC de l’entreprise. Il est également possible, à ce stade, de définir un callback pour être notifié en cas de changement d’état de la requête (par exemple, en cas de complétion).

EXEMPLE DE RÉPONSE

POST /comunica_pec

La réponse contiendra une série d’informations, en particulier l’état d’activation et l’ID. Cet ID est essentiel pour vérifier l’état et la complétion de la requête.

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

Les états disponibles pour la requête sont : codice_in_richiesta (code en cours), in_attesa_di_documenti (en_attente_de_documents), documenti_caricati (documents_téléchargés), comunicazione_evasa (communication_traitée).

Télécharger le Formulaire de Communication

GET/comunica_pec/{id}/procura_registro_imprese

Après avoir initialisé la demande, il est nécessaire de télécharger le formulaire de procuration pour la communication. La réponse sera un PDF

Compléter la Requête de Communication

Pour compléter l’activation, il est nécessaire d’envoyer le formulaire correctement rempli et signé numériquement au format p7m, ainsi qu’une pièce d’identité du demandeur, via l’endpoint PATCH /comunica_pec/{id}. L’ID est celui obtenu dans la réponse précédente.

EXEMPLE DE REQUÊTE

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

Le fichier (encodé en base64) p7m devra être transmis dans le payload

EXEMPLE DE RÉPONSE

La réponse sera la suivante :

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

Vérification de l'état de la demande de communication PEC

Il est possible de vérifier à tout moment l'état de la communication PEC via l'endpoint GET /comunica_pec/{id} .

EXEMPLE DE REQUÊTE

GET /comunica_pec/{id}

La requête pour vérifier l’état de la PEC précédemment activée avec l’id 60ad149c3a7168084f1d2b68 sera :

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

EXEMPLE DE RÉPONSE

GET /pec/{id}

Voici un exemple de réponse :

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

L'API PEC est utilisée par des éditeurs de logiciels, des banques et institutions financières, des portails pour comptables, des administrations publiques et des grandes entreprises. Elle permet aux clients d’activer tout type de boîte PEC, de gérer leurs communications de manière sécurisée et certifiée, et d’automatiser les processus de communication avec le registre des entreprises.