{"openapi":"3.0.2","info":{"description":"Webdienste zur Aktivierung und Verwaltung von zertifizierten E-Mail-Adressen (PEC). Mit diesen Diensten können Sie ein neues zertifiziertes Postfach registrieren sowie bestehende Konten verlängern oder widerrufen. Außerdem können Sie Postfachoptionen wie den Gesamtspeicherplatz und den Archivspeicherplatz anpassen oder die rechtskonforme Aufbewahrung aktivieren und erweitern. Darüber hinaus bietet das System Funktionen zur Meldung einer zertifizierten E-Mail-Adresse an das Handelsregister. Schließlich können Sie diese Dienste nutzen, um Aktivierungsformulare sowohl für das Postfach als auch für den Dienst zur rechtskonformen Aufbewahrung herunterzuladen und hochzuladen.","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":"Produktion"},{"url":"https://test.pec.openapi.it","description":"Sandbox"}],"tags":[{"name":"Pec","description":"Verfahren, mit denen Sie eine zertifizierte E-Mail-Adresse registrieren, aktivieren und ändern können"},{"name":"Comunica Pec","description":"Verfahren, mit denen Sie eine beglaubigte E-Mail an das Handelsregister übermitteln können"},{"name":"Domini","description":"Methoden, mit denen Sie eine zertifizierte Domain aktivieren und ändern können"},{"name":"Modulistica","description":"Methoden, mit denen Sie die für die Verwaltung zertifizierter E-Mail-Postfächer erforderlichen Formulare herunterladen können"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"BodyPostPec":{"type":"object","properties":{"casella_pec":{"type":"string","description":"die zertifizierte E-Mail-Adresse (PEC)"},"tipo_casella":{"type":"string","description":"Postfachtyp. STANDARD/BRONZE/SILVER/GOLD/MASSIVA1-3 werden über InfoCert bereitgestellt; DOMICILIODIGITALE/PECMASSIVA werden über Namirial bereitgestellt. Der Anbieter wird aus diesem Wert (zuzüglich der Domain) abgeleitet und nicht separat ausgewählt; er bestimmt, welche der anderen BodyPostPec-Felder tatsächlich zutreffen (siehe deren Beschreibungen).","enum":["STANDARD","BRONZE","SILVER","GOLD","DOMICILIODIGITALE","PECMASSIVA","MASSIVA1","MASSIVA2","MASSIVA3"]},"tipo_cliente":{"type":"string","description":"die Kundenart","enum":["IM","PS","PL","PC","A","PV","X"]},"sottotipo_cliente":{"type":"string","description":"Der Kundensubtyp. Die Validierung erfolgt anhand der datenbankgestützten „tipologie“-Nachschlagsammlung, nicht anhand einer festen Liste – welche Codes gültig sind, hängt von „tipo_cliente“ ab; die Codetabellen für die einzelnen „tipo_cliente“-Typen finden Sie im Schema „TipologieCliente“.","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":"anderer Kundenuntertyp"},"nome_richiedente":{"type":"string","description":"Vorname des Antragstellers"},"cognome_richiedente":{"type":"string","description":"Nachname des Antragstellers"},"email":{"type":"string","description":"Standard-E-Mail-Adresse des Bewerbers"},"telefono":{"type":"string","description":"Telefonnummer des Antragstellers"},"cellulare":{"type":"string","description":"Handynummer des Antragstellers"},"codice_fiscale_richiedente":{"type":"string","description":"Steuernummer des Antragstellers"},"data_nascita_richiedente":{"type":"string","description":"Geburtsdatum des Antragstellers"},"sesso_richiedente":{"type":"string","description":"Geschlecht des Antragstellers","enum":["M","F"]},"nazione_nascita_richiedente":{"type":"string","description":"Geburtsland des Antragstellers"},"comune_nascita_richiedente":{"type":"string","description":"City of birth of the applicant"},"provincia_nascita_richiedente":{"type":"string","description":"Geburtsprovince des Antragstellers"},"denominazione_titolare":{"type":"string","description":"Name des Postfachinhabers. Erforderlich, wenn „tipo_cliente“ nicht „PV“ ist."},"cf_piva_titolare":{"type":"string","description":"Steuernummer oder Umsatzsteuer-Identifikationsnummer des Postfachinhabers. Erforderlich, wenn „tipo_cliente“ nicht „PV“ ist."},"indirizzo_titolare":{"type":"string","description":"Anschrift des Postfachinhabers"},"comune_titolare":{"type":"string","description":"City of the Mailbox Owner"},"cap_titolare":{"type":"string","description":"Postleitzahl (CAP) des Briefkasteninhabers"},"nazione_titolare":{"type":"string","description":"Land des Postfachinhabers"},"provincia_titolare":{"type":"string","description":"Province of the mailbox holder"},"callback":{"$ref":"#/components/schemas/Callback"},"autorinnovo":{"type":"boolean","description":"Wird dieser Wert auf „true“ gesetzt, kann das System das Konto nach Ablauf automatisch verlängern und dabei versuchen, Guthaben aus der Geldbörse des Inhabers abzubuchen.","default":false},"tipo_documento":{"type":"string","description":"Art des Ausweisdokuments","enum":["CARTA_D_IDENTITA","PATENTE","PASSAPORTO"]},"numero_documento":{"type":"string","description":"Dokumentennummer"},"data_scadenza_documento":{"type":"string","description":"Gültigkeitsdauer des Dokuments"},"documento_rilasciato_da":{"type":"string","description":"ausstellende Behörde des Dokuments"},"data_rilascio_documento":{"type":"string","description":"Ausstellungsdatum des Dokuments"},"rinnovo_anni":{"type":"integer","description":"zusätzliche Jahre über das vorgeschriebene erste Jahr hinaus (0–3); Gesamtdauer der Registrierung = 1 + rinnovo_anni, d. h. 1–4 Jahre; Standardwert ist 0","minimum":0,"maximum":3,"default":0},"spazio_disco":{"type":"integer","description":"Anfänglicher Speicherplatz in MB (optional; muss ein Vielfaches von 1024 sein)"},"spazio_storico":{"type":"integer","description":"Anfänglicher Archivspeicherplatz in MB (optional; muss ein Vielfaches von 1024 sein)"},"spazio_conservazione":{"type":"integer","description":"Anfänglicher Speicherplatz in MB (optional; muss ein Vielfaches von 512 sein)"},"invio_massivo_pec":{"type":"integer","description":"Nur InfoCert. Kontingent für Massenversand (muss ein positives Vielfaches von 50 sein). Wird auf Namirial-Servern nicht unterstützt."},"phishing_protection":{"type":"boolean","description":"Nur InfoCert. Aktivieren Sie den Phishing-Schutz bei der Registrierung. Wird auf Namirial-Geräten nicht unterstützt."},"password_protection":{"type":"boolean","description":"Nur InfoCert. Aktivieren Sie den Passwortschutz bei der Registrierung. Wird auf Namirial-Geräten nicht unterstützt."},"multiutenza":{"oneOf":[{"type":"boolean","description":"Nur Namirial. „true“ aktiviert den Dienst „Multiutenza ein/aus“ bei der Registrierung."},{"type":"array","description":"InfoCert: Jeder Eintrag erstellt ein eigenständiges, individuell verwaltetes Slave-Konto. Namirial: Es können keine einzelnen Benutzer angelegt werden – ein nicht leeres Array reicht ebenfalls aus, um den Dienst zu aktivieren; der Inhalt wird ansonsten ignoriert.","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":"interne Notizen"}},"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":"Der zu aktivierende Domainname (z. B. example.com). Bevor dieser Endpunkt aufgerufen wird, muss im DNS dieser Domain bereits ein MX-Eintrag konfiguriert sein, der auf den Mailserver des Anbieters verweist – siehe „Anbieter“.","example":"testdominio.legalmail.it"},"fornitore":{"type":"string","enum":["infocert","namirial"],"description":"Der Dienstanbieter. Legt den erforderlichen MX-Eintrag für „dominio“ fest: „mx.cert.legalmail.it“ für Infocert, „mailpro.sicurezzapostale.it“ für Namirial.","example":"infocert"},"anni":{"type":"integer","description":"Anzahl der Jahre, für die die Domain erworben wird (nur bei der erstmaligen Aktivierung, 1–3)","default":1,"example":1,"enum":[1,2,3]},"numero_pec":{"type":"integer","description":"Anzahl der für die Domain erworbenen PEC-Boxen","default":0,"example":1},"note":{"type":"string","description":"Mit der Domain gestorete interne Freitext-Notiz. Wird niemals von GET /dominio oder GET /dominio/{id} zurückgegeben (wird ausschließlich aus diesen beiden Antworten entfernt)."},"data_scadenza":{"type":"string","description":"Explizites Ablaufdatum (TT/MM/JJJJ). Falls angegeben, wird die Berechnung auf Basis von „anni“ vollständig außer Kraft gesetzt und die Überprüfung der Gültigkeitsdauer von 1–3 Jahren übersprungen.","example":"02/02/2027"},"tipo_cliente":{"type":"string","description":"[Nur Namirial] Kundentyp. Wird bei Fehlen zwangsläufig auf „IM“ gesetzt oder auf „PV“ – eine Domain-Aktivierung kann jedoch niemals tatsächlich als „PV“ erfasst werden, sodass denominazione_titolare/cf_piva_titolare für Namirial praktisch immer erforderlich sind.","enum":["IM","PS","PL","PC","A","PV","X"],"example":"IM"},"nome_richiedente":{"type":"string","description":"[Nur Namirial] Vorname des Antragstellers. Erforderlich."},"cognome_richiedente":{"type":"string","description":"[Nur Namirial] Nachname des Antragstellers. Erforderlich."},"codice_fiscale_richiedente":{"type":"string","description":"[Nur Namirial] Steuer-Identifikationsnummer des Antragstellers. Erforderlich."},"data_nascita_richiedente":{"type":"string","description":"[Nur Namirial] Geburtsdatum des Antragstellers (TT/MM/JJJJ). Erforderlich für die Domain-Aktivierung, unabhängig von „tipo_cliente“."},"sesso_richiedente":{"type":"string","enum":["M","F"],"description":"[Nur Namirial] Geschlecht des Antragstellers. Für die Domain-Aktivierung erforderlich, unabhängig von „tipo_cliente“."},"email":{"type":"string","description":"[Nur Namirial] E-Mail-Adresse des Antragstellers. Erforderlich."},"cellulare":{"type":"string","description":"[Nur Namirial] Mobiltelefonnummer des Antragstellers. Erforderlich."},"indirizzo_titolare":{"type":"string","description":"[Nur Namirial] Anschrift des Inhabers. Erforderlich."},"comune_titolare":{"type":"string","description":"[Nur Namirial] City des Inhabers. Erforderlich."},"cap_titolare":{"type":"string","description":"[Nur Namirial] Postleitzahl des Inhabers. Erforderlich."},"provincia_titolare":{"type":"string","description":"[Nur Namirial] Province des Inhabers. Erforderlich."},"nazione_titolare":{"type":"string","description":"[Nur Namirial] Land des Inhabers. Erforderlich."},"denominazione_titolare":{"type":"string","description":"[Nur Namirial] Name des Unternehmens/der Organisation. In der Praxis immer erforderlich – „tipo_cliente“ darf bei einer Domain-Aktivierung niemals den Wert „PV“ behalten."},"cf_piva_titolare":{"type":"string","description":"[Nur Namirial] Steuer- oder Umsatzsteuer-Identifikationsnummer des Inhabers. In der Praxis immer erforderlich – „tipo_cliente“ darf bei einer Domain-Aktivierung niemals den Wert „PV“ behalten."},"comune_nascita_richiedente":{"type":"string","description":"[Nur Namirial] City of birth of the applicant. Required for domain activation, regardless of „tipo_cliente“."},"provincia_nascita_richiedente":{"type":"string","description":"[Nur Namirial] Geburtsprovince des Antragstellers."},"nazione_nascita_richiedente":{"type":"string","description":"[Nur Namirial] Geburtsland des Antragstellers. Für die Domain-Aktivierung erforderlich, unabhängig vom „tipo_cliente“."},"tipo_documento":{"type":"string","enum":["CARTA_D_IDENTITA","PASSAPORTO"],"description":"[Nur Namirial] Art des Ausweisdokuments. Erforderlich. Der Führerschein (PATENTE) wird für die Domainregistrierung NICHT akzeptiert (im Gegensatz zur Aktivierung eines PEC-Postfachs, bei der er sehr wohl akzeptiert wird)."},"numero_documento":{"type":"string","description":"[Nur Namirial] Dokumentennummer. Erforderlich."},"data_scadenza_documento":{"type":"string","description":"[Nur Namirial] Ablaufdatum des Dokuments (TT/MM/JJJJ). Erforderlich."},"documento_rilasciato_da":{"type":"string","description":"[Nur Namirial] Ausstellende Behörde des Dokuments. Erforderlich."},"data_rilascio_documento":{"type":"string","description":"[Nur Namirial] Ausstellungsdatum des Dokuments (TT/MM/JJJJ). Erforderlich."},"callback":{"$ref":"#/components/schemas/Callback"}}},"Dominio":{"type":"object","description":"GET/POST/PATCH/DELETE geben den in MongoDB gespeicherten Domänen-Datensatz nahezu unverändert zurück (nur einige wenige Felder werden entfernt, siehe die einzelnen Endpunkte). Bei einigen InfoCert-Domains umfasst dies Felder, die von keinem aktuellen API-Codepfad geschrieben werden – „anagrafica_sincronizzata“, „pec_attive“, „pec_totali“, „sottotipo_cliente“, „telefono“ (alle unten dokumentiert) – sowie italienischsprachige „dns“/„config“/„certif“-Werte (z. B. „CORRETTO“/„ERRATO“), die durch die XML-Integration von InfoCert erzeugt werden (DominioInfoCert::sincronizza / InfocertDominiClient::getStatoDominio) generiert werden, im Gegensatz zu den englischen Werten „OK“/„KO“, die von der bei der Erstaktivierung verwendeten rest-Integration erzeugt werden.","properties":{"id":{"type":"string","description":"Domain-ID","example":"69806bcce09fb76c6b0fef0b"},"dominio":{"type":"string","description":"Domainname","example":"testdominio.legalmail.it"},"fornitore":{"type":"string","enum":["infocert","namirial"],"description":"Der Dienstleister","example":"infocert"},"owner":{"type":"string","description":"Benutzername des Domaininhabers","example":"mail@domain.com"},"stato_fornitore":{"type":"string","enum":["OK","KO","PENDING"],"description":"Status der Domain auf Anbieterseite. „PENDING“ wird derzeit von keinem Codepfad in diesem Repository generiert (tatsächlich werden nur „OK“ und „KO“ gesetzt) – wird in der Enumeration als dokumentierter, aber derzeit ungenutzter bzw. reservierter Wert beibehalten.","example":"OK"},"dns":{"type":"string","description":"DNS-Konfigurationsstatus des Anbieters","example":"OK"},"config":{"type":"string","description":"Status der Serverkonfiguration vom Anbieter","example":"OK"},"certif":{"type":"string","description":"Zertifizierungsstatus des Anbieters","example":"missing"},"note":{"type":"string","description":"Interne Notiz im Freitextformat. Erscheint niemals in Antworten auf GET /dominio oder GET /dominio/{id} (wird entfernt); kann in Antworten auf POST, PATCH, DELETE und GET .../rinnovo vorkommen."},"record_mx":{"type":"string","description":"Mit der Domain verknüpfter MX-Eintrag"},"tipo_dominio":{"type":"string","enum":["interno","esterno"],"description":"Domain-Typ (intern oder extern)","example":"interno"},"stato":{"type":"string","enum":["registrato","in_attesa_certificazione","evaso","revocato"],"description":"Interner Bearbeitungsstatus","example":"registrato"},"data_scadenza":{"type":"string","description":"Ablaufdatum (TT/MM/JJJJ)","example":"02/02/2027"},"data_certificazione":{"type":"string","description":"Zertifizierungsdatum (TT/MM/JJJJ)","example":"02/02/2026"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"id_ordine":{"type":"string","description":"Mit der Aktivierung verknüpfte Bestell-ID. Erscheint niemals in Antworten auf GET /dominio oder GET /dominio/{id} (wird entfernt); erscheint in Antworten auf POST/PATCH/DELETE und GET .../rinnovo.","example":"62558f"},"autorinnovo":{"type":"boolean","default":false,"description":"Falls zutreffend, wird die Domain automatisch verlängert.","example":false},"anni":{"type":"integer","description":"Anzahl der Jahre, für die die Domain erworben wurde","example":1},"numero_pec":{"type":"integer","description":"Anzahl der für die Domain erworbenen PEC-Boxen","default":0,"example":1},"callback":{"$ref":"#/components/schemas/Callback"},"tipo_cliente":{"type":"string","description":"[Nur Namirial-Domains] Kundentyp","enum":["IM","PS","PL","PC","A","PV","X"],"example":"IM"},"nome_richiedente":{"type":"string","description":"[Nur Namirial-Domains] Vorname des Antragstellers"},"cognome_richiedente":{"type":"string","description":"[Nur Namirial-Domains] Nachname des Antragstellers"},"codice_fiscale_richiedente":{"type":"string","description":"[Nur Namirial-Domains] Steuer-ID des Antragstellers"},"email":{"type":"string","description":"[Nur Namirial-Domains] E-Mail-Adresse des Antragstellers"},"cellulare":{"type":"string","description":"[Nur für Namirial-Domains] Mobiltelefonnummer des Antragstellers"},"indirizzo_titolare":{"type":"string","description":"[Nur Namirial-Domains] Anschrift des Inhabers"},"comune_titolare":{"type":"string","description":"[Nur Namirial-Domains] City of the Inhaber"},"cap_titolare":{"type":"string","description":"[Nur Namirial-Domains] Postleitzahl des Inhabers"},"provincia_titolare":{"type":"string","description":"[Nur Namirial-Domänen] Province des Inhabers"},"nazione_titolare":{"type":"string","description":"[Nur Namirial-Domains] Land des Inhabers"},"denominazione_titolare":{"type":"string","description":"[Nur Namirial-Domains] Name des Unternehmens/der Organisation"},"cf_piva_titolare":{"type":"string","description":"[Nur für Namirial-Domains] Steuer- oder Umsatzsteuer-Identifikationsnummer des Inhabers"},"data_nascita_richiedente":{"type":"string","description":"[Nur für Namirial-Domains] Geburtsdatum des Antragstellers (TT/MM/JJJJ)"},"sesso_richiedente":{"type":"string","enum":["M","F"],"description":"[Nur Namirial-Domains] Geschlecht des Antragstellers"},"comune_nascita_richiedente":{"type":"string","description":"[Nur für Namirial-Domänen] City of birth of the applicant"},"provincia_nascita_richiedente":{"type":"string","description":"[Nur Namirial-Domänen] Geburtsprovince des Antragstellers"},"nazione_nascita_richiedente":{"type":"string","description":"[Nur Namirial-Domains] Geburtsland des Antragstellers"},"documenti_attivazione":{"type":"array","items":{"type":"string"},"description":"[Nur Namirial-Domains] Über PATCH /dominio/{id} übermittelte Aktivierungsdokumente"},"tipo_documento":{"type":"string","enum":["CARTA_D_IDENTITA","PATENTE","PASSAPORTO"],"description":"[Nur Namirial-Domains] Art des Ausweisdokuments des Antragstellers. Bei Domains, die aktiviert wurden, bevor dieses Feld bei neuen Aktivierungen auf CARTA_D_IDENTITA|PASSAPORTO beschränkt wurde, kann weiterhin „PATENTE“ erscheinen (siehe BodyPostDominio.tipo_documento)."},"numero_documento":{"type":"string","description":"[Nur Namirial-Domänen] Dokumentennummer"},"data_scadenza_documento":{"type":"string","description":"[Nur Namirial-Domains] Ablaufdatum des Dokuments (TT/MM/JJJJ)"},"documento_rilasciato_da":{"type":"string","description":"[Nur Namirial-Domänen] Ausstellende Stelle des Dokuments"},"data_rilascio_documento":{"type":"string","description":"[Nur Namirial-Domänen] Ausstellungsdatum des Dokuments (TT/MM/JJJJ)"},"sottotipo_cliente":{"type":"string","description":"Wurde auf einigen InfoCert-Domains festgestellt. Wird von keinem aktuellen API-Codepfad geschrieben."},"telefono":{"type":"string","description":"Kontakt-Telefonnummer, die auf einigen InfoCert-Domains zu sehen ist. Wird von keinem aktuellen API-Codepfad erfasst (im Aktivierungsablauf wird nur „cellulare“ erfasst)."},"anagrafica_sincronizzata":{"type":"boolean","description":"Flag, das auf einigen InfoCert-Domains zu sehen ist. Wird von keinem aktuellen API-Codepfad geschrieben."},"pec_attive":{"type":"integer","description":"Anzahl der aktiven PEC-Postfächer in dieser Domain, wie sie bei einigen InfoCert-Domains zu sehen ist. Wird von keinem aktuellen API-Codepfad geschrieben. Nicht identisch mit „numero_pec“, das von der API festgelegt wird."},"pec_totali":{"type":"integer","description":"Anzahl der gesamten PEC-Postfächer in dieser Domain, wie sie bei einigen InfoCert-Domains zu sehen ist. Wird von keinem aktuellen API-Codepfad geschrieben. Nicht zu verwechseln mit „numero_pec“, das von der API festgelegt wird."}}},"BodyPostComunicaPec":{"type":"object","properties":{"casella_pec":{"type":"string","description":"die zertifizierte E-Mail-Adresse (PEC)"},"pec_amministratore":{"type":"boolean","description":"Falls „true“, gehört das Postfach dem Unternehmensadministrator.","default":false},"cf":{"type":"string","description":"Steuergesetzbuch"},"nome":{"type":"string","description":"Vorname"},"cognome":{"type":"string","description":"Nachname"},"qualifica":{"type":"string","description":"Qualifikation des Eigentümers","enum":["AMMINISTRATORE","COMMISSARIO_GIUDIZIARIO","CURATORE_FALLIMENTARE","LEGALE_RAPPRESENTANTE","LIQUIDATORE","SOCIO","TITOLARE"]},"email":{"type":"string","description":"E-Mail-Adresse des Eigentümers"},"cellulare":{"type":"string","description":"Handy des Besitzers"},"ragione_sociale":{"type":"string","description":"Firmenname"},"cf_piva":{"type":"string","description":"Steuernummer oder Umsatzsteuer-Identifikationsnummer des Unternehmens"},"comune":{"type":"string","description":"Sitz der Gesellschaft"},"provincia":{"type":"string","description":"Geschäftsgebiet des Unternehmens"},"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":"Vorname"},"cognome":{"type":"string","description":"Nachname"},"descrizione":{"type":"string","description":"Beschreibung. Erforderlich für InfoCert-Postfächer (STANDARD/BRONZE/SILVER/GOLD). Wird für Namirial-Postfächer (DOMICILIODIGITALE/PECMASSIVA) überhaupt nicht überprüft, da deren „multiutenza“-Flag lediglich ein einfaches Ein-/Aus-Flag ist."},"email_gestione_password":{"type":"string","description":"E-Mail-Adresse des Benutzers"}},"required":["nome","cognome","email_gestione_password"]},"TipologieCliente":{"type":"object","properties":{"IM":{"type":"string","description":"Unternehmen","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":"Kommunalverwaltung","enum":["LR - REGIONE","LP - PROVINCIA","LC - COMUNE","LM - COMUNITA MONTANA","LA - ASL","LI - CCIAA","X - ALTRO"]},"PC":{"type":"string","description":"Zentrale öffentliche Verwaltung"},"A":{"type":"string","description":"Verein"},"PV":{"type":"string","description":"Privato"},"X":{"type":"string","description":"Sonstiges"}}},"Casella":{"type":"object","properties":{"casella_pec":{"type":"string","description":"die zertifizierte E-Mail-Adresse (PEC)"},"tipo_casella":{"type":"string","description":"Art des Briefkastens","enum":["STANDARD","BRONZE","SILVER","GOLD","DOMICILIODIGITALE","PECMASSIVA","MASSIVA1","MASSIVA2","MASSIVA3"]},"tipo_cliente":{"type":"string","description":"die Kundenart"},"sottotipo_cliente":{"type":"string","description":"der Kunden-Subtyp"},"sottotipo_cliente_altro":{"type":"string","description":"anderer Kundenuntertyp"},"nome_richiedente":{"type":"string","description":"Vorname des Antragstellers"},"cognome_richiedente":{"type":"string","description":"Nachname des Antragstellers"},"email":{"type":"string","description":"Standard-E-Mail-Adresse des Bewerbers"},"telefono":{"type":"string","description":"Telefonnummer des Antragstellers"},"cellulare":{"type":"string","description":"Handynummer des Antragstellers"},"codice_fiscale_richiedente":{"type":"string","description":"Steuer-ID des Antragstellers"},"data_nascita_richiedente":{"type":"string","description":"Geburtsdatum des Antragstellers"},"sesso_richiedente":{"type":"string","description":"Geschlecht des Antragstellers"},"nazione_nascita_richiedente":{"type":"string","description":"Geburtsland des Antragstellers"},"comune_nascita_richiedente":{"type":"string","description":"City of birth of the applicant"},"provincia_nascita_richiedente":{"type":"string","description":"Geburtsprovince des Antragstellers"},"denominazione_titolare":{"type":"string","description":"Name des Postfachinhabers. Erforderlich, wenn „tipo_cliente“ nicht „PV“ ist."},"cf_piva_titolare":{"type":"string","description":"Steuernummer oder Umsatzsteuer-Identifikationsnummer des Postfachinhabers. Erforderlich, wenn „tipo_cliente“ nicht „PV“ ist."},"indirizzo_titolare":{"type":"string","description":"Anschrift des Postfachinhabers"},"comune_titolare":{"type":"string","description":"City of the Mailbox Owner"},"cap_titolare":{"type":"string","description":"Postleitzahl (CAP) des Postfachinhabers"},"nazione_titolare":{"type":"string","description":"Land des Postfachinhabers"},"provincia_titolare":{"type":"string","description":"Province of the mailbox holder"},"callback":{"$ref":"#/components/schemas/Callback"},"dominio":{"type":"string","description":"der mit dem PEC-Postfach verknüpfte Domainname"},"owner":{"type":"string","description":"Kennung des Eigentümers"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"cod_attivazione":{"type":"string","description":"Aktivierungscode für das Postfach"},"uid":{"type":"string","description":"Eindeutige Kennung für das Postfach oder die Anfrage"},"conservazione":{"type":"boolean","description":"Zeigt an, ob die gesetzlich vorgeschriebene elektronische Aufbewahrung (conservazione a norma) aktiv ist"},"data_scadenza":{"type":"string","description":"Ablaufdatum des Dienstes/des Postfachs"},"descrizione":{"type":"string","description":"Beschreibung"},"sms":{"type":"boolean","description":"[Zeigt an, ob SMS-Benachrichtigungen aktiviert sind]"},"spazio_conservazione":{"type":"integer","description":"zugewiesener Speicherplatz für die gesetzlich vorgeschriebene Aufbewahrungsfrist in MB"},"spazio_disco":{"type":"integer","description":"(Gesamter für das Postfach zugewiesener Speicherplatz in MB)"},"spazio_storico":{"type":"integer","description":"zugewiesener Speicherplatz für historische Daten/Archiv in MB"},"stato":{"type":"string","enum":["registrata","in_evasione","evasa","revocata","chiusa","documenti_errati"],"description":"Aktueller Status des Postfachs/der Anfrage"},"storico":{"type":"boolean","description":"Zeigt an, ob der Zugriff auf historische Daten oder die Archivierungsfunktion aktiv ist"},"documenti_attivazione":{"type":"array","items":{"type":"string"},"description":"Zeichenfolgenarray für Aktivierungsdokumente"},"data_attivazione":{"type":"string","description":"Aktivierungsdatum des Postfachs"},"documenti_conservazione":{"type":"array","items":{"type":"string"},"description":"Zeichenfolgenarray für Aufbewahrungsunterlagen"},"multiutenza":{"oneOf":[{"type":"boolean","description":"Namirial (DOMICILIODIGITALE/PECMASSIVA)-Felder: „true“, sobald der Multiutenza-Dienst aktiviert wurde"},{"type":"array","items":{"$ref":"#/components/schemas/Utenza"},"description":"InfoCert-Boxen: Liste der untergeordneten Benutzer"}]},"rinnovo_anni":{"type":"integer","description":"zusätzliche Jahre über das bei der Anmeldung angegebene obligatorische erste Jahr hinaus (0–3)"},"id":{"type":"string","description":"Objekt-ID"},"autorinnovo":{"type":"boolean","description":"Wird dieser Wert auf „true“ gesetzt, kann das System das Konto nach Ablauf automatisch verlängern und dabei versuchen, Guthaben aus der Geldbörse des Inhabers abzubuchen."},"tipo_documento":{"type":"string","enum":["CARTA_D_IDENTITA","PATENTE","PASSAPORTO"],"description":"Art des Ausweisdokuments"},"numero_documento":{"type":"string","description":"Dokumentennummer"},"data_scadenza_documento":{"type":"string","description":"Gültigkeitsdauer des Dokuments"},"documento_rilasciato_da":{"type":"string","description":"ausstellende Behörde des Dokuments"},"data_rilascio_documento":{"type":"string","description":"Ausstellungsdatum des Dokuments"},"phishing_protection":{"type":"boolean","description":"Zeigt an, ob das Phishing-Schutz-Add-on aktiv ist"},"password_protection":{"type":"boolean","description":"Zeigt an, ob das Add-on zum Passwortschutz aktiv ist"},"invio_massivo":{"type":"boolean","description":"Zeigt an, ob der Massenversand-Dienst (invio massivo) aktiv ist"},"invio_massivo_pec":{"type":"integer","description":"Kontingent für Massenversand in Anzahl der Nachrichten"},"invio_massivo_stat":{"type":"object","description":"Nutzungsstatistiken für Massenversendungen (nur vorhanden, wenn „invio_massivo“ aktiv ist)","properties":{"totale":{"type":"integer","description":"Gesamtquote"},"consumati":{"type":"integer","description":"verarbeitete Nachrichten"},"rimanenti":{"type":"integer","description":"verbleibende Nachrichten"}}}}},"Callback":{"type":"object","description":"Standardisierte Callback-Konfiguration. Ermöglicht den Empfang von Benachrichtigungen über Statusaktualisierungen asynchroner Anfragen.","properties":{"method":{"type":"string","description":"Geben Sie die Callback-Methode an. Bei der Einstellung „POST“ wird eine standardmäßige HTTP-POST-Anfrage mit dem Content-Type „application/x-www-form-urlencoded“ ausgelöst. Die JSON-Daten werden in ein Schlüssel-Wert-Paar namens „data“ kodiert (anpassbar über den Parameter „field“). Bei der Einstellung „JSON“ wird eine direkte HTTP-POST-Anfrage mit dem Content-Type „application/json“ und dem rohen JSON-Body gesendet.","enum":["POST","JSON"],"default":"JSON"},"field":{"type":"string","nullable":true,"description":"Funktioniert mit method='POST'. Bestimmt den Namen des Parameters, der im POST-Anfragetext gesendet wird. Null, wenn method='JSON' (nicht zutreffend).","example":"data","default":"data"},"url":{"type":"string","format":"uri","description":"Eine gültige URL, die POST-Anfragen verarbeiten kann. Bei authentifizierten Endpunkten ist der Parameter „headers“ zu verwenden. Die maximale Zeitüberschreitung beträgt 30 Sekunden. Wenn „retry“ gesetzt ist, versucht das System es so lange erneut, bis ein Statuscode 200 empfangen wird.","example":"https://www.mysite.com/myEndpoint"},"retry":{"type":"integer","description":"Maximale Anzahl von Wiederholungsversuchen. Wiederholungsversuche erfolgen nur bei vorübergehenden ERRORs (z. B. 502, 503) oder Netzwerkproblemen, mit exponentiellem Backoff. Der Maximalwert beträgt 5.","example":3,"minimum":0,"maximum":5,"default":0},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"HTTP-Header, die mit der Callback-Anfrage gesendet werden sollen. Nützlich für die Authentifizierung (Basic-Auth, Bearer-Auth) oder benutzerdefinierte Metadaten.","example":{"session_id":"9834r5fh589494"}},"custom":{"description":"Zusätzliche Daten, die in die Callback-Nutzlast aufgenommen werden sollen und über den Schlüssel „custom“ im Callback-Körper zugänglich sind. Kann ein beliebiger JSON-Wert sein (Objekt, Array, Zeichenfolge, Zahl).","example":{"my_custom_id":"123456789"}}}},"Timestamp":{"type":"object","properties":{"registrazione":{"type":"integer","description":"Zeitpunkt der Registrierung/Erstellung"},"ultima_modifica":{"type":"integer","description":"Zeitpunkt der letzten Änderung"},"evasione":{"type":"integer","description":"Bearbeitungs-/Lösungszeit"},"certificazione":{"type":"integer","description":"Zertifizierungs-/Aktivierungszeit"},"scadenza":{"type":"integer","description":"Ablauf-/Fristzeitpunkt"},"revoca":{"type":"integer","description":"Widerrufsfrist"}}},"RichiesteComunicazionePec":{"type":"object","properties":{"id":{"type":"string","description":"Objekt-ID"},"casella_pec":{"type":"string","description":"die zertifizierte E-Mail-Adresse (PEC)"},"stato":{"type":"string","description":"Anfragestatus","enum":["codice_in_richiesta","in_attesa_di_documenti","documenti_caricati","annullata"]},"timestamp":{"type":"integer"},"owner":{"type":"string","description":"Kennung des Eigentümers"}}},"RichiestaComunicazionePec":{"type":"object","properties":{"casella_pec":{"type":"string","description":"die zertifizierte E-Mail-Adresse (PEC), serverseitig in Kleinbuchstaben"},"pec_amministratore":{"type":"boolean","description":"Falls „true“, gehört das Postfach dem Unternehmensadministrator.","default":false},"cf":{"type":"string","description":"Steuerkennzeichen, serverseitig großgeschrieben"},"nome":{"type":"string","description":"Vorname"},"cognome":{"type":"string","description":"Nachname"},"qualifica":{"type":"string","description":"Qualifikation des Bewerbers, serverseitig großgeschrieben","enum":["AMMINISTRATORE","COMMISSARIO_GIUDIZIARIO","CURATORE_FALLIMENTARE","LEGALE_RAPPRESENTANTE","LIQUIDATORE","SOCIO","TITOLARE"]},"email":{"type":"string","description":"E-Mail-Adresse des Eigentümers"},"cellulare":{"type":"string","description":"Handy des Besitzers"},"ragione_sociale":{"type":"string","description":"Firmenname"},"cf_piva":{"type":"string","description":"Steuernummer oder Umsatzsteuer-Identifikationsnummer des Unternehmens, serverseitig in Großbuchstaben umgewandelt"},"comune":{"type":"string","description":"Sitz der Gesellschaft"},"provincia":{"type":"string","description":"Geschäftsgebiet des Unternehmens"},"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":"Kennung des Eigentümers"},"timestamp":{"type":"integer"},"id":{"type":"string","description":"Objekt-ID"}}},"Utenza":{"type":"object","properties":{"nome":{"type":"string","description":"Vorname"},"cognome":{"type":"string","description":"Nachname"},"descrizione":{"type":"string","description":"Anmerkungen"},"email_gestione_password":{"type":"string","description":"E-Mail-Adresse, die für die Passwortverwaltung verwendet wird"},"id_utenza":{"type":"string","description":"Kennung für das Benutzerkonto"},"timestamp":{"type":"object","properties":{"attivazione":{"type":"integer","description":"Aktivierungszeitstempel für das Konto"}}},"userid":{"type":"string","description":"Benutzer-Anmelde-ID"}}},"Caselle":{"type":"object","properties":{"casella_pec":{"type":"string","description":"die zertifizierte E-Mail-Adresse (PEC)"},"tipo_casella":{"type":"string","description":"Art des Briefkastens","enum":["STANDARD","BRONZE","SILVER","GOLD","DOMICILIODIGITALE","PECMASSIVA","MASSIVA1","MASSIVA2","MASSIVA3"]},"owner":{"type":"string","description":"Kennung des Eigentümers"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"data_scadenza":{"type":"string","description":"Ablaufdatum"},"stato":{"type":"string","description":"Bearbeitungsstatus","enum":["registrata","in_evasione","evasa","revocata","chiusa","documenti_errati"]},"id":{"type":"string","description":"Objekt-ID"}}}}},"paths":{"/dominio":{"get":{"tags":["Domini"],"summary":"Alle mit dem Konto verknüpften Domains auflisten","operationId":"getDominiList","responses":{"200":{"description":"Liste der Domains","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Dominio"}}}}}}},"404":{"description":"Es wurden keine Domains gefunden","content":{"application/json":{"example":{"success":false,"message":"no domains linked to this account","error":701,"data":null}}}}}},"post":{"tags":["Domini"],"summary":"Eine neue zertifizierte Domain aktivieren","description":"Bevor dieser Endpunkt aufgerufen wird, muss der Kunde in der DNS-Konfiguration seiner Domain einen MX-Eintrag einrichten, der auf den Mailserver des Anbieters verweist: „mx.cert.legalmail.it“ für InfoCert, „mailpro.sicurezzapostale.it“ für Namirial. Diese Prüfung wird für interne legalmail.it-Subdomains und in Testumgebungen (AMBIENTE_TEST_DOMINI) übersprungen. Fehlt der MX-Eintrag oder ist er fehlerhaft, schlägt die Anfrage mit ERROR 714 fehl. Zusätzlich zur Überprüfung in der lokalen Datenbank wird die Domain auch anhand des zentralen Domain-Registers überprüft (dieselbe Abfrage, die auch von GET /domini_pec/{dominio} verwendet wird); Ist sie dort bereits registriert, schlägt die Anfrage mit Fehler 712 (InfoCert) oder 732 (Namirial) fehl; sollte die Abfrage im Register selbst fehlschlagen, schlägt die Anfrage mit Fehler 710 (503) fehl.","operationId":"postDominio","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostDominio"},"examples":{"infocert":{"summary":"InfoCert-Domain","description":"InfoCert benötigt lediglich die Domain, den Anbieter, die Laufzeit/das Kontingent und gegebenenfalls einen Vermerk/Rückruf – die Felder zum Antragsteller/Inhaber sind nicht relevant.","value":{"dominio":"testdominio.legalmail.it","fornitore":"infocert","anni":1,"numero_pec":1}},"namirial":{"summary":"Namirial-Domäne","description":"Namirial benötigt für die Aktivierung die vollständigen Angaben zum Antragsteller und zum Inhaber bzw. zum Unternehmen.","value":{"dominio":"testdominio.pecmassiva.com","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":"RSSXXXXXXXX56E","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":"3401234567","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":"Die Domain-Aktivierung wurde gestartet","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":"testdominio.pecmassiva.com","fornitore":"namirial","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,"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":"RSSXXXXXXXX56E","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":"3401234567","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","id":"69806bcce09fb76c6b0fef0c"}}}}}}},"402":{"description":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":403,"data":null}}}},"406":{"description":"Nicht akzeptabel","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":"Konflikt","content":{"application/json":{"example":{"success":false,"message":"domain already registered","error":732,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"example":{"success":false,"message":"tipo_documento not valid for domain: CARTA_D_IDENTITA|PASSAPORTO","error":723,"data":null}}}},"428":{"description":"Voraussetzung erforderlich. Je nach „fornitore“ und den übermittelten Feldern können zusätzlich Fehler bei der Feldvalidierung des Namirial-Antragstellers/Inhabers durch den gemeinsamen PEC-Validator (ERROR-Codes 360–406, siehe POST /pec) zurückgegeben werden.","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}}}}}},"503":{"description":"Dienst nicht verfügbar","content":{"application/json":{"example":{"success":false,"message":"service temporarily unavailable","error":710,"data":null}}}}}}},"/dominio/{id}":{"get":{"tags":["Domini"],"summary":"Details zu einer bestimmten Domain abrufen","operationId":"getDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"Die Domänen-ID"}],"responses":{"200":{"description":"Domain-Details","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dominio"}}},"examples":{"infocert":{"summary":"InfoCert-Domain","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":"Namirial-Domäne","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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":702,"data":null}}}}}},"patch":{"tags":["Domini"],"summary":"Eine zertifizierte Domain aktualisieren","description":"Aktualisiert eine zertifizierte Domain. Akzeptiert Aktivierungsdokumente (nur Namirial – InfoCert gibt den Fehler 730 zurück) und/oder verlängert oder reaktiviert die Domain für eine bestimmte Anzahl von Jahren (1–10). Mindestens einer der Parameter „documenti“ oder „anni“ muss angegeben werden. Befindet sich die Domain im Status „revocato“ und wird „anni“ angegeben, wird die Domain reaktiviert.","operationId":"patchDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"Die Domain-ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"documenti":{"type":"array","items":{"oneOf":[{"type":"string","description":"base64_encode(Dateiinhalt)"},{"type":"object","properties":{"file":{"type":"string","description":"base64_encode(Dateiinhalt)"}}}],"description":"PDF-Dateien (application/pdf) oder P7M-Dateien (application/octet-stream) sind zulässig; jeder Eintrag kann entweder eine einfache Base64-Zeichenkette oder ein Objekt mit dem Schlüssel „file“ sein."},"description":"Aktivierungsdokumente. Nur Namirial – löst die Übermittlung der Dokumente per zertifizierter PEC-E-Mail an den Anbieter aus. Befindet sich die Domain derzeit im Status „revocato“, werden die übermittelten Dokumente stillschweigend verworfen und die Domain stattdessen reaktiviert (siehe Verhalten bei „anni“ weiter unten)."},"anni":{"type":"integer","description":"Anzahl der Jahre für die Verlängerung oder Reaktivierung der Domain (1–10). Befindet sich die Domain im Status „revocato“, wird sie dadurch reaktiviert (Standardwert ist 1 Jahr, falls nicht angegeben); andernfalls wird die aktuelle Laufzeit verlängert.","minimum":1,"maximum":10,"example":1}}},"examples":{"renew_years":{"summary":"Domain für N Jahre verlängern oder reaktivieren","value":{"anni":1}},"upload_documents":{"summary":"Bitte laden Sie ausschließlich Aktivierungsunterlagen hoch (nur Namirial)","value":{"documenti":["JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PAovVHlwZSAvUGFnZQovTWVkaWFCb3ggWzAgMCA1OTUgODQyXQo..."]}},"renew_and_upload":{"summary":"Domain verlängern und Aktivierungsunterlagen hochladen (nur Namirial)","value":{"anni":1,"documenti":["JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PAovVHlwZSAvUGFnZQovTWVkaWFCb3ggWzAgMCA1OTUgODQyXQo..."]}}}}}},"responses":{"200":{"description":"Domain aktualisiert","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":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":403,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":705,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","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}}}}}}}},"delete":{"tags":["Domini"],"summary":"Eine zertifizierte Domain widerrufen","description":"Die Domäne und die zugehörigen PEC-Postfächer werden widerrufen. Postfächer, die sich bereits im Status „evasa“ befinden, werden über den Provider widerrufen (mit Rückrufbenachrichtigung); noch nicht aktive Postfächer (alle anderen Status außer „revocata“) werden direkt in den Status „revocata“ versetzt, ohne den Provider zu kontaktieren.","operationId":"deleteDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"Die zu widerrufende Domain-ID"}],"responses":{"200":{"description":"Domain widerrufen","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"}}}}},"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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":705,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","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":"Eine zertifizierte Domain verlängern oder reaktivieren","description":"Verlängert die Domain um die angegebene Anzahl von Jahren (1–3). Befindet sich die Domain im Status „revocato“, wird sie reaktiviert und die zugehörigen, noch nicht abgelaufenen PEC-Postfächer werden wiederhergestellt.","operationId":"renewDominio","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"},"description":"Die Domain-ID"},{"name":"anni","in":"query","schema":{"type":"integer","default":1,"minimum":1,"maximum":3},"description":"Anzahl der Jahre für die Verlängerung oder Reaktivierung (1–3). Standardwert: 1."}],"responses":{"200":{"description":"Ergebnis der Verlängerung oder Reaktivierung","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":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":403,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":705,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","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":"Formular zur Domain-Aktivierung herunterladen","description":"Laden Sie das PDF-Aktivierungsformular für eine zertifizierte Domain herunter. Nur für Namirial-Domains verfügbar. Laden Sie das ausgefüllte und unterschriebene Formular anschließend über PATCH /dominio/{id} im Feld „documenti“ hoch.","operationId":"getDominioModuloAttivazione","parameters":[{"name":"id","in":"path","required":true,"description":"Die Domain-ID","schema":{"type":"string","example":"69806bcce09fb76c6b0fef0b"}}],"responses":{"200":{"description":"Eine PDF-Datei","headers":{"Content-Disposition":{"schema":{"type":"string"},"example":"inline;filename=modulo_attivazione_testdominio.legalmail.it.pdf","description":"Nur Namirial – der Dateiname wird dynamisch aus dem Domainnamen gebildet; die Darstellung ist „inline“, nicht „Anhang“"}},"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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no domain found","error":705,"data":null}}}}}}},"/domini_pec/{dominio}":{"get":{"tags":["Domini"],"summary":"Domain-Prüfung","description":"Mit dieser Methode können Sie überprüfen, ob eine Domain zum Senden oder Empfangen einer PEC berechtigt ist.","parameters":[{"name":"dominio","in":"path","description":"Domäne","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":"In der aktuellen Implementierung ist es immer ein leeres Array"},"success":{"type":"boolean","description":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"example":{"data":[],"success":true,"message":"legalmail.it found!","error":null}}}},"204":{"description":"Kein Inhalt"},"402":{"description":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":403,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"domain not valid","error":709,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"domain required","error":700,"data":null}}}},"503":{"description":"Dienst nicht verfügbar","content":{"application/json":{"example":{"success":false,"message":"service temporarily unavailable","error":710,"data":null}}}}}}},"/verifica_pec/{pec}":{"get":{"tags":["Pec"],"summary":"Verfügbarkeit eines zertifizierten E-Mail-Postfachs","description":"Diese Methode zeigt Ihnen die Verfügbarkeit eines zertifizierten E-Mail-Postfachs an. Sie kann die Verfügbarkeit von Postfächern nur für Domänen überprüfen, die vom System konfiguriert und verwaltet werden. Bei nicht verwalteten Domänen wird eine ERROR-Meldung ausgegeben, da deren Existenz nicht überprüft werden kann.","parameters":[{"name":"pec","in":"path","description":"E-Mail-Postfach","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":"Zeigt an, ob die E-Mail-Adresse registriert werden kann"}}},"success":{"type":"boolean","description":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"example":{"data":{"available":true},"success":true,"message":"","error":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"invalid casella_pec","error":213,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","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 Ihrer zertifizierten E-Mail-Postfächer","description":"Mit dieser Methode können Sie die Liste der zertifizierten E-Mail-Postfächer einsehen, die zu Ihrem Konto gehören.","parameters":[{"name":"skip","in":"query","description":"Optional. Anzahl der Elemente, die bei der Paginierung übersprungen werden sollen. Wenn kein Wert angegeben wird, beträgt der Standardwert 0.","required":false,"schema":{"type":"integer","example":0}},{"name":"limit","in":"query","description":"Optional. Maximale Anzahl der zurückzugebenden Einträge. Wenn kein Wert angegeben wird, beträgt der Standardwert 100.","required":false,"schema":{"type":"integer","example":100}},{"name":"expiring","in":"query","description":"Optional. Anzahl der Tage. Positiv (1–365): Gibt Postfächer im Status „evasa“ zurück, deren Ablaufdatum (timestamp.scadenza) auf diesen Kalendertag fällt (heute + N Tage, 00:00:00–23:59:59), sortiert nach dem Ablaufdatum in aufsteigender Reihenfolge. Negativ (-1 bis -366): gibt Postfächer im Status „revocata“ zurück, deren Ablaufdatum (timestamp.scadenza) auf diesen Kalendertag fällt (heute + N Tage, d. h. heute – |N| Tage, 00:00:00–23:59:59), sortiert nach dem Ablaufdatum in aufsteigender Reihenfolge.","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":"Gesamtzahl der PEC-Postfächer, die der Abfrage entsprechen, ohne Berücksichtigung der Paginierung durch „skip“ und „limit“."},"success":{"type":"boolean","description":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no PEC linked to this account","error":200,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"expiring must be between -366 and -1, or between 1 and 365","error":262,"data":null}}}}}},"post":{"tags":["Pec"],"summary":"Ein neues zertifiziertes Postfach registrieren","description":"Mit dieser Methode können Sie ein neues zertifiziertes Postfach registrieren. \n\nWenn Sie keine eigene zertifizierte Domain besitzen, muss die Postfachadresse zwingend wie folgt aufgebaut sein: \n\n- „box_name“@legalmail.it (z. B. provapec@legalmail.it) für STANDARD-, BRONZE-, SILVER- und GOLD-Postfächer; \n\n- „box_name“@domiciliodigitale.com (z. B. provapec@domiciliodigitale.com) für DOMICILIODIGITALE-Postfächer; \n\n- „box_name“@pecmassiva.com (z. B. provapec@pecmassiva.com) für PECMASSIVA-Postfächer. \n\nIn der sandbox muss Folgendes angegeben werden: 'box_name'@testcert.legalmail.it (z. B. provapec@testcert.legalmail.it) oder 'box_name'@test.domiciliodigitale.com (z. B. provapec@test.domiciliodigitale.com).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostPec"},"examples":{"infocert":{"summary":"Beispiel: 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":"RSSXXXXXXXX56E","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":1024,"spazio_storico":1024,"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":"Beispiel für 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":"3401234567","codice_fiscale_richiedente":"RSSXXXXXXXX56E","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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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":"RSSXXXXXXXX56E","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":1615199724,"ultima_modifica":1615199726},"cod_attivazione":"10174594","uid":"MA178634","conservazione":false,"data_scadenza":"","descrizione":"yourpec@testcert.legalmail.it","sms":false,"spazio_conservazione":0,"spazio_disco":2048,"spazio_storico":3072,"stato":"registrata","storico":false,"autorinnovo":false,"phishing_protection":false,"password_protection":false,"invio_massivo":false,"invio_massivo_pec":0,"id":"6045fdee3a716847a978a471"},"success":true,"message":"","error":null}}}},"402":{"description":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":262,"data":null}}}},"404":{"description":"Nicht gefunden","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":"Nicht akzeptabel","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}}}}}},"428":{"description":"Voraussetzung erforderlich","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}}}}}}}}},"/pec/{id}":{"get":{"tags":["Pec"],"summary":"Spezifische zertifizierte E-Mail-Adresse","description":"Mit dieser Methode können Sie die spezifische zertifizierte E-Mail-Adresse abrufen, die mit der ID verknüpft ist.","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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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":"RSSXXXXXXXX56E","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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}}}},"delete":{"tags":["Pec"],"summary":"Widerruf der Pec-Zulassung","description":"Mit dieser Methode können Sie die spezifische zertifizierte E-Mail-Adresse widerrufen, die mit der ID verknüpft ist.","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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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"},"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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":237,"data":null}}}},"406":{"description":"Nicht akzeptabel","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":"Voraussetzung erforderlich","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":"Kombinierte PEC-Maßnahmen","description":"Führen Sie einen oder mehrere Vorgänge für ein PEC-Postfach in einem einzigen Aufruf mit einer einzigen Abrechnung durch: Aktivierungsdokumente hochladen, verlängern, Postfachtyp aktualisieren, Speicherplatz/Optionen ändern, Archivierung aktivieren und/oder Mehrbenutzerkonten hinzufügen. Es muss mindestens ein Vorgang angegeben werden. Die Aktivierung (ModuloAttivazione) erfordert den Status „registrata“ oder „documenti_errati“; alle anderen Vorgänge erfordern den Status „evasa“ (für „rinnovo“ wird auch „revocata“ akzeptiert). Einige Felder gelten nur für InfoCert: „upgrade_casella“ schlägt bei Namirial immer fehl (ERROR 236, keine höheren Tarife zum Upgrade), und „phishing_protection“/„password_protection“/„invio_massivo_pec“ haben dort keine Wirkung. „multiutenza“ verhält sich zudem je nach Anbieter unterschiedlich (eine echte Liste pro Benutzer bei InfoCert gegenüber einem einzigen Ein-/Aus-Dienst bei Namirial ohne individuelle Benutzerverwaltung). Siehe die Feldbeschreibungen unten und das Beispiel „combined_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":{"documenti":{"type":"array","description":"Hochzuladende Dokumente; jeder Eintrag muss „tipo“ (ModuloAttivazione|richiestaConservazione) und „file“ (base64-kodiertes PDF) enthalten. Hiermit werden die Dokumente lediglich bereitgestellt – die eigentliche Aktivierung auf Anbieterseite erfolgt später durch einen Mitarbeiter und nicht über diese API. Für „richiestaConservazione“: InfoCert benötigt nur 1 Dokument; Namirial benötigt genau 2 Dokumente in der folgenden Reihenfolge (1. = Aufbewahrungsvertrag, 2. = Datenschutzerklärung), bevor die Aufbewahrung tatsächlich aktiviert werden kann.","items":{"type":"object","properties":{"tipo":{"type":"string","enum":["ModuloAttivazione","richiestaConservazione"]},"file":{"type":"string","description":"Base64-kodierter PDF-Inhalt"}},"required":["tipo","file"]}},"rinnovo_anni":{"type":"integer","description":"Anzahl der Jahre für die Verlängerung (1–3)","minimum":1,"maximum":3},"upgrade_casella":{"type":"string","description":"Nur InfoCert. Aktualisieren Sie den Box-Typ (es sind nur Upgrades zulässig, eine der InfoCert-Stufen). Bei Namirial-Boxen schlägt dies stets fehl (DOMICILIODIGITALE/PECMASSIVA – ERROR 236, da es hierfür keine Upgrade-Stufen gibt).","enum":["STANDARD","BRONZE","SILVER","GOLD"]},"spazio_disco":{"oneOf":[{"type":"string","example":"+1024"},{"type":"integer","example":2048}],"description":"Speicherplatz in MB. Das Präfix „+“ addiert den Wert zum aktuellen Wert hinzu (z. B. „+1024“); eine einfache Ganzzahl legt den absoluten Wert fest. Muss ein Vielfaches von 1024 sein."},"spazio_storico":{"oneOf":[{"type":"string","example":"+1024"},{"type":"integer","example":1024}],"description":"Archivspeicherplatz in MB. Das Präfix „+“ addiert den Wert zum aktuellen Wert; eine reine Ganzzahl legt den absoluten Wert fest. Muss ein Vielfaches von 1024 sein."},"spazio_conservazione":{"oneOf":[{"type":"string","example":"+512"},{"type":"integer","example":512}],"description":"Speicherplatz in MB. Das Präfix „+“ addiert den Wert zum aktuellen Wert; eine einfache Ganzzahl legt den absoluten Wert fest. Muss ein Vielfaches von 512 sein."},"phishing_protection":{"type":"boolean","description":"Nur InfoCert. Phishing-Schutz aktivieren (einseitig). Wird auf Namirial-Geräten nicht unterstützt – hat dort keine Wirkung."},"password_protection":{"type":"boolean","description":"Nur InfoCert. Passwortschutz aktivieren (Einweg). Wird auf Namirial-Rechnern nicht unterstützt – hat dort keine Wirkung."},"invio_massivo_pec":{"type":"integer","description":"Nur InfoCert. Kontingent für Massenversand hinzufügen (muss ein positives Vielfaches von 50 sein). Wird auf Namirial-Servern nicht unterstützt."},"multiutenza":{"oneOf":[{"type":"boolean","description":"Nur Namirial. „true“ aktiviert bzw. deaktiviert den Multiutenza-Dienst."},{"type":"array","description":"InfoCert: Für jeden Eintrag wird ein eigenständiges, individuell verwaltetes Slave-Konto erstellt (insgesamt bis zu 25, Abrechnung pro Benutzer). Namirial: Es können keine einzelnen Benutzer angelegt werden – ein leeres Array reicht ebenfalls aus, um den Dienst zu aktivieren; der Inhalt wird ansonsten ignoriert.","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":"Beispiel für InfoCert","value":{"documenti":[{"tipo":"ModuloAttivazione","file":"JVBERi0xLjQKJ..."},{"tipo":"richiestaConservazione","file":"JVBERi0xLjQKJ..."}],"rinnovo_anni":1,"upgrade_casella":"SILVER","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":"Beispiel für 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 – synchronisierte Casella-Daten sowie eine Liste der ausgeführten Operationen","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"operazioni_eseguite":{"type":"array","description":"Ausgeführte Vorgänge: Aktivierung, Verlängerung, E-Mail-Konto-Upgrade, Änderung, Aufbewahrung, Mehrbenutzer","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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Nicht akzeptabel","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_invalid":{"value":{"success":false,"message":"spazio_conservazione must be a positive multiple of 512 MB","error":715,"data":null}}}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"examples":{"locked":{"value":{"success":false,"message":"pec locked, retry later","error":700,"data":null},"summary":"Derzeit nicht erreichbar: „lock“ ist keine in PecBase deklarierte Eigenschaft, daher wird sie nie aus der Datenbank nachgeladen und ist zur Laufzeit immer „falsy“."},"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}},"upgrade_casella_not_supported_namirial":{"value":{"success":false,"message":"this service cannot be activated on these boxes: DOMICILIODIGITALE|PECMASSIVA","error":236,"data":null},"summary":"Nur Namirial-Postfächer – „upgrade_casella“ schlägt bei Namirial immer fehl, da es keine höheren Tarife gibt, auf die ein Upgrade möglich wäre (DOMICILIODIGITALE/PECMASSIVA gehören nicht zur Tarifskala STANDARD/BRONZE/SILVER/GOLD)."}}}}}}}},"/pec/{id}/attivazione":{"patch":{"tags":["Pec"],"summary":"Aktivierung per zertifizierter E-Mail","description":"Mit dieser Methode können Sie, sobald Sie Ihre zertifizierte elektronische Mailbox registriert haben, diese durch Hochladen der erforderlichen Unterlagen aktivieren. Zu den erforderlichen Unterlagen gehören Ihr gültiger Ausweis sowie das ausgefüllte und unterschriebene Aktivierungsformular, das Sie über die Methode GET/pec/{id}/modulo_attivazione herunterladen können. Für die Postfächer vom Typ DOMICILIODIGITALE und PECMASSIVA muss ein einziges Dokument erstellt werden, das das unterschriebene Aktivierungsformular und den Ausweis enthält.","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(Dateiinhalt); es sind nur PDF-Dateien zulässig"},{"type":"array","items":{"type":"string","description":"base64_encode(Dateiinhalt); es sind nur PDF-Dateien zulässig"}}]}}},"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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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"},"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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"wrong file format, pdf required","error":528,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","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":"Postfacheinstellungen ändern","description":"Ändern Sie die Einstellungen eines aktiven PEC-Postfachs. Die Speicherplatzfelder (spazio_disco, spazio_storico, spazio_conservazione) akzeptieren eine Ganzzahl (absoluter Wert) oder eine Zeichenfolge mit dem Präfix „+“ für eine schrittweise Erhöhung (z. B. „+1024“). Für den Speicherplatz sind nur Erhöhungen zulässig. Boolesche Felder aktivieren optionale Dienste (phishing_protection, password_protection) – nur bei InfoCert, keine Auswirkung auf Namirial-Postfächer. invio_massivo_pec legt das Kontingent für das Massenversand-Add-on fest (Vielfaches von 50) – ebenfalls nur bei InfoCert. Mindestens ein Feld muss ausgefüllt werden.","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":"Wenn Sie das Pluszeichen (+) vorangestellt haben, wird der vorhandene Abstand vergrößert. Wenn Sie nur eine Zahl angeben, wird der Abstand auf diesen Wert festgelegt."},"spazio_storico":{"oneOf":[{"type":"string","example":"+1024","multipleOf":1024},{"type":"integer","example":1024,"multipleOf":1024}],"description":"Wenn Sie das Pluszeichen (+) vorangestellt haben, wird der vorhandene Abstand vergrößert. Wenn Sie nur eine Zahl angeben, wird der Abstand auf diesen Wert festgelegt."},"spazio_conservazione":{"oneOf":[{"type":"string","example":"+512","multipleOf":512},{"type":"integer","example":512,"multipleOf":512}],"description":"Wenn Sie das Pluszeichen (+) voranstellen, wird der vorhandene Abstand vergrößert. Wenn Sie nur eine Zahl eingeben, wird der Abstand auf diesen Wert festgelegt. Dazu muss der Dienst „conservazione“ aktiviert sein."},"invio_massivo_pec":{"type":"integer","multipleOf":50,"minimum":50,"example":100,"description":"Nur InfoCert. Kontingent für das Massenversand-Add-on. Muss ein positives Vielfaches von 50 sein (z. B. 50, 100, 150). Wird auf Namirial-Servern nicht unterstützt."},"phishing_protection":{"type":"boolean","example":true,"description":"Nur InfoCert. Phishing-Schutz-Add-on aktivieren. Kann nicht auf „true“ gesetzt werden, wenn es bereits aktiv ist (ERROR 516). Wird auf Namirial-Boxen nicht unterstützt."},"password_protection":{"type":"boolean","example":true,"description":"Nur InfoCert. Add-on für den Passwortschutz aktivieren. Kann nicht auf „true“ gesetzt werden, wenn es bereits aktiv ist (ERROR 517). Wird auf Namirial-Servern nicht unterstützt."}}},"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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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"},"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":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":290,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"examples":{"spazio_disco_same":{"summary":"spazio_disco: Der Wert entspricht dem aktuellen Wert","value":{"success":false,"message":"you already have this space value","error":284,"data":null}},"spazio_disco_lower":{"summary":"spazio_disco: Wert kleiner als der aktuelle Wert","value":{"success":false,"message":"you cannot decrease your space","error":285,"data":null}},"spazio_storico_same":{"summary":"spazio_storico: Der Wert entspricht dem aktuellen Wert","value":{"success":false,"message":"you already have this space value","error":286,"data":null}},"spazio_storico_lower":{"summary":"spazio_storico: Wert kleiner als der aktuelle Wert","value":{"success":false,"message":"you cannot decrease your space","error":287,"data":null}},"spazio_conservazione_same":{"summary":"spazio_conservazione: Der Wert entspricht dem aktuellen Wert","value":{"success":false,"message":"you already have this space value","error":288,"data":null}},"spazio_conservazione_lower":{"summary":"spazio_conservazione: Wert kleiner als der aktuelle Wert","value":{"success":false,"message":"you cannot decrease your space","error":289,"data":null}},"space_negative":{"summary":"Beliebiges Feld: Negativer Wert übergeben","value":{"success":false,"message":"you cannot decrease your space","error":523,"data":null}},"space_wrong_multiple":{"summary":"Beliebiges Feld: kein Vielfaches von 512 (conservazione) oder 1024 (sonstige)","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 ist kein Vielfaches von 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":"Phishing-Schutz bereits aktiv","value":{"success":false,"message":"phishing protection is already active","error":516,"data":null}},"password_already_active":{"summary":"Passwortschutz bereits aktiviert","value":{"success":false,"message":"password protection is already active","error":517,"data":null}}}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"examples":{"not_processed":{"summary":"PEC noch nicht bearbeitet","value":{"success":false,"message":"you can modify your certified mail only if it has been processed","error":513,"data":null}},"conservazione_not_active":{"summary":"Konservierungsdienst nicht aktiv","value":{"success":false,"message":"you must first activate the 'conservazione' service","error":514,"data":null}},"no_values":{"summary":"Es wurden keine Felder zur Bearbeitung angegeben","value":{"success":false,"message":"you did not pass any values","error":518,"data":null}}}}}}}}},"/pec/{id}/conservazione":{"patch":{"tags":["Pec"],"summary":"Gesetzliche Ausweisung als Naturschutzgebiet","description":"Mit dieser Methode können Sie den Standard-Speicherdienst in Ihrer zertifizierten E-Mail aktivieren. Wird für alle Postfachtypen unterstützt, einschließlich DOMICILIODIGITALE und PECMASSIVA (Namirial). Hiermit wird lediglich die Anfrage vorbereitet (Speicherplatz + Dokumente) – die eigentliche Aktivierung auf Anbieterseite erfolgt später durch einen Mitarbeiter und nicht über diese API. InfoCert benötigt nur 1 Dokument („documenti“ als einfache Zeichenkette oder als Array mit einem Element); Namirial benötigt genau 2, die in der angegebenen Reihenfolge übergeben werden müssen (1. = Aufbewahrungsvertrag, 2. = Datenschutzerklärung) – siehe das Beispiel für die „namirial“-Anfrage.","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":"Wird dieser Parameter nicht übergeben, beträgt der Standardwert 512 (InfoCert) bzw. 1024 (Namirial)."},"documenti":{"oneOf":[{"type":"string","description":"base64_encode(Dateiinhalt); es sind nur PDF-Dateien zulässig. Nur InfoCert – Namirial benötigt zwei Dokumente, verwenden Sie das Array-Format."},{"type":"array","items":{"type":"string","description":"base64_encode(Dateiinhalt); es sind nur PDF-Dateien zulässig"},"description":"InfoCert: 1 Eintrag reicht aus. Namirial: muss genau 2 Einträge enthalten, in der angegebenen Reihenfolge – [0] = Erhaltungsvertrag, [1] = Datenschutzerklärung."}]}},"required":["documenti"]},"examples":{"infocert":{"summary":"Beispiel für InfoCert","value":{"spazio_conservazione":512,"documenti":"JVBERi0xLjUKJeLjz9MKNyAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9UaW1lcyMyME5ldyMyMFJvbWFuCi9GbGFncyAzMgovSXRhbGljQW5nbGUgMAovQXNjZW50IDg5MQovRGVzY2VudCAtMjE2Ci9DYXBIZWlnaHQgNjkzCi9BdmdXaWR0aCA0MDEKL01heFdpZHRoIDI2MTQKL0ZvbnRXZWlnaHQgNDAwCi9YSGVpZ2h0IDI1MAovTGVhZGluZyA0MgovU3RlbVYgNDAKL0ZvbnRCQm94IFstNTY4IC0yMTYgMjA0NiA2OTNdCj4+CmVuZG9iago4IDAgb2JqClsyNTAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAyNTAgMCA1MDAgMCA1MDAgMCAwIDUwMCA1MDAgNTAwIDUwMCA1MDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNDQ0IDAgNDQ0IDAgMCAwIDAgMCAyNzggMCAwIDAgMCA1MDAgNTAwIDUwMCAwIDMzMyAzODkgMjc4IDAgNTAwXQplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udAovU3VidHlwZSAvVHJ1ZVR5cGUKL05hbWUgL0YxCi9CYXNlRm9udCAvVGltZXMjMjBOZXcjMjBSb21hbgovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwovRm9udERlc2NyaXB0b3IgNyAwIFIKL0ZpcnN0Q2hhciAzMgovTGFzdENoYXIgMTE4Ci9XaWR0aHMgOCAwIFIKPj4KZW5kb2JqCjkgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovY2EgMQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovQk0gL05vcm1hbAovQ0EgMQo+PgplbmRvYmoKMTEgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZ"}},"namirial":{"summary":"Beispiel für 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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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"},"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":645,"data":null}}}},"402":{"description":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":297,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"examples":{"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":645,"data":null},"summary":"Nur Namirial-Boxen. Hinweis: Der Fehlercode 645 ist in dieser API doppelt belegt – am selben Endpunkt bedeutet er auch „Falsche ID“ mit HTTP 400 (siehe die 400-Antwort oben); die Verwendung von HTTP 406 mit dieser Meldung ist die einzige Möglichkeit, die beiden Fälle voneinander zu unterscheiden."}}}}},"428":{"description":"Voraussetzung erforderlich","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":"Box-Typ ändern","description":"Mit dieser Methode können Sie die Art der zertifizierten E-Mail-Adresse ändern. Es sind nur Upgrades zulässig, d. h. Sie können beispielsweise von einer STANDARD-Adresse zu einer SILVER- oder GOLD-Adresse wechseln. Diese Aktion ist für die folgenden beiden Postfachtypen nicht zulässig: 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":"Art des Briefkastens","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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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"},"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":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":279,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Nicht akzeptabel","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":520,"data":null}}}}}},"428":{"description":"Voraussetzung erforderlich","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":"Verlängerung der zertifizierten E-Mail-Adresse","description":"Mit dieser Methode können Sie die mit der ID gekennzeichnete zertifizierte E-Mail-Adresse um ein Jahr verlängern oder reaktivieren.","parameters":[{"name":"id","in":"path","description":"Pec-ID","required":true,"schema":{"type":"string","example":"6040e4613a716838dc4eee0e"}},{"name":"anni","in":"query","description":"Anzahl der Jahre, für die Sie die PEC-Box verlängern möchten (1–3). Wird kein Wert angegeben, ist der Standardwert 1. Werte über 3 werden stillschweigend auf 3 begrenzt; nicht numerische Werte oder Werte unter 1 führen zum ERROR 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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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"},"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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","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":"Benutzer hinzufügen","description":"InfoCert: Fügt einen Benutzer hinzu, der eine vorhandene PEC-Box nutzen kann (wiederholbar, bis zu 25 Benutzer). Namirial (DOMICILIODIGITALE/PECMASSIVA): Fügt keinen Benutzer hinzu – dieser Aufruf aktiviert lediglich einmalig den Dienst „Multiutenza on/off“. Der Textkörper wird bei Namirial gar nicht gelesen, ein leeres „{}“ funktioniert; ein erneuter Aufruf führt zum ERROR 596 „multiutenza nur für diese PEC verfügbar“.","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":"Beispiel: InfoCert","value":{"nome":"luca","cognome":"bianchi","descrizione":"prima utenza","email_gestione_password":"mail@domain.com"}},"namirial":{"summary":"Beispiel für Namirial","value":{}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Casella"},"success":{"type":"boolean","description":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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"},"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":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":220,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":646,"data":null}}}},"406":{"description":"Nicht akzeptabel","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":"Voraussetzung erforderlich","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":"Nur InfoCert-Felder – „descrizione“ wird gemäß den Vorgaben des Codes erzwungen, obwohl es nicht in „BodyPostMultiutenza.required“ aufgeführt ist. Bei Namirial-Feldern (DOMICILIODIGITALE/PECMASSIVA) wird dies ignoriert, da diese Felder diese Felder überhaupt nicht validieren."},"email_gestione_password_required":{"value":{"success":false,"message":"email_gestione_password required","error":547,"data":null}}}}}}}},"get":{"tags":["Pec"],"summary":"Mehrbenutzer-Slave-Benutzer auflisten (oder einen abrufen)","description":"Gibt die untergeordneten Benutzer des „multiutenza“-Dienstes eines InfoCert-Postfachs zurück. Gilt nicht für Namirial-Postfächer (DOMICILIODIGITALE/PECMASSIVA), deren Feld „multiutenza“ ein boolescher Wert und kein Array ist – siehe ERROR 208.","parameters":[{"name":"id","in":"path","description":"Pec-ID","required":true,"schema":{"type":"string","example":"6040e4613a716838dc4eee0e"}},{"name":"id_subset","in":"query","description":"Falls angegeben, wird anstelle der vollständigen Liste nur der einzelne Slave-Benutzer an diesem Index zurückgegeben. Format: '<BELIEBIGES_PRÄFIX>_<INDEX>' (es wird nur der Teil nach dem letzten Unterstrich verwendet, z. B. funktioniert der eigene „id_utenza“-Wert des Postfachs direkt).","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":645,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"examples":{"no_pec_found":{"value":{"success":false,"message":"no pec found","error":646,"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 Ihrer Mitteilungen","description":"Mit dieser Methode werden Ihnen alle zertifizierten E-Mail-Nachrichten angezeigt, die an das Handelsregister gestartet wurden.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RichiesteComunicazionePec"}},"success":{"type":"boolean","description":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no request linked to this account","error":332,"data":null}}}}}},"post":{"tags":["Comunica Pec"],"summary":"Eine zertifizierte E-Mail versenden","description":"Mit dieser Methode können Sie eine zertifizierte E-Mail an das Handelsregister senden.","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":"34xxxxxx18","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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 182.03","error":610,"data":null}}}},"406":{"description":"Nicht akzeptabel","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":"Voraussetzung erforderlich","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":"Konkrete Anfrage bezüglich der Kommunikation (pec)","description":"Diese Methode gibt Ihnen die spezifische Anfrage zurück, die mit der ID gekennzeichnet ist.","parameters":[{"name":"id","in":"path","description":"Pec-ID angeben","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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no request found","error":334,"data":null}}}}}},"patch":{"tags":["Comunica Pec"],"summary":"Laden Sie die Dokumente hoch","description":"Mit dieser Methode können Sie den Antrag auf Übermittlung Ihrer PEC an das Handelsregister stellen, indem Sie die erforderlichen Unterlagen hochladen. Zu den erforderlichen Unterlagen gehört das ausgefüllte und digital signierte Formular (PDF oder p7m), das Sie über die Methode GET/comunica_pec/{id}/procura_registro_imprese herunterladen können.","parameters":[{"name":"id","in":"path","description":"Pec-ID angeben","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(Dateiinhalt); Es werden PDF- oder P7M-Dateien akzeptiert"},{"type":"array","items":{"type":"string","description":"base64_encode(Dateiinhalt); Es werden PDF- oder P7M-Dateien akzeptiert"}}]}}},"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":"Erfolg der Operation (wahr/falsch)."},"message":{"type":"string","description":"Fehlermeldung"},"error":{"type":"integer","description":"Fehlercode"}}},"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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no request found","error":354,"data":null}}}},"406":{"description":"Nicht akzeptabel","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":"Voraussetzung erforderlich","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":"Laden Sie das Aktivierungsformular herunter","description":"Mit dieser Methode können Sie das Aktivierungsformular einer zertifizierten E-Mail direkt herunterladen. Nach dem Ausfüllen und Unterzeichnen wird es in Form einer Base64-kodierten Zeichenfolge mithilfe der Methode PATCH/pec/{id}/attivazione zusammen mit einem Ausweisdokument übermittelt.","parameters":[{"name":"id","in":"path","description":"Anfrage-ID","required":true,"schema":{"type":"string","example":"5f7b2e323a716857774a4373"}}],"responses":{"200":{"description":"Eine PDF-Datei","headers":{"Content-Disposition":{"schema":{"type":"string"},"example":"attachment; filename=\"modulo_attivazione.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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","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}}}}}}}}},"/pec/{id}/modulo_conservazione":{"get":{"tags":["Modulistica"],"summary":"Laden Sie das Aktivierungsformular herunter","description":"Mit dieser Methode können Sie das Formular zur Speicherkennzeichnung einer zertifizierten E-Mail direkt herunterladen. Nach dem Ausfüllen und Unterzeichnen muss es als Base64-kodierte Zeichenfolge über PATCH /pec/{id}/conservazione übermittelt werden.","parameters":[{"name":"id","in":"path","description":"Anfrage-ID","required":true,"schema":{"type":"string","example":"5f7b2e323a716857774a4373"}}],"responses":{"200":{"description":"Eine PDF-Datei","headers":{"Content-Disposition":{"schema":{"type":"string"},"example":"attachment; filename=\"modulo_conservazione.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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no pec found","error":202,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","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":"Laden Sie die Vollmacht herunter","description":"Mit dieser Methode können Sie das PEC-Kommunikationsformular aus dem Unternehmensregister herunterladen. Sobald es digital im P7M-Format signiert ist, wird es in Form einer Base64-kodierten Zeichenfolge mithilfe der Methode PATCH/comunica_pec/{id} übermittelt.","parameters":[{"name":"id","in":"path","description":"Anfrage-ID","required":true,"schema":{"type":"string","example":"5f7b2e323a716857774a4373"}}],"responses":{"200":{"description":"Wenn das unterschriebene Formular bereits hochgeladen wurde, wird die gespeicherte PDF-Datei zurückgegeben. Andernfalls (und wenn „stato“ nicht „codice_in_richiesta“ ist) wird anstelle einer Datei der JSON-Anfragedatensatz zurückgegeben.","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":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no request found","error":334,"data":null}}}},"406":{"description":"Nicht zulässig – Das Formular kann noch nicht generiert werden, da sich die Anfrage noch im Status „codice_in_richiesta“ befindet. Wird als Klartext-Body zurückgegeben, nicht als JSON-Envelope.","content":{"text/plain":{"schema":{"type":"string"},"example":"you cannot download this module, it doesn't exist yet"}}}}}}},"externalDocs":{"description":"Zum ersten Mal hier? Erstellen Sie einen neuen Zugriffstoken.","url":"https://console.openapi.com/de/oauth"},"security":[{"bearerAuth":[]}]}