€4.50 + TVA
Gérez l'activation et le renouvellement d'une ou plusieurs boîtes PEC Domicilio Digitale via API. Service idéal pour les particuliers qui n'ont pas besoin d'envoyer ou de recevoir de grandes quantités de messages PEC et qui souhaitent avoir une boîte PEC avec l'extension domiciliodigitale.com.
Le service PEC vous permet de vérifier, d'activer, de gérer et de renouveler les boîtes aux lettres Domicile Numérique et toutes les solutions Legalmail PEC. L'API PEC peut être utilisée pour activer PEC pour votre entreprise ou pour des tiers, par exemple pour créer un site de vente et activer PEC pour les particuliers, les professionnels et les entreprises.
La boîte aux lettres PEC Domicile Numérique est la solution pour ceux qui n'ont pas besoin d'envoyer/recevoir de grandes quantités de messages PEC.
Elle peut être la solution idéale pour les particuliers, les indépendants et les PME.
La boîte aux lettres PEC Domicile Numérique comprend :
Pour procéder à l'activation d'une PEC Domicile Numérique, il est nécessaire de faire les demandes d'API suivantes.
GET/pec.openapi.it/verifica_pec/{pec}
Le premier point de terminaison utile pour l'activation du Domicile Numérique est GETpec.openapi.it/verifica_pec/{pec}, car cela permet de vérifier la disponibilité de l'adresse PEC souhaitée.
GET/verifica_pec
Ceci est un exemple de demande pour vérifier la disponibilité de l'adresse PEC impresa@domiciliodigitale.com
https://pec.openapi.it/verifica_pec/impresa@domiciliodigitale.com
Ceci est un exemple de réponse indiquant que l'adresse est disponible (available:true) :
{
"data": {
"available": true
},
"success": true,
"message": "",
"error": null
}
POST/pec.openapi.it/pec
Après avoir confirmé la disponibilité de la PEC, vous pouvez procéder à l'enregistrement via le point de terminaison POST/pec.openapi.it/pec
POST/pec.openapi.it/pec
Voici un exemple de requête :
https://pec.openapi.it/pec
Les valeurs suivantes doivent être incluses dans le corps de la requête :
Voici un exemple de charge utile :
{
"casella_pec": "yourpec@domiciliodigitale.com",
"tipo_casella": "Domicilio Digitale",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "mail@domain.com",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "roma",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data"
}
}
Dans ce cas, la requête concerne une boîte aux lettres PEC Domicilio Digitale, et la valeur 'DOMICILIODIGITALE' a été transmise dans le paramètre 'tipo_casella'.
Lors de la demande, il est également possible d'activer le renouvellement automatique en ajoutant le paramètre facultatif "autorinnovo" avec la valeur 'true' (par défaut, la valeur est actuellement 'false').
POST/pec.openapi.it/pec
La réponse contient une série d'informations, y compris un récapitulatif des caractéristiques de la boîte PEC, de l'état d'activation et de l'ID. L'ID est essentielle pour les étapes suivantes d'activation, de vérification de l'état et de renouvellement.
{
"data": {
"casella_pec": "yourpec@domiciliodigitale.com",
"tipo_casella": "DOMICILIODIGITALE",
"tipo_cliente": "PV",
"sottotipo_cliente": "",
"sottotipo_cliente_altro": "",
"nome_richiedente": "mario",
"cognome_richiedente": "rossi",
"email": "mail@domain.com",
"telefono": "0548798569",
"codice_fiscale_richiedente": "RSSXXXXXXXX56E",
"data_nascita_richiedente": "11/04/1982",
"sesso_richiedente": "M",
"nazione_nascita_richiedente": "IT",
"provincia_nascita_richiedente": "RM",
"denominazione_titolare": "",
"cf_piva_titolare": "",
"indirizzo_titolare": "via verdi 20",
"comune_titolare": "rome",
"cap_titolare": "00042",
"nazione_titolare": "IT",
"provincia_titolare": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"dominio": "domiciliodigitale.com",
"owner": "mail@domain.com",
"timestamp": {
"registrazione": 1614865504,
"ultima_modifica": 1614868403,
},
"cellulare": "",
"comune_nascita_richiedente": "",
"cod_attivazione": "10173956",
"uid": "MA177987",
"conservazione": false,
"data_scadenza": "",
"descrizione": "yourpec@domiciliodigitale.com",
"sms": false,
"spazio_conservazione": 0,
"spazio_disco": 0,
"spazio_storico": 0,
"stato": "registrata",
"storico": false,
"id": "6040e4613a716838dc4eee0e",
"autorinnovo": false
},
"success": true,
"message": "",
"error": null
}
PATCH /pec.openapi.it/pec/{id}/attivazione
Pour finaliser l'activation, vous devez télécharger les formulaires requis (GET/pec/{id}/modulo_attivazione) et soumettre le formulaire correctement rempli et signé, accompagné de la pièce d'identité du demandeur, via le PATCH /pec/{id}/attivazione. L'ID est celle obtenue dans la réponse précédente.
PATCH /pec/{id}/attivazione
La réponse sera comme suit :
{
"data": {
"boite_pec": "yourpec@domiciliodigitale.com",
"type_boite": "DOMICILIODIGITALE",
"type_client": "PV",
"sous_type_client": "",
"sous_type_client_autre": "",
"prenom_demandeur": "mario",
"nom_demandeur": "rossi",
"email": "mail@domain.com",
"telephone": "0548798569",
"code_fiscal_demandeur": "RSSXXXXXXXX56E",
"date_naissance_demandeur": "11/04/1982",
"sexe_demandeur": "M",
"pays_naissance_demandeur": "IT",
"province_naissance_demandeur": "RM",
"nom_titulaire": "",
"code_fiscal_vat_titulaire": "",
"adresse_titulaire": "via verdi 20",
"ville_titulaire": "roma",
"code_postal_titulaire": "00042",
"pays_titulaire": "IT",
"province_titulaire": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"domaine": "domiciliodigitale.com",
"proprietaire": "mail@domain.com",
"timestamp": {
"inscription": 1614865504,
"derniere_modification": 1614868403,
},
"mobile": "",
"ville_naissance_demandeur": "",
"code_activation": "10173956",
"uid": "MA177987",
"preservation": false,
"date_expiration": "",
"description": "yourpec@domiciliodigitale.com",
"sms": false,
"espace_preservation": 0,
"espace_disque": 1024,
"espace_historique": 1024,
"statut": "en_cours",
"historique": false,
"documents_activation": [
"6040e4613a716838dc4eee0e_0_activation.pdf",
"6040e4613a716838dc4eee0e_1_activation.pdf"
],
"date_activation": "04/03/2021",
"id": "6040e4613a716838dc4eee0e",
"renouvellement_automatique": false
},
"success": true,
"message": "",
"error": null
}
GET /pec.openapi.it/pec/{id}
Vous pouvez vérifier l'état de votre PEC à tout moment via le point de terminaison GET/pec/{id}.
La requête pour vérifier l'état du PEC activé précédemment avec l'ID 6040e4613a716838dc4eee0e est :
https://pec.openapi.it/pec/6040e4613a716838dc4eee0e
Ceci est un exemple de réponse :
{
"data": {
"boite_pec": "yourpec@domiciliodigitale.com",
"type_boite": "DOMICILIODIGITALE",
"type_client": "PV",
"sous_type_client": "",
"sous_type_client_autre": "",
"prenom_demandeur": "mario",
"nom_demandeur": "rossi",
"email": "mail@domain.com",
"telephone": "0548798569",
"code_fiscal_demandeur": "RSSXXXXXXXX56E",
"date_naissance_demandeur": "11/04/1982",
"sexe_demandeur": "M",
"pays_naissance_demandeur": "IT",
"province_naissance_demandeur": "RM",
"nom_titulaire": "",
"code_fiscal_vat_titulaire": "",
"adresse_titulaire": "via verdi 20",
"ville_titulaire": "roma",
"code_postal_titulaire": "00042",
"pays_titulaire": "IT",
"province_titulaire": "rm",
"callback": {
"url": "https://your_domain.it/your_callback.php",
"field": "data",
"method": "POST",
"data": {}
},
"domaine": "domiciliodigitale.com",
"proprietaire": "mail@domain.com",
"timestamp": {
"inscription": 1614865504,
"derniere_modification": 1614868403,
"traitement": 1614865504,
"expiration": 1614868403,
"annulation": ,
},
"mobile": "",
"ville_naissance_demandeur": "",
"code_activation": "10173956",
"uid": "MA177987",
"preservation": false,
"date_expiration": "",
"description": "yourpec@domiciliodigitale.com",
"sms": false,
"espace_preservation": 0,
"espace_disque": 1024,
"espace_historique": 1024,
"statut": "en_cours",
"historique": true,
"documents_activation": [
"6040e4613a716838dc4eee0e_0_activation.pdf",
"6040e4613a716838dc4eee0e_1_activation.pdf"
],
"date_activation": "04/03/2021",
"id": "6040e4613a716838dc4eee0e",
"renouvellement_automatique": false
},
"success": true,
"message": "",
"error": null
}
Une fois l'activation terminée, les identifiants d'accès à la nouvelle boîte PEC sont envoyés au demandeur.
L'API PEC est utilisée par les éditeurs de logiciels, les banques et les institutions financières, les portails de comptabilité, les administrations publiques et les grandes entreprises.
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!