Legalmail CEM for sending communications and documents securely and with full legal value
On Openapi, you can activate, renew, and extend the storage of your InfoCert Legalmail, Domicilio Digitale, and Pecmassiva Certified Email Mailbox.
No. Under AgID regulations, two active certifications cannot exist simultaneously for the same domain. Furthermore, simply changing the DNS records (MX) is not sufficient to complete the transfer.
To transfer a certified domain from one provider to another, the following steps must be completed:
1) De-certification with the previous provider
The domain owner, or the legal representative, must send a written request via PEC to the previous provider requesting the termination of the active certification.
2) Removal from the IGPEC registry
The previous provider must remove the domain from the national registry of certified domains (IGPEC), managed by AgID.
3) New certification with us
Once the domain has been removed from IGPEC, you can proceed with the new certification and purchase the service through DominiCertificati.com, then complete the required DNS configuration (MX and TXT SPF records).
4) Mailbox content migration
The migration of messages and other content from the old mailbox must be handled separately. Generally, the previous provider keeps the mailbox available for a limited period, for example 60 days, during which you can access and save its contents.
With the PEC API, you can comply with current regulations to complete the notification of PEC registration or changes for a company, and to communicate the administrator’s PEC.
You must start the request via the POST /comunica_pec endpoint (the response will return the ID), upload the delegation document via POST /comunica_pec/{id}/procura_registro_imprese, and send/finalize the request using the dedicated GET /comunica_pec/{id} endpoint.
To successfully complete the communication request, the following is required:
-
an active PEC mailbox (even if not activated with Openapi)
-
a valid digital signature
-
to be the legal representative of the company or an authorized intermediary
A certified domain is a domain for which the PEC provider has verified ownership by the holder (company or professional) and which can be used for custom PEC mailboxes. With Openapi, using the endpoint GET /domini_pec/{domain}, you can verify not only if an email address includes the domain of a PEC provider (e.g. @legalmail.com or @pec.it), but also if it is associated with one of over 250,000 certified domains.
Before proceeding with any activation request, it is necessary to verify the availability of a PEC address using the method: GET /verifica_pec/{pec}.
To make a request to the GET /domini_pec/{dominio} endpoint you need to pass in the body of the request as the value the domain of the PEC.
You can check the full list of registered CEMs via the same Openapi account with the GET /pec endpoint.
To make a request to the GET /verifica_pec/{pec} dominio and thus verify the availability of a Certified Email address, it is necessary to pass in the body of the request as the value the full address of the Certified Email, for example: [email protected].
Currently it is only possible to check the availability of Legalmail and Domicilio Digitale CEMs.
You can register the following types of Certified Email boxes:
- 'box_name'@legalmail.it (Ex. [email protected]) for STANDARD, BRONZE, SILVER AND GOLD boxes;
- 'box_name'@domiciliodigitale.com (Ex. [email protected]) for the DOMICILIODIGITALe box;
- 'box_name'@pecmassiva.com (Ex. [email protected]) for the PECMASSIVA box.
No parameter or value is needed in the body of the request.
The response to the request will indicate information such as CEM address, box type, status, expiration date, registration.
You can proceed to register a Certified Email address via the POST /pec endpoint.
Remember that registration does not automatically provide for activation of the Certified Email box, which must be completed by sending the necessary documentation via the PATCH endpoint /pec/{id}/activation. The id is present in the response to the POST /pec request.
To complete the activation of a Certified Email (CEM/PEC), it is necessary to send via the PATCH method /pec/{id}/activation:
- valid ID document
- completed and signed activation form
For DOMICILIODIGITALE and PECMASSIVA boxes, it is necessary to create a single document consisting of the signed activation form and the ID document.
The documents must be in PDF format.
The activation form is available using the GET/pec/{id}/modulo_attivazione method.
The activation form is available using the GET/pec/{id}/modulo_attivazione method.
The id is present in the POST request response /pec .
A PEC mailbox can have one of the following statuses:
- registrata
- in_evasione
- evasa
- revocata
- chiusa
The “registrata” (registered) status means the PEC address has been registered via the POST /pec endpoint, but the mailbox is not active yet. To activate it, you need to submit the required documentation: the activation form, completed and signed, and the applicant’s ID document. You can download the form with GET /pec/{id}/modulo_attivazione and submit the documentation with PATCH /pec/{id}/attivazione.
The “in_evasione” (processing) status means the documentation has been submitted successfully and the activation request is being processed. Once activation is complete, the status will change to “evasa” (completed).
You can check the status of a mailbox at any time with GET /pec/{id}.
Yes, you can change the features of an active PEC. Specifically, you can:
- increase the mailbox (inbox) size with
PATCH /pec/{id}/modifica - increase the security archive size with
PATCH /pec/{id}/modifica - enable digital preservation with
PATCH /pec/{id}/conservazione
For Legalmail mailboxes only, you can also upgrade from one mailbox type to another, for example from Bronze to Silver, with PATCH /pec/{id}/trasformazione.
You can renew a PEC for one or more years with the GET /pec/{id}/rinnovo?anni=N endpoint, where N is the number of years to renew.
The request must include the mailbox ID, which you receive in the response to POST /pec during registration. If you don’t have it at hand, you can retrieve the details of all your activated PECs, ID included, with GET /pec.
A mailbox in “revocata” (revoked) status can be renewed within 6 months of expiry for the Legalmail line and within 1 month for the Digital Domicile line.