{"openapi":"3.0.1","info":{"description":"Servizi web per l'attivazione e la gestione della Posta Elettronica Certificata (PEC). Questi servizi consentono di registrare una nuova casella di posta elettronica certificata, nonché di rinnovare o revocare gli account esistenti. È anche possibile modificare le opzioni delle caselle di posta elettronica, come lo spazio totale di archiviazione e di memorizzazione, o attivare ed espandere la conservazione a norma di legge. Inoltre, il sistema include metodi per segnalare un indirizzo e-mail certificato al Business Report. Infine, è possibile utilizzare questi servizi per scaricare e caricare i moduli di attivazione sia per la casella di posta che per il servizio di conservazione a norma di legge.","version":"1.0.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":"Produzione"},{"url":"https://test.pec.openapi.it","description":"Sandbox"}],"tags":[{"name":"Pec","description":"Metodi che permettono di registrare, attivare e modificare una posta elettronica certificata"},{"name":"Comunica Pec","description":"Metodi che consentono di comunicare un messaggio di posta elettronica certificata al registro delle imprese"},{"name":"Domini","description":"Metodi che consentono di attivare e modificare un dominio certificato"},{"name":"Modulistica","description":"Metodi che consentono di scaricare la modulistica necessaria per la gestione delle caselle di posta elettronica certificata"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"BodyPostPec":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'indirizzo di posta elettronica certificata (PEC)"},"tipo_casella":{"type":"string","description":"tipo di cassetta postale","enum":["STANDARD","BRONZE","SILVER","GOLD","DOMICILIODIGITALE","PECMASSIVA"]},"tipo_cliente":{"type":"string","description":"il tipo di cliente","enum":["IM","PS","PL","PC","A","PV","X"]},"sottotipo_cliente":{"type":"string","description":"il sottotipo di 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"]},"sottotipo_cliente_altro":{"type":"string","description":"altro sottotipo di cliente"},"nome_richiedente":{"type":"string","description":"nome del richiedente"},"cognome_richiedente":{"type":"string","description":"cognome del richiedente"},"email":{"type":"string","description":"indirizzo e-mail standard del richiedente"},"telefono":{"type":"string","description":"numero di telefono del richiedente"},"cellulare":{"type":"string","description":"numero di cellulare del richiedente"},"codice_fiscale_richiedente":{"type":"string","description":"codice fiscale del richiedente"},"data_nascita_richiedente":{"type":"string","description":"data di nascita del richiedente"},"sesso_richiedente":{"type":"string","description":"sesso del richiedente","enum":["M","F"]},"nazione_nascita_richiedente":{"type":"string","description":"paese di nascita del richiedente"},"comune_nascita_richiedente":{"type":"string","description":"city di nascita del richiedente"},"provincia_nascita_richiedente":{"type":"string","description":"provincia di nascita del richiedente"},"denominazione_titolare":{"type":"string","description":"nome del titolare della cassetta postale"},"cf_piva_titolare":{"type":"string","description":"codice fiscale o partita IVA del titolare della cassetta postale"},"indirizzo_titolare":{"type":"string","description":"indirizzo del titolare della cassetta postale"},"comune_titolare":{"type":"string","description":"city del titolare della cassetta postale"},"cap_titolare":{"type":"string","description":"codice postale (CAP) del titolare della cassetta postale"},"nazione_titolare":{"type":"string","description":"paese del titolare della cassetta postale"},"provincia_titolare":{"type":"string","description":"province del supporto per la cassetta postale"},"callback":{"$ref":"#/components/schemas/Callback"},"autorinnovo":{"type":"boolean","description":"se impostato su true, permette al sistema di rinnovare automaticamente l'account alla scadenza, cercando di prelevare il credito dal borsellino del proprietario","default":false},"tipo_documento":{"type":"string","description":"tipo di documento di identificazione","enum":["CARTA_D_IDENTITA","PATENTE","PASSAPORTO"]},"numero_documento":{"type":"string","description":"numero del documento"},"data_scadenza_documento":{"type":"string","description":"data di scadenza del documento"},"documento_rilasciato_da":{"type":"string","description":"autorità di emissione del documento"},"data_rilascio_documento":{"type":"string","description":"Data di emissione del documento"}},"required":["casella_pec","tipo_casella","tipo_cliente","nome_richiedente","cognome_richiedente","email","telefono","codice_fiscale_richiedente","data_nascita_richiedente","sesso_richiedente","nazione_nascita_richiedente","indirizzo_titolare","comune_titolare","cap_titolare","nazione_titolare","provincia_titolare"]},"BodyPostDominio":{"type":"object","required":["dominio","fornitore"],"properties":{"dominio":{"type":"string","description":"Il nome del dominio da attivare (ad es. example.com)","example":"testdominio.legalmail.it"},"callback":{"$ref":"#/components/schemas/Callback"},"fornitore":{"type":"string","enum":["infocert","namirial"],"description":"Il fornitore di servizi","example":"infocert"},"anni":{"type":"integer","description":"Numero di anni per cui è stato acquistato il dominio","default":1,"example":1,"enum":[1,2,3,4,5,6,7,8,9,10]},"numero_pec":{"type":"integer","description":"Numero di caselle PEC acquistate per il dominio","default":1,"example":1}}},"Dominio":{"type":"object","properties":{"id":{"type":"string","description":"ID dominio","example":"69806bcce09fb76c6b0fef0b"},"dominio":{"type":"string","description":"Nome del dominio","example":"testdominio.legalmail.it"},"fornitore":{"type":"string","enum":["infocert","namirial"],"description":"Il fornitore di servizi","example":"infocert"},"owner":{"type":"string","description":"Nome utente del proprietario del dominio","example":"mail@domain.com"},"stato_fornitore":{"type":"string","enum":["OK","KO","PENDING"],"description":"Stato del dominio sul lato del provider","example":"OK"},"dns":{"type":"string","description":"Stato della configurazione DNS dal provider","example":"OK"},"config":{"type":"string","description":"Stato della configurazione del server dal provider","example":"OK"},"certif":{"type":"string","description":"Stato di certificazione del fornitore","example":"MISSING"},"tipo_dominio":{"type":"string","enum":["interno","esterno"],"description":"Tipo di dominio (interno o esterno)","example":"interno"},"stato":{"type":"string","enum":["registrato","evaso","revocato"],"description":"Stato di elaborazione interna","example":"registrato"},"data_scadenza":{"type":"string","description":"Data di scadenza (gg/mm/aaaa)","example":"02/02/2027"},"data_certificazione":{"type":"string","description":"Data di certificazione (gg/mm/aaaa)","example":"02/02/2026"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"id_ordine":{"type":"string","description":"ID ordine associato all'attivazione","example":"62558f"},"autorinnovo":{"type":"boolean","default":false,"description":"Se è vero, il dominio verrà rinnovato automaticamente","example":false},"anni":{"type":"integer","description":"Numero di anni per cui è stato acquistato il dominio","example":1},"numero_pec":{"type":"integer","description":"Numero di caselle PEC acquistate per il dominio","example":1},"callback":{"$ref":"#/components/schemas/Callback"}}},"BodyPostComunicaPec":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'indirizzo di posta elettronica certificata (PEC)"},"cf":{"type":"string","description":"codice fiscale"},"nome":{"type":"string","description":"nome"},"cognome":{"type":"string","description":"cognome"},"qualifica":{"type":"string","description":"qualifica del proprietario","enum":["AMMINISTRATORE","COMMISSARIO_GIUDIZIARIO","CURATORE_FALLIMENTARE","LEGALE_RAPPRESENTANTE","LIQUIDATORE","SOCIO","TITOLARE"]},"email":{"type":"string","description":"e-mail del proprietario"},"cellulare":{"type":"string","description":"telefono cellulare del proprietario"},"ragione_sociale":{"type":"string","description":"nome dell'azienda"},"cf_piva":{"type":"string","description":"codice fiscale o partita IVA dell'azienda"},"comune":{"type":"string","description":"comune dell'azienda"},"provincia":{"type":"string","description":"province dell'azienda"},"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":"nome"},"cognome":{"type":"string","description":"cognome"},"descrizione":{"type":"string","description":"descrizione"},"email_gestione_password":{"type":"string","description":"e-mail dell'utente"}},"required":["nome","cognome","descrizione","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":"Pubblica Amministrazione Locale","enum":["LR - REGIONE","LP - PROVINCIA","LC - COMUNE","LM - COMUNITA MONTANA","LA - ASL","LI - CCIAA","X - ALTRO"]},"PC":{"type":"string","description":"Pubblica Amministrazione Centrale"},"A":{"type":"string","description":"Associazione"},"PV":{"type":"string","description":"Privato"},"X":{"type":"string","description":"Altro"}}},"Casella":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'indirizzo di posta elettronica certificata (PEC)"},"tipo_casella":{"type":"string","description":"tipo di cassetta postale","enum":["STANDARD","BRONZE","SILVER","GOLD","DOMICILIODIGITALE","PECMASSIVA"]},"tipo_cliente":{"type":"string","description":"il tipo di cliente"},"sottotipo_cliente":{"type":"string","description":"il sottotipo di cliente"},"sottotipo_cliente_altro":{"type":"string","description":"altro sottotipo di cliente"},"nome_richiedente":{"type":"string","description":"nome del richiedente"},"cognome_richiedente":{"type":"string","description":"cognome del richiedente"},"email":{"type":"string","description":"indirizzo e-mail standard del richiedente"},"telefono":{"type":"string","description":"numero di telefono del richiedente"},"cellulare":{"type":"string","description":"numero di cellulare del richiedente"},"codice_fiscale_richiedente":{"type":"string","description":"codice fiscale del richiedente"},"data_nascita_richiedente":{"type":"string","description":"data di nascita del richiedente"},"sesso_richiedente":{"type":"string","description":"sesso del richiedente"},"nazione_nascita_richiedente":{"type":"string","description":"paese di nascita del richiedente"},"comune_nascita_richiedente":{"type":"string","description":"città di nascita del richiedente"},"provincia_nascita_richiedente":{"type":"string","description":"provincia di nascita del richiedente"},"denominazione_titolare":{"type":"string","description":"nome del titolare della cassetta postale"},"cf_piva_titolare":{"type":"string","description":"codice fiscale o partita IVA del titolare della cassetta postale"},"indirizzo_titolare":{"type":"string","description":"indirizzo del titolare della cassetta postale"},"comune_titolare":{"type":"string","description":"city del titolare della cassetta postale"},"cap_titolare":{"type":"string","description":"codice postale (CAP) del titolare della cassetta postale"},"nazione_titolare":{"type":"string","description":"paese del titolare della cassetta postale"},"provincia_titolare":{"type":"string","description":"province del supporto della cassetta postale"},"callback":{"$ref":"#/components/schemas/Callback"},"dominio":{"type":"string","description":"il nome di dominio associato alla casella di posta PEC"},"owner":{"type":"string","description":"identificativo del proprietario"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"cod_attivazione":{"type":"string","description":"codice di attivazione della mailbox"},"uid":{"type":"string","description":"identificativo univoco della mailbox o della richiesta"},"conservazione":{"type":"boolean","description":"indica se la conservazione elettronica legale (conservazione a norma) è attiva"},"data_scadenza":{"type":"string","description":"data di scadenza del servizio/della casella di posta elettronica"},"descrizione":{"type":"string","description":"descrizione"},"sms":{"type":"boolean","description":"indica se le notifiche SMS sono attive]"},"spazio_conservazione":{"type":"integer","description":"spazio di archiviazione assegnato per la conservazione legale in MB"},"spazio_disco":{"type":"integer","description":"spazio totale su disco allocato per la mailbox in MB)"},"spazio_storico":{"type":"integer","description":"spazio di archiviazione allocato per i dati storici /archive in MB"},"stato":{"type":"string","enum":["registrata","in_attivazione","evasa","revocata","chiusa"],"description":"stato attuale della mailbox/richiesta"},"storico":{"type":"boolean","description":"indica se la funzione di accesso ai dati storici o di archiviazione è attiva"},"documenti_attivazione":{"type":"array","items":{"type":"string"},"description":"array di stringhe per i documenti di attivazione"},"data_attivazione":{"type":"string","description":"data di attivazione della mailbox"},"documenti_conservazione":{"type":"array","items":{"type":"string"},"description":"array di stringhe per i documenti di conservazione"},"multiutenza":{"type":"array","items":{"$ref":"#/components/schemas/Utenza"}},"id":{"type":"string","description":"iD oggetto"},"autorinnovo":{"type":"boolean","description":"se impostato su true, permette al sistema di rinnovare automaticamente l'account alla scadenza, cercando di prelevare il credito dal borsellino del proprietario"},"tipo_documento":{"type":"string","enum":["CARTA_D_IDENTITA","PATENTE","PASSAPORTO"],"description":"tipo di documento di identificazione"},"numero_documento":{"type":"string","description":"numero del documento"},"data_scadenza_documento":{"type":"string","description":"data di scadenza del documento"},"documento_rilasciato_da":{"type":"string","description":"autorità di emissione del documento"},"data_rilascio_documento":{"type":"string","description":"Data di emissione del documento"}}},"Callback":{"type":"object","properties":{"method":{"type":"string","description":"Indicare il metodo con cui si desidera ricevere i dati con il callback; per impostazione predefinita, è POST","enum":["POST","JSON"]},"field":{"type":"string","description":"Nome del campo contenente i dati di ritorno della callback"},"url":{"type":"string","description":"Url dove verrà effettuata la chiamata di callback","example":"https://www.mysite.it/callback.php"},"data":{"type":"object","description":"Oggetto da completare a proprio piacimento con dati aggiuntivi che possono essere riutilizzati con il callback"}}},"Timestamp":{"type":"object","properties":{"registrazione":{"type":"integer","description":"tempo di registrazione/creazione"},"ultima_modifica":{"type":"integer","description":"ora dell'ultima modifica"},"evasione":{"type":"integer","description":"tempo di completamento/risoluzione"},"certificazione":{"type":"integer","description":"tempo di certificazione/attivazione"},"scadenza":{"type":"integer","description":"scadenza/scadenza"},"revoca":{"type":"integer","description":"tempo di revoca"}}},"RichiesteComunicazionePec":{"type":"object","properties":{"id":{"type":"string","description":"iD oggetto"},"casella_pec":{"type":"string","description":"l'indirizzo di posta elettronica certificata (PEC)"},"stato":{"type":"string","description":"Stato della richiesta","enum":["codice_in_richiesta","in_attesa_di_documenti","documenti_caricati","comunicazione_evasa"]},"timestamp":{"type":"integer"},"owner":{"type":"string","description":"identificativo del proprietario"}}},"RichiestaComunicazionePec":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'indirizzo di posta elettronica certificata (PEC)"},"cf":{"type":"string","description":"codice fiscale"},"nome":{"type":"string","description":"nome"},"cognome":{"type":"string","description":"cognome"},"qualifica":{"type":"string","description":"qualifica del richiedente","enum":["AMMINISTRATORE","COMMISSARIO_GIUDIZIARIO","CURATORE_FALLIMENTARE","LEGALE_RAPPRESENTANTE","LIQUIDATORE","SOCIO","TITOLARE"]},"email":{"type":"string","description":"e-mail del proprietario"},"cellulare":{"type":"string","description":"telefono cellulare del proprietario"},"ragione_sociale":{"type":"string","description":"nome della compagnia"},"cf_piva":{"type":"string","description":"codice fiscale o partita IVA dell'azienda"},"comune":{"type":"string","description":"comune dell'azienda"},"provincia":{"type":"string","description":"province dell'azienda"},"callback":{"$ref":"#/components/schemas/Callback"},"stato":{"type":"string","enum":["codice_in_richiesta","in_attesa_di_documenti","documenti_caricati","comunicazione_evasa"]},"codice_registro_imprese":{"type":"string"},"documenti_registro_imprese":{"type":"array","items":{"type":"string"}},"owner":{"type":"string","description":"identificativo del proprietario"},"timestamp":{"type":"integer"},"id":{"type":"string","description":"iD oggetto"}}},"Utenza":{"type":"object","properties":{"nome":{"type":"string","description":"nome"},"cognome":{"type":"string","description":"cognome"},"descrizione":{"type":"string","description":"note"},"email_gestione_password":{"type":"string","description":"indirizzo e-mail utilizzato per la gestione delle password"},"id_utenza":{"type":"string","description":"identificativo dell'account utente"},"timestamp":{"type":"object","properties":{"attivazione":{"type":"integer","description":"timestamp di attivazione del conto"}}},"userid":{"type":"string","description":"identificativo di accesso dell'utente"}}},"Caselle":{"type":"object","properties":{"casella_pec":{"type":"string","description":"l'indirizzo di posta elettronica certificata (PEC)"},"tipo_casella":{"type":"string","description":"tipo di cassetta postale","enum":["STANDARD","BRONZE","SILVER","GOLD","DOMICILIODIGITALE","PECMASSIVA"]},"owner":{"type":"string","description":"identificativo del proprietario"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"data_scadenza":{"type":"string","description":"data di scadenza"},"stato":{"type":"string","description":"stato di elaborazione","enum":["registrata","in_attivazione","evasa","revocata","chiusa"]},"id":{"type":"string","description":"iD oggetto"}}}}},"paths":{"/dominio":{"get":{"tags":["Domini"],"summary":"Elenco di tutti i domini associati all'account","operationId":"getDominiList","responses":{"200":{"description":"Elenco dei domini","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Dominio"}}}}}}},"404":{"description":"Nessun dominio trovato","content":{"application/json":{"example":{"success":false,"message":"no domains linked to this account","error":701,"data":null}}}}}},"post":{"tags":["Domini"],"summary":"Attivare un nuovo dominio certificato","operationId":"postDominio","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostDominio"}}}},"responses":{"200":{"description":"Attivazione del dominio avviata","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dominio"}}},"example":{"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":"string"},"id":"69806bcce09fb76c6b0fef0b"}}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"examples":{"already_present":{"value":{"success":false,"message":"domain already present in the system","error":712,"data":null}},"invalid_domain":{"value":{"success":false,"message":"domain not valid","error":711,"data":null}},"unreachable":{"value":{"success":false,"message":"The domain '...' is unreachable","error":715,"data":null}}}}}},"428":{"description":"Precondition Required","content":{"application/json":{"examples":{"domain_required":{"value":{"success":false,"message":"domain required","error":703,"data":null}},"no_mx":{"value":{"success":false,"message":"Invalid domain: no MX record found...","error":714,"data":null}}}}}}}}},"/dominio/{id}":{"get":{"tags":["Domini"],"summary":"Ottenere i dettagli di un dominio specifico","operationId":"getDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"L'ID del dominio"}],"responses":{"200":{"description":"Dettagli del dominio","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dominio"}}},"example":{"data":{"dominio":"testdominio.legalmail.it","fornitore":"infocert","owner":"gcloud-tests@openapi.it","stato_fornitore":"OK","dns":"OK","config":"OK","certif":"OK","tipo_dominio":"interno","stato":"evaso","data_scadenza":"02/02/2027","timestamp":{"registrazione":1770023882,"scadenza":1801559882,"ultima_modifica":1770023884,"certificazione":1770023884},"anni":1,"numero_pec":1,"id_ordine":"62558f","autorinnovo":false,"callback":{"url":"https://www.mysite.it/callback.php","method":"POST","field":"data"},"data_certificazione":"03/03/2026","id":"69806bcce09fb76c6b0fef0b"}}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":702,"data":null}}}}}},"delete":{"tags":["Domini"],"summary":"Revocare un dominio certificato","operationId":"deleteDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"L'ID del dominio da revocare"}],"responses":{"200":{"description":"Dominio revocato","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/Dominio"}}},"example":{"success":true,"message":"Domain and associated boxes revoked","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"}}}}},"428":{"description":"Precondition Required","content":{"application/json":{"examples":{"id_required":{"value":{"success":false,"message":"id required","error":705,"data":null}},"already_revoked":{"value":{"success":false,"message":"your domain has already been revoked","error":716,"data":null}}}}}}}}},"/dominio/{id}/rinnovo":{"get":{"tags":["Domini"],"summary":"Rinnovare un dominio certificato","operationId":"renewDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"L'ID del dominio"},{"name":"anni","in":"query","schema":{"type":"integer","default":1,"enum":[1,2,3,4,5,6,7,8,9,10]},"description":"Numero di anni per il rinnovo. Predefinito 1."}],"responses":{"200":{"description":"Risultato del rinnovo","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"}}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":702,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"examples":{"cannot_renew":{"value":{"success":false,"message":"cannot renew domain with status: ...","error":716,"data":null}},"invalid_years":{"value":{"success":false,"message":"years must be between 1 and 10","error":717,"data":null}}}}}}}}},"/domini_pec/{dominio}":{"get":{"tags":["Pec"],"summary":"Controllo del dominio","description":"Questo metodo consente di verificare se un dominio è idoneo all'invio o alla ricezione di una pec","parameters":[{"name":"dominio","in":"path","description":"Dominio","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"}},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"example":{"data":[],"success":true,"message":"legalmail.it found!","error":null}}}},"204":{"description":"Nessun contenuto"},"402":{"description":"Pagamento richiesto","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":403,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"domain not valid","error":709,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"domain required","error":700,"data":null}}}},"503":{"description":"Servizio non disponibile","content":{"application/json":{"example":{"success":false,"message":"service temporarily unavailable","error":710,"data":null}}}}}}},"/verifica_pec/{pec}":{"get":{"tags":["Pec"],"summary":"Disponibilità di una casella di posta elettronica certificata","description":"Questo metodo mostra la disponibilità di una casella di posta elettronica certificata. Può verificare la disponibilità di caselle di posta elettronica solo per i domini configurati e gestiti dal sistema. Per i domini non gestiti, restituirà un errore poiché non è possibile verificarne l'esistenza.","parameters":[{"name":"pec","in":"path","description":"Casella e-mail","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":"Mostra se l'indirizzo e-mail può essere registrato"}}},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"example":{"data":{"available":true},"success":true,"message":"","error":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"invalid casella_pec","error":208,"data":null}}}},"428":{"description":"Precondition Required","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":"Elenco delle vostre caselle di posta elettronica certificata","description":"Questo metodo mostra l'elenco delle caselle di posta elettronica certificata che appartengono al vostro account","parameters":[{"name":"skip","in":"query","description":"Opzionale. Numero di elementi da saltare per la paginazione. Se non è specificato, il valore predefinito è 0.","required":false,"schema":{"type":"integer","example":0}},{"name":"limit","in":"query","description":"Opzionale. Numero massimo di elementi da restituire. Se non viene specificato, il valore predefinito è 100.","required":false,"schema":{"type":"integer","example":100}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Caselle"}},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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"}],"success":true,"message":"","error":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec linked to this account","error":200,"data":null}}}}}},"post":{"tags":["Pec"],"summary":"Registrare una nuova casella di posta elettronica certificata","description":"Questo metodo consente di registrare una nuova casella di posta elettronica certificata.\n\nSe non si dispone di un proprio dominio certificato, la casella di posta deve necessariamente essere composta da:\n\n- 'nome_box'@legalmail.it (Es. provapec@legalmail.it) per le caselle STANDARD, BRONZO, ARGENTO E ORO;\n\n- 'nome_box'@domiciliodigitale.com (Es. provapec@domiciliodigitale.com) per la casella DOMICILIODIGITALE;\n\n- 'box_name'@pecmassiva.com (Es. provapec@pecmassiva.com) per la casella PECMASSIVA.\n\nIn Sandbox deve essere: 'nome_casella'@testcert.legalmail.it (Es. provapec@testcert.legalmail.it) o 'nome_casella'@test.domiciliodigitale.com (Es. provapec@test.domiciliodigitale.com).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostPec"},"example":{"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"it","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"it","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data"}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"IT","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data","method":"POST","data":{}},"dominio":"testcert.legalmail.it","owner":"mail@domain.com","timestamp":{"registrazione":1615199724,"ultima_modifica":1615199726},"cellulare":"","comune_nascita_richiedente":"","cod_attivazione":"10174594","uid":"MA178634","conservazione":false,"data_scadenza":"","descrizione":"prova.sviluppo@testcert.legalmail.it","sms":false,"spazio_conservazione":0,"spazio_disco":0,"spazio_storico":0,"stato":"registrata","storico":false,"id":"6045fdee3a716847a978a471","autorinnovo":false},"success":true,"message":"","error":null}}}},"402":{"description":"Pagamento richiesto","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":262,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"the domain $dominio is non-existent in the system or belongs to someone else","error":326,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"data_nascita_richiedente not valid, accepted format: dd/mm/yyyy","error":242,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"tipo_casella required","error":224,"data":null}}}}}}},"/pec/{id}":{"get":{"tags":["Pec"],"summary":"Indirizzo di posta elettronica certificata specifico","description":"Questo metodo mostra l'indirizzo di posta elettronica certificata specifico relativo all'id","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":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"IT","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data","method":"POST","data":{}},"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":201,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}}}},"delete":{"tags":["Pec"],"summary":"Revoca della Pec","description":"Questo metodo consente di revocare lo specifico indirizzo di posta elettronica certificata relativo all'id","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":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"IT","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data","method":"POST","data":{}},"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":301,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":302,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"your pec has already been revoked","error":303,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"you can revoke the pec only if it is active","error":304,"data":null}}}}}}},"/pec/{id}/attivazione":{"patch":{"tags":["Pec"],"summary":"Attivazione della posta elettronica certificata","description":"Questo metodo consente, una volta registrata la casella di posta elettronica certificata, di attivarla caricando la documentazione necessaria. La documentazione richiesta comprende un documento d'identità valido e il modulo di attivazione compilato e firmato, scaricabile con il metodo GET/pec/{id}/modulo_attivazione. Per le caselle di tipo DOMICILIODIGITALE e PECMASSIVA è necessario creare un unico documento composto dal modulo di attivazione firmato e dal documento di identità.","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":{"oneOf":[{"type":"string","description":"base64_encode(contenuto del file); sono ammessi solo i file pdf"},{"type":"array","items":{"type":"string","description":"base64_encode(contenuto del file); sono ammessi solo i file pdf"}}]}}},"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":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"IT","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data","method":"POST","data":{}},"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":265,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":266,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"wrong file format, pdf required","error":296,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"you can activate the pec only when it is in the 'registrata' state","error":267,"data":null}}}}}}},"/pec/{id}/modifica":{"patch":{"tags":["Pec"],"summary":"Cambiare lo spazio della casella di posta elettronica","description":"Questo metodo consente di modificare lo spazio di una posta elettronica certificata. È possibile modificare lo spazio disco('spazio_disco'), lo spazio dell'archivio di sicurezza('spazio_storico') e lo spazio di archiviazione standard('spazio_conservazione'). È consentito solo un aggiornamento dello spazio. Azione non consentita per questi due tipi di caselle: DOMICILIODIGITALE, PECMASSIVA.","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":"Se si mette il simbolo + davanti si va ad aggiungere spazio a quello che si ha. Se si passa solo un numero si va a impostare lo spazio con quel valore."},"spazio_storico":{"oneOf":[{"type":"string","example":"+1024","multipleOf":1024},{"type":"integer","example":1024,"multipleOf":1024}],"description":"Se si mette il simbolo + davanti si va ad aggiungere spazio a quello che si ha. Se si passa solo un numero si va a impostare lo spazio con quel valore."},"spazio_conservazione":{"oneOf":[{"type":"string","example":"+512","multipleOf":512},{"type":"integer","example":512,"multipleOf":512}],"description":"Se si mette il simbolo + davanti si va ad aggiungere spazio a quello che si ha. Se si passa solo un numero si va a impostare lo spazio con quel valore."}}},"example":{"spazio_disco":"3072","spazio_storico":"+1024","spazio_conservazione":1536}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"IT","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data","method":"POST","data":{}},"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":265,"data":null}}}},"402":{"description":"Pagamento richiesto","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":290,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":266,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"the system only takes into account multiples of 1024","error":325,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"you must first activate the 'conservazione' service","error":282,"data":null}}}}}}},"/pec/{id}/conservazione":{"patch":{"tags":["Pec"],"summary":"Attivazione della conservazione a norma di legge","description":"Questo metodo consente di attivare il servizio di conservazione standard nella posta elettronica certificata. Azione non consentita per questi due type di caselle: DOMICILIODIGITALE, PECMASSIVA.","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":"Se questo parametro non viene passato, viene impostato a 512 per impostazione predefinita"},"documenti":{"oneOf":[{"type":"string","description":"base64_encode(contenuto del file); sono ammessi solo i file pdf"},{"type":"array","items":{"type":"string","description":"base64_encode(contenuto del file); sono ammessi solo i file pdf"}}]}},"required":["documenti"]},"example":{"spazio_conservazione":1024,"documenti":"JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"IT","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data","method":"POST","data":{}},"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":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":265,"data":null}}}},"402":{"description":"Pagamento richiesto","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":297,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":266,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"conservazione service is already active","error":293,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"documenti required","error":294,"data":null}}}}}}},"/pec/{id}/trasformazione":{"patch":{"tags":["Pec"],"summary":"Cambiare il tipo di casella","description":"Questo metodo permette di cambiare il type della posta elettronica certificata. Sono consentiti solo gli aggiornamenti, ad esempio da STANDARD si può passare a SILVER o GOLD. Azione non consentita per questi due type di caselle: DOMICILIODIGITALE, PECMASSIVA.","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":"tipo di cassetta postale","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":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"IT","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data","method":"POST","data":{}},"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":265,"data":null}}}},"402":{"description":"Pagamento richiesto","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":279,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":266,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"a downgrade of the 'tipo_casella' is not allowed; only SILVER or GOLD allowed","error":276,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"you can trasform your certified mail only if it has been processed","error":272,"data":null}}}}}}},"/pec/{id}/rinnovo":{"get":{"tags":["Pec"],"summary":"Rinnovo della posta elettronica certificata","description":"Questo metodo consente di rinnovare per un anno o riattivare la posta elettronica certificata identificata dall'id","parameters":[{"name":"id","in":"path","description":"Pec id","required":true,"schema":{"type":"string","example":"6040e4613a716838dc4eee0e"}},{"name":"anni","in":"query","description":"Numero di anni per i quali si desidera rinnovare la casella pec. Se non viene passato è 1 per impostazione predefinita","required":false,"schema":{"type":"integer","example":2}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"IT","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data","method":"POST","data":{}},"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":201,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"you can renew only evaded or revoked pec","error":203,"data":null}}}}}}},"/pec/{id}/multiutenza":{"post":{"tags":["Pec"],"summary":"Aggiungi utente","description":"Questo metodo consente di aggiungere un utente che può utilizzare una casella di posta elettronica esistente. Può essere attivato solo sulle caselle di posta elettronica STANDARD, BRONZO, ARGENTO e ORO.","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"},"example":{"nome":"luca","cognome":"bianchi","descrizione":"prima utenza","email_gestione_password":"mail@domain.com"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"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":"RSSXXXXXXXX56E","data_nascita_richiedente":"11/04/1982","sesso_richiedente":"M","nazione_nascita_richiedente":"IT","provincia_nascita_richiedente":"RM","denominazione_titolare":"","cf_piva_titolare":"","indirizzo_titolare":"via verdi 20","comune_titolare":"roma","cap_titolare":"00042","nazione_titolare":"IT","provincia_titolare":"rm","callback":{"url":"https://your_domain.it/your_callback.php","field":"data","method":"POST","data":{}},"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":212,"data":null}}}},"402":{"description":"Pagamento richiesto","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":220,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":213,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"maximum number of users reached: 25","error":217,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"this service cannot be activated on these boxes: DOMICILIODIGITALE|PECMASSIVA","error":390,"data":null}}}}}}},"/comunica_pec":{"get":{"tags":["Comunica Pec"],"summary":"Elenco delle vostre comunicazioni","description":"Questo metodo mostra tutte le comunicazioni di posta elettronica certificata al registro delle imprese avviato","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RichiesteComunicazionePec"}},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"example":{"data":[{"id":"60ad149c3a7168084f1d2b68","casella_pec":"mypec@pec.com","stato":"comunicazione_evasa","timestamp":1622127248,"owner":"mail@domain.com"},{"id":"60ad0f2a3a716801f42a9773","casella_pec":"yourpec@pec.it","stato":"comunicazione_evasa","timestamp":1622126850,"owner":"mail@domain.com"}],"success":true,"message":"","error":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no request linked to this account","error":332,"data":null}}}}}},"post":{"tags":["Comunica Pec"],"summary":"Comunicare un messaggio di posta elettronica certificata","description":"Questo metodo consente di comunicare un messaggio di posta elettronica certificata al registro delle imprese","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostComunicaPec"},"example":{"casella_pec":"mypec@pec.com","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"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RichiestaComunicazionePec"},"success":{"type":"boolean","description":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"example":{"data":{"casella_pec":"mypec@pec.com","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":"Pagamento richiesto","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":351,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"invalid casella_pec","error":336,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"cf_piva required","error":344,"data":null}}}}}}},"/comunica_pec/{id}":{"get":{"tags":["Comunica Pec"],"summary":"Richiesta specifica di comunicazione pec","description":"Questo metodo restituisce la richiesta specifica contrassegnata con l'id","parameters":[{"name":"id","in":"path","description":"Comunica Pec id","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":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"example":{"data":{"casella_pec":"mypec@pec.com","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":"comunicazione_evasa","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":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no request found","error":334,"data":null}}}}}},"patch":{"tags":["Comunica Pec"],"summary":"Caricare i documenti","description":"Questo metodo consente di completare la richiesta di comunicazione della propria pec al registro delle imprese caricando la documentazione necessaria. La documentazione richiesta comprende il modulo compilato e firmato digitalmente in formato p7m che è possibile scaricare utilizzando il metodo GET/comunica_pec/{id}/procura_registro_imprese.","parameters":[{"name":"id","in":"path","description":"Comunica Pec id","required":true,"schema":{"type":"string","example":"60dc8da86c8b04624536bbb2"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"documenti":{"oneOf":[{"type":"string","description":"base64_encode(contenuto del file); sono ammessi solo i file p7m"},{"type":"array","items":{"type":"string","description":"base64_encode(contenuto del file); sono ammessi solo i file p7m"}}]}}},"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":"Successo dell'operazione (vero/falso)."},"message":{"type":"string","description":"messaggio di errore"},"error":{"type":"integer","description":"codice di errore"}}},"example":{"data":{"casella_pec":"mypec@pec.com","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":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no request found","error":354,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"you can only upload documents when stato is 'in_attesa_di_documenti'","error":355,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"documenti required","error":356,"data":null}}}}}}},"/pec/{id}/modulo_attivazione":{"get":{"tags":["Modulistica"],"summary":"Scarica il modulo di attivazione","description":"Questo metodo consente di scaricare direttamente il modulo di attivazione di una posta elettronica certificata. Una volta compilato e firmato, verrà passato sotto forma di stringa codificata in base 64 utilizzando il metodo PATCH/pec/{id}/attivazione insieme a un documento di identità.","parameters":[{"name":"id","in":"path","description":"id richiesta","required":true,"schema":{"type":"string","example":"5f7b2e323a716857774a4373"}}],"responses":{"200":{"description":"Un file PDF","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":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"you can activate the pec only when it is in the 'registrata|documenti_errati' state","error":267,"data":null}}}}}}},"/pec/{id}/modulo_conservazione":{"get":{"tags":["Modulistica"],"summary":"Scarica il modulo di attivazione","description":"Questo metodo consente di scaricare direttamente il modulo di attivazione della conservazione per una posta elettronica certificata. una volta compilato e firmato verrà passato sotto forma di stringa codificata in base 64 utilizzando il metodo PATCH/pec/{id}/conservazione insieme a un documento di identità.","parameters":[{"name":"id","in":"path","description":"id richiesta","required":true,"schema":{"type":"string","example":"5f7b2e323a716857774a4373"}}],"responses":{"200":{"description":"Un file PDF","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":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"you can activate this service only if the pec has been processed","error":214,"data":null}}}}}}},"/comunica_pec/{id}/procura_registro_imprese":{"get":{"tags":["Modulistica"],"summary":"Scarica la procura","description":"Questo metodo consente di scaricare il modulo di comunicazione pec sul registro delle imprese. Una volta firmato digitalmente in formato p7m, verrà passato sotto forma di stringa codificata in base 64 utilizzando il metodo PATCH/comunica_pec/{id}.","parameters":[{"name":"id","in":"path","description":"id richiesta","required":true,"schema":{"type":"string","example":"5f7b2e323a716857774a4373"}}],"responses":{"200":{"description":"Un file PDF","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":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"you can activate this service only if the pec has been processed","error":214,"data":null}}}}}}}},"externalDocs":{"description":"Prima volta qui? Generare un nuovo token di accesso","url":"https://console.openapi.com/it/oauth"},"security":[{"bearerAuth":[]}]}