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.
Non. Conformément à la réglementation AgID, deux certifications actives ne peuvent pas être présentes simultanément sur le même domaine. De plus, la simple modification des enregistrements DNS (MX) ne suffit pas pour effectuer le transfert.
Pour transférer un domaine certifié d’un fournisseur à un autre, il est nécessaire de suivre les étapes suivantes :
1) Décertification auprès de l’ancien fournisseur
Le titulaire du domaine, ou son représentant légal, doit envoyer à l’ancien fournisseur une demande écrite par PEC afin de demander la clôture de la certification active.
2) Suppression du registre IGPEC
L’ancien fournisseur doit supprimer le domaine du registre national des domaines certifiés (IGPEC), géré par l’AgID.
3) Nouvelle certification auprès de nos services
Une fois le domaine supprimé du registre IGPEC, vous pouvez procéder à une nouvelle certification et acheter le service via DominiCertificati.com, puis effectuer la configuration DNS requise (enregistrements MX et TXT SPF).
4) Migration du contenu de la boîte mail
La migration des messages et des autres contenus de l’ancienne boîte mail doit être gérée séparément. En général, l’ancien fournisseur maintient la boîte mail disponible pendant une période limitée, par exemple 60 jours, au cours de laquelle il est possible d’accéder aux contenus et de les sauvegarder.
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 .
Une boîte PEC peut avoir l’un des statuts suivants :
- registrata
- in_evasione
- evasa
- revocata
- chiusa
Le statut « registrata » (enregistrée) signifie que l’adresse PEC a été enregistrée via l’endpoint POST /pec, mais que la boîte n’est pas encore active. Pour l’activer, vous devez envoyer les documents requis : le formulaire d’activation rempli et signé, ainsi que la pièce d’identité du demandeur. Vous pouvez télécharger le formulaire avec GET /pec/{id}/modulo_attivazione et envoyer les documents avec PATCH /pec/{id}/attivazione.
Le statut « in_evasione » (en cours de traitement) signifie que les documents ont bien été envoyés et que la demande d’activation est en cours de traitement. Une fois l’activation terminée, le statut passera à « evasa » (traitée).
Vous pouvez vérifier le statut d’une boîte à tout moment avec GET /pec/{id}
Oui, vous pouvez modifier les caractéristiques d’une PEC active. Vous pouvez notamment :
- augmenter la taille de la boîte de réception avec
PATCH /pec/{id}/modifica - augmenter la taille de l’archive de sécurité avec
PATCH /pec/{id}/modifica - activer l’archivage à valeur probante avec
PATCH /pec/{id}/conservazione
Pour les boîtes Legalmail uniquement, vous pouvez également passer d’un type de boîte à un autre, par exemple de Bronze à Silver, avec PATCH /pec/{id}/trasformazione.
Vous pouvez renouveler une PEC pour une ou plusieurs années avec l’endpoint GET /pec/{id}/rinnovo?anni=N, où N correspond au nombre d’années de renouvellement.
La requête doit inclure l’ID de la boîte, que vous recevez dans la réponse à la POST /pec lors de l’enregistrement. Si vous ne l’avez pas sous la main, vous pouvez récupérer les données de toutes vos PEC activées, ID compris, avec GET /pec.
Une boîte au statut « revocata » (révoquée) peut être renouvelée dans un délai de 6 mois après son expiration pour la gamme Legalmail, et de 1 mois pour la gamme Domicilio Digitale.