Activer et gérer Legalmail PEC et Digital Domicile via API

Sur Openapi, vous pouvez activer, renouveler et étendre l’espace de stockage de votre boîte aux lettres de courrier électronique certifié InfoCert Legalmail, Domicilo Digitale et Pecmassiva.

Grâce à l'API PEC, il est possible de se conformer à la législation en vigueur pour effectuer la déclaration d'enregistrement ou de modification de l’adresse PEC d'une entreprise, ainsi que pour communiquer l’adresse PEC de l’administrateur.
Il est nécessaire d’initier la demande via l’endpoint POST /comunica_pec (l’ID sera fourni dans la réponse), de charger le document de délégation via POST /comunica_pec/{id}/procura_registro_imprese et d’envoyer/finaliser la demande via l’endpoint dédié GET /comunica_pec/{id}.

Pour compléter correctement la demande de communication, il faut :

  • disposer d’une boîte PEC active (même si elle n’a pas été activée avec Openapi)

  • posséder une signature électronique valide

  • être le représentant légal de l’entreprise ou un intermédiaire mandaté

Un domaine certifié est un domaine pour lequel le fournisseur PEC a vérifié le contrôle par le titulaire (entreprise ou professionnel), et qui peut être utilisé pour des boîtes PEC personnalisées. Avec Openapi, via l’endpoint GET /domini_pec/{domaine}, il est possible de vérifier non seulement si une adresse email contient le domaine d’un fournisseur PEC (par exemple @legalmail.com ou @pec.it), mais aussi si elle est associée à l’un des plus de 250 000 domaines certifiés.

Pour effectuer une demande au endpoint GET /domini_pec/{dominio}, vous devez transmettre le domaine de l'email certifié dans le corps de la demande en tant que valeur.

Avant de procéder à une demande d'activation, il est nécessaire de vérifier la disponibilité d'une adresse d'email certifié via la méthode GET /verifica_pec/{pec}.

Pour effectuer une demande au endpoint GET /verifica_pec/{pec} et vérifier ainsi la disponibilité d'une adresse d'email certifié, il est nécessaire de transmettre l'adresse complète de l'email certifié dans le corps de la demande en tant que valeur, par exemple: [email protected].

Actuellement, il n'est possible de vérifier la disponibilité que des les email certifiés Legalmail et Digital Domicile.

Vous pouvez consulter la liste complète des email certifiés enregistrés via le compte Openapi avec l'endpoint GET /pec.

 

Aucun paramètre ou valeur n'est nécessaire dans le corps de la requête.

La réponse à la demande indiquera des informations telles que l'adresse d'email certifiés, le type de boîte, le statut, la date d'expiration, l'enregistrement.

Vous pouvez enregistrer les types de boîtes d'email certifiés suivants:

  • 'box_name'@legalmail.it (par exemple [email protected]) pour les boîtes STANDARD, BRONZE, SILVER ET GOLD ;
  • 'box_name'@domiciliodigitale.com (par exemple [email protected]) pour la boîte DOMICILIODIGITALE ;
  • 'box_name'@pecmassive.com (E.g. [email protected]) pour la boîte PECMASSIVA.

Il est possible d'enregistrer une adresse d'email certifié via l'endpoint POST /pec.

Veuillez noter que l'enregistrement ne prévoit pas automatiquement l'activation de la boîte PEC, qui doit être réalisée en envoyant la documentation nécessaire via l'endpoint PATCH /pec/{id}/activation. L'identifiant est présent dans la réponse à la requête POST /pec .

Pour compléter l'activation d'un CEP, il est nécessaire d'envoyer via la méthode PATCH /pec/{id}/attivazione:

  • une pièce d'identité valide
  • le formulaire d'activation complété et signé

Pour les cases de type DOMICILIODIGITALE et PECMASSIVA, il est nécessaire de créer un document unique composé du formulaire d'activation signé et de la pièce d'identité.

Les documents doivent être au format PDF.

Le formulaire d'activation est disponible via la méthode GET/pec/{id}/modulo_attivazione.

Le formulaire d'activation est disponible en utilisant la méthode GET/pec/{id}/modulo_attivazione.

L'identifiant est présent dans la réponse à la requête POST /pec .

Le statut d'une boîte d'email certifié peut être:

  • registrata (enregistré)
  • in_attivazione (en_activation)
  • evasa (évadé)
  • revocata (révoqué)
  • chiusa (fermée)

Le statut "registrata" ("enregistré") signifie que l'adresse de l'email certifié a été enregistrée via l'endpoint POST /pec, mais que la documentation nécessaire (documents et formulaire d'activation complété et signé) doit être envoyée pour activer la boîte. Pour envoyer la documentation, la méthode GET/pec/{id}/modulo_attivazione doit être utilisée. Une fois la demande terminée, le statut passera à "in_attivazione" ("en_activation").

Une fois la documentation envoyée, elle sera vérifiée et, dans quelques heures, le statut de l'email certifié passera à "evasa" ("évadé") et la boîte sera utilisable.

Il est possible à tout moment de vérifier le statut d'une email certifié via la méthode GET /pec/{id}.

Le statut "revocata" ("révoqué") peut signifier que l'adresse de l'email certifié n'a pas été renouvelée ou que la révocation a été demandée via la méthode dédiée (DELETE /pec/{id}).

Oui, il est possible de modifier les caractéristiques de l'email certifié, pour l'instant uniquement pour les boîtes Legalmail.

Vous pouvez notamment:

  • augmenter la taille de l'inbox (méthode PATCH /pec/{id}/modifica)
  • augmenter la taille de l'archive de sécurité (PATCH /pec/{id}/modifica)
  • activer la conservation (PATCH /pec/{id}/conservazione)
  • passer d'un type de boîte à un autre, par exemple de bronze à silver (PATCH /pec/{id}/transformazione).

Vous pouvez renouveler un'e-mail certifié pour une ou plusieurs années via l'endpoint GET /pec/{id}/renewal.

Dans la demande de renouvellement, vous devrez transmettre l'identifiant associé à l'enregistrement/activation.

L'endpoint GET /pec vous permet d'obtenir les données, y compris l'ID, de tous les e-mail certifiés activés.