{"openapi":"3.0.2","info":{"description":"Services Web destinés à l'activation et à la gestion de la messagerie électronique certifiée (PEC). Ces services vous permettent d'enregistrer une nouvelle boîte aux lettres certifiée, ainsi que de renouveler ou de révoquer des comptes existants. Vous pouvez également modifier les paramètres de la boîte aux lettres, tels que l'espace de stockage total et l'espace d'archivage, ou activer et étendre la conservation conforme à la législation. De plus, le système propose des fonctionnalités permettant de déclarer une adresse e-mail certifiée au registre du commerce. Enfin, vous pouvez utiliser ces services pour télécharger et mettre en ligne des formulaires d’activation, tant pour la boîte aux lettres que pour le service de conservation légale. Tous les points de terminaison qui acceptent un identifiant (id) opèrent uniquement sur les ressources appartenant au compte authentifié : un identifiant appartenant à un autre compte renvoie la même erreur 404 qu’un identifiant inexistant.","version":"1.1.0","title":"Pec (Posta Elettronica Certificata)","termsOfService":"https://openapi.it/en/terms-and-conditions","contact":{"url":"https://openapi.it/en/support","name":"Support"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}},"servers":[{"url":"https://pec.openapi.it","description":"Production"},{"url":"https://test.pec.openapi.it","description":"Sandbox"}],"tags":[{"name":"Pec","description":"Méthodes permettant d'enregistrer, d'activer et de modifier une adresse e-mail certifiée"},{"name":"Comunica Pec","description":"Méthodes permettant d'envoyer un e-mail certifié au registre du commerce"},{"name":"Domini","description":"Méthodes permettant d'activer et de modifier un domaine certifié"},{"name":"Modulistica","description":"Méthodes permettant de télécharger les formulaires nécessaires à la gestion des boîtes aux lettres électroniques certifiées"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"BodyPostPec":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'adresse e-mail certifiée (PEC)"},"tipo_casella":{"type":"string","description":"type de boîte aux lettres. Les types STANDARD/BRONZE/SILVER/GOLD/MASSIVA1-3 sont fournis par InfoCert ; les types DOMICILIODIGITALE/PECMASSIVA sont fournis par Namirial. Le fournisseur est déterminé à partir de cette valeur (associée au domaine) ; il n’est pas choisi séparément et détermine lesquels des autres champs BodyPostPec s’appliquent effectivement (voir leurs descriptions). Le type doit correspondre au fournisseur du domaine : un type InfoCert sur un domaine Namirial (domiciliodigitale.com, pecmassiva.com) ou un type Namirial sur un domaine InfoCert (legalmail.it) renvoie l'erreur 505.","enum":["STANDARD","BRONZE","SILVER","GOLD","DOMICILIODIGITALE","PECMASSIVA","MASSIVA1","MASSIVA2","MASSIVA3"]},"tipo_cliente":{"type":"string","description":"le type de client","enum":["IM","PS","PL","PC","A","PV","X"]},"sottotipo_cliente":{"type":"string","description":"Le sous-type de client. Validé par rapport à la collection de référence « tipologie » issue de la base de données ; il ne s'agit pas d'une liste fixe — les codes valides dépendent de « tipo_cliente » ; voir le schéma TipologieCliente pour les tables de codes spécifiques à chaque « tipo_cliente ».","enum":["SI","IN","CM","TE","ES","ME","AL","CF","ED","TM","MA","AR","TL","FI","X","PC","PR","PN","PT","PA","PL","LR","LP","LC","LM","LA","LI"],"x-valori-per-tipo-cliente":{"$ref":"#/components/schemas/TipologieCliente"}},"sottotipo_cliente_altro":{"type":"string","description":"autre sous-type de client"},"nome_richiedente":{"type":"string","description":"prénom du demandeur"},"cognome_richiedente":{"type":"string","description":"nom de famille du demandeur"},"email":{"type":"string","description":"adresse e-mail habituelle du candidat"},"telefono":{"type":"string","description":"numéro de téléphone du demandeur. InfoCert : obligatoire, numérique, 11 caractères maximum. Namirial (DOMICILIODIGITALE/PECMASSIVA) : ignoré et enregistré vide."},"cellulare":{"type":"string","description":"numéro de téléphone portable du demandeur. Namirial (DOMICILIODIGITALE/PECMASSIVA) : obligatoire, avec l'indicatif international (par exemple +393490000000). InfoCert : facultatif, numérique."},"codice_fiscale_richiedente":{"type":"string","description":"numéro d'identification fiscale du demandeur"},"data_nascita_richiedente":{"type":"string","description":"date de naissance du demandeur (jj/mm/aaaa). InfoCert : obligatoire pour chaque tipo_cliente. Namirial (DOMICILIODIGITALE/PECMASSIVA) : obligatoire pour les clients particuliers (tipo_cliente PV), facultatif et enregistré tel qu’il a été envoyé pour les autres. Sur Namirial, il est nécessaire d'activer ultérieurement le service de conservation pour chaque type de client ; il convient donc de l'envoyer si la conservation doit être demandée."},"sesso_richiedente":{"type":"string","description":"sexe du demandeur ; M ou F. InfoCert : obligatoire pour chaque tipo_cliente. Namirial (DOMICILIODIGITALE/PECMASSIVA) : obligatoire pour les clients particuliers (tipo_cliente PV), facultatif et enregistré tel qu’il a été envoyé pour les autres. Sur Namirial, il est nécessaire d’activer ultérieurement le service de conservation pour chaque type de client ; il convient donc de le transmettre si la conservation est demandée.","enum":["M","F"]},"nazione_nascita_richiedente":{"type":"string","description":"pays de naissance du demandeur. InfoCert : obligatoire pour chaque « tipo_cliente », 2 caractères maximum (par ex. IT). Namirial (DOMICILIODIGITALE/PECMASSIVA) : facultatif, enregistré tel qu’il a été envoyé. Sur Namirial, il est nécessaire d’activer ultérieurement le service de conservation pour chaque type de client ; il convient donc de l’envoyer si la conservation est demandée."},"comune_nascita_richiedente":{"type":"string","description":"city of birth of the applicant. InfoCert : facultatif. Namirial (DOMICILIODIGITALE/PECMASSIVA) : obligatoire pour les particuliers (tipo_cliente PV), facultatif et conservé tel qu’il a été SENT pour les autres. Sur Namirial, il est nécessaire d’activer ultérieurement le service de conservation pour chaque type de client ; veuillez donc l’indiquer si la conservation est demandée."},"provincia_nascita_richiedente":{"type":"string","description":"Province de naissance du demandeur. 3 caractères maximum. InfoCert : facultatif. Namirial (DOMICILIODIGITALE/PECMASSIVA) : obligatoire pour les particuliers (tipo_cliente PV), facultatif et conservé tel qu’il a été SENT pour les autres. Sur Namirial, il est nécessaire d’activer ultérieurement le service de conservation pour chaque type de client ; veuillez donc l’indiquer si la conservation est demandée."},"denominazione_titolare":{"type":"string","description":"Nom du titulaire de la boîte aux lettres. Obligatoire lorsque « tipo_cliente » n'est pas « PV »."},"cf_piva_titolare":{"type":"string","description":"numéro d'identification fiscale ou numéro de TVA du titulaire de la boîte aux lettres. Obligatoire lorsque « tipo_cliente » n'est pas égal à « PV »."},"indirizzo_titolare":{"type":"string","description":"adresse du titulaire de la boîte aux lettres"},"comune_titolare":{"type":"string","description":"city of the owner of the mailbox"},"cap_titolare":{"type":"string","description":"code postal (CAP) du titulaire de la boîte aux lettres"},"nazione_titolare":{"type":"string","description":"pays du titulaire de la boîte aux lettres"},"provincia_titolare":{"type":"string","description":"province du titulaire de la boîte mail. Obligatoire uniquement lorsque « nazione_titolare » est « IT » (Namirial accepte également « ITA »). Pour tout autre pays, Namirial enregistre « EE » ; InfoCert enregistre la valeur telle qu'elle a été envoyée."},"callback":{"$ref":"#/components/schemas/Callback"},"autorinnovo":{"type":"boolean","description":"Si cette option est définie sur « true », elle permet au système de renouveler automatiquement le compte à son expiration, en essayant de prélever le montant correspondant sur le portefeuille du titulaire.","default":false},"tipo_documento":{"type":"string","description":"type de pièce d'identité","enum":["CARTA_D_IDENTITA","PATENTE","PASSAPORTO"]},"numero_documento":{"type":"string","description":"numéro du document"},"data_scadenza_documento":{"type":"string","description":"date d'expiration du document"},"documento_rilasciato_da":{"type":"string","description":"autorité émettrice du document"},"data_rilascio_documento":{"type":"string","description":"Date d'émission du document"},"rinnovo_anni":{"type":"integer","description":"années supplémentaires au-delà de la première année obligatoire (0-3) ; durée totale de l'inscription = 1 + rinnovo_anni, soit 1 à 4 ans ; valeur par défaut : 0","minimum":0,"maximum":3,"default":0},"spazio_disco":{"type":"integer","description":"espace disque initial en Mo (facultatif ; doit être un multiple de 1 024)"},"spazio_storico":{"type":"integer","description":"espace d'archivage initial en Mo (facultatif ; doit être un multiple de 1 024)"},"spazio_conservazione":{"type":"integer","description":"espace de conservation initial en Mo (facultatif). Vendu par paquets : doit être un multiple de 512 pour les boîtes InfoCert, et de 1 024 (1 Go) pour les boîtes Namirial (DOMICILIODIGITALE/PECMASSIVA). L'espace est payé ici (paquets × années), mais le service est activé ultérieurement, lors du téléchargement des documents signés via PATCH /pec/{id}/conservazione, ce qui n'entraîne pas de facturation supplémentaire."},"invio_massivo_pec":{"type":"integer","description":"InfoCert uniquement. Limite d'envoi groupé (doit être un multiple positif de 50). Non pris en charge sur les boîtes Namirial."},"phishing_protection":{"type":"boolean","description":"Uniquement pour InfoCert. Activez la protection contre le phishing lors de l'inscription. Non pris en charge sur les boîtiers Namirial."},"password_protection":{"type":"boolean","description":"InfoCert uniquement. Activez la protection par mot de passe lors de l'inscription. Non pris en charge sur les boîtiers Namirial."},"norma_ai":{"type":"boolean","description":"Uniquement pour InfoCert. Activez l'extension Norma AI lors de l'inscription (facturée à l'année, comme les autres extensions). Non pris en charge sur les boîtiers Namirial.","default":false},"multiutenza":{"oneOf":[{"type":"boolean","description":"Namirial uniquement. La valeur « true » active ou désactive le service multi-utilisateurs lors de l'inscription."},{"type":"array","description":"InfoCert : chaque élément crée un compte esclave distinct, géré individuellement. Namirial : il n'est pas possible de créer des utilisateurs individuels — un tableau non vide permet également d'activer le service ; dans le cas contraire, son contenu est ignoré.","items":{"type":"object","properties":{"nome":{"type":"string"},"cognome":{"type":"string"},"descrizione":{"type":"string"},"email_gestione_password":{"type":"string"}},"required":["nome","cognome","email_gestione_password"]}}]},"note":{"type":"string","description":"notes internes"}},"required":["casella_pec","tipo_casella","tipo_cliente","nome_richiedente","cognome_richiedente","email","codice_fiscale_richiedente","indirizzo_titolare","comune_titolare","cap_titolare","nazione_titolare"]},"BodyPostDominio":{"type":"object","required":["dominio","fornitore"],"properties":{"dominio":{"type":"string","description":"Le nom de domaine à activer (par exemple, example.com). Un enregistrement MX doit déjà être configuré dans le DNS de ce domaine et pointer vers le serveur de messagerie du fournisseur avant d'appeler ce point de terminaison — voir « fournisseur ».","example":"testdominio.legalmail.it"},"fornitore":{"type":"string","enum":["infocert","namirial"],"description":"Le prestataire de services. Détermine l'enregistrement MX requis pour « dominio » : « mx.cert.legalmail.it » pour Infocert, « mailpro.sicurezzapostale.it » pour Namirial.","example":"infocert"},"anni":{"type":"integer","description":"Nombre d'années pour lesquelles le nom de domaine est acheté (activation initiale uniquement, 1 à 3)","default":1,"example":1,"enum":[1,2,3]},"numero_pec":{"type":"integer","description":"Nombre de boîtes PEC achetées pour le domaine","default":0,"example":1},"note":{"type":"string","description":"Note interne sous forme de texte libre stockée avec le domaine. Elle n'est jamais renvoyée par les requêtes GET /dominio ou GET /dominio/{id} (elle est supprimée uniquement de ces deux réponses)."},"tipo_cliente":{"type":"string","description":"[Namirial uniquement] Type de client. La valeur « IM » est imposée en cas d’absence de cette information, ou « PV » — une activation de domaine ne pouvant jamais être enregistrée sous la mention « PV », les champs « denominazione_titolare » et « cf_piva_titolare » sont donc toujours obligatoires pour Namirial. La valeur « X » est rejetée (ERROR 362).","enum":["IM","PS","PL","PC","A","PV"],"example":"IM"},"nome_richiedente":{"type":"string","description":"[Namirial uniquement] Prénom du demandeur. Obligatoire."},"cognome_richiedente":{"type":"string","description":"[Namirial uniquement] Nom de famille du demandeur. Champ obligatoire."},"codice_fiscale_richiedente":{"type":"string","description":"[Namirial uniquement] Numéro d'identification fiscale du demandeur. Obligatoire."},"data_nascita_richiedente":{"type":"string","description":"[Namirial uniquement] Date de naissance du demandeur (jj/mm/aaaa). Obligatoire pour l'activation du domaine, quelle que soit la valeur de « tipo_cliente »."},"sesso_richiedente":{"type":"string","enum":["M","F"],"description":"[Namirial uniquement] Sexe du demandeur. Obligatoire pour l'activation du domaine, quelle que soit la valeur de « tipo_cliente »."},"email":{"type":"string","description":"[Namirial uniquement] Adresse e-mail du demandeur. Champ obligatoire."},"cellulare":{"type":"string","description":"[Namirial uniquement] Numéro de téléphone portable du demandeur. Obligatoire."},"indirizzo_titolare":{"type":"string","description":"[Namirial uniquement] Adresse du titulaire. Champ obligatoire."},"comune_titolare":{"type":"string","description":"[Namirial uniquement] City du titulaire. Obligatoire."},"cap_titolare":{"type":"string","description":"[Namirial uniquement] Code postal du titulaire. Champ obligatoire."},"provincia_titolare":{"type":"string","description":"[Namirial uniquement] Province du titulaire, 3 caractères maximum. Obligatoire uniquement lorsque « nazione_titolare » est « IT » ou « ITA » ; pour tout autre pays, la valeur « EE » est enregistrée."},"nazione_titolare":{"type":"string","description":"[Namirial uniquement] Pays du titulaire. Champ obligatoire."},"denominazione_titolare":{"type":"string","description":"[Namirial uniquement] Nom de la société/entité. Toujours obligatoire dans la pratique — le champ « tipo_cliente » ne peut en aucun cas rester « PV » lors de l'activation d'un domaine."},"cf_piva_titolare":{"type":"string","description":"[Namirial uniquement] Numéro de TVA du titulaire : seul un numéro de partita IVA à 11 chiffres est accepté (ERROR 389), et non un code fiscal. Ce champ est toujours obligatoire dans la pratique — le champ « tipo_cliente » ne peut jamais rester sur « PV » lors de l'activation d'un domaine."},"comune_nascita_richiedente":{"type":"string","description":"[Namirial uniquement] Ville de naissance du demandeur. Obligatoire pour l'activation du domaine, quelle que soit la valeur de « tipo_cliente »."},"provincia_nascita_richiedente":{"type":"string","description":"[Namirial uniquement] Province de naissance du demandeur."},"nazione_nascita_richiedente":{"type":"string","description":"[Namirial uniquement] Pays de naissance du demandeur. Obligatoire pour l'activation du domaine, quelle que soit la valeur de « tipo_cliente »."},"tipo_documento":{"type":"string","enum":["CARTA_D_IDENTITA","PASSAPORTO"],"description":"[Namirial uniquement] Type de pièce d'identité. Obligatoire. Le permis de conduire (PATENTE) n'est PAS accepté pour l'enregistrement d'un nom de domaine (contrairement à l'activation d'une boîte mail PEC, qui l'accepte)."},"numero_documento":{"type":"string","description":"[Namirial uniquement] Numéro de document. Obligatoire."},"data_scadenza_documento":{"type":"string","description":"[Namirial uniquement] Date d'expiration du document (jj/mm/aaaa). Obligatoire. Si cette information est omise pour un CARTA_D_IDENTITA dont le titulaire avait au moins 70 ans à la date de délivrance du document (ou à la date du jour si cette information est manquante), elle est définie sur le 01/01/2100 (pas de date d'expiration)."},"documento_rilasciato_da":{"type":"string","description":"[Namirial uniquement] Autorité émettrice du document. Obligatoire."},"data_rilascio_documento":{"type":"string","description":"[Namirial uniquement] Date d'émission du document (jj/mm/aaaa). Champ obligatoire."},"callback":{"$ref":"#/components/schemas/Callback"}}},"Dominio":{"type":"object","description":"Les méthodes GET/POST/PATCH/DELETE renvoient toutes l'enregistrement de domaine tel qu'il est stocké dans MongoDB, pratiquement tel quel (seuls quelques champs sont supprimés ; voir les points de terminaison individuels). Sur certains domaines InfoCert, cela inclut des champs qui ne sont utilisés par aucun chemin de code actuel de l’API — « anagrafica_sincronizzata », « pec_attive », « pec_totali », « sottotipo_cliente », « telefono » (tous documentés ci-dessous) — ainsi que des valeurs en italien dans les champs « dns »/« config »/« certif » (par exemple « CORRETTO »/«ERRATO ») écrites par le cron asynchrone (CronAutorinnovo), qui les lit à partir de l’interface XML d’InfoCert (InfocertDominiClient::getStatoDominio) — DominioInfoCert::sincronizza ne met à jour que stato_fornitore — contrairement aux valeurs en anglais « OK »/« KO » générées par l’intégration rest utilisée lors de l’activation initiale.","properties":{"id":{"type":"string","description":"Identifiant de domaine","example":"69806bcce09fb76c6b0fef0b"},"dominio":{"type":"string","description":"Nom de domaine","example":"testdominio.legalmail.it"},"fornitore":{"type":"string","enum":["infocert","namirial"],"description":"Le prestataire de services","example":"infocert"},"owner":{"type":"string","description":"Nom d'utilisateur du propriétaire du domaine","example":"mail@domain.com"},"stato_fornitore":{"type":"string","enum":["OK","KO","PENDING"],"description":"État du domaine du côté du fournisseur. La valeur « PENDING » n'est actuellement générée par aucun chemin de code dans ce dépôt (seules les valeurs « OK » et « KO » sont effectivement définies) — elle est conservée dans l'énumération en tant que valeur documentée, mais pour l'instant inutilisée ou réservée.","example":"OK"},"dns":{"type":"string","description":"État de la configuration DNS fournie par le fournisseur d'accès","example":"OK"},"config":{"type":"string","description":"État de configuration du serveur fourni par le fournisseur","example":"OK"},"certif":{"type":"string","description":"Statut de certification indiqué par le prestataire","example":"missing"},"note":{"type":"string","description":"Note interne sous forme de texte libre. N'apparaît jamais dans les réponses GET /dominio ou GET /dominio/{id} (supprimée) ; peut apparaître dans les réponses POST/PATCH/DELETE et GET .../rinnovo."},"record_mx":{"type":"string","description":"Enregistrement MX associé au domaine"},"tipo_dominio":{"type":"string","enum":["interno","esterno"],"description":"Type de domaine (interne ou externe)","example":"interno"},"stato":{"type":"string","enum":["registrato","in_attesa_certificazione","evaso","revocato"],"description":"Statut de traitement interne","example":"registrato"},"data_scadenza":{"type":"string","description":"Date d'expiration (jj/mm/aaaa)","example":"02/02/2027"},"data_certificazione":{"type":"string","description":"Date de certification (jj/mm/aaaa)","example":"02/02/2026"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"id_ordine":{"type":"string","description":"Identifiant de commande associé à l'activation. Il n'apparaît jamais dans les réponses GET /dominio ou GET /dominio/{id} (supprimé) ; il apparaît dans les réponses POST/PATCH/DELETE et GET .../rinnovo.","example":"62558f"},"autorinnovo":{"type":"boolean","default":false,"description":"Si cette option est activée, le nom de domaine sera automatiquement renouvelé.","example":false},"anni":{"type":"integer","description":"Nombre d'années pour lesquelles le nom de domaine est acheté","example":1},"numero_pec":{"type":"integer","description":"Nombre de boîtes PEC achetées pour le domaine","default":0,"example":1},"callback":{"$ref":"#/components/schemas/Callback"},"tipo_cliente":{"type":"string","description":"[Domaines Namirial uniquement] Type de client","enum":["IM","PS","PL","PC","A","PV","X"],"example":"IM"},"nome_richiedente":{"type":"string","description":"[Domaines Namirial uniquement] Prénom du demandeur"},"cognome_richiedente":{"type":"string","description":"[Domaines Namirial uniquement] Nom de famille du demandeur"},"codice_fiscale_richiedente":{"type":"string","description":"[Domaines Namirial uniquement] Numéro d'identification fiscale du demandeur"},"email":{"type":"string","description":"[Domaines Namirial uniquement] Adresse e-mail du demandeur"},"cellulare":{"type":"string","description":"[Domaines Namirial uniquement] Numéro de téléphone portable du demandeur"},"indirizzo_titolare":{"type":"string","description":"[Domaines Namirial uniquement] Adresse du titulaire"},"comune_titolare":{"type":"string","description":"[Domaines Namirial uniquement] City du titulaire"},"cap_titolare":{"type":"string","description":"[Domaines Namirial uniquement] Code postal du titulaire"},"provincia_titolare":{"type":"string","description":"[Domaines Namirial uniquement] Province du titulaire"},"nazione_titolare":{"type":"string","description":"[Domaines Namirial uniquement] Pays du titulaire"},"denominazione_titolare":{"type":"string","description":"[Domaines Namirial uniquement] Nom de la société/entité"},"cf_piva_titolare":{"type":"string","description":"[Domaines Namirial uniquement] Numéro d'identification fiscale ou numéro de TVA du titulaire"},"data_nascita_richiedente":{"type":"string","description":"[Domaines Namirial uniquement] Date de naissance du demandeur (jj/mm/aaaa)"},"sesso_richiedente":{"type":"string","enum":["M","F"],"description":"[Domaines Namirial uniquement] Sexe du demandeur"},"comune_nascita_richiedente":{"type":"string","description":"[Domaines Namirial uniquement] City of birth of the applicant"},"provincia_nascita_richiedente":{"type":"string","description":"[Domaines Namirial uniquement] Province de naissance du demandeur"},"nazione_nascita_richiedente":{"type":"string","description":"[Domaines Namirial uniquement] Pays de naissance du demandeur"},"documenti_attivazione":{"type":"array","items":{"type":"string"},"description":"Non renseigné par l'API : la requête PATCH /dominio/{id} envoie les documents d'activation à Namirial par PEC et ne les enregistre pas. Présent uniquement s'il a été renseigné par d'autres outils."},"tipo_documento":{"type":"string","enum":["CARTA_D_IDENTITA","PATENTE","PASSAPORTO"],"description":"[Domaines Namirial uniquement] Type de pièce d'identité du demandeur. La mention « PATENTE » peut encore apparaître sur les domaines activés avant que ce champ ne soit limité aux valeurs CARTA_D_IDENTITA|PASSAPORTO pour les nouvelles activations (voir BodyPostDominio.tipo_documento)."},"numero_documento":{"type":"string","description":"[Domaines Namirial uniquement] Numéro de document"},"data_scadenza_documento":{"type":"string","description":"[Domaines Namirial uniquement] Date d'expiration du document (jj/mm/aaaa). Si cette information est omise pour un CARTA_D_IDENTITA dont le titulaire était âgé d'au moins 70 ans à la date data_rilascio_documento (ou à la date du jour si cette date est manquante), elle est fixée au 01/01/2100 (pas de date d'expiration)."},"documento_rilasciato_da":{"type":"string","description":"[Domaines Namirial uniquement] Autorité émettrice du document"},"data_rilascio_documento":{"type":"string","description":"[Domaines Namirial uniquement] Date d'émission du document (jj/mm/aaaa)"},"sottotipo_cliente":{"type":"string","description":"Observé sur certains domaines InfoCert. N'est généré par aucun chemin de code API actuel."},"telefono":{"type":"string","description":"Numéro de téléphone de contact apparaissant sur certains domaines InfoCert. Il n'est pris en charge par aucun chemin de code API actuel (le processus d'activation ne recueille que le « cellulare »)."},"anagrafica_sincronizzata":{"type":"boolean","description":"Indicateur observé sur certains domaines InfoCert. N'est généré par aucun chemin de code API actuel."},"pec_attive":{"type":"integer","description":"Nombre de boîtes aux lettres PEC actives sur ce domaine, observé sur certains domaines InfoCert. Cette valeur n'est générée par aucun chemin de code actuel de l'API. Elle ne correspond pas à « numero_pec », qui est définie par l'API."},"pec_totali":{"type":"integer","description":"Nombre total de boîtes aux lettres PEC sur ce domaine, tel qu'il apparaît sur certains domaines InfoCert. Cette valeur n'est générée par aucun chemin de code actuel de l'API. Elle ne correspond pas à « numero_pec », qui est défini par l'API."}}},"BodyPostComunicaPec":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'adresse e-mail certifiée (PEC)"},"pec_amministratore":{"type":"boolean","description":"si cette valeur est vraie, la boîte aux lettres appartient à l'administrateur de l'entreprise","default":false},"cf":{"type":"string","description":"code fiscal"},"nome":{"type":"string","description":"prénom"},"cognome":{"type":"string","description":"nom de famille"},"qualifica":{"type":"string","description":"qualification du propriétaire","enum":["AMMINISTRATORE","COMMISSARIO_GIUDIZIARIO","CURATORE_FALLIMENTARE","LEGALE_RAPPRESENTANTE","LIQUIDATORE","SOCIO","TITOLARE"]},"email":{"type":"string","description":"adresse e-mail du propriétaire"},"cellulare":{"type":"string","description":"téléphone portable du propriétaire"},"ragione_sociale":{"type":"string","description":"nom de l'entreprise"},"cf_piva":{"type":"string","description":"numéro d'identification fiscale ou numéro de TVA de l'entreprise"},"comune":{"type":"string","description":"commune où est implantée l'entreprise"},"provincia":{"type":"string","description":"zone d'activité de l'entreprise"},"callback":{"$ref":"#/components/schemas/Callback"}},"required":["casella_pec","cf","nome","cognome","qualifica","email","cellulare","ragione_sociale","cf_piva","comune","provincia"]},"BodyPostMultiutenza":{"type":"object","properties":{"nome":{"type":"string","description":"prénom"},"cognome":{"type":"string","description":"nom de famille"},"descrizione":{"type":"string","description":"Description. Obligatoire pour les boîtes mail InfoCert (STANDARD/BRONZE/SILVER/GOLD). N'est absolument pas validé pour les boîtes mail Namirial (DOMICILIODIGITALE/PECMASSIVA), dont la fonctionnalité « multi-utilisateurs » correspond à un simple indicateur activé/désactivé."},"email_gestione_password":{"type":"string","description":"adresse e-mail de l'utilisateur"}},"required":["nome","cognome","email_gestione_password"]},"TipologieCliente":{"type":"object","properties":{"IM":{"type":"string","description":"Impresa","enum":["SI - SERVIZI IMPRESE","IN - INFORMATICA","CM - COMMERCIO","TE - TELECOMUNICAZIONI","ES - EDITORIA STAMPA","ME - MECCANICA ELETTRICA","AL - ALIMENTARE","CF - CHIMICA FARMACEUTICA","ED - EDILIZIA","TM - TESSILE MODA","MA - MOBILI ARREDAMENTI","AR - ALBERGHI RISTORANTI","TL - TRASPOSRTI LOGISTICA","FI - FINANZA","X - ALTRO"]},"PS":{"type":"string","description":"Professionista","enum":["PC - COMMERCIALISTA","PR - RAGIONIERE","PN - NOTAIO","PT - TRIBUTARISTA","PA - AVVOCATO","PL - CONSULENTE LAVORO","X - ALTRO"]},"PL":{"type":"string","description":"Administration publique locale","enum":["LR - REGIONE","LP - PROVINCIA","LC - COMUNE","LM - COMUNITA MONTANA","LA - ASL","LI - CCIAA","X - ALTRO"]},"PC":{"type":"string","description":"Administration publique centrale"},"A":{"type":"string","description":"Association"},"PV":{"type":"string","description":"Privato"},"X":{"type":"string","description":"Autres"}}},"Casella":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'adresse e-mail certifiée (PEC)"},"tipo_casella":{"type":"string","description":"type de boîte aux lettres","enum":["STANDARD","BRONZE","SILVER","GOLD","DOMICILIODIGITALE","PECMASSIVA","MASSIVA1","MASSIVA2","MASSIVA3"]},"tipo_cliente":{"type":"string","description":"le type de client"},"sottotipo_cliente":{"type":"string","description":"le sous-type de client"},"sottotipo_cliente_altro":{"type":"string","description":"autre sous-type de client"},"nome_richiedente":{"type":"string","description":"prénom du demandeur"},"cognome_richiedente":{"type":"string","description":"nom de famille du demandeur"},"email":{"type":"string","description":"adresse e-mail habituelle du candidat"},"telefono":{"type":"string","description":"numéro de téléphone du demandeur"},"cellulare":{"type":"string","description":"numéro de téléphone portable du demandeur"},"codice_fiscale_richiedente":{"type":"string","description":"numéro d'identification fiscale du demandeur"},"data_nascita_richiedente":{"type":"string","description":"date de naissance du demandeur"},"sesso_richiedente":{"type":"string","description":"sexe du candidat"},"nazione_nascita_richiedente":{"type":"string","description":"pays de naissance du demandeur"},"comune_nascita_richiedente":{"type":"string","description":"city of birth of the applicant"},"provincia_nascita_richiedente":{"type":"string","description":"province de naissance du demandeur"},"denominazione_titolare":{"type":"string","description":"Nom du titulaire de la boîte aux lettres. Obligatoire lorsque « tipo_cliente » n'est pas « PV »."},"cf_piva_titolare":{"type":"string","description":"numéro d'identification fiscale ou numéro de TVA du titulaire de la boîte aux lettres. Obligatoire lorsque « tipo_cliente » n'est pas égal à « PV »."},"indirizzo_titolare":{"type":"string","description":"adresse du titulaire de la boîte aux lettres"},"comune_titolare":{"type":"string","description":"city of the owner of the mailbox"},"cap_titolare":{"type":"string","description":"code postal (CAP) du titulaire de la boîte aux lettres"},"nazione_titolare":{"type":"string","description":"pays du titulaire de la boîte aux lettres"},"provincia_titolare":{"type":"string","description":"province du titulaire de la boîte aux lettres"},"callback":{"$ref":"#/components/schemas/Callback"},"dominio":{"type":"string","description":"le nom de domaine associé à la boîte aux lettres PEC"},"owner":{"type":"string","description":"identifiant du propriétaire"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"cod_attivazione":{"type":"string","description":"code d'activation de la boîte aux lettres"},"uid":{"type":"string","description":"identifiant unique de la boîte aux lettres ou de la demande"},"conservazione":{"type":"boolean","description":"indique si la conservation électronique conforme à la législation (conservazione a norma) est active"},"data_scadenza":{"type":"string","description":"date d'expiration du service/de la boîte mail. Elle nous appartient, et non au fournisseur : ce dernier ne résilie jamais une boîte mail tant que nous ne le lui demandons pas ; par conséquent, seuls le jour et le mois de la date indiquée par le fournisseur sont utilisés (définis lors de l'activation comme « aujourd'hui + rinnovo_anni années »)."},"descrizione":{"type":"string","description":"description"},"sms":{"type":"boolean","description":"[indique si les notifications par SMS sont activées]"},"spazio_conservazione":{"type":"integer","description":"espace de stockage alloué à des fins de conservation légale, en Mo"},"spazio_disco":{"type":"integer","description":"espace disque total alloué à la boîte aux lettres (en Mo)"},"spazio_storico":{"type":"integer","description":"espace de stockage alloué aux données historiques/aux archives, en Mo"},"stato":{"type":"string","enum":["registrata","in_evasione","evasa","revocata","chiusa","documenti_errati"],"description":"état actuel de la boîte aux lettres/de la demande"},"rejection_reason":{"type":"string","enum":["Wrong document","Invalid document","Document must be in color","Missing form","Missing document","Form not signed"],"description":"Raison pour laquelle notre équipe a rejeté les documents d'activation. Cette information n'apparaît que dans la réponse envoyée lorsque la boîte aux lettres passe à l'état « documenti_errati » ; elle n'est pas enregistrée dans la boîte aux lettres, elle n'est donc jamais renvoyée par la requête GET /pec/{id} ni incluse dans les réponses ultérieures. Veuillez télécharger les documents corrigés à l'aide de la requête PATCH /pec/{id}/attivazione."},"storico":{"type":"boolean","description":"indique si l'accès aux données historiques ou la fonctionnalité d'archivage est activé(e)"},"documenti_attivazione":{"type":"array","items":{"type":"string"},"description":"tableau de chaînes de caractères  pour les documents d'activation"},"data_attivazione":{"type":"string","description":"date d'activation de la boîte aux lettres"},"documenti_conservazione":{"type":"array","items":{"type":"string"},"description":"tableau de chaînes de caractères pour les documents de conservation"},"multiutenza":{"oneOf":[{"type":"boolean","description":"Cases « Namirial » (DOMICILIODIGITALE/PECMASSIVA) : à cocher une fois le service multi-utilisateurs activé"},{"type":"array","items":{"$ref":"#/components/schemas/Utenza"},"description":"Boîtiers InfoCert : liste des utilisateurs secondaires"}]},"rinnovo_anni":{"type":"integer","description":"Nombre total d'années payées pour la boîte aux lettres : 1 lors de l'inscription + les années supplémentaires demandées via POST /pec (où « rinnovo_anni » désigne les années supplémentaires, comprises entre 0 et 3) ; ce nombre est également majoré des années payées via PATCH /pec/{id} avec le ModuloAttivazione. Lors de l'activation, la date d'expiration est fixée à aujourd'hui + rinnovo_anni années. Généralement 1 à 4, mais avec la requête PATCH /pec/{id}, ce nombre peut dépasser 4 (jusqu'à 4 + 3). Non mis à jour par la requête GET /pec/{id}/rinnovo."},"id":{"type":"string","description":"ID d'objet"},"autorinnovo":{"type":"boolean","description":"Si cette option est définie sur « true », elle permet au système de renouveler automatiquement le compte à son expiration, en essayant de prélever le montant correspondant sur le portefeuille du titulaire."},"tipo_documento":{"type":"string","enum":["CARTA_D_IDENTITA","PATENTE","PASSAPORTO"],"description":"type de pièce d'identité"},"numero_documento":{"type":"string","description":"numéro du document"},"data_scadenza_documento":{"type":"string","description":"date d'expiration du document"},"documento_rilasciato_da":{"type":"string","description":"autorité émettrice du document"},"data_rilascio_documento":{"type":"string","description":"Date d'émission du document"},"phishing_protection":{"type":"boolean","description":"indique si le module complémentaire de protection contre le phishing est actif"},"password_protection":{"type":"boolean","description":"indique si le module complémentaire de protection par mot de passe est activé"},"norma_ai":{"type":"boolean","description":"indique si le module complémentaire Norma AI est actif (InfoCert uniquement ; toujours « false » sur les boîtiers Namirial)"},"invio_massivo":{"type":"boolean","description":"indique si le service d'envoi en masse (invio massivo) est actif"},"invio_massivo_pec":{"type":"integer","description":"quota d'envoi groupé en nombre de messages"},"invio_massivo_stat":{"type":"object","description":"Statistiques d'utilisation de l'envoi groupé (affichées uniquement lorsque la fonction « invio_massivo » est active)","properties":{"totale":{"type":"integer","description":"quota total"},"consumati":{"type":"integer","description":"messages consultés"},"rimanenti":{"type":"integer","description":"messages restants"}}}}},"Callback":{"type":"object","description":"Configuration standardisée des rappels. Permet de recevoir des notifications concernant les mises à jour de statut des requêtes asynchrones. Pour les boîtes aux lettres, la charge utile est l'objet Casella ; lorsque des documents d'activation sont rejetés (état « documenti_errati »), elle contient également le paramètre « rejection_reason ».","properties":{"method":{"type":"string","description":"Spécifiez la méthode de rappel. Si la valeur est « POST », une requête HTTP POST standard sera lancée avec le type de contenu « application/x-www-form-urlencoded ». Les données JSON seront encodées sous la forme d'une paire clé-valeur nommée « data » (personnalisable via le paramètre « field »). Lorsque la valeur est définie sur « JSON », une requête HTTP POST directe sera effectuée avec le type de contenu application/json et le corps JSON brut.","enum":["POST","JSON"],"default":"JSON"},"field":{"type":"string","description":"Fonctionne avec method='POST'. Détermine le nom du paramètre envoyé dans le corps de la requête POST. Toujours définir la valeur « data » lorsqu'il n'est pas envoyé, y compris avec method='JSON' (où il n'est pas utilisé).","example":"data","default":"data"},"url":{"type":"string","format":"uri","description":"Une URL valide capable de traiter les requêtes POST. Pour les points de terminaison authentifiés, utilisez le paramètre « headers ». Le délai d'expiration maximal est de 30 secondes. Si le paramètre « retry » est défini, le système effectue plusieurs tentatives jusqu'à ce qu'un code d'état 200 soit reçu.","example":"https://www.mysite.com/myEndpoint"},"retry":{"type":"integer","description":"Nombre maximal de tentatives de réessai. Les réessais ne s'appliquent qu'en cas d'erreurs temporaires (par exemple 502, 503) ou de problèmes réseau, avec un délai d'attente exponentiel. La valeur maximale est 5.","example":3,"minimum":0,"maximum":5,"default":0},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"En-têtes HTTP à envoyer avec la requête de rappel. Utile pour l'authentification (authentification de base, authentification « bearer ») ou pour des métadonnées personnalisées.","example":{"session_id":"9834r5fh589494"}},"custom":{"description":"Données supplémentaires à inclure dans la charge utile de la fonction de rappel, accessibles via la clé « custom » du corps de la fonction de rappel. Il peut s'agir de n'importe quelle valeur JSON (objet, tableau, chaîne de caractères, nombre), d'une taille maximale de 512 octets une fois encodée au format JSON (sinon, la requête est REJECTED).","example":{"my_custom_id":"123456789"}}}},"Timestamp":{"type":"object","properties":{"registrazione":{"type":"integer","description":"heure d'inscription/de création"},"ultima_modifica":{"type":"integer","description":"heure de la dernière modification"},"evasione":{"type":"integer","description":"délai de traitement/résolution"},"certificazione":{"type":"integer","description":"durée de certification/activation"},"scadenza":{"type":"integer","description":"date d'expiration / date limite"},"revoca":{"type":"integer","description":"délai de révocation"}}},"RichiesteComunicazionePec":{"type":"object","properties":{"id":{"type":"string","description":"ID d'objet"},"casella_pec":{"type":"string","description":"l'adresse e-mail certifiée (PEC)"},"stato":{"type":"string","description":"Statut de la demande","enum":["codice_in_richiesta","in_attesa_di_documenti","documenti_caricati","annullata"]},"timestamp":{"type":"integer"},"owner":{"type":"string","description":"identifiant du propriétaire"}}},"RichiestaComunicazionePec":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'adresse e-mail certifiée (PEC), en minuscules côté serveur"},"pec_amministratore":{"type":"boolean","description":"si cette valeur est vraie, la boîte aux lettres appartient à l'administrateur de l'entreprise","default":false},"cf":{"type":"string","description":"code fiscal, en majuscules côté serveur"},"nome":{"type":"string","description":"prénom"},"cognome":{"type":"string","description":"nom de famille"},"qualifica":{"type":"string","description":"qualification du candidat, en majuscules côté serveur","enum":["AMMINISTRATORE","COMMISSARIO_GIUDIZIARIO","CURATORE_FALLIMENTARE","LEGALE_RAPPRESENTANTE","LIQUIDATORE","SOCIO","TITOLARE"]},"email":{"type":"string","description":"adresse e-mail du propriétaire"},"cellulare":{"type":"string","description":"téléphone portable du propriétaire"},"ragione_sociale":{"type":"string","description":"nom de l'entreprise"},"cf_piva":{"type":"string","description":"code fiscal ou numéro de TVA de l'entreprise, converti en majuscules côté serveur"},"comune":{"type":"string","description":"commune où est implantée l'entreprise"},"provincia":{"type":"string","description":"zone d'activité de l'entreprise"},"callback":{"$ref":"#/components/schemas/Callback"},"stato":{"type":"string","enum":["codice_in_richiesta","in_attesa_di_documenti","documenti_caricati","annullata"]},"codice_registro_imprese":{"type":"string"},"documenti_registro_imprese":{"type":"array","items":{"type":"string"}},"owner":{"type":"string","description":"identifiant du propriétaire"},"timestamp":{"type":"integer"},"id":{"type":"string","description":"ID d'objet"}}},"Utenza":{"type":"object","properties":{"nome":{"type":"string","description":"prénom"},"cognome":{"type":"string","description":"nom de famille"},"descrizione":{"type":"string","description":"notes"},"email_gestione_password":{"type":"string","description":"adresse e-mail utilisée pour la gestion des mots de passe"},"id_utenza":{"type":"string","description":"identifiant du compte utilisateur"},"timestamp":{"type":"object","properties":{"attivazione":{"type":"integer","description":"horodatage d'activation du compte"}}},"userid":{"type":"string","description":"identifiant de connexion de l'utilisateur"}}},"Caselle":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'adresse e-mail certifiée (PEC)"},"tipo_casella":{"type":"string","description":"type de boîte aux lettres","enum":["STANDARD","BRONZE","SILVER","GOLD","DOMICILIODIGITALE","PECMASSIVA","MASSIVA1","MASSIVA2","MASSIVA3"]},"owner":{"type":"string","description":"identifiant du propriétaire"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"data_scadenza":{"type":"string","description":"Date d'expiration"},"stato":{"type":"string","description":"état de traitement","enum":["registrata","in_evasione","evasa","revocata","chiusa","documenti_errati"]},"id":{"type":"string","description":"ID d'objet"}}}}},"paths":{"/dominio":{"get":{"tags":["Domini"],"summary":"Afficher la liste de tous les domaines associés au compte","operationId":"getDominiList","responses":{"200":{"description":"Liste des domaines","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Dominio"}}}}}}},"404":{"description":"Aucun domaine trouvé","content":{"application/json":{"example":{"success":false,"message":"no domains linked to this account","error":701,"data":null}}}}}},"post":{"tags":["Domini"],"summary":"Activer un nouveau domaine certifié","description":"Avant d'appeler ce point de terminaison, le client doit configurer un enregistrement MX dans le DNS de son propre domaine, pointant vers le serveur de messagerie du fournisseur : « mx.cert.legalmail.it » pour InfoCert, « mailpro.sicurezzapostale.it » pour Namirial. Cette vérification est ignorée pour les sous-domaines internes de legalmail.it et dans les environnements de test (AMBIENTE_TEST_DOMINI). Si l’enregistrement MX est manquant ou incorrect, la requête échoue avec l’erreur 714. Outre la vérification dans la base de données locale, le domaine est également vérifié par rapport au registre central des domaines (la même recherche que celle utilisée par GET /domini_pec/{dominio}), sauf si son enregistrement MX pointe déjà vers le serveur de messagerie du fournisseur choisi (le registre détecterait alors l’enregistrement MX du fournisseur, et non un enregistrement réel) ; s’il y est déjà répertorié, la requête échoue avec l’ERROR 712 (InfoCert) ou 732 (Namirial), et si la recherche dans le registre échoue, la requête échoue avec l’ERROR 710 (503).","operationId":"postDominio","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostDominio"},"examples":{"infocert":{"summary":"Domaine InfoCert","description":"InfoCert n'a besoin que du nom de domaine, du fournisseur, de la durée/du quota et, éventuellement, d'une remarque ou d'un rappel — aucun des champs relatifs au demandeur ou au titulaire n'est pertinent.","value":{"dominio":"testdominio.legalmail.it","fornitore":"infocert","anni":1,"numero_pec":1}},"namirial":{"summary":"Domaine de Namirial","description":"Namirial exige que les informations complètes concernant le demandeur et le titulaire/l'entreprise soient fournies pour l'activation.","value":{"dominio":"studiorossi.it","fornitore":"namirial","anni":1,"numero_pec":1,"tipo_cliente":"IM","denominazione_titolare":"esempio srl","cf_piva_titolare":"01234567890","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","provincia_titolare":"rm","nazione_titolare":"it","nome_richiedente":"mario","cognome_richiedente":"rossi","codice_fiscale_richiedente":"RSSMRA82D11H501D","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","comune_nascita_richiedente":"roma","provincia_nascita_richiedente":"RM","nazione_nascita_richiedente":"it","email":"mail@domain.com","cellulare":"+393401234567","tipo_documento":"CARTA_D_IDENTITA","numero_documento":"CA00000AA","data_rilascio_documento":"01/01/2020","data_scadenza_documento":"01/01/2030","documento_rilasciato_da":"Comune di Roma"}}}}}},"responses":{"200":{"description":"L'activation du domaine a commencé","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dominio"}}},"examples":{"infocert":{"value":{"data":{"dominio":"testdominio.legalmail.it","fornitore":"infocert","owner":"gcloud-tests@openapi.it","stato_fornitore":"KO","dns":"OK","config":"KO","certif":"KO","tipo_dominio":"interno","stato":"registrato","data_scadenza":"02/02/2027","timestamp":{"registrazione":1770023882,"scadenza":1801559882,"ultima_modifica":1770023884},"anni":1,"numero_pec":1,"id_ordine":"62558f","autorinnovo":false,"callback":{"url":"https://www.mysite.it/callback.php","method":"POST","field":"data"},"id":"69806bcce09fb76c6b0fef0b"}}},"namirial":{"value":{"data":{"dominio":"studiorossi.it","fornitore":"namirial","owner":"gcloud-tests@openapi.it","stato_fornitore":"KO","dns":"KO","config":"KO","certif":"KO","tipo_dominio":"esterno","stato":"registrato","data_scadenza":"02/02/2027","timestamp":{"registrazione":1770023882,"scadenza":1801559882,"ultima_modifica":1770023882},"autorinnovo":false,"anni":1,"numero_pec":1,"id_ordine":"62559a","tipo_cliente":"IM","nome_richiedente":"mario","cognome_richiedente":"rossi","codice_fiscale_richiedente":"RSSMRA82D11H501D","email":"mail@domain.com","cellulare":"+393401234567","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","provincia_titolare":"rm","nazione_titolare":"IT","denominazione_titolare":"esempio srl","cf_piva_titolare":"01234567890","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","comune_nascita_richiedente":"roma","provincia_nascita_richiedente":"RM","nazione_nascita_richiedente":"it","tipo_documento":"CARTA_D_IDENTITA","numero_documento":"CA00000AA","data_scadenza_documento":"01/01/2030","documento_rilasciato_da":"Comune di Roma","data_rilascio_documento":"01/01/2020","id":"69806bcce09fb76c6b0fef0c"}}}}}}},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":403,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"already_present_infocert":{"value":{"success":false,"message":"domain already present in the system","error":712,"data":null}},"invalid_domain_infocert":{"value":{"success":false,"message":"domain not valid","error":733,"data":null}},"invalid_domain_namirial":{"value":{"success":false,"message":"invalid domain format","error":725,"data":null}},"reserved_name":{"value":{"success":false,"message":"domain cannot contain reserved provider names","error":723,"data":null}},"legalmail_namirial":{"value":{"success":false,"message":"legalmail.it subdomains cannot be registered with Namirial","error":724,"data":null}},"provider_not_supported":{"value":{"success":false,"message":"provider not supported or not identified: infocert, namirial","error":708,"data":null}}}}}},"409":{"description":"Conflit","content":{"application/json":{"example":{"success":false,"message":"domain already registered","error":732,"data":null}}}},"422":{"description":"Entité non traitable","content":{"application/json":{"example":{"success":false,"message":"tipo_documento not valid for domain: CARTA_D_IDENTITA|PASSAPORTO","error":723,"data":null}}}},"428":{"description":"Condition préalable requise. En fonction de « fornitore » et des champs renseignés, des erreurs supplémentaires de validation des champs du demandeur/titulaire Namirial provenant du validateur PEC partagé (codes d'erreur 360 à 406, voir POST /pec) peuvent également être renvoyées.","content":{"application/json":{"examples":{"domain_required":{"value":{"success":false,"message":"domain required","error":703,"data":null}},"provider_required":{"value":{"success":false,"message":"provider required","error":706,"data":null}},"no_mx":{"value":{"success":false,"message":"Invalid domain: no MX record found...","error":714,"data":null}},"unreachable":{"value":{"success":false,"message":"The domain '...' is unreachable","error":715,"data":null}},"anagrafici_richiedente_required":{"value":{"success":false,"message":"required for domain: data_nascita_richiedente, sesso_richiedente, comune_nascita_richiedente, nazione_nascita_richiedente","error":733,"data":null}},"doc_fields_required":{"value":{"success":false,"message":"tipo_documento required for domain","error":720,"data":null}},"denominazione_required":{"value":{"success":false,"message":"denominazione_titolare required for professional domains","error":721,"data":null}},"cf_piva_required":{"value":{"success":false,"message":"cf_piva_titolare required for professional domains","error":722,"data":null}},"anni_range":{"value":{"success":false,"message":"anni must be between 1 and 3","error":738,"data":null}},"callback_invalid_type":{"summary":"la fonction de rappel n'est pas un objet (auparavant, elle renvoyait un code HTTP 500) ; une URL de rappel non valide est rejetée avec un code 406 avant toute facturation","value":{"success":false,"message":"Error: The 'callback' field has an invalid type, expected object","error":407,"data":null}},"campo_tipo_non_valido":{"summary":"Un champ est d'un type incorrect (par exemple, « numero_pec » n'est pas de type numérique ; une valeur non numérique « anni » renvoie 738) ; auparavant, cela renvoyait un code HTTP 500.","value":{"success":false,"message":"numero_pec: invalid type (expected int)","error":743,"data":null}}}}}},"503":{"description":"Service indisponible","content":{"application/json":{"example":{"success":false,"message":"service temporarily unavailable","error":710,"data":null}}}}}}},"/dominio/{id}":{"get":{"tags":["Domini"],"summary":"Obtenir des informations sur un nom de domaine spécifique","operationId":"getDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"L'identifiant du domaine"}],"responses":{"200":{"description":"Détails du domaine","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dominio"}}},"examples":{"infocert":{"summary":"Domaine InfoCert","value":{"data":{"dominio":"pec.esempiosrl.it","fornitore":"infocert","owner":"gcloud-tests@openapi.it","stato_fornitore":"OK","dns":"CORRETTO","config":"CORRETTO","certif":"CORRETTO","tipo_dominio":"esterno","stato":"evaso","numero_pec":0,"data_scadenza":"09/04/2027","data_certificazione":"09/04/2013","timestamp":{"registrazione":1365465600,"certificazione":1365465600,"scadenza":1807228800,"ultima_modifica":1770023884},"callback":{"method":"JSON","url":"https://www.esempiosrl.it/callback/domini-certificati","field":null,"retry":2,"custom":{},"headers":{}},"autorinnovo":false,"anagrafica_sincronizzata":true,"cap_titolare":"00100","cellulare":"3491234567","cf_piva_titolare":"01234567890","codice_fiscale_richiedente":"RSSMRA80A01H501U","cognome_richiedente":"Rossi","comune_titolare":"Roma","data_nascita_richiedente":"01/01/1980","denominazione_titolare":"Esempio S.r.l.","email":"m.rossi@esempiosrl.it","indirizzo_titolare":"Via Roma 1","nazione_nascita_richiedente":"IT","nazione_titolare":"Italiana","nome_richiedente":"Mario","pec_attive":0,"pec_totali":1,"provincia_titolare":"RM","sesso_richiedente":"M","sottotipo_cliente":"SI","telefono":"0612345678","tipo_cliente":"IM","id":"65f1a2b3c4d5e6f7a8b9c0d1"}}},"namirial":{"summary":"Domaine de Namirial","value":{"data":{"dominio":"pec.esempioclienti.com","fornitore":"namirial","owner":"gcloud-tests@openapi.it","stato_fornitore":"OK","dns":"OK","config":"OK","certif":"OK","tipo_dominio":"esterno","stato":"evaso","data_scadenza":"12/06/2027","timestamp":{"registrazione":1781277767,"scadenza":1812813767,"ultima_modifica":1781280020,"certificazione":1781280020},"anni":1,"numero_pec":0,"autorinnovo":false,"callback":{"method":"JSON","url":"https://www.esempioclienti.com/callback/domini","field":null,"retry":0,"custom":{},"headers":{}},"tipo_cliente":"IM","nome_richiedente":"Giulia","cognome_richiedente":"Bianchi","codice_fiscale_richiedente":"BNCGLI85M42H501Z","email":"g.bianchi@example.com","cellulare":"+447700900123","indirizzo_titolare":"12 Example Street","comune_titolare":"London","cap_titolare":"EC1A 1AA","provincia_titolare":"EE","nazione_titolare":"REG","denominazione_titolare":"Example Company Ltd","cf_piva_titolare":"98765432100","data_nascita_richiedente":"","sesso_richiedente":"","comune_nascita_richiedente":"","provincia_nascita_richiedente":"","tipo_documento":"PATENTE","numero_documento":"AB1234567CD","data_scadenza_documento":"20/04/2027","documento_rilasciato_da":"DVLA","data_rilascio_documento":"12/08/2020","data_certificazione":"12/06/2026","id":"65f1a2b3c4d5e6f7a8b9c0d2"}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":739,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":702,"data":null}}}}}},"patch":{"tags":["Domini"],"summary":"Mettre à jour un domaine certifié","description":"Met à jour un domaine certifié. Accepte les documents d'activation (Namirial uniquement — InfoCert renvoie l'erreur 730) et/ou renouvelle ou réactive le domaine pour un nombre d'années donné (1 à 10). Il faut fournir au moins l'un des paramètres « documenti » ou « anni ». Si le domaine est à l'état « revocato » et que le paramètre « anni » est fourni, le domaine est réactivé.","operationId":"patchDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"L'identifiant du domaine"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"documenti":{"type":"array","items":{"oneOf":[{"type":"string","description":"base64_encode(contenu du fichier)"},{"type":"object","properties":{"file":{"type":"string","description":"base64_encode(contenu du fichier)"}}}],"description":"Les fichiers au format PDF (application/pdf) ou P7M (application/octet-stream) sont autorisés ; chaque élément peut être une chaîne Base64 simple ou un objet comportant une clé « file »"},"description":"Documents d'activation. Namirial uniquement — déclenche l'envoi des documents au fournisseur via un e-mail PEC certifié. Si le domaine se trouve actuellement à l'état « revocato », les documents envoyés sont ignorés sans message d'erreur et le domaine est réactivé à la place (voir le comportement « anni » ci-dessous)."},"anni":{"type":"integer","description":"Nombre d'années pour renouveler ou réactiver le domaine (1 à 10). Si le domaine est à l'état « revocato », cela le réactive (la valeur par défaut est 1 an si ce paramètre est omis) ; sinon, cela renouvelle la date d'expiration actuelle.","minimum":1,"maximum":10,"example":1}}},"examples":{"renew_years":{"summary":"Renouveler ou réactiver le nom de domaine pour N années","value":{"anni":1}},"upload_documents":{"summary":"Téléverser uniquement les documents d'activation (Namirial uniquement)","value":{"documenti":["JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PAovVHlwZSAvUGFnZQovTWVkaWFCb3ggWzAgMCA1OTUgODQyXQo..."]}},"renew_and_upload":{"summary":"Renouveler le nom de domaine et télécharger les documents d'activation (Namirial uniquement)","value":{"anni":1,"documenti":["JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PAovVHlwZSAvUGFnZQovTWVkaWFCb3ggWzAgMCA1OTUgODQyXQo..."]}}}}}},"responses":{"200":{"description":"Domaine mis à jour","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dominio"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"documenti_not_supported":{"value":{"success":false,"message":"documenti not supported for InfoCert domains","error":730,"data":null}},"invalid_id":{"value":{"success":false,"message":"invalid form or id format. Did you pass a subset as an ID?","error":711,"data":null}}}}}},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":403,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":705,"data":null}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"id_required":{"value":{"success":false,"message":"id required","error":734,"data":null}},"payload_missing":{"value":{"success":false,"message":"payload must include 'documenti' and/or 'anni'","error":735,"data":null}},"wrong_state_for_documents":{"value":{"success":false,"message":"documents can only be submitted when domain is in 'registrato' state","error":737,"data":null}},"anni_range":{"value":{"success":false,"message":"years must be between 1 and 10","error":717,"data":null}},"invio_documenti_fallito":{"summary":"Domaines Namirial : les documents n'ont pas pu être envoyés au fournisseur ; le domaine reste « registrato » et la requête peut être réitérée (auparavant, le code d'état 200 était renvoyé)","value":{"success":false,"message":"documents could not be sent to the provider, please retry","error":742,"data":null}}}}}}}},"delete":{"tags":["Domini"],"summary":"Révoquer un domaine certifié","description":"Révoque le domaine et les boîtes aux lettres PEC qui y sont associées. Les boîtes aux lettres se trouvant déjà à l'état « evasa » sont révoquées par l'intermédiaire du fournisseur ; la notification de révocation n'est envoyée que pour les boîtes aux lettres InfoCert. Les boîtes aux lettres qui ne sont pas encore actives (tout état autre que « revocata ») sont supprimées de manière provisoire et passées directement à l’état « revocata » sans contact avec le fournisseur. Si le fournisseur refuse de révoquer une boîte aux lettres, les autres sont tout de même traitées et celles qui ont été refusées sont répertoriées dans la notification adressée aux opérateurs. Le domaine lui-même est défini sur « revocato » dans notre base de données, mais il est révoqué manuellement chez le fournisseur : les opérateurs reçoivent une notification les invitant à effectuer cette opération dans le panneau d’administration du fournisseur. La notification relative au domaine, si elle est configurée, est envoyée.","operationId":"deleteDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"L'identifiant du domaine à révoquer"}],"responses":{"200":{"description":"Nom de domaine révoqué","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/Dominio"}}},"example":{"success":true,"message":"","data":{"dominio":"pec.testgestionale.com","fornitore":"infocert","owner":"gcloud-tests@openapi.it","stato_fornitore":"OK","dns":"OK","config":"OK","certif":"OK","tipo_dominio":"esterno","stato":"revocato","data_scadenza":"13/03/2054","data_certificazione":"13/03/2026","timestamp":{"registrazione":1773401265,"scadenza":2657014065,"ultima_modifica":1774273311,"certificazione":1773401405,"revoca":1774273558},"autorinnovo":false,"anni":1,"numero_pec":3,"id_ordine":"1a54cf","callback":{"url":"https://www.mysite.it/callback.php"},"id":"69b3f4b1d0747173230c4448"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"invalid form or id format. Did you pass a subset as an ID?","error":711,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":705,"data":null}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"id_required":{"value":{"success":false,"message":"id required","error":704,"data":null}},"already_revoked_infocert":{"value":{"success":false,"message":"your domain has already been revoked","error":716,"data":null}},"already_revoked_namirial":{"value":{"success":false,"message":"your domain has already been revoked","error":736,"data":null}}}}}}}}},"/dominio/{id}/rinnovo":{"get":{"tags":["Domini"],"summary":"Renouveler ou réactiver un nom de domaine certifié","description":"Renouvelle le domaine pour le nombre d'années spécifié (1 à 3). Si le domaine est en état « revocato », il le réactive et rétablit les boîtes PEC associées qui ne sont pas encore arrivées à expiration (également chez le fournisseur). La nouvelle date d'expiration s'ajoute à la date actuelle si le domaine n'a pas encore expiré ; dans le cas contraire, elle commence à compter d'aujourd'hui.","operationId":"renewDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"L'identifiant du domaine"},{"name":"anni","in":"query","schema":{"type":"integer","default":1,"minimum":1,"maximum":3},"description":"Nombre d'années pour le renouvellement ou la réactivation (1 à 3). Valeur par défaut : 1."}],"responses":{"200":{"description":"Résultat du renouvellement ou de la réactivation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dominio"}}},"example":{"data":{"dominio":"pec.testgestionale.com","fornitore":"infocert","owner":"gcloud-tests@openapi.it","stato_fornitore":"OK","dns":"OK","config":"OK","certif":"OK","tipo_dominio":"esterno","stato":"evaso","data_scadenza":"13/03/2054","data_certificazione":"13/03/2026","timestamp":{"registrazione":1773401265,"scadenza":2657014065,"ultima_modifica":1774273311,"certificazione":1773401405},"autorinnovo":false,"anni":1,"numero_pec":3,"id_ordine":"1a54cf","callback":{"url":"https://www.mysite.it/callback.php"},"id":"69b3f4b1d0747173230c4448"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"invalid form or id format. Did you pass a subset as an ID?","error":711,"data":null}}}},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":403,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":705,"data":null}}}},"422":{"description":"Entité non traitable","content":{"application/json":{"example":{"success":false,"message":"anni must be between 1 and 3","error":713,"data":null}}}}}}},"/dominio/{id}/modulo_attivazione":{"get":{"tags":["Modulistica"],"summary":"Télécharger le formulaire d'activation de domaine","description":"Télécharge le formulaire d'activation au format PDF pour un domaine certifié. Disponible uniquement pour les domaines Namirial. Une fois rempli et signé, téléchargez-le à l'aide de la requête PATCH /dominio/{id} en indiquant la valeur « documenti » dans le champ correspondant.","operationId":"getDominioModuloAttivazione","parameters":[{"name":"id","in":"path","required":true,"description":"L'identifiant du domaine","schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"}}],"responses":{"200":{"description":"Un fichier PDF","headers":{"Content-Disposition":{"schema":{"type":"string"},"example":"inline;filename=modulo_attivazione_studiorossi.it.pdf","description":"Namirial uniquement — le nom de fichier est généré dynamiquement à partir du nom de domaine ; le mode de transmission est « inline » et non « attachment »"}},"content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"unsupported_provider":{"value":{"success":false,"message":"modulo_attivazione non supportato per questo fornitore","error":731,"data":null}},"invalid_id":{"value":{"success":false,"message":"invalid form or id format. Did you pass a subset as an ID?","error":711,"data":null}}}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":705,"data":null}}}}}}},"/domini_pec/{dominio}":{"get":{"tags":["Domini"],"summary":"Vérification du nom de domaine","description":"Cette méthode vous permet de vérifier si un domaine est autorisé à envoyer ou à recevoir un PEC.","parameters":[{"name":"dominio","in":"path","description":"Domaine","required":true,"schema":{"type":"string","example":"legalmail.it"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"string"},"description":"Dans l'implémentation actuelle, il s'agit toujours d'un tableau vide."},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":[],"success":true,"message":"legalmail.it found!","error":null}}}},"204":{"description":"Pas de contenu"},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":403,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"example":{"success":false,"message":"domain not valid","error":709,"data":null}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"example":{"success":false,"message":"domain required","error":700,"data":null}}}},"503":{"description":"Service indisponible","content":{"application/json":{"example":{"success":false,"message":"service temporarily unavailable","error":710,"data":null}}}}}}},"/verifica_pec/{pec}":{"get":{"tags":["Pec"],"summary":"Disponibilité d'une boîte e-mail certifiée","description":"Cette méthode vous permet de vérifier la disponibilité d'une boîte e-mail certifiée. Elle ne peut vérifier la disponibilité que des boîtes e-mail associées aux domaines configurés et gérés par le système. Pour les domaines non gérés, elle renverra une erreur, car leur existence ne peut être vérifiée.","parameters":[{"name":"pec","in":"path","description":"Boîte de messagerie","required":true,"schema":{"type":"string","example":"prova_pec@legalmail.it"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"available":{"type":"boolean","description":"Indique si l'adresse e-mail peut être enregistrée"}}},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"available":true},"success":true,"message":"","error":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"example":{"success":false,"message":"invalid casella_pec","error":213,"data":null}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"casella_pec_required":{"value":{"success":false,"message":"casella_pec required","error":212,"data":null}},"unmanaged_domain":{"value":{"success":false,"message":"we cannot know if the mailbox exists for unmanaged domains","error":253,"data":null}}}}}}}}},"/pec":{"get":{"tags":["Pec"],"summary":"Liste de vos boîtes e-mail certifiées","description":"Cette méthode vous permet de consulter la liste des boîtes e-mail certifiées associées à votre compte","parameters":[{"name":"skip","in":"query","description":"Facultatif. Nombre d'éléments à ignorer pour la pagination. Si cette valeur n'est pas spécifiée, la valeur par défaut est 0.","required":false,"schema":{"type":"integer","example":0}},{"name":"limit","in":"query","description":"Facultatif. Nombre maximal d'éléments à renvoyer. Si ce paramètre n'est pas spécifié, la valeur par défaut est 100.","required":false,"schema":{"type":"integer","example":100}},{"name":"expiring","in":"query","description":"Facultatif. Nombre de jours. Positif (1-365) : renvoie les boîtes aux lettres en état « evasa » dont la date d'expiration (timestamp.scadenza) tombe ce jour-là (aujourd'hui + N jours, de 00:00:00 à 23:59:59), triées par date d'expiration croissante. Négatif (-1 à -366) : renvoie les boîtes aux lettres à l'état « revocata » dont la date d'expiration (timestamp.scadenza) tombe ce jour-là (aujourd'hui + N jours, c'est-à-dire aujourd'hui - |N| jours, de 00:00:00 à 23:59:59), triées par ordre croissant de date d'expiration.","required":false,"schema":{"type":"integer","minimum":-366,"maximum":365,"example":30}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Caselle"}},"total_count":{"type":"integer","description":"Nombre total de boîtes aux lettres PEC correspondant à la requête, sans tenir compte de la pagination (skip/limit)."},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":[{"id":"6040e4613a716838dc4eee0e","casella_pec":"mypec@testcert.legalmail.it","tipo_casella":"BRONZE","stato":"revocata","data_scadenza":"04/03/2022","timestamp":{"registrazione":1614865504,"ultima_modifica":1614868403,"evasione":1614868312,"scadenza":1646391493,"revoca":1614868400},"owner":"mail@domain.com"},{"id":"6040c9df3a716838dc4eede4","casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"STANDARD","stato":"evasa","data_scadenza":"04/03/2022","timestamp":{"registrazione":1614858718,"ultima_modifica":1614859181,"evasione":1614859181,"scadenza":1646391493},"owner":"mail@domain.com"}],"total_count":2,"success":true,"message":"","error":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no PEC linked to this account","error":200,"data":null}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"expiring":{"summary":"dépassement de la plage de validité","value":{"success":false,"message":"expiring must be between -366 and -1, or between 1 and 365","error":262,"data":null}},"pagination":{"summary":"« skip » ou « limit » non acceptés","value":{"success":false,"message":"skip and limit must be non-negative integers","error":263,"data":null}}}}}}}},"post":{"tags":["Pec"],"summary":"Enregistrer une nouvelle boîte aux lettres certifiée","description":"Cette méthode vous permet d'enregistrer une nouvelle boîte mail certifiée. \n\nSi vous ne disposez pas de votre propre domaine certifié, l'adresse de la boîte mail doit obligatoirement se présenter comme suit : \n\n- « nom_boîte »@legalmail.it (par ex. provapec@legalmail.it) pour les boîtes mail STANDARD, BRONZE, SILVER et GOLD ; \n\n- « nom_de_la_boîte »@domiciliodigitale.com (par ex. provapec@domiciliodigitale.com) pour les boîtes DOMICILIODIGITALE ; \n\n- « nom_de_boîte »@pecmassiva.com (par ex. provapec@pecmassiva.com) pour la boîte PECMASSIVA. \n\nDans sandbox, il doit s'agir de : « box_name »@testcert.legalmail.it (par ex. provapec@testcert.legalmail.it) ou « box_name »@test.domiciliodigitale.com (par ex. provapec@test.domiciliodigitale.com).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostPec"},"examples":{"infocert":{"summary":"Exemple d'InfoCert","value":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"bronze","tipo_cliente":"PV","sottotipo_cliente":"SI","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","cellulare":"3401234567","codice_fiscale_richiedente":"RSSMRA82D11H501D","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"it","comune_nascita_richiedente":"roma","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","tipo_documento":"CARTA_D_IDENTITA","numero_documento":"CA00000AA","data_rilascio_documento":"01/01/2020","data_scadenza_documento":"01/01/2030","documento_rilasciato_da":"Comune di Roma","autorinnovo":false,"rinnovo_anni":1,"spazio_disco":2048,"spazio_storico":3072,"spazio_conservazione":512,"invio_massivo_pec":50,"phishing_protection":false,"password_protection":false,"multiutenza":[{"nome":"luca","cognome":"bianchi","descrizione":"collaboratore","email_gestione_password":"luca.bianchi@mail.com"}],"note":"note interne","callback":{"url":"https://your-domain.it/your_callback.php","custom":{"my_order_id":"123456"}}}},"namirial":{"summary":"Exemple de Namirial","value":{"casella_pec":"yourpec@domiciliodigitale.com","tipo_casella":"DOMICILIODIGITALE","tipo_cliente":"PV","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","cellulare":"+393401234567","codice_fiscale_richiedente":"RSSMRA82D11H501D","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"it","comune_nascita_richiedente":"roma","provincia_nascita_richiedente":"RM","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"it","provincia_titolare":"rm","tipo_documento":"CARTA_D_IDENTITA","numero_documento":"CA00000AA","data_rilascio_documento":"01/01/2020","data_scadenza_documento":"01/01/2030","documento_rilasciato_da":"Comune di Roma","autorinnovo":false,"rinnovo_anni":1,"spazio_disco":1024,"spazio_storico":1024,"spazio_conservazione":1024,"multiutenza":true,"note":"note interne","callback":{"url":"https://your-domain.it/your_callback.php","custom":{"my_order_id":"123456"}}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","dominio":"testcert.legalmail.it","owner":"mail@domain.com","uid":"MA178634","cod_attivazione":"10174594","callback":{"method":"JSON","url":"https://your-domain.it/your_callback.php","user_id":"","username":"","field":"data","headers":[],"data":[],"retry":0,"scope":null,"domain":null,"custom":{"my_order_id":"123456"}},"tipo_casella":"BRONZE","stato":"registrata","descrizione":"yourpec@testcert.legalmail.it","autorinnovo":false,"spazio_disco":2048,"storico":false,"spazio_storico":3072,"conservazione":false,"spazio_conservazione":512,"sms":false,"phishing_protection":false,"password_protection":false,"tipo_cliente":"PV","sottotipo_cliente":"SI","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","cellulare":"3401234567","codice_fiscale_richiedente":"RSSMRA82D11H501D","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"it","comune_nascita_richiedente":"roma","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","provincia_titolare":"rm","nazione_titolare":"it","tipo_documento":"CARTA_D_IDENTITA","numero_documento":"CA00000AA","data_rilascio_documento":"01/01/2020","data_scadenza_documento":"01/01/2030","documento_rilasciato_da":"Comune di Roma","timestamp":{"registrazione":1615199724,"ultima_modifica":1615199724},"multiutenza":[{"nome":"luca","cognome":"bianchi","descrizione":"collaboratore","email_gestione_password":"luca.bianchi@mail.com"}],"documenti_attivazione":[],"documenti_conservazione":[],"invio_massivo":false,"norma_ai":false,"invio_massivo_pec":50,"rinnovo_anni":2,"id":"6045fdee3a716847a978a471"},"success":true,"message":"","error":null}}}},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":262,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"the domain testcert.legalmail.it is non-existent in the system or belongs to someone else","error":506,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"date_not_valid":{"value":{"success":false,"message":"data_nascita_richiedente not valid, accepted format: dd/mm/yyyy","error":568,"data":null}},"tipo_casella_not_valid":{"value":{"success":false,"message":"tipo_casella not valid: STANDARD|BRONZE|SILVER|GOLD|DOMICILIODIGITALE|PECMASSIVA|MASSIVA1|MASSIVA2|MASSIVA3","error":505,"data":null}},"cf_piva_titolare_not_valid":{"value":{"success":false,"message":"cf_piva_titolare not valid","error":576,"data":null}},"tipo_documento_not_valid_namirial":{"value":{"success":false,"message":"tipo_documento not valid: CARTA_D_IDENTITA|PATENTE|PASSAPORTO","error":641,"data":null}},"spazio_storico_sotto_minimo":{"summary":"spazio_storico inférieur à la valeur minimale du paquet (674 ; une valeur qui n'est pas un multiple de 1 024 Mo donne 658)","value":{"success":false,"message":"spazio_storico non può essere inferiore al minimo del pacchetto GOLD (13312 MB)","error":674,"data":null}}}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"tipo_casella_required":{"value":{"success":false,"message":"tipo_casella required","error":504,"data":null}},"casella_pec_required":{"value":{"success":false,"message":"casella_pec required","error":647,"data":null}},"already_in_db":{"value":{"success":false,"message":"yourpec@testcert.legalmail.it not available (already exists in database)","error":502,"data":null}},"not_available_at_provider":{"value":{"success":false,"message":"Box not available","error":503,"data":null}},"domain_revocato":{"value":{"success":false,"message":"the domain testcert.legalmail.it has been revoked","error":507,"data":null}},"denominazione_titolare_required":{"value":{"success":false,"message":"denominazione_titolare required","error":574,"data":null}},"cf_piva_titolare_required":{"value":{"success":false,"message":"cf_piva_titolare required","error":575,"data":null}},"campo_tipo_non_valido":{"summary":"Un champ est d'un type incorrect (par exemple, « spazio_disco » sous forme de chaîne non numérique, « tipo_casella » sous forme de tableau) ; auparavant, cela provoquait une erreur HTTP 500.","value":{"success":false,"message":"Error: spazio_disco: invalid type (expected int)","error":501,"data":null}},"token_infocert":{"summary":"Boîtes InfoCert : impossible d'obtenir le jeton d'authentification InfoCert ; veuillez réessayer plus tard","value":{"success":false,"message":"Error: token not available","error":673,"data":null}}}}}}}}},"/pec/{id}":{"get":{"tags":["Pec"],"summary":"Adresse e-mail certifiée spécifique","description":"Cette méthode vous indique l'adresse e-mail certifiée associée à l'identifiant","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6040e4613a716838dc4eee0e"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"BRONZE","tipo_cliente":"PV","sottotipo_cliente":"SI","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","cellulare":"3401234567","codice_fiscale_richiedente":"RSSMRA82D11H501D","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","comune_nascita_richiedente":"roma","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","tipo_documento":"CARTA_D_IDENTITA","numero_documento":"CA00000AA","data_rilascio_documento":"01/01/2020","data_scadenza_documento":"01/01/2030","documento_rilasciato_da":"Comune di Roma","callback":{"url":"https://your-domain.it/your_callback.php","custom":{"my_order_id":"123456"}},"dominio":"testcert.legalmail.it","owner":"mail@domain.com","timestamp":{"registrazione":1614865504,"ultima_modifica":1614868403,"evasione":1614868312,"scadenza":1646391493,"revoca":1614868400},"cod_attivazione":"10173956","uid":"MA177987","conservazione":true,"data_scadenza":"04/03/2022","data_attivazione":"04/03/2021","descrizione":"yourpec@testcert.legalmail.it","sms":true,"spazio_conservazione":512,"spazio_disco":3072,"spazio_storico":3072,"stato":"revocata","storico":true,"autorinnovo":false,"phishing_protection":true,"password_protection":false,"invio_massivo":true,"invio_massivo_pec":100,"invio_massivo_stat":{"totale":100,"consumati":23,"rimanenti":77},"documenti_attivazione":["6040e4613a716838dc4eee0e_0_attivazione.pdf","6040e4613a716838dc4eee0e_1_attivazione.pdf"],"documenti_conservazione":["6040e4613a716838dc4eee0e_0_conservazione.pdf","6040e4613a716838dc4eee0e_1_conservazione.pdf"],"multiutenza":[{"nome":"luca","cognome":"bianchi","descrizione":"prima utenza","email_gestione_password":"mail@domain.com","id_utenza":"6040e4613a716838dc4eee0e_0","timestamp":{"attivazione":1614868138},"userid":"MA177993"}],"id":"6040e4613a716838dc4eee0e"},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":201,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}}}},"delete":{"tags":["Pec"],"summary":"Révocation de Pec","description":"Cette méthode vous permet de révoquer l'adresse e-mail certifiée spécifique associée à l'identifiant","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6040e4613a716838dc4eee0e"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"BRONZE","tipo_cliente":"PV","sottotipo_cliente":"","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","codice_fiscale_richiedente":"RSSMRA82D11H501D","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"},"dominio":"testcert.legalmail.it","owner":"mail@domain.com","timestamp":{"registrazione":1614865504,"ultima_modifica":1614868403,"evasione":1614868312,"scadenza":1646391493,"revoca":1614868400},"cellulare":"","comune_nascita_richiedente":"","cod_attivazione":"10173956","uid":"MA177987","conservazione":true,"data_scadenza":"04/03/2022","descrizione":"yourpec@testcert.legalmail.it","sms":true,"spazio_conservazione":512,"spazio_disco":3072,"spazio_storico":3072,"stato":"revocata","storico":true,"documenti_attivazione":["6040e4613a716838dc4eee0e_0_attivazione.pdf","6040e4613a716838dc4eee0e_1_attivazione.pdf"],"data_attivazione":"04/03/2021","documenti_conservazione":["6040e4613a716838dc4eee0e_0_conservazione.pdf","6040e4613a716838dc4eee0e_1_conservazione.pdf"],"multiutenza":[{"nome":"luca","cognome":"bianchi","descrizione":"prima utenza","email_gestione_password":"mail@domain.com","id_utenza":"6040e4613a716838dc4eee0e_0","timestamp":{"attivazione":1614868138},"userid":"MA177993"}],"id":"6040e4613a716838dc4eee0e","autorinnovo":false},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":236,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":237,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"already_revoked_infocert":{"value":{"success":false,"message":"your pec has already been revoked","error":532,"data":null}},"already_revoked_namirial":{"value":{"success":false,"message":"your pec has already been revoked","error":593,"data":null}}}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"wrong_stato_infocert":{"value":{"success":false,"message":"you can revoke the pec only if it is active","error":533,"data":null}},"wrong_stato_namirial":{"value":{"success":false,"message":"you can revoke the pec only if it is active","error":594,"data":null}}}}}}}},"patch":{"tags":["Pec"],"summary":"Opérations combinées du PEC","description":"Effectuer une ou plusieurs opérations sur une boîte aux lettres PEC en un seul appel avec une seule facturation : télécharger des documents d'activation, renouveler, passer à un type de boîte supérieur, modifier l'espace de stockage ou les options, activer la conservation et/ou ajouter des comptes multi-utilisateurs. Au moins une opération doit être spécifiée. L'activation (ModuloAttivazione) nécessite le statut « stato registrata » ou « documenti_errati » ; toutes les autres opérations nécessitent le statut « stato evasa » (l'opération « rinnovo » accepte également le statut « revocata »). Lorsque ModuloAttivazione est envoyé avec d’autres opérations, celles-ci sont toutes facturées lors du même cycle de facturation mais, la boîte n’étant pas encore active, elles sont enregistrées sur la boîte (augmentation de rinnovo_anni, nouveaux totaux d’espace, options, utilisateurs multiutenza, conservation en attente) et appliquées chez le fournisseur lorsqu’un opérateur l’active ; elles sont répertoriées dans « operazioni_in_attesa_di_attivazione » (la conservation figure quant à elle dans « operazioni_eseguite ») et la boîte reste dans l’état « in_evasione ». « upgrade_casella » ne peut pas être combiné avec ModuloAttivazione (ERROR 704, avant toute facturation). Plusieurs champs sont propres à InfoCert : « upgrade_casella » échoue systématiquement sur Namirial (ERROR 609, aucun niveau vers lequel effectuer la mise à niveau, avant toute facturation), et « phishing_protection »/« password_protection »/« norma_ai »/« invio_massivo_pec » n’ont aucun effet sur cette plateforme. « multiutenza » se comporte également différemment selon le fournisseur (une véritable liste par utilisateur chez InfoCert contre un service unique activable/désactivable chez Namirial, sans gestion individuelle des utilisateurs). Voir les descriptions des champs ci-dessous et l’exemple « combined_namirial ». Facturation (InfoCert) : les services et l’espace activés après l’inscription (phishing_protection, password_protection, norma_ai, espace supplémentaire, forfaits de conservation, multiutenza et chaque utilisateur) sont facturés au prix annuel complet, quel que soit le nombre de mois restants avant l’expiration de la boîte mail.","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6045fdee3a716847a978a471"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"documenti":{"type":"array","description":"Documents à télécharger ; chaque élément doit comporter un champ « tipo » (ModuloAttivazione|richiestaConservazione) et un champ « file » (PDF encodé en base64). Cette étape ne fait que mettre les documents en attente — l’activation effective côté fournisseur est effectuée ultérieurement par un opérateur, et non via cette API. Pour « richiestaConservazione » : InfoCert n'a besoin que d'un seul document ; Namirial en nécessite exactement deux, dans l'ordre suivant (1er = contrat de conservation, 2e = déclaration de confidentialité ; ERROR 726 dans le cas contraire) : Namirial accepte un document unique, ils sont donc fusionnés en un seul PDF lorsqu'un opérateur active la conservation. « richiestaConservazione » nécessite « spazio_conservazione » (ERROR 727). Tous les documents doivent être au format PDF (ERROR 528), ce qui est vérifié avant toute facturation.","items":{"type":"object","properties":{"tipo":{"type":"string","enum":["ModuloAttivazione","richiestaConservazione"]},"file":{"type":"string","description":"contenu PDF encodé en base64"}},"required":["tipo","file"]}},"rinnovo_anni":{"type":"integer","description":"nombre d'années de renouvellement (1 à 3)","minimum":1,"maximum":3},"upgrade_casella":{"type":"string","description":"InfoCert uniquement. Mettez à niveau le type de boîte (seules les mises à niveau sont autorisées, vers l’un des niveaux InfoCert). Les boîtes MASSIVA1/2/3 ne peuvent pas être transformées (ERROR 708). Échec systématique pour les boîtes Namirial (DOMICILIODIGITALE/PECMASSIVA — ERROR 609, elles ne disposent pas de niveaux de mise à niveau).","enum":["STANDARD","BRONZE","SILVER","GOLD"]},"spazio_disco":{"oneOf":[{"type":"string","example":"+1024"},{"type":"integer","example":2048}],"description":"espace disque en Mo. Le préfixe « + » permet d'ajouter à la valeur actuelle (par exemple « +1024 ») ; un nombre entier simple définit la valeur absolue. Doit être un multiple de 1 024."},"spazio_storico":{"oneOf":[{"type":"string","example":"+1024"},{"type":"integer","example":1024}],"description":"Espace d'archivage en Mo. Le préfixe « + » ajoute à la valeur actuelle ; un nombre entier sans préfixe définit une valeur absolue. Doit être un multiple de 1 024."},"spazio_conservazione":{"oneOf":[{"type":"string","example":"+512"},{"type":"integer","example":512}],"description":"Espace de conservation en Mo. Le préfixe « + » s'ajoute à la valeur actuelle ; un nombre entier simple définit la valeur absolue. Doit être un multiple de 512 pour les boîtes InfoCert, ou de 1 024 (paquets de 1 Go) pour les boîtes Namirial (DOMICILIODIGITALE/PECMASSIVA). La conservation n’est pas encore active : l’espace déjà payé lors de l’inscription n’est pas facturé à nouveau, seuls les forfaits supplémentaires le sont ; une valeur inférieure à l’espace déjà payé renvoie l’erreur 289."},"phishing_protection":{"type":"boolean","description":"InfoCert uniquement. Activer la protection contre le phishing (unidirectionnelle). Non pris en charge sur les boîtiers Namirial — n'a aucun effet sur ces derniers."},"password_protection":{"type":"boolean","description":"InfoCert uniquement. Activer la protection par mot de passe (unidirectionnelle). Non pris en charge sur les boîtiers Namirial — cela n'a aucun effet sur ces derniers."},"norma_ai":{"type":"boolean","description":"InfoCert uniquement. Active l'extension Norma AI (à sens unique). Ne peut pas être défini sur « true » si l'extension est déjà active (ERROR 711). Non pris en charge sur les boîtiers Namirial — n'a aucun effet sur ces derniers."},"invio_massivo_pec":{"type":"integer","description":"InfoCert uniquement. Quota d'envoi groupé à ajouter (doit être un multiple positif de 50). Non pris en charge sur les serveurs Namirial."},"multiutenza":{"oneOf":[{"type":"boolean","description":"Namirial uniquement. La valeur « true » active ou désactive le service multi-utilisateurs. Si le service est déjà actif, l'ERROR 596 est renvoyée avant toute facturation."},{"type":"array","description":"InfoCert : chaque élément crée un compte secondaire distinct, géré individuellement (jusqu'à 25 au total, facturés par utilisateur) ; outre les champs obligatoires indiqués ici, InfoCert exige également le champ « descrizione » (ERROR 546) et une valeur valide pour « email_gestione_password » (ERROR 548), vérifiés lors de la création de l'utilisateur, après la facturation. Namirial : il n'est pas possible de créer des utilisateurs individuels — un tableau vide permet également d'activer le service ; dans le cas contraire, le contenu est ignoré.","items":{"type":"object","properties":{"nome":{"type":"string"},"cognome":{"type":"string"},"descrizione":{"type":"string"},"email_gestione_password":{"type":"string"}},"required":["nome","cognome","email_gestione_password"]}}]}}},"examples":{"combined_infocert":{"summary":"Exemple d'InfoCert","value":{"documenti":[{"tipo":"ModuloAttivazione","file":"JVBERi0xLjQKJ..."},{"tipo":"richiestaConservazione","file":"JVBERi0xLjQKJ..."}],"rinnovo_anni":1,"spazio_disco":"+1024","spazio_storico":"2048","spazio_conservazione":"512","invio_massivo_pec":50,"phishing_protection":true,"password_protection":true,"multiutenza":[{"nome":"Mario","cognome":"Rossi","descrizione":"Collaboratore","email_gestione_password":"mario.rossi@email.it"}]}},"combined_namirial":{"summary":"Exemple de Namirial","value":{"documenti":[{"tipo":"ModuloAttivazione","file":"JVBERi0xLjQKJ..."},{"tipo":"richiestaConservazione","file":"JVBERi0xLjQKJ...(contratto conservazione)"},{"tipo":"richiestaConservazione","file":"JVBERi0xLjQKJ...(informativa privacy)"}],"rinnovo_anni":1,"spazio_disco":"+1024","spazio_storico":"2048","spazio_conservazione":"1024","multiutenza":true}}}}}},"responses":{"200":{"description":"OK — données de la casella synchronisées et liste des opérations exécutées","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"operazioni_eseguite":{"type":"array","description":"opérations effectuées : activation, renouvellement, mise à niveau de la boîte mail, modification, conservation, gestion multi-utilisateurs","items":{"type":"string"}},"operazioni_in_attesa_di_attivazione":{"type":"array","description":"Uniquement avec ModuloAttivazione : les champs payants sont enregistrés dans la boîte et pris en compte lors de l'activation (rinnovo_anni, spazio_disco, spazio_storico, phishing_protection, password_protection, norma_ai, invio_massivo_pec, multiutenza). La conservation n'apparaît pas ici : elle est enregistrée comme en attente et répertoriée dans « operazioni_eseguite » sous le nom « conservazione ».","items":{"type":"string"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"BRONZE","stato":"evasa","spazio_disco":2048,"spazio_storico":3072,"spazio_conservazione":512,"conservazione":true,"storico":true,"sms":false,"autorinnovo":false,"phishing_protection":false,"password_protection":false,"invio_massivo":false,"invio_massivo_pec":0,"id":"6045fdee3a716847a978a471"},"operazioni_eseguite":["rinnovo","modifica"],"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":645,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"rinnovo_anni_invalid":{"value":{"success":false,"message":"rinnovo_anni must be between 1 and 3","error":705,"data":null}},"upgrade_not_valid":{"value":{"success":false,"message":"upgrade_casella not valid: STANDARD|BRONZE|SILVER|GOLD","error":706,"data":null}},"already_same_type":{"value":{"success":false,"message":"pec is already SILVER","error":707,"data":null}},"downgrade_not_allowed":{"value":{"success":false,"message":"downgrade of tipo_casella is not allowed","error":708,"data":null}},"spazio_disco_invalid":{"value":{"success":false,"message":"spazio_disco must be a positive multiple of 1024 MB","error":709,"data":null}},"spazio_storico_invalid":{"value":{"success":false,"message":"spazio_storico must be a positive multiple of 1024 MB","error":710,"data":null}},"invio_massivo_invalid":{"value":{"success":false,"message":"invio_massivo_pec must be a positive multiple of 50","error":714,"data":null}},"spazio_conservazione_lower_than_paid":{"summary":"La conservation n'est pas encore active : la valeur de « spazio_conservazione » est inférieure à l'espace déjà payé lors de l'inscription","value":{"success":false,"message":"spazio_conservazione cannot be lower than the space already paid (1024 MB)","error":289,"data":null}},"spazio_conservazione_invalid":{"summary":"Boîtes InfoCert : « spazio_conservazione » n'est pas un multiple de 512","value":{"success":false,"message":"spazio_conservazione must be a positive multiple of 512 MB","error":715,"data":null}},"spazio_conservazione_invalid_namirial":{"summary":"Boîtes Namirial (DOMICILIODIGITALE/PECMASSIVA) : espace_de_stockage n'est pas un multiple de 1 024","value":{"success":false,"message":"spazio_conservazione must be a positive multiple of 1024 MB","error":715,"data":null}},"documenti_conservazione_namirial":{"summary":"Boîtes Namirial : les documents requis pour la conservation doivent être au nombre de 2 exactement (contrat de conservation, puis déclaration de confidentialité). Vérification effectuée avant toute facturation.","value":{"success":false,"message":"Namirial requires exactly 2 conservation documents, in order: conservation contract and privacy disclosure","error":726,"data":null}},"documenti_conservazione_senza_spazio":{"summary":"Demande de conservation des documents envoyés sans « spazio_conservazione » (auparavant, ceux-ci étaient ignorés sans avertissement)","value":{"success":false,"message":"richiestaConservazione documents require spazio_conservazione","error":727,"data":null}}}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"locked":{"value":{"success":false,"message":"pec locked, retry later","error":700,"data":null},"summary":"Actuellement inaccessible : « lock » n'est pas une propriété déclarée dans PecBase ; elle n'est donc jamais renseignée à partir de la base de données et prend toujours la valeur « falsy » lors de l'exécution."},"no_operations":{"value":{"success":false,"message":"no operations specified","error":701,"data":null}},"wrong_stato_attivazione":{"value":{"success":false,"message":"ModuloAttivazione requires stato registrata/documenti_errati","error":702,"data":null}},"wrong_stato_evasa":{"value":{"success":false,"message":"operations require stato evasa","error":704,"data":null}},"rinnovo_revocata_too_long":{"value":{"success":false,"message":"casella revocata da piu di 6 mesi","error":252,"data":null},"summary":"rinnovo_anni sur une boîte révoquée depuis trop longtemps (plus de 6 mois pour InfoCert, plus d'un mois pour Namirial : « casella revocata da più di un mese »), même règle que GET /pec/{id}/rinnovo. Renvoyé avant toute facturation."},"upgrade_casella_not_supported_namirial":{"value":{"success":false,"message":"this service cannot be activated on these boxes: DOMICILIODIGITALE|PECMASSIVA","error":609,"data":null},"summary":"Uniquement pour les abonnements Namirial — la mise à niveau « upgrade_casella » échoue systématiquement avec Namirial, car il n'existe pas de niveaux supérieurs vers lesquels effectuer la mise à niveau (les formules DOMICILIODIGITALE et PECMASSIVA ne font pas partie de l'échelle STANDARD/BRONZE/SILVER/GOLD)."}}}}}}}},"/pec/{id}/attivazione":{"patch":{"tags":["Pec"],"summary":"Activation de l'adresse e-mail certifiée","description":"Cette méthode vous permet, une fois votre boîte aux lettres électronique certifiée enregistrée, de l'activer en téléversant les documents requis. Les documents requis comprennent votre pièce d'identité en cours de validité ainsi que le formulaire d'activation dûment rempli et signé, que vous pouvez télécharger via la méthode GET/pec/{id}/modulo_attivazione. Pour les boîtes de type DOMICILIODIGITALE et PECMASSIVA (Namirial), plusieurs fichiers PDF peuvent être envoyés (par exemple, le formulaire et la pièce d'identité) : ils sont fusionnés en un seul fichier PDF, car Namirial accepte qu'un seul document.","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6045fdee3a716847a978a471"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["documenti"],"properties":{"documenti":{"oneOf":[{"type":"string","description":"base64_encode(contenu du fichier) ; seuls les fichiers PDF sont autorisés"},{"type":"array","items":{"type":"string","description":"base64_encode(contenu du fichier) ; seuls les fichiers PDF sont autorisés"}}]}}},"example":{"documenti":["JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ","JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAw"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"BRONZE","tipo_cliente":"PV","sottotipo_cliente":"","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","codice_fiscale_richiedente":"RSSMRA82D11H501D","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"},"dominio":"testcert.legalmail.it","owner":"mail@domain.com","timestamp":{"registrazione":1615199724,"ultima_modifica":1615200175},"cellulare":"","comune_nascita_richiedente":"","cod_attivazione":"10174594","uid":"MA178634","conservazione":false,"data_scadenza":"","descrizione":"yourpec@testcert.legalmail.it","sms":false,"spazio_conservazione":0,"spazio_disco":0,"spazio_storico":0,"stato":"in_evasione","storico":false,"documenti_attivazione":["6045fdee3a716847a978a471_0_attivazione.pdf","6045fdee3a716847a978a471_1_attivazione.pdf"],"id":"6045fdee3a716847a978a471","autorinnovo":false},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":645,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"example":{"success":false,"message":"wrong file format, pdf required","error":528,"data":null}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"wrong_stato_infocert":{"value":{"success":false,"message":"you can activate the pec only when it is in the 'registrata|documenti_errati' state","error":539,"data":null}},"wrong_stato_namirial":{"value":{"success":false,"message":"you can activate the pec only when it is in the 'registrata|documenti_errati' state","error":602,"data":null}},"pdf_merge_failed_namirial":{"value":{"success":false,"message":"Errore nella generazione del documento di attivazione","error":603,"data":null}}}}}}}}},"/pec/{id}/modifica":{"patch":{"tags":["Pec"],"summary":"Modifier les paramètres de la boîte aux lettres","description":"Modifier les paramètres d'une boîte aux lettres PEC active. Les champs relatifs à l'espace (spazio_disco, spazio_storico, spazio_conservazione) acceptent un nombre entier (valeur absolue) ou une chaîne de caractères préfixée par « + » pour une augmentation incrémentielle (par exemple « +1024 »). Seules les augmentations sont autorisées pour l'espace. Les champs booléens activent des services optionnels (phishing_protection, password_protection, norma_ai) — InfoCert uniquement, sans effet sur les boîtes Namirial. invio_massivo_pec ajoute des paquets d’envoi groupé (multiples de 50, un paquet tous les 50) au quota existant — également InfoCert uniquement. Au moins un champ doit être renseigné. Facturation (InfoCert) : les services et l’espace activés après l’inscription (phishing_protection, password_protection, norma_ai, espace supplémentaire, forfaits de conservation, multiutenza et chaque utilisateur) sont facturés au prix annuel complet, quel que soit le nombre de mois restants avant l’expiration de la boîte mail.","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6045fdee3a716847a978a471"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"spazio_disco":{"oneOf":[{"type":"string","example":"+1024","multipleOf":1024},{"type":"integer","example":1024,"multipleOf":1024}],"description":"Si vous placez le symbole « + » devant, vous ajoutez de l'espace à ce que vous avez déjà. Si vous ne passez qu'un nombre, vous définissez l'espace à cette valeur."},"spazio_storico":{"oneOf":[{"type":"string","example":"+1024","multipleOf":1024},{"type":"integer","example":1024,"multipleOf":1024}],"description":"Si vous placez le symbole « + » devant, vous ajoutez de l'espace à ce que vous avez déjà. Si vous ne passez qu'un nombre, vous définissez l'espace à cette valeur."},"spazio_conservazione":{"oneOf":[{"type":"string","example":"+512","multipleOf":512},{"type":"integer","example":512,"multipleOf":512}],"description":"Si vous placez le symbole « + » devant, vous ajoutez de l'espace à ce dont vous disposez déjà. Si vous ne passez qu'un nombre, l'espace est défini sur cette valeur. Nécessite que le service « conservazione » soit actif. La valeur doit être un multiple de 512 pour les boîtes InfoCert, ou de 1 024 (forfaits de 1 Go) pour les boîtes Namirial (DOMICILIODIGITALE/PECMASSIVA)."},"invio_massivo_pec":{"type":"integer","multipleOf":50,"minimum":50,"example":100,"description":"InfoCert uniquement. Les envois groupés s'ajoutent au quota actuel (N/50 paquets). Le nombre doit être un multiple positif de 50 (par exemple : 50, 100, 150). Non pris en charge sur les boîtiers Namirial."},"phishing_protection":{"type":"boolean","example":true,"description":"InfoCert uniquement. Activer le module complémentaire de protection contre le phishing. Ne peut pas être défini sur « true » s'il est déjà actif (ERROR 516). Non pris en charge sur les boîtiers Namirial."},"password_protection":{"type":"boolean","example":true,"description":"InfoCert uniquement. Activer le module complémentaire de protection par mot de passe. Ne peut pas être défini sur « true » s'il est déjà actif (ERROR 517). Non pris en charge sur les serveurs Namirial."},"norma_ai":{"type":"boolean","example":true,"description":"InfoCert uniquement. Activez l'extension Norma AI. Ne peut pas être défini sur « true » si l'extension est déjà active (ERROR 652). Non pris en charge sur les boîtiers Namirial."}}},"example":{"spazio_disco":"+1024","invio_massivo_pec":100,"phishing_protection":true}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"GOLD","tipo_cliente":"PV","sottotipo_cliente":"","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","codice_fiscale_richiedente":"RSSMRA82D11H501D","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"},"dominio":"testcert.legalmail.it","owner":"mail@domain.com","timestamp":{"registrazione":1615199724,"evasione":1615199724,"scadenza":1646391493,"ultima_modifica":1615200175},"cellulare":"","comune_nascita_richiedente":"","cod_attivazione":"10174594","uid":"MA178634","conservazione":true,"data_attivazione":"20/04/2021","data_scadenza":"20/04/2022","descrizione":"yourpec@testcert.legalmail.it","sms":true,"spazio_conservazione":1536,"spazio_disco":3072,"spazio_storico":14336,"stato":"evasa","storico":true,"documenti_attivazione":["6045fdee3a716847a978a471_0_attivazione.pdf","6045fdee3a716847a978a471_1_attivazione.pdf"],"documenti_conservazione":["6045fdee3a716847a978a471_0_conservazione.pdf"],"id":"6045fdee3a716847a978a471","autorinnovo":false},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":645,"data":null}}}},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":290,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"spazio_disco_same":{"summary":"spazio_disco : la valeur correspond à la valeur actuelle","value":{"success":false,"message":"you already have this space value","error":284,"data":null}},"spazio_disco_lower":{"summary":"spazio_disco : valeur inférieure à la valeur actuelle","value":{"success":false,"message":"you cannot decrease your space","error":285,"data":null}},"spazio_storico_same":{"summary":"spazio_storico : la valeur est égale à la valeur actuelle","value":{"success":false,"message":"you already have this space value","error":286,"data":null}},"spazio_storico_lower":{"summary":"spazio_storico : valeur inférieure à la valeur actuelle","value":{"success":false,"message":"you cannot decrease your space","error":287,"data":null}},"spazio_conservazione_same":{"summary":"spazio_conservazione : la valeur est égale à la valeur actuelle","value":{"success":false,"message":"you already have this space value","error":288,"data":null}},"spazio_conservazione_lower":{"summary":"spazio_conservazione : valeur inférieure à la valeur actuelle","value":{"success":false,"message":"you cannot decrease your space","error":289,"data":null}},"space_negative":{"summary":"Tout champ « espace » : valeur négative transmise","value":{"success":false,"message":"you cannot decrease your space","error":523,"data":null}},"space_wrong_multiple":{"summary":"Tout champ « espace » : si « spazio_disco/spazio_storico » n'est pas un multiple de 1 024 (ERROR 525, comme indiqué) ; si « spazio_conservazione » n'est pas un multiple de 512 sur InfoCert ou de 1 024 sur Namirial, cela génère l'ERROR 524","value":{"success":false,"message":"the system only takes into account multiples of 1024","error":525,"data":null}},"invio_massivo_pec_invalid":{"summary":"invio_massivo_pec n'est pas un multiple de 50","value":{"success":false,"message":"invio_massivo_pec must be a multiple of 50 (e.g. 50, 100, 150)","error":515,"data":null}},"phishing_already_active":{"summary":"La protection contre le phishing est déjà activée","value":{"success":false,"message":"phishing protection is already active","error":516,"data":null}},"password_already_active":{"summary":"La protection par mot de passe est déjà activée","value":{"success":false,"message":"password protection is already active","error":517,"data":null}}}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"not_processed":{"summary":"PEC non encore traité","value":{"success":false,"message":"you can modify your certified mail only if it has been processed","error":513,"data":null}},"conservazione_not_active":{"summary":"Le service « conservation » n'est pas actif","value":{"success":false,"message":"you must first activate the 'conservazione' service","error":514,"data":null}},"no_values":{"summary":"Aucun champ de modification n'est fourni","value":{"success":false,"message":"you did not pass any values","error":518,"data":null}}}}}}}}},"/pec/{id}/conservazione":{"patch":{"tags":["Pec"],"summary":"Mise en œuvre des mesures de conservation conformément à la loi","description":"Cette méthode vous permet d'activer le service de stockage standard dans votre messagerie électronique certifiée. Elle est prise en charge pour tous les types de boîtes aux lettres, y compris DOMICILIODIGITALE et PECMASSIVA (Namirial). Elle ne fait que préparer la demande (espace + documents) ; l'activation effective côté fournisseur est effectuée ultérieurement par un opérateur, et non via cette API. L’espace de conservation est vendu par tranches de 512 Mo sur InfoCert et de 1 Go (1 024 Mo) sur Namirial. L’espace de conservation est acheté lors de l’inscription (POST /pec, spazio_conservazione) ; cet appel télécharge les documents signés et ne facture pas à nouveau cet espace. Seul l’espace dépassant ce qui a déjà été payé est facturé ici, au prix annuel plein. Sur Namirial, l’espace ne peut pas dépasser l’espace d’archivage (ERROR 607). InfoCert n’a besoin que d’un seul document (« documenti » sous forme de chaîne de caractères simple ou de tableau à un élément) ; Namirial en nécessite exactement deux, transmis dans l’ordre (1er = contrat de conservation, 2e = déclaration de confidentialité ; sinon, ERROR 726, avant toute facturation) : Namirial accepte un seul document, ils sont donc fusionnés en un seul PDF lorsqu’un opérateur active la conservation — voir l’exemple de requête « namirial ».","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6045fdee3a716847a978a471"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"spazio_conservazione":{"oneOf":[{"type":"string","example":"1024","multipleOf":512},{"type":"integer","example":1024,"multipleOf":512}],"description":"L'espace de stockage acheté lors de l'inscription (POST /pec) est déjà payé et conservé. Si ce paramètre n'est pas fourni, cet espace est utilisé (si aucun n'a été acheté : 512 Mo sur InfoCert, 1 024 Mo sur Namirial) ; une valeur supérieure ou « +N » ne facture que les paquets dépassant l'espace déjà payé ; une valeur inférieure renvoie l'erreur 289."},"documenti":{"oneOf":[{"type":"string","description":"base64_encode(contenu du fichier) ; seuls les fichiers PDF sont autorisés. InfoCert uniquement — Namirial a besoin de 2 documents, utilisez le format tableau."},{"type":"array","items":{"type":"string","description":"base64_encode(contenu du fichier) ; seuls les fichiers PDF sont autorisés"},"description":"InfoCert : un seul élément suffit. Namirial : doit contenir exactement deux éléments, dans l'ordre suivant : [0] = contrat de conservation, [1] = déclaration de confidentialité (fusionnés en un seul fichier PDF lors de l'activation)."}]}},"required":["documenti"]},"examples":{"infocert":{"summary":"Exemple d'InfoCert","value":{"spazio_conservazione":512,"documenti":"JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ"}},"namirial":{"summary":"Exemple de Namirial","value":{"spazio_conservazione":1024,"documenti":["JVBERi0xLjQKJ...(contratto conservazione)","JVBERi0xLjQKJ...(informativa privacy)"]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"GOLD","tipo_cliente":"PV","sottotipo_cliente":"","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","codice_fiscale_richiedente":"RSSMRA82D11H501D","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"},"dominio":"testcert.legalmail.it","owner":"mail@domain.com","timestamp":{"registrazione":1615199724,"evasione":1615199724,"scadenza":1646391493,"ultima_modifica":1615200175},"cellulare":"","comune_nascita_richiedente":"","cod_attivazione":"10174594","uid":"MA178634","conservazione":false,"data_attivazione":"20/04/2021","data_scadenza":"20/04/2022","descrizione":"yourpec@testcert.legalmail.it","sms":true,"spazio_conservazione":1024,"spazio_disco":2048,"spazio_storico":13312,"stato":"evasa","storico":true,"documenti_attivazione":["6045fdee3a716847a978a471_0_attivazione.pdf","6045fdee3a716847a978a471_1_attivazione.pdf"],"documenti_conservazione":["6045fdee3a716847a978a471_0_conservazione.pdf"],"id":"6045fdee3a716847a978a471","autorinnovo":false},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":645,"data":null}}}},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":297,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"spazio_conservazione_lower_than_paid":{"summary":"spazio_conservazione inférieur à l'espace déjà payé lors de l'inscription","value":{"success":false,"message":"spazio_conservazione cannot be lower than the space already paid (1024 MB)","error":289,"data":null}},"already_active_infocert":{"value":{"success":false,"message":"conservazione service is already active","error":541,"data":null}},"already_active_namirial":{"value":{"success":false,"message":"conservazione service is already active","error":541,"data":null},"summary":"Boîtes Namirial : même code que celles d'InfoCert (541)"},"documenti_namirial":{"summary":"Boîtes Namirial : 2 documents sont requis (contrat de conservation, puis déclaration de confidentialité). Vérification effectuée avant toute facturation.","value":{"success":false,"message":"Namirial requires exactly 2 conservation documents, in order: conservation contract and privacy disclosure","error":726,"data":null}}}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"documenti_required":{"value":{"success":false,"message":"documenti required","error":526,"data":null}},"not_processed_infocert":{"value":{"success":false,"message":"you can activate this service only if the pec has been processed","error":540,"data":null}},"not_processed_namirial":{"value":{"success":false,"message":"you can activate this service only if the pec has been processed","error":644,"data":null}}}}}}}}},"/pec/{id}/trasformazione":{"patch":{"tags":["Pec"],"summary":"Modifier le type de case","description":"Cette méthode vous permet de modifier le type de boîte mail certifiée. Seules les mises à niveau sont autorisées ; par exemple, vous pouvez passer d’une boîte STANDARD à une boîte SILVER ou GOLD. Cette opération n'est pas autorisée pour ces deux types de boîtes : DOMICILIODIGITALE, PECMASSIVA. Les boîtes MASSIVA1, MASSIVA2 et MASSIVA3 ne peuvent pas être transformées en STANDARD, BRONZE, SILVER ou GOLD (ERROR 522).","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6045fdee3a716847a978a471"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tipo_casella":{"type":"string","description":"type de boîte aux lettres","enum":["STANDARD","BRONZE","SILVER","GOLD"]}}},"example":{"tipo_casella":"GOLD"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"GOLD","tipo_cliente":"PV","sottotipo_cliente":"","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","codice_fiscale_richiedente":"RSSMRA82D11H501D","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"},"dominio":"testcert.legalmail.it","owner":"mail@domain.com","timestamp":{"registrazione":1615199724,"evasione":1615199724,"scadenza":1646391493,"ultima_modifica":1615200175},"cellulare":"","comune_nascita_richiedente":"","cod_attivazione":"10174594","uid":"MA178634","conservazione":false,"data_attivazione":"20/04/2021","data_scadenza":"20/04/2022","descrizione":"yourpec@testcert.legalmail.it","sms":true,"spazio_conservazione":0,"spazio_disco":2048,"spazio_storico":13312,"stato":"evasa","storico":true,"documenti_attivazione":["6045fdee3a716847a978a471_0_attivazione.pdf","6045fdee3a716847a978a471_1_attivazione.pdf"],"id":"6045fdee3a716847a978a471","autorinnovo":false},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":645,"data":null}}}},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":279,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"downgrade_not_allowed":{"value":{"success":false,"message":"a downgrade of the 'tipo_casella' is not allowed","error":522,"data":null}},"tipo_casella_not_valid":{"value":{"success":false,"message":"tipo_casella not valid: STANDARD|BRONZE|SILVER|GOLD","error":676,"data":null}}}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"wrong_stato_infocert":{"value":{"success":false,"message":"you can trasform your certified mail only if it has been processed","error":519,"data":null}},"not_supported_namirial":{"value":{"success":false,"message":"this service cannot be activated on these boxes: DOMICILIODIGITALE|PECMASSIVA","error":609,"data":null}}}}}}}}},"/pec/{id}/rinnovo":{"get":{"tags":["Pec"],"summary":"Renouvellement de l'adresse e-mail certifiée","description":"Cette méthode vous permet de renouveler (1 à 3 ans, paramètre de requête « anni ») ou de réactiver l'adresse e-mail certifiée identifiée par l'identifiant. La boîte aux lettres conserve toujours le jour et le mois de sa date d’expiration précédente : la nouvelle date d’expiration correspond à la date précédente majorée du nombre d’années renouvelées si la boîte aux lettres a expiré il y a moins de 6 mois (InfoCert) ou moins d’un mois (Namirial) ; dans le cas contraire, elle correspond à la dernière date anniversaire déjà passée majorée du nombre d’années renouvelées (le cycle annuel se poursuit ; par exemple : expiration le 15/03/2025, renouvellement le 10/10/2026 pour 1 an → 15/03/2027). Une boîte aux lettres révoquée ne peut être renouvelée que dans ces limites (ERROR 252).","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6040e4613a716838dc4eee0e"}},{"name":"anni","in":"query","description":"Nombre d'années pour lesquelles vous souhaitez renouveler la boîte PEC (1 à 3). Si ce paramètre n'est pas spécifié, la valeur par défaut est 1. Les valeurs supérieures à 3 sont automatiquement limitées à 3 ; les valeurs non numériques ou inférieures à 1 génèrent l'erreur 649.","required":false,"schema":{"type":"integer","minimum":1,"maximum":3,"example":2}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"BRONZE","tipo_cliente":"PV","sottotipo_cliente":"","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","codice_fiscale_richiedente":"RSSMRA82D11H501D","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"},"dominio":"testcert.legalmail.it","owner":"mail@domain.com","timestamp":{"registrazione":1614865504,"ultima_modifica":1614868403,"evasione":1614868312,"scadenza":1646391493},"cellulare":"","comune_nascita_richiedente":"","cod_attivazione":"10173956","uid":"MA177987","conservazione":true,"data_scadenza":"04/03/2022","descrizione":"yourpec@testcert.legalmail.it","sms":true,"spazio_conservazione":512,"spazio_disco":3072,"spazio_storico":3072,"stato":"evasa","storico":true,"documenti_attivazione":["6040e4613a716838dc4eee0e_0_attivazione.pdf","6040e4613a716838dc4eee0e_1_attivazione.pdf"],"data_attivazione":"04/03/2021","documenti_conservazione":["6040e4613a716838dc4eee0e_0_conservazione.pdf","6040e4613a716838dc4eee0e_1_conservazione.pdf"],"multiutenza":[{"nome":"luca","cognome":"bianchi","descrizione":"prima utenza","email_gestione_password":"mail@domain.com","id_utenza":"6040e4613a716838dc4eee0e_0","timestamp":{"attivazione":1614868138},"userid":"MA177993"}],"id":"6040e4613a716838dc4eee0e","autorinnovo":false},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"examples":{"wrong_id":{"value":{"success":false,"message":"Wrong id","error":201,"data":null}},"invalid_anni":{"value":{"success":false,"message":"invalid anni parameter","error":649,"data":null}}}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"wrong_stato":{"value":{"success":false,"message":"you can renew only evaded or revoked pec","error":203,"data":null}},"revocata_too_long_infocert":{"value":{"success":false,"message":"casella revocata da piu di 6 mesi","error":252,"data":null}},"revocata_too_long_namirial":{"value":{"success":false,"message":"casella revocata da piu di un mese","error":252,"data":null}}}}}}}}},"/pec/{id}/multiutenza":{"post":{"tags":["Pec"],"summary":"Ajouter un utilisateur","description":"InfoCert : ajoute un utilisateur pouvant utiliser une boîte PEC existante (opération répétable, jusqu'à 25 utilisateurs). Namirial (DOMICILIODIGITALE/PECMASSIVA) : n'ajoute pas d'utilisateur — cet appel active uniquement une fois le service d'activation/désactivation du mode multi-utilisateurs. Le corps du message n’est pas lu du tout pour Namirial ; un corps vide « {} » fonctionne ; un nouvel appel renvoie l’ERROR 596 « multiutenza uniquement disponible pour cette boîte PEC ». Facturation (InfoCert) : le service multi-utilisateurs (premier utilisateur uniquement) et chaque utilisateur sont facturés au prix annuel complet, quel que soit le nombre de mois restants avant l’expiration de la boîte aux lettres.","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6040e4613a716838dc4eee0e"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostMultiutenza"},"examples":{"infocert":{"summary":"Exemple d'InfoCert","value":{"nome":"luca","cognome":"bianchi","descrizione":"prima utenza","email_gestione_password":"mail@domain.com"}},"namirial":{"summary":"Exemple de Namirial","value":{}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"yourpec@testcert.legalmail.it","tipo_casella":"BRONZE","tipo_cliente":"PV","sottotipo_cliente":"","sottotipo_cliente_altro":"","nome_richiedente":"mario","cognome_richiedente":"rossi","email":"mail@domain.com","telefono":"0548798569","codice_fiscale_richiedente":"RSSMRA82D11H501D","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"},"dominio":"testcert.legalmail.it","owner":"mail@domain.com","timestamp":{"registrazione":1614865504,"ultima_modifica":1614868403,"evasione":1614868312,"scadenza":1646391493},"cellulare":"","comune_nascita_richiedente":"","cod_attivazione":"10173956","uid":"MA177987","conservazione":true,"data_scadenza":"04/03/2022","descrizione":"yourpec@testcert.legalmail.it","sms":true,"spazio_conservazione":512,"spazio_disco":3072,"spazio_storico":3072,"stato":"evasa","storico":true,"documenti_attivazione":["6040e4613a716838dc4eee0e_0_attivazione.pdf","6040e4613a716838dc4eee0e_1_attivazione.pdf"],"data_attivazione":"04/03/2021","documenti_conservazione":["6040e4613a716838dc4eee0e_0_conservazione.pdf","6040e4613a716838dc4eee0e_1_conservazione.pdf"],"multiutenza":[{"nome":"luca","cognome":"bianchi","descrizione":"prima utenza","email_gestione_password":"mail@domain.com","id_utenza":"6040e4613a716838dc4eee0e_0","timestamp":{"attivazione":1614868138},"userid":"MA177993"}],"id":"6040e4613a716838dc4eee0e","autorinnovo":false},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":645,"data":null}}}},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":220,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"max_users_infocert":{"value":{"success":false,"message":"maximum number of users reached: 25","error":535,"data":null}},"already_active_namirial":{"value":{"success":false,"message":"multiutenza just available for this pec","error":596,"data":null}},"email_gestione_password_not_valid":{"value":{"success":false,"message":"email_gestione_password not valid","error":548,"data":null}}}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"wrong_stato_infocert":{"value":{"success":false,"message":"you can activate this service only if the pec has been processed","error":543,"data":null}},"wrong_stato_namirial":{"value":{"success":false,"message":"you can activate this service only if the pec has been processed","error":604,"data":null}},"nome_required":{"value":{"success":false,"message":"nome required","error":544,"data":null}},"cognome_required":{"value":{"success":false,"message":"cognome required","error":545,"data":null}},"descrizione_required":{"value":{"success":false,"message":"descrizione required","error":546,"data":null},"summary":"Boîtes InfoCert uniquement — le champ « descrizione » est obligatoire conformément au code, même s'il ne figure pas dans la liste BodyPostMultiutenza.required. Ce champ est ignoré pour les boîtes Namirial (DOMICILIODIGITALE/PECMASSIVA), qui ne valident pas du tout ces champs."},"email_gestione_password_required":{"value":{"success":false,"message":"email_gestione_password required","error":547,"data":null}}}}}}}},"get":{"tags":["Pec"],"summary":"Afficher (ou récupérer) un utilisateur esclave multi-utilisateurs","description":"Renvoie les utilisateurs secondaires du service « multiutenza » d'une boîte aux lettres InfoCert. Ne s'applique pas aux boîtes Namirial (DOMICILIODIGITALE/PECMASSIVA), dont le champ « multiutenza » est une valeur booléenne et non un tableau — voir l'ERROR 208.","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6040e4613a716838dc4eee0e"}},{"name":"id_subset","in":"query","description":"Si ce paramètre est fourni, la fonction renvoie uniquement l'utilisateur esclave correspondant à cet index, au lieu de la liste complète. Format : « <id>_<index> », c'est-à-dire la valeur « id_utenza » de l'utilisateur : la partie située après le premier trait de soulignement sert d'index. Un index inexistant renvoie le code 200 avec des données nulles.","required":false,"schema":{"type":"string","example":"6040e4613a716838dc4eee0e_0"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/Utenza"}},{"$ref":"#/components/schemas/Utenza"}]},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"example":{"data":[{"nome":"luca","cognome":"bianchi","descrizione":"prima utenza","email_gestione_password":"mail@domain.com","id_utenza":"6040e4613a716838dc4eee0e_0","timestamp":{"attivazione":1614868138},"userid":"MA177993"}],"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":201,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"examples":{"no_pec_found":{"value":{"success":false,"message":"no pec found","error":202,"data":null}},"multiutenza_not_active":{"value":{"success":false,"message":"multiuser not yet activated on this box","error":208,"data":null}}}}}}}}},"/comunica_pec":{"get":{"tags":["Comunica Pec"],"summary":"Liste de vos communications","description":"Cette méthode vous permet de consulter l'ensemble des communications par courrier électronique certifié startées au registre du commerce et des sociétés.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RichiesteComunicazionePec"}},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":[{"id":"60ad149c3a7168084f1d2b68","casella_pec":"mypec@pec.com","stato":"documenti_caricati","timestamp":1622127248,"owner":"mail@domain.com"},{"id":"60ad0f2a3a716801f42a9773","casella_pec":"yourpec@pec.it","stato":"documenti_caricati","timestamp":1622126850,"owner":"mail@domain.com"}],"success":true,"message":"","error":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no request linked to this account","error":332,"data":null}}}}}},"post":{"tags":["Comunica Pec"],"summary":"Envoyer un e-mail certifié","description":"Cette méthode vous permet d'envoyer un e-mail certifié au registre du commerce.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostComunicaPec"},"example":{"casella_pec":"mypec@pec.com","pec_amministratore":false,"cf":"RSSMRA80A01L117D","nome":"mario","cognome":"rossi","qualifica":"LEGALE_RAPPRESENTANTE","email":"mail@domain.com","cellulare":"3401234567","ragione_sociale":"azienda test","cf_piva":"12345678910","comune":"roma","provincia":"RM","callback":{"url":"https://your-domain.it/your_callback.php","custom":{"my_order_id":"123456"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RichiestaComunicazionePec"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"mypec@pec.com","pec_amministratore":false,"cf":"RSSMRA80A01L117D","nome":"mario","cognome":"rossi","qualifica":"LEGALE_RAPPRESENTANTE","email":"mail@domain.com","cellulare":"34xxxxxx18","ragione_sociale":"azienda test","cf_piva":"12345678910","comune":"roma","provincia":"RM","callback":false,"stato":"codice_in_richiesta","codice_registro_imprese":"openapi","documenti_registro_imprese":[],"owner":"mail@domain.com","timestamp":1621955739,"id":"60ad149c3a7168084f1d2b68"},"success":true,"message":"","error":null}}}},"402":{"description":"Paiement requis","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 182.03","error":610,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"invalid_casella_pec":{"value":{"success":false,"message":"invalid casella_pec","error":336,"data":null}},"already_exists":{"value":{"success":false,"message":"a request already exists for this name: mypec@pec.com","error":337,"data":null}},"invalid_email":{"value":{"success":false,"message":"email not valid","error":340,"data":null}},"cellulare_not_numeric":{"value":{"success":false,"message":"cellulare must be numeric","error":342,"data":null}},"invalid_cf_piva":{"value":{"success":false,"message":"cf_piva not valid","error":345,"data":null}},"invalid_cf":{"value":{"success":false,"message":"cf not valid","error":400,"data":null}},"invalid_qualifica":{"value":{"success":false,"message":"qualifica not valid, choose one of these: [\"AMMINISTRATORE\",\"COMMISSARIO_GIUDIZIARIO\",\"CURATORE_FALLIMENTARE\",\"LEGALE_RAPPRESENTANTE\",\"LIQUIDATORE\",\"SOCIO\",\"TITOLARE\"]","error":403,"data":null}},"callback_url_malformed":{"value":{"success":false,"message":"malformed url","error":704,"data":null}},"callback_url_scheme":{"value":{"success":false,"message":"url must start with http:// or https://","error":706,"data":null}},"callback_custom_too_big":{"value":{"success":false,"message":"custom field exceeds 512 bytes","error":730,"data":null}},"callback_invalid_retry":{"value":{"success":false,"message":"invalid retry value","error":740,"data":null}},"callback_invalid_header":{"value":{"success":false,"message":"invalid header key or value","error":708,"data":null}},"callback_header_key_too_long":{"value":{"success":false,"message":"header key too long","error":709,"data":null}},"callback_header_value_not_string":{"value":{"success":false,"message":"header value must be a string","error":710,"data":null}},"callback_headers_too_long":{"value":{"success":false,"message":"headers too long","error":711,"data":null}}}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"casella_pec_required":{"value":{"success":false,"message":"casella_pec required","error":335,"data":null}},"email_required":{"value":{"success":false,"message":"email required","error":339,"data":null}},"cellulare_required":{"value":{"success":false,"message":"cellulare required","error":341,"data":null}},"ragione_sociale_required":{"value":{"success":false,"message":"ragione_sociale required","error":343,"data":null}},"cf_piva_required":{"value":{"success":false,"message":"cf_piva required","error":344,"data":null}},"comune_required":{"value":{"success":false,"message":"comune required","error":346,"data":null}},"provincia_required":{"value":{"success":false,"message":"provincia required","error":347,"data":null}},"nome_required":{"value":{"success":false,"message":"nome required","error":348,"data":null}},"cognome_required":{"value":{"success":false,"message":"cognome required","error":349,"data":null}},"cf_required":{"value":{"success":false,"message":"cf required","error":350,"data":null}},"qualifica_required":{"value":{"success":false,"message":"qualifica required","error":351,"data":null}},"invalid_callback":{"value":{"success":false,"message":"Error: The 'callback' field has an invalid type (string or other), expected object|array. Value: <print_r output of the submitted value>","error":407,"data":null}}}}}}}}},"/comunica_pec/{id}":{"get":{"tags":["Comunica Pec"],"summary":"Demande spécifique de communication pec","description":"Cette méthode vous renvoie la requête spécifique identifiée par l'identifiant","parameters":[{"name":"id","in":"path","description":"Indiquez le numéro d'identification Pec","required":true,"schema":{"type":"string","example":"60ad149c3a7168084f1d2b68"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RichiestaComunicazionePec"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"mypec@pec.com","pec_amministratore":false,"cf":"RSSMRA80A01L117D","nome":"mario","cognome":"rossi","qualifica":"LEGALE_RAPPRESENTANTE","email":"mail@domain.com","cellulare":"349xxxxx18","ragione_sociale":"azienda test","cf_piva":"12345678910","comune":"roma","provincia":"RM","callback":false,"stato":"documenti_caricati","codice_registro_imprese":"openapi","documenti_registro_imprese":["60ad149c3a7168084f1d2b68_0_registro_imprese.p7m"],"owner":"mail@domain.com","timestamp":1622127248,"id":"60ad149c3a7168084f1d2b68"},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":333,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no request found","error":334,"data":null}}}}}},"patch":{"tags":["Comunica Pec"],"summary":"Téléverser les documents","description":"Cette méthode vous permet d'effectuer la demande de communication de votre PEC au registre du commerce en téléversant les documents requis. Les documents requis comprennent le formulaire dûment rempli et signé numériquement (au format PDF ou p7m), que vous pouvez télécharger à l'aide de la méthode GET/comunica_pec/{id}/procura_registro_imprese.","parameters":[{"name":"id","in":"path","description":"Indiquez le numéro d'identification Pec","required":true,"schema":{"type":"string","example":"60dc8da86c8b04624536bbb2"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["documenti"],"properties":{"documenti":{"oneOf":[{"type":"string","description":"base64_encode(contenu du fichier) ; les fichiers PDF ou p7m sont acceptés"},{"type":"array","items":{"type":"string","description":"base64_encode(contenu du fichier) ; les fichiers PDF ou p7m sont acceptés"}}]}}},"example":{"documenti":"JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RichiestaComunicazionePec"},"success":{"type":"boolean","description":"Succès de l'opération (vrai/faux)."},"message":{"type":"string","description":"message d'erreur"},"error":{"type":"integer","description":"code d'erreur"}}},"example":{"data":{"casella_pec":"mypec@pec.com","pec_amministratore":false,"cf":"RSSMRA80A01L117D","nome":"mario","cognome":"rossi","qualifica":"LEGALE_RAPPRESENTANTE","email":"mail@domain.com","cellulare":"34xxxxx018","ragione_sociale":"azienda test","cf_piva":"12345678910","comune":"roma","provincia":"RM","callback":false,"stato":"documenti_caricati","codice_registro_imprese":"openapi","documenti_registro_imprese":["60dc8da86c8b04624536bbb2_0_registro_imprese.p7m"],"owner":"mail@domain.com","timestamp":1625067055,"id":"60dc8da86c8b04624536bbb2"},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":353,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no request found","error":354,"data":null}}}},"406":{"description":"Inacceptable","content":{"application/json":{"examples":{"wrong_stato":{"value":{"success":false,"message":"you can only upload documents when stato is 'in_attesa_di_documenti'","error":355,"data":null}},"wrong_file_format":{"value":{"success":false,"message":"wrong file format, p7m required","error":402,"data":null}}}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"id_required":{"value":{"success":false,"message":"id required","error":352,"data":null}},"documenti_required":{"value":{"success":false,"message":"documenti required","error":356,"data":null}},"documenti_empty":{"value":{"success":false,"message":"documenti empty","error":401,"data":null}}}}}}}}},"/pec/{id}/modulo_attivazione":{"get":{"tags":["Modulistica"],"summary":"Télécharger le formulaire d'activation","description":"Cette méthode vous permet de télécharger directement le formulaire d'activation d'un e-mail certifié. Une fois rempli et signé, il sera transmis sous la forme d'une chaîne encodée en base 64 via la méthode PATCH/pec/{id}/attivazione, accompagné d'une pièce d'identité.","parameters":[{"name":"id","in":"path","description":"identifiant de la demande","required":true,"schema":{"type":"string","example":"5f7b2e323a716857774a4373"}}],"responses":{"200":{"description":"Le fichier PDF (Content-Type : application/pdf, sans en-tête Content-Disposition)","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":201,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"wrong_stato_infocert":{"value":{"success":false,"message":"you can activate the pec only when it is in the 'registrata|documenti_errati' state","error":537,"data":null}},"wrong_stato_namirial":{"value":{"success":false,"message":"you can activate the pec only when it is in the 'registrata|documenti_errati' state","error":598,"data":null}},"pdf_generation_failed_namirial":{"value":{"success":false,"message":"Errore nella generazione del modulo","error":601,"data":null}},"generazione_modulo":{"summary":"Impossible de générer le formulaire d'activation au format PDF ; veuillez réessayer plus tard.","value":{"success":false,"message":"Errore nella generazione del modulo","error":603,"data":null}}}}}}}}},"/pec/{id}/modulo_conservazione":{"get":{"tags":["Modulistica"],"summary":"Télécharger le formulaire d'activation","description":"Cette méthode vous permet de télécharger directement le formulaire d'activation de la conservation d'un e-mail certifié. Une fois rempli et signé, il doit être transmis sous forme de chaîne encodée en base64 via la requête PATCH /pec/{id}/conservazione.","parameters":[{"name":"id","in":"path","description":"identifiant de la demande","required":true,"schema":{"type":"string","example":"5f7b2e323a716857774a4373"}}],"responses":{"200":{"description":"Le fichier PDF (Content-Type : application/pdf, sans en-tête Content-Disposition)","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":201,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Condition préalable requise","content":{"application/json":{"examples":{"wrong_stato_infocert":{"value":{"success":false,"message":"you can activate this service only if the pec has been processed","error":538,"data":null}},"wrong_stato_namirial":{"value":{"success":false,"message":"you can activate this service only if the pec has been processed","error":599,"data":null}},"pdf_generation_failed_namirial":{"value":{"success":false,"message":"Errore nella generazione del modulo","error":601,"data":null}}}}}}}}},"/comunica_pec/{id}/procura_registro_imprese":{"get":{"tags":["Modulistica"],"summary":"Télécharger la procuration","description":"Cette méthode vous permet de télécharger le formulaire de communication PEC vers le registre du commerce. Une fois signé numériquement au format p7m, il sera transmis sous la forme d'une chaîne encodée en base 64 à l'aide de la méthode PATCH/comunica_pec/{id}.","parameters":[{"name":"id","in":"path","description":"identifiant de la demande","required":true,"schema":{"type":"string","example":"5f7b2e323a716857774a4373"}}],"responses":{"200":{"description":"Si le formulaire signé a déjà été téléchargé, renvoie le fichier PDF stocké. Dans le cas contraire (et si « stato » n'est pas égal à « codice_in_richiesta »), le système renvoie alors l'enregistrement de la requête au format JSON à la place d'un fichier.","headers":{"Content-Disposition":{"schema":{"type":"string"},"example":"attachment; filename=\"5f7b2e323a716857774a4373_procura_registro_imprese.pdf\""}},"content":{"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RichiestaComunicazionePec"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":333,"data":null}}}},"404":{"description":"Introuvable","content":{"application/json":{"example":{"success":false,"message":"no request found","error":334,"data":null}}}},"406":{"description":"Inacceptable — le formulaire ne peut pas encore être généré car la demande est toujours à l'état « codice_in_richiesta ». Renvoyé sous forme de corps en texte brut, et non dans une enveloppe JSON.","content":{"text/plain":{"schema":{"type":"string"},"example":"you cannot download this module, it doesn't exist yet"}}}}}}},"externalDocs":{"description":"C'est votre première visite ? Générez un nouveau jeton d'accès","url":"https://console.openapi.com/fr/oauth"},"security":[{"bearerAuth":[]}]}