€17.36 + TVA
Gérez l’activation et le renouvellement d’une ou plusieurs boîtes PEC Legalmail via API. Service idéal pour les particuliers et les professions libérales qui n’ont pas besoin d’envoyer ou de recevoir de grands volumes de messages PEC.
Avec l'API Legalmail Courrier électronique recommandé (REM), vous vérifiez, activez, gérez et renouvelez les boîtes Legalmail d'InfoCert directement depuis votre logiciel. Legalmail est le courrier électronique certifié italien (PEC), désormais conforme au standard européen REM. Vous pouvez activer des boîtes pour votre propre entreprise ou pour le compte de tiers, par exemple en intégrant la vente et l'activation de boîtes REM pour les particuliers, les professionnels et les entreprises dans votre portail ou logiciel de gestion.
Le REM a la même valeur légale qu'une lettre recommandée avec accusé de réception : il certifie l'envoi et la remise, garantit l'intégrité du contenu et atteste la date et l'heure de transmission. Avec une seule intégration, vous gérez tous les types de boîtes Legalmail, de la Standard à la Gold.
Toutes les boîtes Legalmail incluent :
La solution de base pour ceux qui n'ont pas besoin d'envoyer ou de recevoir de grands volumes de messages certifiés. Adaptée aux particuliers, aux professions libérales et aux PME.
Plus d'espace pour un usage régulier, toujours sans grands volumes d'envoi. Adaptée aux particuliers, aux professions libérales et aux PME.
Pour ceux qui ont besoin de plus d'espace et souhaitent gérer plus simplement les factures électroniques reçues par courrier certifié.
La solution la plus complète, pour ceux qui ont besoin de grands espaces de stockage et d'un niveau de sécurité élevé. Inclut toutes les fonctionnalités de la Silver.
Le processus d'activation est le même pour toutes les boîtes : seule la valeur du paramètre tipo_casella change.
La première étape consiste à vérifier que l'adresse souhaitée est disponible, via l'endpoint GET /verifica_pec/{pec}.
GET /verifica_pec/{pec}
GET https://pec.openapi.it/verifica_pec/[email protected]
GET /verifica_pec/{pec}
Si l'adresse est disponible, le champ available renvoie true :
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}
Une fois la disponibilité vérifiée, enregistrez la boîte via l'endpoint POST /pec. Le corps de la requête doit inclure :
Pour choisir la boîte à activer, indiquez l'une de ces valeurs dans le paramètre tipo_casella :
En définissant le paramètre facultatif "autorinnovo" sur true, vous activez également le renouvellement automatique (par défaut, il est sur false).
POST /pec
Voici un exemple simplifié de payload pour une boîte Standard. La liste complète des champs est disponible dans la documentation.
{
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"tipo_cliente": "PV",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "[email protected]",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"provincia_titolare": "rm",
"autorinnovo": true,
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data"
}
}
POST /pec
La réponse récapitule les caractéristiques de la boîte et indique son statut et son ID. Vous aurez besoin de l'ID pour finaliser l'activation, vérifier le statut et gérer la boîte dans le temps.
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "STANDARD",
"dominio": "legalmail.it",
"cod_attivazione": "10173956",
"stato": "registrata",
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": true
},
"success": true,
"message": "",
"error": null
}
Pour finaliser l'activation, téléchargez les formulaires requis via GET /pec/{id}/modulo_attivazione. Envoyez ensuite le formulaire rempli et signé, accompagné de la pièce d'identité du demandeur, via PATCH /pec/{id}/attivazione, en utilisant l'ID obtenu lors de l'enregistrement.
PATCH /pec/{id}/attivazione
La boîte passe au statut in_evasione (en cours de traitement) et la réponse indique les documents d'activation chargés :
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"stato": "in_evasione",
"documenti_attivazione": [
"6040e4613a716838dc4eee0e_0_attivazione.pdf",
"6040e4613a716838dc4eee0e_1_attivazione.pdf"
],
"id": "6040e4613a716838dc4eee0e"
},
"success": true,
"message": "",
"error": null
}
Une fois l'activation terminée, InfoCert envoie directement au demandeur les identifiants d'accès à la nouvelle boîte.
Vous pouvez vérifier à tout moment le statut de la boîte via l'endpoint GET /pec/{id}.
GET /pec/{id}
GET https://pec.openapi.it/pec/6040e4613a716838dc4eee0e
GET /pec/{id}
{
"data": {
"casella_pec": "[email protected]",
"tipo_casella": "standard",
"stato": "registrata",
"data_attivazione": "04/03/2021",
"timestamp": {
"registrazione": 1614865504,
"evasione": 1614865504,
"scadenza": 1614868403,
"revoca": null
},
"spazio_disco": 1024,
"spazio_storico": 1024,
"conservazione": false,
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": true
},
"success": true,
"message": "",
"error": null
}
Après l'activation, votre boîte évolue avec vos besoins grâce à un seul endpoint : PATCH /pec/{id}. Avec cet appel, vous pouvez :
Le renouvellement peut aussi être automatique si vous avez défini le paramètre "autorinnovo" sur true lors de l'enregistrement.
Le service REM propose également :
L'API Legalmail Courrier électronique recommandé (REM) est utilisée par les éditeurs de logiciels, les banques et institutions financières, les portails pour experts-comptables, les administrations publiques et les grandes entreprises. Elle est conçue pour ceux qui souhaitent proposer à leurs clients l'activation de tout type de boîte Legalmail, ou gérer les boîtes de leur organisation de manière automatisée, sécurisée et certifiée.
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
L’API Legalmail REM permet de vérifier, activer, gérer, renouveler et faire évoluer via API les boîtes Legalmail d’InfoCert. Legalmail permet d’envoyer des messages et des documents de manière sécurisée, avec la même valeur légale qu’une lettre recommandée avec accusé de réception. Grâce à l’API, vous pouvez activer des boîtes pour votre propre entreprise ou pour le compte de tiers, par exemple en proposant l’activation de boîtes à vos clients directement depuis votre portail ou logiciel de gestion.
Grâce à l’API, vous pouvez activer quatre types de boîtes Legalmail, de la plus simple à la plus complète :
Legalmail Standard est la solution de base, conçue pour ceux qui n’ont pas besoin d’envoyer ou de recevoir de grands volumes de messages certifiés. Elle est adaptée aux particuliers, aux professions libérales et aux PME. Elle offre 2 Go d’espace au total (1 Go d’espace de réception et 1 Go d’archive de sécurité) et inclut :
Legalmail Bronze offre plus d’espace que la Standard, pour ceux qui utilisent le courrier certifié régulièrement mais sans grands volumes d’envoi. Elle est adaptée aux particuliers, aux professions libérales et aux PME. Elle offre 5 Go d’espace au total (2 Go d’espace de réception et 3 Go d’archive de sécurité), ne prévoit aucun coût par envoi et inclut toutes les fonctionnalités de la Standard.
Legalmail Silver est conçue pour ceux qui ont besoin de plus d’espace et souhaitent gérer plus simplement les factures électroniques reçues par courrier certifié. Elle offre 8 Go d’espace au total (2 Go d’espace de réception et 6 Go d’archive de sécurité). En plus des fonctionnalités de la Bronze, elle inclut :
Legalmail Gold est la solution la plus complète, pour ceux qui gèrent de grands volumes de messages et ont besoin d’importants espaces de stockage et d’un niveau de sécurité élevé. Elle offre 18 Go d’espace au total (5 Go d’espace de réception et 13 Go d’archive de sécurité). Elle inclut toutes les fonctionnalités de la Silver, ainsi que les services de cybersécurité Phishing Protection et Password Protection.
L’Archive de sécurité est la sauvegarde automatique des messages de votre boîte. Elle enregistre une copie des messages entrants et sortants, avec leurs pièces jointes et leurs reçus, pour que rien ne soit perdu même si vous supprimez un message ou si votre boîte est pleine. Depuis le webmail, vous pouvez choisir les types de messages à archiver, rechercher les messages enregistrés et, si nécessaire, en restaurer une copie dans votre boîte.
La fonctionnalité Envois en masse permet d’envoyer le même message certifié à de nombreux destinataires en une seule opération, directement depuis le webmail Legalmail. Il suffit d’importer la liste des destinataires depuis un fichier CSV, de personnaliser le message pour chacun et de recevoir à la fin un rapport indiquant le résultat de chaque envoi. Chaque message conserve la pleine valeur légale du courrier certifié.
Toutes les boîtes Legalmail, de la Standard à la Gold, s’activent pour un an et peuvent être renouvelées à chaque fois pour une période de 1 à 3 ans. Le renouvellement s’effectue via l’endpoint PATCH /pec/{id}, en indiquant l’ID obtenu lors de l’enregistrement. Vous pouvez aussi activer le renouvellement automatique dès l’enregistrement : votre boîte reste ainsi active sans avoir à le demander à chaque fois.
Oui. Une fois activée, vous pouvez modifier la boîte à tout moment via l’endpoint PATCH /pec/{id}, en indiquant l’ID obtenu lors de l’enregistrement. En un seul appel, vous pouvez :
En plus des fonctionnalités incluses, vous pouvez enrichir les boîtes Legalmail avec des options supplémentaires :
Oui, le REM a pleine valeur légale et la même valeur qu’une lettre recommandée avec accusé de réception. Cela vaut pour toutes les boîtes Legalmail, de la Standard à la Gold. Les messages certifiés garantissent :
Oui. Grâce au service REM, vous pouvez activer un domaine certifié personnalisé, afin que les adresses de votre organisation portent le nom de votre entreprise. Deux types de personnalisation sont disponibles :
Une boîte Legalmail peut être activée aussi bien par des particuliers et des entreprises italiens qu’étrangers, à condition que ces derniers disposent d’un code fiscal italien (codice fiscale) ou d’un numéro de TVA italien.
Oui, toutes les boîtes Legalmail (Standard, Bronze, Silver et Gold) sont déjà prêtes pour la mise à niveau gratuite vers les nouveaux standards européens.
L’API s’adresse aux éditeurs de logiciels, aux banques et institutions financières, aux portails pour experts-comptables, aux administrations publiques et aux grandes entreprises. Elle permet d’activer tout type de boîte Legalmail pour gérer les communications de manière sécurisée et certifiée, pour soi-même ou pour ses clients.
Le service est traité en 2 heures pour tous les types de boîtes Legalmail.
Le coût dépend du type de boîte :