{"openapi":"3.0.0","info":{"title":"E-Signature","description":"Questa API è uno strumento affidabile progettato per sviluppatori e aziende che desiderano automatizzare e integrare nelle proprie applicazioni processi di firma sicura dei documenti. L’API è pienamente conforme alla normativa eIDAS, garantendo che tutte le firme soddisfino i rigorosi standard europei in materia di validità legale.\n La documentazione illustra una suite completa di funzionalità, che consente agli utenti di implementare vari tipi di firme digitali, tra cui le firme elettroniche semplici (SES) protette tramite OTP, i sigilli elettronici qualificati e le firme elettroniche qualificate automatiche su larga scala (QES) per esigenze di volumi elevati. Tra le funzionalità chiave figurano la possibilità di apporre un timestamp ai documenti, gestire i certificati e accedere a registri di audit dettagliati per tracciare l’intero ciclo di vita della firma.\nL’interfaccia Swagger UI fornita nella documentazione consente agli sviluppatori di esplorare e testare direttamente gli endpoint, gestire i flussi di firma e verificare lo stato delle certificazioni, facilitando un processo di integrazione fluido per la dematerializzazione dei flussi di lavoro cartacei.","termsOfService":"https://openapi.it/en/terms-and-conditions","version":"1.0.21","contact":{"url":"https://openapi.it/en/support","name":"Support"}},"externalDocs":{"description":"È la prima volta che visiti questo sito? Genera un nuovo token di accesso","url":"https://console.openapi.com/it/oauth"},"servers":[{"url":"https://esignature.openapi.com","description":"Produzione"},{"url":"https://test.esignature.openapi.com","description":"Sandbox"}],"tags":[{"name":"Certificates","description":"Acquistare o rinnovare i certificati di firma","externalDocs":{"description":"Scopri di più","url":"https://openapi.com/trust-services"}},{"name":"Signatures","description":"Apporre una firma elettronica a un file"}],"security":[{"bearerAuth":[]}],"paths":{"/certificates":{"get":{"tags":["Certificates"],"summary":"Ottieni un elenco dei certificati","description":"Ottieni un elenco dei certificati. L'elenco può essere filtrato in base al tipo di certificato (certificateType) e allo stato. I tipi disponibili sono: EU-QES_automatic e EU-QES_otp. Gli stati disponibili sono: NEW, EXPIRED e SUSPENDED.","operationId":"get_certificates","parameters":[{"name":"certificateType","in":"query","description":"Type di certificato","schema":{"type":"string","enum":["EU-QES_automatic","EU-QES_otp","EU-QES_eseal"]},"example":"EU-QES_automatic"},{"name":"state","in":"query","description":"Stato del certificato","schema":{"type":"string","enum":["NEW","EXPIRED","SUSPENDED"]},"example":"NEW"},{"name":"skip","in":"query","description":"Numero di elementi da saltare","schema":{"type":"integer","default":0,"minimum":0},"example":0},{"name":"limit","in":"query","description":"Numero massimo di articoli da restituire (min. 1, max. 100)","schema":{"type":"integer","default":100,"maximum":100,"minimum":1},"example":100}],"responses":{"200":{"description":"Operazione riuscita","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CertificateListObject"}}}}},"400":{"description":"Dati inseriti non validi"}}}},"/certificates/{id}":{"get":{"tags":["Certificates"],"summary":"Ottieni un certificato","description":"Ottieni un certificato tramite ID. L'ID del certificato è necessario per accedere al servizio.","operationId":"get_certificates__id_","parameters":[{"name":"id","in":"path","description":"ID del certificato","required":true,"schema":{"type":"string"},"example":"67af24c5af9b55291406e946"}],"responses":{"200":{"description":"Operazione riuscita","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CertificateObject"}}}},"400":{"description":"Dati inseriti non validi"},"404":{"description":"Certificato non trovato"}}}},"/certificates/namirial-automatic":{"post":{"tags":["Certificates"],"summary":"Acquista un certificato automatico Namirial","description":"Acquista un certificato Namirial Automatic, valido per 3 anni e utilizzabile per firmare documenti nei formati CAdES, PAdES, XAdES e PKCS#1. La procedura restituisce un certificateLink, ovvero una procedura una tantum da parte dell’autorità di certificazione volta a qualificare il titolare del certificato.\n\n Una volta completata la procedura, il firmatario riceverà un’e-mail contenente un file PDF protetto da password e un link per ricevere la password tramite SMS. Il file PDF contiene le credenziali necessarie.\n\nL’oggetto callback non è richiesto.","operationId":"post_certificates_namirial_automatic","requestBody":{"description":"Crea una nuova richiesta di certificato automatico Namirial specificando i dettagli del certificato.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CertificateNamirial_POST"}}},"required":true},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CertificateCallbackPayload"}}}},"responses":{"200":{"description":"Richiamata riuscita"},"400":{"description":"Dati inseriti non validi"}}}}}},"responses":{"200":{"description":"Operazione riuscita","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"ID del certificato","example":"67af24c5af9b55291406e946"},"certificateType":{"type":"string","description":"Type di certificato","example":"EU-QES_automatic","enum":["EU-QES_automatic","EU-QES_otp","EU-QES_eseal"]},"state":{"type":"string","description":"Stato della richiesta","example":"DONE","enum":["NEW","DONE","REGISTERING","WORKING","CANCELLED"]},"certificateLink":{"type":"string","format":"uri","description":"URL per start la procedura di attribuzione del certificato","example":"https://my-domain.com/certificate.html"},"certificateOwner":{"type":"object","description":"Informazioni sul titolare del certificato","properties":{"owner":{"type":"string","description":"Riferimento del titolare per il certificato","example":"Mario Rossi"},"customReference":{"type":"string","description":"Riferimento personalizzato per il certificato","example":"MyCustomReference#123"}}},"createdAt":{"type":"string","description":"Data e ora di creazione","example":"2025-02-14 11:11:01.892+00:00"},"expireAt":{"type":"string","description":"Data e ora di scadenza","example":"2028-02-14 11:11:01.892+00:00"}}},"success":{"type":"boolean","description":"Esito positivo dell'intervento","example":true},"message":{"type":"string","description":"Messaggio","example":"Certificate purchased successfully"},"error":{"type":"string","nullable":true,"description":"Codice di errore","example":""}}}}}},"404":{"description":"Certificato non disponibile","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","nullable":true},"success":{"type":"boolean","description":"Operazione non riuscita","example":false},"message":{"type":"string","description":"Messaggio","example":"No namirial-automatic certificate available on stock. Contact us for more information"},"error":{"type":"integer","nullable":true,"description":"Codice di errore","example":305}}}}}}}}},"/certificates/namirial-otp":{"post":{"tags":["Certificates"],"summary":"Acquista un certificato OTP Namirial","description":"Acquista un certificato OTP Namirial. Il certificato ha una validità di 3 anni e può essere utilizzato per firmare documenti nei formati CAdES, PAdES, XAdES e PKCS#1.","operationId":"post_certificates_namirial_otp","requestBody":{"description":"Crea una nuova richiesta di certificato automatico Namirial specificando i dettagli del certificato.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CertificateNamirial_POST"}}},"required":true},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CertificateCallbackPayload"}}}},"responses":{"200":{"description":"Richiamata riuscita"},"400":{"description":"Dati inseriti non validi"}}}}}},"responses":{"200":{"description":"Operazione riuscita","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"ID del certificato","example":"67af24c5af9b55291406e946"},"certificateType":{"type":"string","description":"Type di certificato","example":"EU-QES_otp","enum":["EU-QES_automatic","EU-QES_otp"]},"state":{"type":"string","description":"Stato della richiesta","example":"DONE","enum":["NEW","DONE","REGISTERING","WORKING","CANCELLED"]},"certificateLink":{"type":"string","format":"uri","description":"URL per start la procedura di attribuzione del certificato","example":"https://my-domain.com/certificate.html"},"certificateOwner":{"type":"object","description":"Informazioni sul titolare del certificato","properties":{"owner":{"type":"string","description":"Riferimento del titolare per il certificato","example":"Mario Rossi"},"customReference":{"type":"string","description":"Riferimento personalizzato per il certificato","example":"MyCustomReference#123"}}},"createdAt":{"type":"string","description":"Data e ora di creazione","example":"2025-02-14 11:11:01.892+00:00"},"expireAt":{"type":"string","description":"Data e ora di scadenza","example":"2028-02-14 11:11:01.892+00:00"}}},"success":{"type":"boolean","description":"Esito positivo dell'intervento","example":true},"message":{"type":"string","description":"Messaggio","example":"Certificate purchased successfully"},"error":{"type":"string","nullable":true,"description":"Codice di errore","example":""}}}}}},"404":{"description":"Certificato non disponibile","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","nullable":true},"success":{"type":"boolean","description":"Operazione non riuscita","example":false},"message":{"type":"string","description":"Messaggio","example":"No namirial-otp certificate available on stock. Contact us for more information"},"error":{"type":"integer","nullable":true,"description":"Codice di errore","example":305}}}}}}}}},"/signatures":{"get":{"tags":["Signatures"],"summary":"Ottieni un elenco di firme","description":"Ottieni un elenco di firme. L'elenco può essere filtrato per stato, tipo di certificato e tipo di firma. Gli stati disponibili sono: WAIT_VALIDATION, WAIT_SIGN, WAIT_SIGNER, DONE ed ERROR. The types of certificate available are: EU-QES_automatic, EU-QES_otp and EU-SES. The types of signature available are: cades, pades, xades and pkcs1.","operationId":"get_signatures","parameters":[{"name":"state","in":"query","description":"Stato della firma","schema":{"type":"string","enum":["WAIT_VALIDATION","WAIT_SIGN","WAIT_SIGNER","DONE","ERROR"]},"example":"DONE"},{"name":"certificateType","in":"query","description":"Type di certificato","schema":{"type":"string","enum":["EU-QES_automatic","EU-QES_otp"]},"example":"EU-QES_automatic"},{"name":"signatureType","in":"query","description":"Type of signature","schema":{"type":"string","enum":["cades","pades","xades","pkcs1"]},"example":"pades"},{"name":"skip","in":"query","description":"Numero di elementi da saltare","schema":{"type":"integer","default":0,"minimum":0},"example":0},{"name":"limit","in":"query","description":"Numero massimo di articoli da restituire (min. 1, max. 100)","schema":{"type":"integer","default":100,"maximum":100,"minimum":1},"example":100}],"responses":{"200":{"description":"Operazione riuscita","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SignatureListElement"}},"examples":{"LIST":{"$ref":"#/components/examples/SignatureList"}}}}},"404":{"description":"Non sono state trovate firme"}}}},"/signatures/{id}/{actionType}":{"get":{"tags":["Signatures"],"summary":"Scarica il documento firmato, visualizza i dettagli, la traccia di audit o il documento convalidato relativo a una firma","description":"Recupera i dettagli, l'audit, il signedDocument o il validatedDocument di una firma.
Per accedere al servizio è necessario l'ID della firma.
Il parametro actionType può essere utilizzato per specificare il tipo di informazioni da recuperare.
Le opzioni disponibili sono: signedDocument, validatedDocument, audit e detail.
I parametri signedDocument e validatedDocument restituiscono il contenuto binario del file pronto per essere scaricato.
La traccia di audit è disponibile in diversi formati in base al valore Accept dell’intestazione della richiesta.
I formati disponibili sono: application/json, text/plain, text/html, application/pdf.","operationId":"get_signatures__id___actionType_","parameters":[{"name":"id","in":"path","description":"ID della firma","required":true,"schema":{"type":"string"},"example":"67af24c5af9b55291406e946"},{"name":"actionType","in":"path","description":"Type di azione da eseguire: \"detail\" oppure lasciare vuoto per le informazioni sul documento firmato, \"signedDocument\", \"audit\" per la traccia di audit oppure \"validatedDocument\"","required":true,"schema":{"type":"string","default":"","enum":["detail","audit","signedDocument","validatedDocument",""]},"example":"detail"}],"responses":{"200":{"$ref":"#/components/responses/signatures200"},"400":{"description":"Dati inseriti non validi"},"404":{"description":"Firma non trovata"}}}},"/EU-QES_automatic":{"post":{"tags":["Signatures"],"summary":"Creare una firma QES utilizzando il certificato automatico Massive","description":"Crea una procedura di firma a partire da uno o più file. \n### Ottenimento del certificato:\n Per accedere al servizio, è necessario un certificato automatico che può essere acquistato tramite\n l'endpoint appropriato \"/certificates/namirial-automatic\". \n\n### Formati disponibili:\n Il sistema è in grado di firmare nei formati CAdES, PAdES, XAdES e PKCS#1.\n\n\nSe non specificato, il sistema cercherà\n il formato più adatto in base al mimeType del file caricato\n .\n\n### File di input:\n È possibile caricare uno o più file di input sia\n in formato base64 sia specificando l’URL della risorsa ed eventuali\n parametri di autenticazione.\n\n\n - In caso di caricamento di più file\n con firma PAdES, questi verranno uniti in un unico documento PDF firmato\n . \n \n - Nel caso di firma di più file in formato CAdES, verrà generato e firmato un\n file zip.\n\n### Modalità asincrona, elaborazione in batch, callback e firma \"detached\":\n Per la firma in massa di grandi quantità di file, è possibile caricare e firmare in modalità asincrona\n . È disponibile un sistema di callback autenticato per ricevere\n gli aggiornamenti. \n\n È inoltre possibile firmare direttamente l’hash del file originale\n e ottenere solo il file di firma \"detached\".\n\n### Conservazione dei documenti e dei dati nel sistema:\n I dettagli della firma dati strutturati e la traccia di audit saranno conservati nel sistema per un massimo di 10 anni.\n I documenti firmati, i documenti caricati e quelli convalidati rimarranno nel sistema per un massimo di 3 mesi per consentirne il download.\n Trascorso questo periodo, i documenti verranno automaticamente cancellati.\n \n### Marca temporale qualificata disponibile:\n È disponibile un’opzione di marca temporale qualificata. È inoltre possibile utilizzare credenziali di marca temporale qualificata già in vostro possesso. In questo caso, il sistema consente di specificare l’URL di autenticazione dell’autorità di certificazione pertinente.\n \n\n### Sandbox:\n A scopo di test, è possibile utilizzare le seguenti credenziali:\n - certificateUsername: \"openapiSandboxUsername\"\n - certificatePassword: \"openapiSandboxPassword\"","operationId":"post_EU_QES_automatic","requestBody":{"description":"Crea una nuova richiesta di firma automatica in massa specificando i file di input e le credenziali del certificato.\n\nIl sistema è in grado di firmare nei formati CAdES, PAdES, XAdES e PKCS#1. Se non specificato, il sistema individuerà il formato più adatto in base al mimeType del file caricato.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EU-QES_POST"},"examples":{"cades":{"summary":"Firma CAdES di un file Base64 SENT con inputDocumentObject","value":{"inputDocuments":[{"sourceType":"base64","payload":"BASE64string"}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","title":"CAdES Signature","description":"Firma CAdES di un file in formato base64","signatureType":"cades"}},"pades":{"summary":"Firma PAdES da un file remoto e da un file in formato base64","value":{"inputDocuments":[{"sourceType":"remote","url":"https://my-domain.com/remoteResource.pdf"},{"sourceType":"base64","payload":"BASE64string"}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","title":"PAdES Signature","description":"Firma PAdES di un file remoto e in formato Base64","signatureType":"pades"}},"xades":{"summary":"Firma XAdES da file base64","value":{"inputDocuments":[{"sourceType":"base64","payload":"BASE64string"}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","title":"XAdES Signature","description":"Firma XAdES di un file in formato base64","signatureType":"xades"}},"pkcs1":{"summary":"Firma PKCS1 derivata dall'hash di un file codificato in base64","value":{"inputDocuments":[{"sourceType":"base64Hash","payload":"msj3f4hJCSELbMkWjkFwNrf0XhkebTnAKaKhx4686DY="}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","title":"PKCS1 Signature","description":"Firma PKCS1 dell'hash di un file codificato in base64","signatureType":"pkcs1"}}}}},"required":true},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"$ref":"#/components/requestBodies/SignatureCallback"},"responses":{"200":{"description":"Richiamata riuscita"},"400":{"description":"Dati inseriti non validi"}}}}}},"responses":{"200":{"$ref":"#/components/responses/EU-QES_automatic200"},"422":{"$ref":"#/components/responses/POSTsignature422"}}}},"/EU-QES_otp":{"post":{"tags":["Signatures"],"summary":"Creare una firma QES utilizzando un certificato OTP remoto","description":"Creare una procedura di firma a partire da uno o più file. \n### Ottenimento del certificato:\n Per accedere al servizio è necessario un certificato automatico acquistabile tramite\n l'endpoint dedicato /certificates/namirial-otp. \n\n### Formati disponibili:\n Il sistema è in grado di firmare nei formati CAdES, PAdES, XAdES e PKCS#1.\n\n\nSe non specificato, il sistema cercherà\n il formato più adatto in base al mimeType del file caricato\n .\n\n### File di input:\n È possibile caricare uno o più file di input sia\n in formato base64 sia specificando l’URL della risorsa ed eventuali\n parametri di autenticazione.\n\n\n - Nel caso di caricamento di più file\n con firma PAdES, questi verranno uniti in un unico documento PDF firmato\n . \n \n - Nel caso di firma di più file in formato CAdES, verrà generato e firmato un file zip\n .\n\n### Modalità asincrona, elaborazione in batch, callback e firma \"detached\":\n Per la firma in massa di grandi quantità di file, è possibile caricare e firmare in modalità asincrona\n . È disponibile un sistema di callback autenticato per ricevere\n gli aggiornamenti. \n\n È inoltre possibile firmare direttamente l’hash del file originale\n e ottenere solo il file di firma \"detached\".\n\n### Conservazione dei documenti e dei dati nel sistema:\n I dettagli della firma dati strutturati e la traccia di audit saranno conservati nel sistema per un massimo di 10 anni.\n I documenti firmati, i documenti caricati e quelli convalidati rimarranno nel sistema per un massimo di 3 mesi per consentirne il download.\n Trascorso questo periodo, i documenti verranno automaticamente eliminati.\n \n### Marca temporale qualificata disponibile:\n È disponibile un’opzione di marca temporale qualificata. È inoltre possibile utilizzare credenziali di marca temporale qualificata già in vostro possesso. In questo caso, il sistema consente di specificare l’URL di autenticazione dell’autorità di certificazione pertinente.\n \n\n### Sandbox:\n A scopo di test, è possibile utilizzare le seguenti credenziali:\n - certificateUsername: \"openapiSandboxUsername\"\n - certificatePassword: \"openapiSandboxPassword\"","operationId":"post_EU_QES_otp","requestBody":{"description":"Crea una nuova richiesta di firma automatica in massa specificando i file di input e le credenziali del certificato.\n\nIl sistema è in grado di firmare nei formati CAdES, PAdES, XAdES e PKCS#1. Se non specificato, il sistema individuerà il formato più adatto in base al mimeType del file caricato.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EU-QES_POST"},"examples":{"cades":{"summary":"Firma CAdES di un file Base64 SENT con inputDocumentObject","value":{"inputDocuments":[{"sourceType":"base64","payload":"BASE64string"}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","certificateOtp":"123456","certificateIdOtp":-1,"title":"CAdES Signature","description":"Firma CAdES di un file in formato base64","signatureType":"cades"}},"pades":{"summary":"Firma PAdES da un file remoto e da un file in formato base64","value":{"inputDocuments":[{"sourceType":"remote","url":"https://my-domain.com/remoteResource.pdf"},{"sourceType":"base64","payload":"BASE64string"}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","certificateOtp":"123456","certificateIdOtp":-1,"title":"PAdES Signature","description":"Firma PAdES di un file remoto e in formato Base64","signatureType":"pades"}},"xades":{"summary":"Firma XAdES da file base64","value":{"inputDocuments":[{"sourceType":"base64","payload":"BASE64string"}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","certificateOtp":"123456","certificateIdOtp":-1,"title":"XAdES Signature","description":"Firma XAdES di un file in formato base64","signatureType":"xades"}},"pkcs1":{"summary":"Firma PKCS1 derivata dall'hash di un file codificato in base64","value":{"inputDocuments":[{"sourceType":"base64Hash","payload":"msj3f4hJCSELbMkWjkFwNrf0XhkebTnAKaKhx4686DY="}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","certificateOtp":"123456","certificateIdOtp":-1,"title":"PKCS1 Signature","description":"Firma PKCS1 dell'hash di un file codificato in base64","signatureType":"pkcs1"}}}}},"required":true},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"$ref":"#/components/requestBodies/SignatureCallback"},"responses":{"200":{"description":"Richiamata riuscita"},"400":{"description":"Dati inseriti non validi"}}}}}},"responses":{"200":{"$ref":"#/components/responses/EU-QES_otp200"},"422":{"$ref":"#/components/responses/POSTsignature422"}}}},"/EU-QES_eseal":{"post":{"tags":["Signatures"],"summary":"Creare una firma QES utilizzando un certificato di sigillo elettronico remoto","description":"Crea una procedura di firma a partire da uno o più file. \n### Ottenimento del certificato:\n Per accedere al servizio, è necessario un certificato automatico che può essere acquistato tramite\n il nostro Servizio Clienti. \n\n### Formati disponibili:\n Il sistema è in grado di firmare nei formati CAdES, PAdES, XAdES e PKCS#1.\n\n\nSe non specificato, il sistema cercherà\n il formato più adatto in base al mimeType del file caricato\n .\n\n### File di input:\n È possibile caricare uno o più file di input sia\n in formato base64 sia specificando l’URL della risorsa ed eventuali\n parametri di autenticazione.\n\n\n - In caso di caricamento di più file\n con firma PAdES, questi verranno uniti in un unico documento PDF firmato\n . \n \n - Nel caso di firma di più file in formato CAdES, verrà generato e firmato un file zip\n .\n\n### Modalità asincrona, elaborazione in batch, callback e firma \"detached\":\n Per la firma in massa di grandi quantità di file, è possibile caricare e firmare in modalità asincrona\n . È disponibile un sistema di callback autenticato per ricevere\n gli aggiornamenti. \n\n È inoltre possibile firmare direttamente l’hash del file originale\n e ottenere solo il file di firma “detached”.\n\n### Conservazione dei documenti e dei dati nel sistema:\n I dettagli della firma dati strutturati e la traccia di audit saranno conservati nel sistema per un massimo di 10 anni.\n I documenti firmati, i documenti caricati e quelli convalidati rimarranno nel sistema per un massimo di 3 mesi per consentirne il download.\n Trascorso questo periodo, i documenti verranno automaticamente eliminati.\n \n### Marca temporale qualificata disponibile:\n È disponibile un’opzione di marca temporale qualificata. È inoltre possibile utilizzare credenziali di marca temporale qualificata già in vostro possesso. In questo caso, il sistema consente di specificare l’URL di autenticazione dell’autorità di certificazione pertinente.\n \n\n### Sandbox:\n A scopo di test, è possibile utilizzare le seguenti credenziali:\n - certificateUsername: \"openapiSandboxUsername\"\n - certificatePassword: \"openapiSandboxPassword\"","operationId":"post_EU_QES_eseal","requestBody":{"description":"Crea una nuova richiesta di firma automatica in massa specificando i file di input e le credenziali del certificato.\n\nIl sistema è in grado di firmare nei formati CAdES, PAdES, XAdES e PKCS#1. Se non specificato, il sistema individuerà il formato più adatto in base al mimeType del file caricato.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EU-QES_POST"},"examples":{"cades":{"summary":"Firma CAdES di un file Base64 SENT con inputDocumentObject","value":{"inputDocuments":[{"sourceType":"base64","payload":"BASE64string"}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","title":"CAdES Signature","description":"Firma CAdES di un file in formato base64","signatureType":"cades"}},"pades":{"summary":"Firma PAdES da un file remoto e da un file in formato base64","value":{"inputDocuments":[{"sourceType":"remote","url":"https://my-domain.com/remoteResource.pdf"},{"sourceType":"base64","payload":"BASE64string"}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","title":"PAdES Signature","description":"Firma PAdES di un file remoto e in formato Base64","signatureType":"pades"}},"xades":{"summary":"Firma XAdES da file base64","value":{"inputDocuments":[{"sourceType":"base64","payload":"BASE64string"}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","title":"XAdES Signature","description":"Firma XAdES di un file in formato base64","signatureType":"xades"}},"pkcs1":{"summary":"Firma PKCS1 derivata dall'hash di un file codificato in base64","value":{"inputDocuments":[{"sourceType":"base64Hash","payload":"msj3f4hJCSELbMkWjkFwNrf0XhkebTnAKaKhx4686DY="}],"certificateUsername":"openapiSandboxUsername","certificatePassword":"openapiSandboxPassword","title":"PKCS1 Signature","description":"Firma PKCS1 dell'hash di un file codificato in base64","signatureType":"pkcs1"}}}}},"required":true},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"$ref":"#/components/requestBodies/SignatureCallback"},"responses":{"200":{"description":"Richiamata riuscita"},"400":{"description":"Dati inseriti non validi"}}}}}},"responses":{"200":{"$ref":"#/components/responses/EU-QES_automatic200"},"400":{"description":"Dati inseriti non validi"},"422":{"description":"Eccezione di convalida"}}}},"/EU-SES":{"post":{"tags":["Signatures"],"summary":"Crea una richiesta SES per uno o più firmatari.","description":"La chiamata restituirà un link, uno per ciascun firmatario, alla nostra applicazione web **esign**. Nell'applicazione web, ciascun firmatario potrà leggere il documento e firmarlo dopo essersi autenticato tramite OTP, che potrà essere inviato tramite SMS o e-mail. **Si prega di tenere presente che il testo dell'SMS verrà analizzato per verificare che sia conforme al formato E.164**; in caso contrario, la richiesta verrà **rejected**.\n **Ogni firmatario può richiedere l’OTP solo un numero limitato di volte.** Per prevenire abusi, gli invii consecutivi di OTP per lo stesso firmatario sono soggetti a limitazioni con un tempo di attesa crescente tra un tentativo e l’altro: ogni nuovo tentativo deve attendere un tempo progressivamente più lungo rispetto al precedente prima che venga inviato un nuovo OTP. Una richiesta effettuata prima che il periodo di attesa sia trascorso viene respinta con codice HTTP 429 e `{\"success\": false, \"message\": \"troppe richieste di OTP, riprovare dopo N secondi\", \"ERROR\": 917}`. Una volta raggiunto il numero massimo consentito di richieste di OTP per un firmatario, la firma passa allo stato **ERROR** e non può più essere firmata; la richiesta REJECTED restituisce un codice di stato HTTP 429 con `{\"success\": false, \"message\": \"Limite di richieste OTP raggiunto (N). Questa firma è stata bloccata per motivi di sicurezza.\", \"ERROR\": 918}`, e lo stesso messaggio è disponibile in seguito nel campo `errorMessage` della firma. **Ogni firmatario può inoltre tentare di convalidare l’OTP solo un numero limitato di volte.** Per proteggersi dagli attacchi di forza bruta, ogni OTP errato inviato viene conteggiato ai fini del limite individuale per firmatario. Finché sono disponibili tentativi, un codice errato viene REJECTED con un codice di stato HTTP 400 e `{\"success\": false, \"message\": \"Errore di convalida OTP\", \"error\": 310, \"data\": {\"otpAttemptsRemaining\": N}}`, dove `otpAttemptsRemaining` è il numero di tentativi ancora disponibili prima che la firma venga bloccata; il campo viene omesso quando non è configurato alcun limite. Una volta raggiunto il numero massimo consentito di tentativi di convalida, la firma passa allo stato **ERROR** e non può più essere firmata; la richiesta REJECTED restituisce un codice di stato HTTP 429 con errore `919`.\n Per ogni firmatario, è **necessario** specificare almeno il numero di cellulare o l’indirizzo e-mail a cui verrà inviato il codice OTP; inoltre, è necessario specificare la modalità di autenticazione all’interno dell’opzione di autenticazione. È inoltre possibile specificare il messaggio che verrà inviato insieme al codice OTP e il modo in cui i firmatari firmeranno il documento; per impostazione predefinita, potranno firmare digitando il proprio nome o disegnandolo.\n Anche l’interfaccia utente visibile al firmatario finale è completamente personalizzabile nella richiesta. La convalida del documento avverrà in modo asincrono. Se per un firmatario non vengono fornite firme, verrà inserita la firma predefinita nell’angolo in alto a sinistra.\n\n### Conservazione dei documenti e dei dati nel sistema:\n I dettagli della firma dati strutturati e la traccia di audit saranno conservati nel sistema per un massimo di 10 anni.\n I documenti firmati, quelli caricati e quelli convalidati rimarranno nel sistema per un massimo di 3 mesi per consentirne il download.\n Trascorso questo periodo, i documenti verranno automaticamente eliminati.","operationId":"post_EU_SES","requestBody":{"description":"Payload per creare una nuova richiesta SES.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EU-SES_POST"}}},"required":true},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"$ref":"#/components/requestBodies/SignatureCallback"},"responses":{"200":{"description":"Richiamata riuscita"},"400":{"description":"Dati inseriti non validi"}}}}}},"responses":{"200":{"$ref":"#/components/responses/EU-SES200"},"422":{"description":"Eccezione di convalida. Questo errore si verifica se il corpo della richiesta non supera la convalida semantica. Tra le cause più comuni figurano:\n- L'array 'signers' manca o è vuoto.\n- Il campo 'inputDocuments' manca.\n- È stato fornito un oggetto 'callback', ma è malformato.\n- All’interno dell’oggetto «options» è stato passato un valore non valido oppure l’oggetto «options» non è stato passato affatto.\n","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"message":{"type":"string","description":"Uno o più parametri non sono validi"},"error":{"type":"integer","description":"Codice di errore interno"}}},"examples":{"EmptySigners":{"summary":"L'array dei firmatari è vuoto","value":{"success":false,"message":"array 'signers' is empty","error":610}},"MissingSigners":{"summary":"Manca l'array dei firmatari","value":{"success":false,"message":"array 'signers' required","error":685}},"MissingInputDocuments":{"summary":"Documenti di input mancanti","value":{"success":false,"message":"inputDocuments required","error":610}},"MalformedCallback":{"summary":"Oggetto di callback non valido","value":{"success":false,"message":"malformed 'url' parameter, must be a valid url in 'callback'","error":704}}}}}}}}},"/verify":{"post":{"tags":["Signatures"],"summary":"Verifica una firma","description":"Verifica la firma caricando il documento firmato. Il sistema fornirà il risultato della verifica.","operationId":"post_verify","requestBody":{"description":"Verifica la firma caricando il documento firmato.","content":{"application/json":{"schema":{"type":"object","required":["inputDocument"],"properties":{"inputDocument":{"type":"string","format":"base64","description":"Documento firmato","example":"BASE64string"},"detachedContent":{"type":"string","format":"base64","description":"Contenuto \"detached\"","example":"BASE64string"},"pdfEncryptionPassword":{"type":"string","description":"Password per la crittografia del PDF","example":"password123"},"recursive":{"type":"boolean","description":"Verifica ricorsiva","example":true},"verifyOnDate":{"type":"string","format":"date","description":"Data di verifica della firma","example":"2025-02-14"}}}}}},"responses":{"200":{"description":"Operazione riuscita","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"Risultato della verifica","properties":{"checkDate":{"type":"string","description":"Data della verifica","example":"2025-02-14 11:11:01.892+00:00"},"verificationDate":{"type":"string","description":"Data della verifica","example":"2025-02-14 11:11:01.892+00:00"},"signatureFormat":{"type":"string","description":"Formato della firma","example":"PAdES"},"nrOfSignatures":{"type":"integer","description":"Numero di firme","example":1},"overallVerified":{"type":"boolean","description":"Risultato complessivo della verifica","example":true},"signatureReportList":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID della firma","example":"0"},"integrity":{"type":"boolean","description":"Risultato della verifica dell'integrità","example":true},"signatureAlgorithmName":{"type":"string","description":"Nome dell'algoritmo di firma","example":"SHA256withRSA"},"subjectDN":{"type":"string","description":"Oggetto: DN","example":"C=IT,SURNAME=ROSSI,GIVENNAME=MARIO,SERIALNUMBER=TINIT-RSSMRA73R02H501H,CN=ROSSI MARIO,DNQ=AUSL2023021972028357"},"issuerDN":{"type":"string","description":"DN dell'emittente","example":"C=IT,O=Namirial S.p.A./02046570426,OU=Certification Authority,CN=Namirial CA Firma Qualificata"},"subjectCN":{"type":"string","description":"Oggetto: Nome comune","example":"ROSSI MARIO"},"issuerCN":{"type":"string","description":"Nome comune dell'emittente","example":"Namirial CA Firma Qualificata"},"serialNumber":{"type":"string","description":"Numero di serie","example":"5557601230250214000"},"signerCertificateStatus":{"type":"string","description":"Stato del certificato del firmatario","example":"VALID"},"signerCertificateNotBefore":{"type":"string","description":"Certificato del firmatario non anteriore a","example":"2025-02-14 11:11:01.892+00:00"},"signerCertificateNotAfter":{"type":"string","description":"Certificato del firmatario non successivo a","example":"2025-02-14 11:11:01.892+00:00"},"signerCertificateRevocationDate":{"type":"string","description":"Data di revoca del certificato del firmatario","example":"2025-02-14 11:11:01.892+00:00"},"issuerCertificateStatus":{"type":"string","description":"Stato del certificato dell'emittente","example":"VALID"},"issuerCertificateRevocationDate":{"type":"string","description":"Data di revoca del certificato dell'emittente","example":"2025-02-14 11:11:01.892+00:00"},"trustedSignatureDate":{"type":"boolean","description":"La data della firma attendibile indica se la data della firma (signatureDate) è considerata attendibile da un'autorità di certificazione (Trusted Authority) tramite un certificato di marcatura temporale standard","example":false},"signatureDate":{"type":"string","description":"Data della firma","example":"2025-02-14 11:11:01.892+00:00"},"issuerTrustedList":{"type":"boolean","description":"L'emittente è presente nell'elenco dei soggetti affidabili","example":true},"keySize":{"type":"integer","description":"Dimensione della chiave di crittografia","example":2048},"qcComplianceStatus":{"type":"string","description":"Stato di conformità al controllo qualità","example":"VALID"},"qcSSCDStatus":{"type":"string","description":"Stato QC SSCD","example":"VALID"},"derEncodedSignerCert":{"type":"string","format":"base64","description":"Certificato del firmatario codificato in formato DER","example":"BASE64string"}}}},"noteReportList":{"type":"array","items":{"type":"object","properties":{"policy":{"type":"integer","description":"ID della politica","example":3},"about":{"type":"integer","description":"Informazioni su Id","example":2},"type":{"type":"integer","description":"Type Id","example":1},"synopsis":{"type":"string","description":"Sinossi","example":"Certified qualified in conformity"},"description":{"type":"string","description":"Descrizione","example":"The qualified certificate of ROSSI MARIO complies with European Directive 1999/93/EC"}}}},"plainDocument":{"type":"string","format":"base64","description":"Documento semplice","example":"BASE64string"}}},"message":{"type":"string","description":"Messaggio","example":"Signature is valid"},"error":{"type":"string","nullable":true,"description":"Codice di errore","example":""},"success":{"type":"boolean","description":"Esito positivo dell'intervento","example":true}}}}}},"400":{"description":"Dati inseriti non validi"},"422":{"description":"Eccezione di convalida"}}}},"/signatures/{id}":{"delete":{"tags":["Signatures"],"summary":"Eliminare il documento firmato, i dettagli, la traccia di audit e il documento convalidato relativi a una firma","operationId":"delete_signatures__id_","parameters":[{"name":"id","in":"path","description":"ID della firma","required":true,"schema":{"type":"string"},"example":"67af24c5af9b55291406e946"}],"responses":{"200":{"description":"Eliminato"},"400":{"description":"Dati inseriti non validi"},"404":{"description":"Firma non trovata"}}}}},"components":{"securitySchemes":{"bearerAuth":{"description":"Inserisci qui il token generato tramite il servizio OAUTH.
Ricordati di specificare gli scopes che intendi utilizzare.
Le scopes sono stringhe che indicano quale endpoint intendi abilitare, composte secondo il seguente schema:
HTTP_METHOD:API_DOMAIN/RESOURCE_PATH
esempio: POST:esignature.openapi.com/EU-QES_automatic","type":"http","scheme":"bearer"}},"schemas":{"CertificateNamirial_POST":{"type":"object","properties":{"certificateOwner":{"type":"string","description":"Nome del titolare del certificato","example":"John Doe"},"customReference":{"type":"string","description":"Riferimento personalizzato per il certificato, utile per la tracciabilità interna","example":"MyCustomReference#123"},"callback":{"$ref":"#/components/schemas/Callback"}}},"CertificateOwnerErrorResponse400":{"type":"object","properties":{"status":{"type":"integer","example":400},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"errorCode":{"type":"integer"},"message":{"type":"string"}}}}}},"CertificateCallbackPayload":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"ID univoco del certificato richiesto","example":"6998248978fa105687021c12"},"certificateType":{"type":"string","description":"Type di certificato richiesto","enum":["EU-QES_automatic","EU-QES_otp"],"example":"EU-QES_automatic"},"state":{"type":"string","description":"Stato finale del certificato","example":"DONE"},"certificateLink":{"type":"string","format":"uri","description":"URL da seguire per start la procedura di autenticazione ai fini dell'attribuzione del certificato","example":"https://example.com/certificates?voucher=6ef5a10d862a9deee9e1"},"certificateOwner":{"type":"object","properties":{"owner":{"type":"string","example":"John Doe"},"customReference":{"type":"string","example":"MyCustomReference#123"}}},"createdAt":{"type":"string","format":"date-time","example":"2026-02-20 09:08:25.032+00:00"},"expireAt":{"type":"string","format":"date-time","example":"2027-02-20 09:08:25.000+00:00"}}},"custom":{"type":"object","nullable":true,"description":"Dati personalizzati inviati dal client nella richiesta originale","example":null}}},"SignatureListElement":{"type":"object","properties":{"id":{"type":"string","description":"ID della firma","example":"67af24c5af9b55291406e946"},"updatedAt":{"type":"string","description":"Data e ora dell'ultimo aggiornamento","example":"2025-02-14 11:11:01.892+00:00"},"createdAt":{"type":"string","description":"Data e ora di creazione","example":"2025-02-14 11:11:01.892+00:00"},"documentTitle":{"type":"string","description":"Titolo del documento","example":"MyDocument Title"},"certificateType":{"type":"string","description":"Type di certificato","example":"EU-QES_automatic","enum":["EU-QES_automatic","EU-QES_remote_otp"]},"signatureType":{"type":"string","description":"Type of signature","example":"pades","enum":["cades","pades","xades","pkcs1"]},"state":{"type":"string","description":"Stato della firma","example":"DONE","enum":["WAIT_VALIDATION","WAIT_SIGN","DONE","ERROR"]},"errorNumber":{"type":"integer","nullable":true,"description":"Numero dell'errore","example":0},"errorMessage":{"type":"string","nullable":true,"description":"Messaggio di errore","example":"Wrong Certificate Credentials"}}},"CertificateListObject":{"type":"object","properties":{"id":{"type":"string","description":"ID del certificato","example":"67af24c5af9b55291406e946"},"certificateOwner":{"type":"string","description":"Nome del titolare del certificato","example":"John Doe"},"customReference":{"type":"string","description":"Riferimento personalizzato per il certificato","example":"MyCustomReference#123"},"certificateType":{"type":"string","description":"Type di certificato","example":"EU-QES_automatic","enum":["EU-QES_automatic","EU-QES_otp"]},"createdAt":{"type":"string","description":"Data e ora di creazione","example":"2025-02-14 11:11:01.892+00:00"},"expireAt":{"type":"string","description":"Data e ora di scadenza del certificato","example":"2025-02-14 11:11:01.892+00:00"},"state":{"type":"string","description":"Stato del certificato","example":"NEW","enum":["NEW","EXPIRED","SUSPENDED"]},"certificateLink":{"type":"string","format":"uri","description":"URL per start la procedura di attribuzione del certificato","example":"https://my-domain.com/certificate.html"}}},"CertificateObject":{"type":"object","properties":{"id":{"type":"string","description":"ID del certificato","example":"67af24c5af9b55291406e946"},"certificateOwner":{"type":"string","description":"Nome del titolare del certificato","example":"John Doe"},"customReference":{"type":"string","description":"Riferimento personalizzato per il certificato","example":"MyCustomReference#123"},"certificateType":{"type":"string","description":"Type di certificato","example":"EU-QES_automatic","enum":["EU-QES_automatic","EU-QES_otp"]},"createdAt":{"type":"string","description":"Data e ora di creazione","example":"2025-02-14 11:11:01.892+00:00"},"expireAt":{"type":"string","description":"Data e ora di scadenza del certificato","example":"2025-02-14 11:11:01.892+00:00"},"state":{"type":"string","description":"Stato del certificato","example":"NEW","enum":["NEW","EXPIRED","SUSPENDED"]},"certificateLink":{"type":"string","format":"uri","description":"URL per start la procedura di attribuzione del certificato","example":"https://my-domain.com/certificate.html"},"callback":{"$ref":"#/components/schemas/Callback"}}},"SignatureObject":{"type":"object","properties":{"id":{"type":"string","description":"ID della firma","example":"67af24c5af9b55291406e946"},"updatedAt":{"type":"string","description":"Data e ora dell'ultimo aggiornamento","example":"2025-02-14 11:11:01.892+00:00"},"createdAt":{"type":"string","description":"Data e ora di creazione","example":"2025-02-14 11:11:01.892+00:00"},"certificateType":{"type":"string","description":"Type di certificato","example":"EU-QES_automatic","enum":["EU-QES_automatic"]},"signatureType":{"type":"string","description":"Type of signature","example":"pades","enum":["cades","pades","xades","pkcs1"]},"state":{"type":"string","description":"Stato della firma","example":"DONE","enum":["WAIT_VALIDATION","WAIT_SIGN","DONE","ERROR"]},"options":{"type":"object","description":"Opzioni aggiuntive per la firma","properties":{"asyncDocumentsValidation":{"type":"boolean","description":"Se convalutare i documenti in modo asincrono","example":true},"asyncSignature":{"type":"boolean","description":"Se firmare i documenti in modo asincrono","example":false},"level":{"type":"string","description":"Livello della firma","example":"B"},"hashAlgorithm":{"type":"string","description":"Algoritmo di hash","example":"SHA256"},"encryptInAnyCase":{"type":"boolean","description":"Crittografare in ogni caso","example":false},"page":{"type":"integer","description":"Numero di pagina su cui apporre la firma","example":1},"withSignatureField":{"type":"boolean","description":"Includi il campo della firma","example":false}}},"errorNumber":{"type":"integer","nullable":true,"description":"Numero dell'errore","example":0},"errorMessage":{"type":"string","nullable":true,"description":"Messaggio di errore","example":"Wrong Certificate Credentials"},"document":{"type":"object","description":"Documento da firmare","properties":{"title":{"type":"string","description":"Titolo del documento","example":"MyDocument Title"},"description":{"type":"string","description":"Descrizione del documento","example":""},"inputDocuments":{"type":"array","items":{"type":"object","properties":{"sourceType":{"type":"string","description":"Type of source of the document","enum":["remote","base64"],"example":"base64"},"createdAt":{"type":"string","description":"Data e ora di creazione","example":"2025-02-14 11:12:33.819+00:00"},"mimetype":{"type":"string","description":"Type MIME del documento","example":"application/pdf"},"extension":{"type":"string","description":"Estensione del documento","example":"pdf"},"size":{"type":"integer","description":"Dimensioni del documento","example":339},"id":{"type":"string","description":"ID del documento","example":"67af252164f60538280f70fb"},"md5":{"type":"string","description":"Hash MD5 del documento","example":"694be78a9eaa52d602bec92e211fa5dc"},"sha256":{"type":"string","description":"Hash SHA256 del documento","example":"2d456324422c6fc66b6f4fe70a63a43f4deae7f87b16c0c117a085c37e50d39e"},"name":{"type":"string","description":"Nome del file del documento","example":"694be78a9eaa52d602bec92e211fa5dc.pdf"}}}},"validatedDocument":{"type":"object","description":"Documento convalidato","properties":{"mimetype":{"type":"string","description":"Type MIME del documento","example":"application/pdf"},"extension":{"type":"string","description":"Estensione del documento","example":"pdf"},"size":{"type":"integer","description":"Dimensioni del documento","example":339},"createdAt":{"type":"string","description":"Data e ora di creazione","example":"2025-02-14 11:12:33.819+00:00"},"id":{"type":"string","description":"ID del documento","example":"67af252164f60538280f70fb"},"md5":{"type":"string","description":"Hash MD5 del documento","example":"694be78a9eaa52d602bec92e211fa5dc"},"fileInfo":{"$ref":"#/components/schemas/DocumentFileInfo"},"name":{"type":"string","description":"Nome del file del documento","example":"694be78a9eaa52d602bec92e211fa5dc.pdf"}}},"signedDocument":{"type":"object","description":"Documento firmato","properties":{"createdAt":{"type":"string","description":"Data e ora di creazione","example":"2025-02-14 11:12:34.229+00:00"},"mimetype":{"type":"string","description":"Type MIME del documento","example":"application/pdf"},"extension":{"type":"string","description":"Estensione del documento","example":"pdf"},"size":{"type":"integer","description":"Dimensioni del documento","example":50133},"id":{"type":"string","description":"ID del documento","example":"67af252264f60538280f70fe"},"md5":{"type":"string","description":"Hash MD5 del documento","example":"363cfdb141fe0e1a3f598e1d6377a4f5"},"sha256":{"type":"string","description":"Hash SHA256 del documento","example":"9e093c7fc456cdfe89e9b75d06b4e4a65e943856694136f162ee3d7f53d97361"},"name":{"type":"string","description":"Nome del file del documento","example":"67af252164f60538280f70f9.pdf"}}}}}}},"EU-QES_POST":{"anyOf":[{"required":["inputDocuments","certificateUsername","certificatePassword"]},{"required":["inputDocuments","certificateUsername","certificatePassword","certificateOtp"]}],"type":"object","properties":{"inputDocuments":{"$ref":"#/components/schemas/InputDocuments"},"certificateUsername":{"type":"string","description":"Nome utente per il certificato: è necessario utilizzare il nome del dispositivo che hai ricevuto. Inizia con: RHI (/EU-QES_otp), SHI (/EU-QES_eseal) o AHI (/EU-QES_automatic)","example":"openapiSandboxUsername"},"certificatePassword":{"type":"string","description":"Password per il certificato: è necessario utilizzare il PIN associato al nome del dispositivo (impostabile dal cliente o ricavabile dalla busta sigillata)","example":"openapiSandboxPassword"},"certificateOtp":{"type":"string","description":"VALIDO SOLO PER l'endpoint /EU-QES_otp, è OBBLIGATORIO e può essere ottenuto tramite l'apposita app OTP fornita dall'autorità di certificazione. L'OTP generato dall'app ha un TTL di 30 secondi, pertanto deve essere inviato prima della scadenza.","example":"123456"},"certificateIdOtp":{"type":"integer","description":"VALIDO SOLO PER l'endpoint /EU-QES_otp; è facoltativo e viene utilizzato nel caso in cui nell'app dell'autorità di certificazione siano impostati più codici OTP. È possibile trovarlo nella sezione in alto a destra dell'app OTP.","example":-1},"title":{"type":"string","description":"Titolo della firma","example":"My signature title"},"description":{"type":"string","description":"Descrizione della firma","example":"My signature long description"},"signatureType":{"type":"string","description":"Type di firma. Può essere cades, pades, xades, pkcs1","example":"pades","enum":["cades","pades","xades","pkcs1"]},"options":{"type":"object","description":"Opzioni aggiuntive per la firma. Le opzioni disponibili dipendono dal `signatureType`:\n\n- **Opzioni comuni**:\n - `asyncDocumentsValidation` (booleano): se convalidare i documenti in modo asincrono. Impostazione predefinita: `false`.\n - `asyncSignature` (booleano): se firmare i documenti in modo asincrono. Impostazione predefinita: `false`.\n- **Opzioni PAdES**:\n - `level` (stringa): livello di firma. Valori: `B`, `T`, `LT`, `LTA`, `LTV`. Impostazione predefinita: `B`.\n - `hashAlgorithm` (stringa): algoritmo di hash. Valori: `SHA1`, `SHA256`, `SHA384`, `SHA512`. Impostazione predefinita: `SHA256`.\n - `encryptInAnyCase` (booleano): Crittografa in ogni caso. Impostazione predefinita: `false`.\n - `page` (numero intero): numero della pagina da firmare. Impostazione predefinita: `1`.\n - `encryptionPassword` (stringa): password per la crittografia del PDF. Impostazione predefinita: `null`.\n - `signerImage` (stringa): immagine del firmatario. Impostazione predefinita: `null`.\n - `lockFields` (stringa): campi da bloccare. Impostazione predefinita: `null`.\n - `withSignatureField` (booleano): include il campo della firma. Valore predefinito: `false`.\n - `withTimestamp` (booleano): include il timestamp. Valore predefinito: `false`.\n - `timestampUrl` (stringa): URL del servizio di timestamp. Valore predefinito: `null`.\n - `timestampUsername` (stringa): nome utente per il servizio di marcatura temporale. Valore predefinito: `null`.\n - `timestampPassword` (stringa): password per il servizio di marcatura temporale. Valore predefinito: `null`.\n - `timestampHashAlgo` (stringa): Algoritmo di hash per il servizio di timestamp. Valori: `SHA1`, `SHA256`, `SHA384`, `SHA512`. Impostazione predefinita: `SHA256`.\n- **Opzioni CAdES**:\n - `detached` (booleano): Firma distaccata. Impostazione predefinita: `false`.\n - `level` (stringa): Livello di firma. Valori: `B`, `T`, `LT`, `LTA`, `LTV`. Impostazione predefinita: `B`.\n - `hashAlgorithm` (stringa): Algoritmo di hash. Valori: `SHA1`, `SHA256`, `SHA384`, `SHA512`. Impostazione predefinita: `SHA256`.\n - `counterSignature` (booleano): Firma di controllo. Impostazione predefinita: `false`.\n - `withTimestamp` (booleano): include il timestamp. Impostazione predefinita: `false`.\n - `timestampUrl` (stringa): URL del servizio di timestamp. Impostazione predefinita: `null`.\n - `timestampUsername` (stringa): nome utente per il servizio di marcatura temporale. Impostazione predefinita: `null`.\n - `timestampPassword` (stringa): password per il servizio di marcatura temporale. Impostazione predefinita: `null`.\n - `timestampHashAlgo` (stringa): Algoritmo di hash per il servizio di marcatura temporale. Valori: `SHA1`, `SHA256`, `SHA384`, `SHA512`. Impostazione predefinita: `SHA256`.\n- **Opzioni XAdES**:\n - `level` (stringa): Livello di firma. Valori: `B`, `T`, `LT`, `LTA`, `LTV`. Impostazione predefinita: `B`.\n - `hashAlgorithm` (stringa): Algoritmo di hash. Valori: `SHA1`, `SHA256`, `SHA384`, `SHA512`. Impostazione predefinita: `SHA256`.\n - \"detached\" (booleano): Firma distaccata. Predefinito: `false`.\n - `withoutSignatureExclusion` (booleano): Senza esclusione della firma. Predefinito: `false`.\n - `XPathQuery` (stringa): query XPath. Impostazione predefinita: `null`.\n - `signElement` (stringa): elemento da firmare. Impostazione predefinita: `null`.\n - `signatureId` (stringa): ID della firma. Impostazione predefinita: `null`.\n - `withTimestamp` (booleano): include il timestamp. Impostazione predefinita: `false`.\n - `timestampUrl` (stringa): URL del servizio di timestamp. Impostazione predefinita: `null`.\n - `timestampUsername` (stringa): nome utente per il servizio di timestamp. Valore predefinito: `null`.\n - `timestampPassword` (stringa): password per il servizio di timestamp. Valore predefinito: `null`.\n - `timestampHashAlgo` (stringa): Algoritmo di hash per il servizio di timestamp. Valori: `SHA1`, `SHA256`, `SHA384`, `SHA512`. Valore predefinito: `SHA256`.\n- **Opzioni PKCS1**:\n - `hashAlgorithm` (stringa): Algoritmo di hash. Valori: `SHA1`, `SHA256`, `SHA384`, `SHA512`. Valore predefinito: `SHA256`.","properties":{"asyncDocumentsValidation":{"type":"boolean","description":"Se convalutare i documenti in modo asincrono, utile per file di grandi dimensioni e per l'elaborazione in batch.\n\nIl sistema restituirà lo stato WAIT_VALIDATION e invierà una callback al completamento del processo di firma o qualora il documento non fosse valido.","example":true,"default":false},"asyncSignature":{"type":"boolean","description":"Possibilità di firmare i documenti in modo asincrono, utile per file di grandi dimensioni e per l'elaborazione in batch.\n\nIl sistema restituirà lo stato WAIT_SIGN e invierà una callback al completamento del processo di firma.","example":false,"default":false},"level":{"type":"string","description":"Livello di firma: B (Base), T (Temporale), LT (A lungo termine), LTA (Archivio a lungo termine), LTV (Convalida a lungo termine)\n\n - `B` Nel file firmato vengono aggiunti la firma elettronica e il certificato di firma. (Pades, Cades, Xades)\n - `T` Come il livello B, ma aggiunge un timestamp, ovvero un contrassegno temporale che attesta l’esistenza della firma in una determinata data e ora.\t(Pades, Cades, Xades)\n - `LT` Come il livello T, ma aggiunge dati VRI (Verification Related Information) al DSS (a lungo termine). (Pades, Cades, Xades)\n - `LTA` Simile al livello LT, ma aggiunge un documento di timbro temporale e dati VRI per la TSA (Time Stamping Authority). Un LTA può aiutare a convalidare la firma al di là di qualsiasi evento che possa limitarne la validità (Long Term con timbri temporali d’archivio). (Pades, Cades, Xades)\n - `LTV` (Convalida a lungo termine) contiene la risposta OCSP/CRL successiva alla firma. Viene utilizzato per la convalida dopo la scadenza del certificato di firma. (Pades)","example":"B","enum":["B","T","LT","LTA","LTV"],"default":"B"},"hashAlgorithm":{"type":"string","description":"L'algoritmo che si desidera utilizzare per la firma.","example":"SHA256","enum":["SHA1","SHA256","SHA384","SHA512"],"default":"SHA256"},"encryptInAnyCase":{"type":"boolean","description":"Crittografare in ogni caso","example":false,"default":false},"page":{"type":"integer","description":"Indicare il numero di pagina su cui si desidera applicare lo stile della firma. Se si desidera aggiungere lo stile all'ultima pagina del file PDF, è necessario impostare il valore \"-1\".","example":1,"default":1},"encryptionPassword":{"type":"string","description":"Specificare la password del PDF, se presente.","example":"password123"},"signerImage":{"type":"object","description":"Immagine del firmatario","properties":{"image":{"type":"string","description":"Dati dell'immagine del firmatario codificati in Base64.","example":"BASE64string"},"imageUrl":{"type":"string","description":"URL dell'immagine del firmatario.","example":"https://example.com/signerImage.png"},"signerName":{"type":"string","description":"Nome del firmatario da visualizzare sull'immagine.","example":"John Doe"},"location":{"type":"string","description":"Posizione del firmatario da visualizzare sull'immagine.","example":"New York, USA"},"reason":{"type":"string","description":"Motivo della firma.","example":"Contract"},"signerEmail":{"type":"string","description":"Indirizzo e-mail del firmatario da visualizzare sull'immagine.","example":"john.doe@example.com"},"imageVisible":{"type":"boolean","description":"Se l'immagine debba essere visibile nella firma.","example":true,"default":true},"width":{"type":"integer","description":"Larghezza dell'immagine in pixel.","example":164,"default":164},"height":{"type":"integer","description":"Altezza dell'immagine in pixel.","example":45,"default":45},"fieldsNameList":{"type":"array","items":{"type":"string"},"description":"Elenco dei nomi dei campi in cui deve essere inserita l'immagine.","example":["field1","field2"]},"signAllFields":{"type":"boolean","description":"Se inserire l'immagine in tutti i campi.","example":false,"default":false}}},"lockFields":{"type":"string","description":"Campi da bloccare","example":"field1,field2"},"withSignatureField":{"type":"boolean","description":"Impostare su \"true\" se si desidera applicare la firma nel campo \"Firma\" del file PDF.","example":false,"default":false},"detached":{"type":"boolean","description":"Firma \"detached\". Impostare su \"true\" se si desidera che la firma e i file siano contenuti in due file distinti. L'output sarà la firma.","example":false,"default":false},"withoutSignatureExclusion":{"type":"boolean","description":"L'opzione \"Senza esclusione della firma\" consente di firmare il file con o senza una firma precedente.","example":false,"default":false},"XPathQuery":{"type":"string","description":"Consente di firmare un percorso specificato di un file XML.","example":"query"},"signElement":{"type":"string","description":"Consente di specificare l'“Id” nel file XML che si desidera firmare.","example":"element"},"signatureId":{"type":"string","description":"Consente di specificare l'“Id” della firma.","example":"id"},"counterSignature":{"type":"boolean","description":"La controfirma serve a firmare un documento .p7m già firmato.","example":false,"default":false},"timezone":{"$ref":"#/components/schemas/Timezones"},"withTimestamp":{"type":"boolean","description":"Includi timestamp. Se il valore è true e sono impostati i parametri timestampUrl, timestampUsername e timestampPassword, il sistema aggiungerà un timestamp alla firma. Se il valore è true ma gli altri parametri relativi al timestamp non sono impostati, il sistema apporrà comunque il timestamp addebitandone il costo sul wallet. (Per ulteriori dettagli, consultare prezzi)","example":false,"default":false},"timestampUrl":{"type":"string","description":"URL del servizio di marcatura temporale","example":"https://my-domain.com/timestamp"},"timestampUsername":{"type":"string","description":"Nome utente per il servizio di marcatura temporale","example":"CC123456"},"timestampPassword":{"type":"string","description":"Password per il servizio di marcatura temporale","example":"password123"}}},"callback":{"$ref":"#/components/schemas/Callback"}}},"EU-SES_POST":{"type":"object","description":"Definizione della richiesta SES.","properties":{"signers":{"type":"array","description":"Elenco dei firmatari. Ne occorre almeno uno.","items":{"type":"object","properties":{"name":{"type":"string","description":"Nome del firmatario.","example":"Mario"},"surname":{"type":"string","description":"Cognome del firmatario.","example":"Rossi"},"email":{"type":"string","format":"email","description":"Indirizzo e-mail a cui verrà inviato il codice OTP (se il metodo di autenticazione scelto è \"e-mail\").","example":"mario_rossi@example.com"},"mobile":{"type":"string","description":"Numero di cellulare al quale verrà inviato il codice OTP (se il metodo di autenticazione scelto è \"sms\"). Deve rispettare il formato E.164.","example":"+393334455666"},"message":{"type":"string","description":"Un messaggio personalizzato da inviare al firmatario. Se il messaggio include il segnaposto {OTP}, questo verrà sostituito dall'OTP effettivo. In caso contrario, il codice OTP verrà aggiunto alla fine del messaggio. **Nota**: per i messaggi SMS, la lunghezza massima consentita è di 160 caratteri (OTP o relativo segnaposto inclusi). Ogni richiesta viene analizzata per verificare che sia conforme al **formato E.164**; se nel corpo del messaggio vengono rilevate parole vietate, la richiesta verrà respinta.","example":"Hello Mario, this is your OTP code: "},"authentication":{"type":"array","description":"Metodi di autenticazione utilizzati.","items":{"type":"string","enum":["email","sms"]},"example":["email"]},"signatures":{"type":"array","description":"Elenco di tutte le firme per ciascun firmatario. Se omesso o vuoto, verrà creato un unico campo per la firma in alto a sinistra.","items":{"type":"object","properties":{"page":{"type":"integer","description":"Numero di pagina in cui è presente questo singolo campo di firma. Le pagine vanno da 1 a N.","example":1},"x":{"type":"string","description":"Coordinata X a partire dalla sinistra.","example":"331"},"y":{"type":"string","description":"Coordinata Y misurata dall'alto.","example":"45"},"name":{"type":"string","description":"L'identificatore del campo della firma singola già presente nel PDF."}},"required":["page","x","y"]}},"language":{"type":"string","description":"La lingua del firmatario. Verrà utilizzata per l'e-mail e per l'interfaccia di firma.","enum":["it","en","fr","de","es","pt","ro","zh","ru","ar","browser"],"default":"browser","example":"it"}},"required":["name","surname","authentication","signatures"]},"minItems":1},"inputDocuments":{"description":"Uno o più documenti PDF da firmare. Possono essere rappresentati sia come array di dati in formato base64 sia come URL.","oneOf":[{"type":"string","format":"uri","description":"Verrà recuperato l'URL contenuto nel PDF.","example":"JVBERi0xLjQKJZOMi54gUmVwb3J0TGFiIEdlbmVyYXRlZCBQREYgZG9jdW1lbnQgaHR0cDovL3d3dy5yZXBvcnRsYWIuY29tCjEgMCBvYmoKPDwKL0YxIDIgMCBSIC9GMiAzIDAgUgo+PgplbmRvYmoKMiAwIG9iago8PAovQmFzZUZvbnQgL0hlbHZldGljYSAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZyAvTmFtZSAvRjEgL1N1YnR5cGUgL1R5cGUxIC9UeXBlIC9Gb250Cj4+CmVuZG9iagozIDAgb2JqCjw8Ci9CYXNlRm9udCAvSGVsdmV0aWNhLUJvbGQgL0VuY29kaW5nIC9XaW5BbnNpRW5jb2RpbmcgL05hbWUgL0YyIC9TdWJ0eXBlIC9UeXBlMSAvVHlwZSAvRm9udAo+PgplbmRvYmoKNCAwIG9iago8PAovQ29udGVudHMgMTIgMCBSIC9NZWRpYUJveCBbIDAgMCA1OTUuMjc1NiA4NDEuODg5OCBdIC9QYXJlbnQgMTEgMCBSIC9SZXNvdXJjZXMgPDwKL0ZvbnQgMSAwIFIgL1Byb2NTZXQgWyAvUERGIC9UZXh0IC9JbWFnZUIgL0ltYWdlQyAvSW1hZ2VJIF0KPj4gL1JvdGF0ZSAwIC9UcmFucyA8PAoKPj4gCiAgL1R5cGUgL1BhZ2UKPj4KZW5kb2JqCjUgMCBvYmoKPDwKL0NvbnRlbnRzIDEzIDAgUiAvTWVkaWFCb3ggWyAwIDAgNTk1LjI3NTYgODQxLjg4OTggXSAvUGFyZW50IDExIDAgUiAvUmVzb3VyY2VzIDw8Ci9Gb250IDEgMCBSIC9Qcm9jU2V0IFsgL1BERiAvVGV4dCAvSW1hZ2VCIC9JbWFnZUMgL0ltYWdlSSBdCj4+IC9Sb3RhdGUgMCAvVHJhbnMgPDwKCj4+IAogIC9UeXBlIC9QYWdlCj4+CmVuZG9iago2IDAgb2JqCjw8Ci9Db250ZW50cyAxNCAwIFIgL01lZGlhQm94IFsgMCAwIDU5NS4yNzU2IDg0MS44ODk4IF0gL1BhcmVudCAxMSAwIFIgL1Jlc291cmNlcyA8PAovRm9udCAxIDAgUiAvUHJvY1NldCBbIC9QREYgL1RleHQgL0ltYWdlQiAvSW1hZ2VDIC9JbWFnZUkgXQo+PiAvUm90YXRlIDAgL1RyYW5zIDw8Cgo+PiAKICAvVHlwZSAvUGFnZQo+PgplbmRvYmoKNyAwIG9iago8PAovQ29udGVudHMgMTUgMCBSIC9NZWRpYUJveCBbIDAgMCA1OTUuMjc1NiA4NDEuODg5OCBdIC9QYXJlbnQgMTEgMCBSIC9SZXNvdXJjZXMgPDwKL0ZvbnQgMSAwIFIgL1Byb2NTZXQgWyAvUERGIC9UZXh0IC9JbWFnZUIgL0ltYWdlQyAvSW1hZ2VJIF0KPj4gL1JvdGF0ZSAwIC9UcmFucyA8PAoKPj4gCiAgL1R5cGUgL1BhZ2UKPj4KZW5kb2JqCjggMCBvYmoKPDwKL0NvbnRlbnRzIDE2IDAgUiAvTWVkaWFCb3ggWyAwIDAgNTk1LjI3NTYgODQxLjg4OTggXSAvUGFyZW50IDExIDAgUiAvUmVzb3VyY2VzIDw8Ci9Gb250IDEgMCBSIC9Qcm9jU2V0IFsgL1BERiAvVGV4dCAvSW1hZ2VCIC9JbWFnZUMgL0ltYWdlSSBdCj4+IC9Sb3RhdGUgMCAvVHJhbnMgPDwKCj4+IAogIC9UeXBlIC9QYWdlCj4+CmVuZG9iago5IDAgb2JqCjw8Ci9QYWdlTW9kZSAvVXNlTm9uZSAvUGFnZXMgMTEgMCBSIC9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagoxMCAwIG9iago8PAovQXV0aG9yIChcKGFub255bW91c1wpKSAvQ3JlYXRpb25EYXRlIChEOjIwMjUxMjE3MTUyMjI0KzAwJzAwJykgL0NyZWF0b3IgKFwodW5zcGVjaWZpZWRcKSkgL0tleXdvcmRzICgpIC9Nb2REYXRlIChEOjIwMjUxMjE3MTUyMjI0KzAwJzAwJykgL1Byb2R1Y2VyIChSZXBvcnRMYWIgUERGIExpYnJhcnkgLSB3d3cucmVwb3J0bGFiLmNvbSkgCiAgL1N1YmplY3QgKFwodW5zcGVjaWZpZWRcKSkgL1RpdGxlIChcKGFub255bW91c1wpKSAvVHJhcHBlZCAvRmFsc2UKPj4KZW5kb2JqCjExIDAgb2JqCjw8Ci9Db3VudCA1IC9LaWRzIFsgNCAwIFIgNSAwIFIgNiAwIFIgNyAwIFIgOCAwIFIgXSAvVHlwZSAvUGFnZXMKPj4KZW5kb2JqCjEyIDAgb2JqCjw8Ci9GaWx0ZXIgWyAvQVNDSUk4NURlY29kZSAvRmxhdGVEZWNvZGUgXSAvTGVuZ3RoIDY0NAo+PgpzdHJlYW0KR2IiLyViQVBjbyddJXEmY0VhKlAxLzs8MS8ucTlMJFA2cDBMQEohSmFRJTomOz4nT2tqInFAQE88RSxfLHFJOGhTOzMrTzstOnVDVlBnXTdxXEYpbCdOQnA0JGFoVjxCSE02TzAob1xHZFRNaShlV2MlW11yO0NpPC9vKm5Hcl8vZ0RCVHRLQnJSJXE9XWUjSGpiNzk2ZjtZVyJSXi1oLGhLSEYpVy06QDtXKW1ZXlRSRGVZXlhpWWVQTUc9LFhJOWZSWk9LcEpdI251dTRBWmE6Yj1WOm5uYEo1RVpKW0dfTXBEIkAsQi89RSdRN0Y4JkJJN3NhWzo4N0VcS1dCNVghLWhUO2UiVCY+cm9BTEljVFFAMyxpJGduYy88N0otR0dYOVpfPmpJNkktQC5kOWJjb3BpXTAoOjA9Iy5CKmFiUEImPl1QO2VPSUgjZG5MJDJHP0g3IVBpbEghai5sP2RCLTQhPFQyJVwrLS9QcnFcMSQnTVkkWiw0bS8iOjptTnMsXj1KJ0ZGLGkwS05uMSFNMmJWaGVEO3FNXDVPIVBPJFtHWVUkU0QzQEcjXmlQJU47LTNEWCZEND5eTSxESmwnVVw9OEFJIkQwLTZYdXBWbTFqUTAwcSsnblI1QXJeQSJGNjNVTmJNQCtQKT43VFJgTl1PI20uPFwpIj51TksrJ2NXTGFbJ2xTQyxgTkZUNEJdX0ooN0VVPExKWyZRYChObjEpXGJnRGxTb2NNVDhnb1tfSTkzamJga0BpLGYzZzYpcWsmUmlbXlxoUWRkQC1qJ24nUD0qcCNUa2hsNzdBKDxuNmtRWFpSUTkjUE0zNV9xLUVqKyFScmEjdTdbOWgjfj5lbmRzdHJlYW0KZW5kb2JqCjEzIDAgb2JqCjw8Ci9GaWx0ZXIgWyAvQVNDSUk4NURlY29kZSAvRmxhdGVEZWNvZGUgXSAvTGVuZ3RoIDY0NAo+PgpzdHJlYW0KR2IiLyViQVBjbyddJXEmY0VhKlAxLzs8MS8ucTlMJFA2cDBMQEohSmFRJTomOz4nT2tqInFAQE88RSxfLHFJOGhTOzMrTzstOnVDVlBnXTdxXEYpbCdOQnA0JGFoVjxCSE02TzAob1xHZFRNaShlV2MlW11yO0NpPC9vKm5Hcl8vZ0RCVHRLQnJSJXE9XWUjSGpiNzk2ZjtZVyJSXi1oLGhLSEYpVy06QDtQY3JJNTVsMkk8SV1qLlMtYjdQOD0+X0gtQixkanNGZDpvdEgoWlJTUV1wUWdpbSI3aUFBTWJIKDdqY144KU9ZaS5HaHFPK2NxTnBQREFSTmpDITViSlUzPVs1I1dnMitBVGJhJVskKitfYFNlKFw0XTFXTVdqXmw9ViRCW2FZc2s5XzxSUk5UbVBXRD8vUz9ZJTtaMU1RTGZrWkguRFUocW5yTWYkZGtqXm9NIitcZTwvUjtlRyVaOEc8ajVEKiZvMDwuc1tCQSctcTkoQFlMUj0jU0tcJXJ1blNzLjIoOFxAPEJsQSIkRFI3Xj0xR2soRi8iIS1lRzduP3FHJGdFX20jRV9nUiNWOUVfNCtnLEE+IzdndGUuN2RdOmBxI148Okw7bGI1Z0ZNLD9AbCwoZjFNUG9GYSNrTkY3ZG1qXjYqKFVNNWxpcEQrKkk4WERTJ0p0KUJCIlA7RVoxLGY0UzhKKW9sRGRHayFyTWluM2tzQk46Pi8qM0RyQVJBMlcwbFRfLE9cUWA/clFGX09KY0kmKVVGWEIsbGMvaVdASiwuJ1JVR1lSLWhrUlMzbGNbW1plUTthL1hmQ14tPidXI1AmKyRFSUxUYWReNT1Bb0wnM1A/Smg+fj5lbmRzdHJlYW0KZW5kb2JqCjE0IDAgb2JqCjw8Ci9GaWx0ZXIgWyAvQVNDSUk4NURlY29kZSAvRmxhdGVEZWNvZGUgXSAvTGVuZ3RoIDY0NAo+PgpzdHJlYW0KR2IiLyViQVBjbyddJXEmY0VhKlAxLzs8MS8ucTlMJFA2cDBMQEohSmFRJTomOz4nT2tqInFAQE88RSxfLHFJOGhTOzMrTzstOnVDVlBnXTdxXEYpbCdOQnA0JGFoVjxCSE02TzAob1xHZFRNaShlV2MlW11yO0NpPC9vKm5Hcl8vZ0RCVHRLQnJSJXE9XWUjSGpiNzk2ZjtZVyJSXi1oLGhLSEYpVy06QDtYQnFWIUpiQ3RYcipDMy86TkUnUFlcSG85YzhKWXBsNzBdcm5qJCYvMC41IVhgTEJCXGFiJVFwLzM7QkVPMilAXTtTN14nNlFkJGstNGVyJmFNSUFNIjgqV0FJJjlYQzViKkZLKj9zMDZMM1lLLkVMMkU5J1tjNWJaNXNeQFAmRFpRSyUyciY2TUosZ10ialg8KVY+QiQvRVtPPm51RCgvcDUma1UoU1hcR2thQipCVyRBblRXVUk1UG1YVUNnMyxoP1c8cTdaYC1WMlowYCFUIlkmMSE/KHMkTCtwO15BU0NfV1tZYCNDJS5NSUFgYmAwMU8jITpUZEtnXmxtJVdqZSouakxBVXU2UWo/QTVadStPJU5Zak47Tjd1SEpuY2VIUiU/NktKW1RDK11gYjctVUJAPWtsTmQzcmpOU1xZRkszMDUkSyojcGc1Ty5TO2dpZ2txMiopKipWMFlKOFkwWElzMk5HYlJuRFxmI2BOZVVwZEFlWz0zRWhuYTFJbDVAZXBnKSdGMThebi9UcSJzU1lKJjRsVik+YlMnMDJfczcyKC43cisuOV5JTidGZXNFLz5XaXU9PD4/MDo5W0lTLysqblhdcSVVWkRFSXUobyItWSQoZWhafj5lbmRzdHJlYW0KZW5kb2JqCjE1IDAgb2JqCjw8Ci9GaWx0ZXIgWyAvQVNDSUk4NURlY29kZSAvRmxhdGVEZWNvZGUgXSAvTGVuZ3RoIDY0NAo+PgpzdHJlYW0KR2IiLyViQVBjbyddJXEmY0VhKlAxLzs8MS8ucTlMJFA2cDBMQEohSmFRJTomOz4nT2tqInFAQE88RSxfLHFJOGhTOzMrTzstOnVDVlBnXTdxXEYpbCdOQnA0JGFoVjxCSE02TzAob1xHZFRNaShlV2MlW11yO0NpPC9vKm5Hcl8vZ0RCVHRLQnJSJXE9XWUjSGpiNzk2ZjtZVyJSXi1oLGhLSEYpVy06QDtYQyVcIkpiQ3RYcipDMy86TkUnUFlcSG85YzhKWXBsNzBdcm5qJCYvMC41IVhgTEJCXGFiJVFwLzM7QkVPMilAXTtTN14nNlFkJGstNGVyJmFNSUFNIjgqV0FJJjlYQzViKkZLKj9zMDZMM1lLLkVMMkU5J1tjNWJaNXNeQFAmRFpRSyUyciY2TUosZ10ialg8KVY+QiQvRVtPPm51RCgvcDUma1UoU1hcR2thQipCVyRBblRXVUk1UG1YVUNnMyxoP1c8cTdaYC1WMlowYCFUIlkmMSE/KHMkTCtwO15BU0NfV1tZYCNDJS5NSUFgYmAwMU8jITpUZEtnXmxtJVdqZSouakxBVXU2UWo/QTVadStPJU5Zak47Tjd1SEpuY2VIUiU/NktKW1RDK11gYjctVUJAPWtsTmQzcmpOU1xZRkszMDUkSyojcGc1Ty5TO2dpZ2txMiopKipWMFlKOFkwWElzMk5HYlJuRFxmI2BOZVVwZEFlWz0zRWhuYTFJbDVAZXBnKSdGMThebi9UcSJzU1lKJjRsVik+YlMnMDJfczcyKC43cisuOV5JTidGZXNFLz5XaXU9PD4/MDo5W0lTLysqblhdcSVVWkRFSXUobyItWixcbGh1fj5lbmRzdHJlYW0KZW5kb2JqCjE2IDAgb2JqCjw8Ci9GaWx0ZXIgWyAvQVNDSUk4NURlY29kZSAvRmxhdGVEZWNvZGUgXSAvTGVuZ3RoIDY0NAo+PgpzdHJlYW0KR2IiLyViQVBjbyddJXEmY0VhKlAxLztaOy8ucTlMJFA2cDBMQEohSmFRJTomOz4nT2tQO0VsRSYwb2MyLHFJOGhTOzMrTzstOnVDcC5vMUxwRHIqUy4mW2Q3IyY3R0ZkNjZMJz5PMy1qVjZfZTRcaC4tP1ZKNklnZXVkLmZIKz5VKm02V18wZG8lJ21aRVQibmI2dUtLWT5dOjpadDddWV4kQlwwOy9eYTBXKloxcEphUERQcipDMy86TkUnUFlcSHI6YzhPMXNDNmk7OTRBWmE6YkohJSRgTEJCXGFiJEZQLzonNjdPMilAXTtTN14nQGl1RjYtNGVyKGA1MXJRIlV1RlpJJjozUzViKkZLNFgvUU5MM1lXMkYuXkkuJ0pcZmlaNXNeQFAmTCUqIktUI2tLSD5CKUZGYyhXMXBSaSk9TyYiW2pBanI9bGswUF4vanU9WGNuZnNiOytHZFNkUCw/TWddOFFXRVN1ZWM/Y2VLZ1QtLV5gJjFcYVY2Jys+PXI9PTFdOjZFPVUkKTwscipvVWkob1VYIW5dR01mITRMbFYwIV9ZalFQXzI6RihgbkYsQGozVXRjbyxVXTNiJDs5MGtpOW9hVlZJOjJEZGlwZmo9M2cpNUc7RVQxS15qM3AkYEcyMG01Kk5GST1XJUxUXjtfa2FVTEUxNzpVZiciUUVRZytuKVxmb1BOZmYwYjpfTWRtKSg8PCNdOCNyZkNqXy5ZMkZjRnMwPjVvMjpsPkFIbS9OJiRcP0REWSZlc1lTTVgzOG1vczcyKG5OUmZzanJ1UzpiZmonUWdXZ1daPVtdOE1PW0lTLysqblhdcSVVV2tPNT1Bb0wnNmoxX2k7fj5lbmRzdHJlYW0KZW5kb2JqCnhyZWYKMCAxNwowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwNzMgMDAwMDAgbiAKMDAwMDAwMDExNCAwMDAwMCBuIAowMDAwMDAwMjIxIDAwMDAwIG4gCjAwMDAwMDAzMzMgMDAwMDAgbiAKMDAwMDAwMDUzOCAwMDAwMCBuIAowMDAwMDAwNzQzIDAwMDAwIG4gCjAwMDAwMDA5NDggMDAwMDAgbiAKMDAwMDAwMTE1MyAwMDAwMCBuIAowMDAwMDAxMzU4IDAwMDAwIG4gCjAwMDAwMDE0MjcgMDAwMDAgbiAKMDAwMDAwMTcxMSAwMDAwMCBuIAowMDAwMDAxNzk1IDAwMDAwIG4gCjAwMDAwMDI1MzAgMDAwMDAgbiAKMDAwMDAwMzI2NSAwMDAwMCBuIAowMDAwMDA0MDAwIDAwMDAwIG4gCjAwMDAwMDQ3MzUgMDAwMDAgbiAKdHJhaWxlcgo8PAovSUQgCls8ZjczNzk2OGRhYWYyYTgzNzE5YjU5ZmQyMjliODE5NDE+PGY3Mzc5NjhkYWFmMmE4MzcxOWI1OWZkMjI5YjgxOTQxPl0KJSBSZXBvcnRMYWIgZ2VuZXJhdGVkIFBERiBkb2N1bWVudCAtLSBkaWdlc3QgKGh0dHA6Ly93d3cucmVwb3J0bGFiLmNvbSkKCi9JbmZvIDEwIDAgUgovUm9vdCA5IDAgUgovU2l6ZSAxNwo+PgpzdGFydHhyZWYKNTQ3MAolJUVPRgo="},{"type":"array","items":{"type":"object","properties":{"sourceType":{"type":"string","enum":["remote","base64"]},"url":{"type":"string","format":"uri","description":"URL del documento (se sourceType è 'remote')."},"payload":{"type":"string","format":"byte","description":"Codifica Base64 del documento (se sourceType è 'base64')."}},"required":["sourceType"]},"example":[{"sourceType":"remote","url":"https://url.pdf.com"}]}]},"callback":{"$ref":"#/components/schemas/Callback"},"options":{"type":"object","description":"Queste sono le opzioni facoltative che consentono di personalizzare l'interfaccia utente visibile all'utente finale o le modalità di firma.","properties":{"ui":{"type":"object","properties":{"sidebarBackgroundColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#55a4ed","description":"Cambia il colore dello sfondo della barra laterale"},"sidebarTitleColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#000000","description":"Cambia il colore della barra laterale del titolo"},"sidebarTextColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#55a4ed","description":"Modifica il colore del testo della barra laterale"},"footerBackgroundColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#afcfed","description":"Modifica il colore dello sfondo del piè di pagina"},"headerBackgroundColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#afcfed","description":"Modifica il colore dello sfondo dell'intestazione"},"headerTitleColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#000000","description":"Modifica il colore del titolo dell'intestazione"},"headerSubtitleColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#55a4ed","description":"Cambia il colore del sottotitolo dell'intestazione"},"buttonTextColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#000000","description":"Modifica il colore del testo del pulsante"},"buttonTextColorHover":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#000000","description":"Cambia il colore del testo del pulsante quando ci passi sopra con il mouse"},"buttonBackgroundColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#ffffff","description":"Cambia il colore dello sfondo del pulsante"},"buttonBackgroundColorHover":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#0a5aa6","description":"Cambia il colore dello sfondo del pulsante quando ci passi sopra con il mouse"},"signButtonTextColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#55a4ed","description":"Cambia il colore del testo del pulsante \"Segnalare\" (quello che ti permette di proseguire la procedura)"},"signButtonTextColorHover":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#000000","description":"Cambia il colore del testo del pulsante \"Segnalazione\" quando ci passi sopra con il mouse"},"signButtonBackgroundColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#0a5aa6","description":"Cambia il colore dello sfondo del pulsante \"Segnale\" (quello che ti permette di proseguire la procedura)"},"signButtonBackgroundColorHover":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#55a4ed","description":"Cambia il colore dello sfondo del pulsante \"Segnale\" quando ci passi sopra con il mouse"},"sidebarLogo":{"type":"string","format":"uri","description":"Ti permette di personalizzare il logo visualizzato nell'angolo in alto a sinistra; questo sarà anche il logo che apparirà nell'e-mail SENT con l'OTP (se l'e-mail è il metodo di autenticazione scelto)"},"hideSidebar":{"type":"boolean","default":false,"description":"Se vero, la barra laterale verrà nascosta"},"hideHeader":{"type":"boolean","default":false,"description":"Se vero, l'intestazione verrà nascosta"},"hideDownloadValidated":{"type":"boolean","default":false,"description":"Se vero, il pulsante che consente di scaricare il documento caricato verrà nascosto"},"hideDownloadSigned":{"type":"boolean","default":false,"description":"Se vero, il pulsante che consente di scaricare il documento firmato verrà nascosto"},"iframeAncestors":{"type":"array","items":{"type":"string"},"example":["https://example.com","https://example2.com"],"description":"Un elenco degli URL principali autorizzati a incorporare questa applicazione web in un iframe"},"completeUrl":{"type":"string","format":"uri","description":"Se valutato, verrà visualizzato il pulsante \"Completa\" che consentirà di reindirizzare l'utente finale all'URL impostato"},"cancelUrl":{"type":"string","format":"uri","description":"Se la condizione viene soddisfatta, verrà visualizzato il pulsante \"Annulla\" che consentirà di reindirizzare l'utente finale all'URL specificato"}}},"signatureMode":{"description":"Scegli come i firmatari apporranno la propria firma. L'impostazione predefinita è la firma tipo.","default":"typed","type":"array","items":{"type":"string"},"example":["typed","drawn"]},"userEditableData":{"type":"object","description":"Scegli se i firmatari potranno modificare i propri dati, cambiare il proprio nome, il numero di cellulare o l'indirizzo e-mail a cui verrà inviato l'OTP. Per impostazione predefinita, queste opzioni non sono obbligatorie e saranno impostate su \"true\".","properties":{"name":{"type":"boolean","default":true},"mobile":{"type":"boolean","default":true},"email":{"type":"boolean","default":true}}},"timezone":{"$ref":"#/components/schemas/Timezones"},"signerMustRead":{"type":"boolean","description":"Se vero, il firmatario sarà obbligato a leggere il documento prima di poterlo firmare.","default":false}}}},"required":["signers","inputDocuments"]},"InputDocuments":{"description":"Per i documenti da firmare, è possibile specificare: \n- un documento sotto forma di URL (il sistema scaricherà il documento e ne indovinerà il tipo MIME)\n- una stringa Base64 di un file (il sistema ne indovinerà il tipo MIME)\n- una stringa base64 dell'hash (SHA256) di un file (il sistema indovinerà il tipo MIME in base alla lunghezza dell'hash pari a 32)\n- un oggetto `InputDocumentObject` con dettagli aggiuntivi quali il \"sourceType\" del documento, l'\"url\" del documento, le \"headers\" per la richiesta del documento remoto, il \"method\" HTTP per la richiesta del documento remoto, i \"postData\" per la richiesta del documento remoto, il \"payload\" del documento codificato in Base64 (nel caso di sourceType base64) oppure l’hash del documento (nel caso di sourceType base64Hash)\".\n- un array contenente alcune delle opzioni precedenti\n\n\nNote sull’hash del file:\n\nQuesto esempio mostra come generare l’hash del file e codificarlo in Base64:\n\n```bash openssl dgst -sha256 -binary FILE_DA_FIRMARE | openssl enc -a```\n\nL'output sarà simile a questo: \"msj3f4hJCSELbMkWjkFwNrf0XhkebTnAKaKhx4686DY=\"\n\nIl sistema cercherà di indovinare se la stringa in base64 è un hash o un file; se la stringa è un hash (SHA256 == CHAR(32)), il sistema firmerà l’hash del file originale.\n\nPer sovrascrivere questo comportamento di \"indovinare\", è possibile utilizzare il campo `sourceType` nello schema `InputDocumentObject`.","oneOf":[{"type":"string","description":"Una stringa URL valida","format":"uri"},{"type":"string","description":"Una stringa Base64 valida","format":"base64"},{"$ref":"#/components/schemas/InputDocumentObject"},{"type":"array","items":{"oneOf":[{"type":"string","description":"Una stringa URL valida","format":"uri"},{"type":"string","description":"Una stringa Base64 valida","format":"base64"},{"$ref":"#/components/schemas/InputDocumentObject"}]}}],"example":{"$ref":"#/components/examples/InputDocumentUrl"}},"InputDocumentObject":{"description":"Questo oggetto consente di specificare un documento da firmare fornendo maggiori dettagli","type":"object","properties":{"sourceType":{"type":"string","description":"Type of source of the document","enum":["remote","base64","base64Hash"],"example":"remote"},"url":{"type":"string","description":"URL del documento remoto","format":"uri","example":"https://my-domain.com/remoteResource.pdf"},"headers":{"type":"array","items":{"type":"string"},"description":"Intestazioni per la richiesta di documenti da remoto","example":["Authorization: Bearer token"]},"method":{"type":"string","description":"Metodo HTTP per la richiesta del documento remoto","default":"get","example":"get","enum":["get","post"]},"postData":{"type":"string","description":"Dati di invio per la richiesta di documenti a distanza","example":"key=value"},"payload":{"type":"string","description":"Payload del documento codificato in Base64 o hash del documento","example":"BASE64string or BASE64ofFileHASH"}}},"Callback":{"type":"object","required":["url"],"description":"Questo è il nostro sistema standardizzato di callback OpenAPI. Consente di configurare i parametri per ricevere notifiche relative agli aggiornamenti di stato delle richieste asincrone inviate a questo endpoint.","properties":{"method":{"type":"string","description":"Specificare il metodo di callback. Se impostato su 'POST', verrà avviata una richiesta HTTP POST standard con l'intestazione Content-Type impostata su application/x-www-form-urlencoded. I dati JSON verranno codificati in una coppia chiave-valore denominata \"data\" (personalizzabile tramite il parametro \"field\") all'interno del corpo della richiesta. Se il metodo è impostato su \"JSON\", verrà effettuata una richiesta HTTP POST diretta con l'intestazione Content-Type impostata su application/json. I dati JSON grezzi verranno inseriti direttamente nel corpo della richiesta senza alcuna codifica.","enum":["POST","JSON"],"default":"JSON"},"field":{"type":"string","description":"Questo parametro funziona in combinazione con il parametro \"method\" impostato su \"POST\". Se specificato come stringa, determina il nome del parametro che verrà inviato nella richiesta POST.","example":"data","default":"data"},"url":{"type":"string","format":"uri","description":"In questo parametro deve essere inserito un URL valido in grado di gestire le richieste POST. Per gli endpoint che richiedono l'autenticazione, è possibile utilizzare il parametro \"headers\" per specificare \"basic auth\" o \"bearer auth\". Il timeout massimo è di 30 secondi. Se è impostato il parametro «retry», il sistema effettuerà un numero di tentativi pari al valore di «retry» fino a quando non verrà ricevuto un codice di stato 200.","example":"https://www.mysite.com/myEndpoint"},"retry":{"type":"integer","description":"Il numero massimo di tentativi è definito dal parametro “retry”. Se si raggiunge il numero massimo di tentativi senza ottenere un codice di stato positivo (ad es. 200 OK), la richiesta viene considerata un errore definitivo. Spesso viene inserito un intervallo di tempo tra un tentativo e l’altro per evitare di sovraccaricare il server. Tale intervallo può aumentare in modo esponenziale ad ogni tentativo, al fine di ridurre l’impatto su un server sovraccarico. Il parametro «retry» è configurato per riprovare la richiesta solo in presenza di specifici codici di stato, in genere quelli che indicano errori temporanei (ad es. 502, 503) o problemi di rete.","example":3,"maximum":5,"minimum":0,"default":0},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"Un insieme di intestazioni HTTP da inviare insieme alla richiesta. Ogni intestazione è definita come una coppia chiave-valore. Le intestazioni possono essere utilizzate per vari scopi, tra cui l'autenticazione, la negoziazione dei contenuti e i metadati personalizzati.","example":{"session_id":"9834r5fh589494"}},"custom":{"type":"object","description":"Questo oggetto può essere popolato con qualsiasi dato aggiuntivo che si desideri includere nella risposta della callback. Questi dati saranno accessibili tramite il parametro \"custom\" della funzione di callback. È possibile utilizzarlo per memorizzare e recuperare qualsiasi informazione rilevante necessaria per la propria applicazione.","example":{"my_custom_id":"123456789"}}}},"Timezones":{"type":"string","description":"Un identificatore per un fuso orario valido; l'impostazione predefinita è UTC.","example":"Europe/Rome","enum":["Africa/Abidjan","Africa/Accra","Africa/Addis_Ababa","Africa/Algiers","Africa/Asmara","Africa/Bamako","Africa/Bangui","Africa/Banjul","Africa/Bissau","Africa/Blantyre","Africa/Brazzaville","Africa/Bujumbura","Africa/Cairo","Africa/Casablanca","Africa/Ceuta","Africa/Conakry","Africa/Dakar","Africa/Dar_es_Salaam","Africa/Djibouti","Africa/Douala","Africa/El_Aaiun","Africa/Freetown","Africa/Gaborone","Africa/Harare","Africa/Johannesburg","Africa/Juba","Africa/Kampala","Africa/Khartoum","Africa/Kigali","Africa/Kinshasa","Africa/Lagos","Africa/Libreville","Africa/Lome","Africa/Luanda","Africa/Lubumbashi","Africa/Lusaka","Africa/Malabo","Africa/Maputo","Africa/Maseru","Africa/Mbabane","Africa/Mogadishu","Africa/Monrovia","Africa/Nairobi","Africa/Ndjamena","Africa/Niamey","Africa/Nouakchott","Africa/Ouagadougou","Africa/Porto-Novo","Africa/Sao_Tome","Africa/Tripoli","Africa/Tunis","Africa/Windhoek","America/Adak","America/Anchorage","America/Anguilla","America/Antigua","America/Araguaina","America/Argentina/Buenos_Aires","America/Argentina/Catamarca","America/Argentina/Cordoba","America/Argentina/Jujuy","America/Argentina/La_Rioja","America/Argentina/Mendoza","America/Argentina/Rio_Gallegos","America/Argentina/Salta","America/Argentina/San_Juan","America/Argentina/San_Luis","America/Argentina/Tucuman","America/Argentina/Ushuaia","America/Aruba","America/Asuncion","America/Atikokan","America/Bahia","America/Bahia_Banderas","America/Barbados","America/Belem","America/Belize","America/Blanc-Sablon","America/Boa_Vista","America/Bogota","America/Boise","America/Cambridge_Bay","America/Campo_Grande","America/Cancun","America/Caracas","America/Cayenne","America/Cayman","America/Chicago","America/Chihuahua","America/Ciudad_Juarez","America/Costa_Rica","America/Creston","America/Cuiaba","America/Curacao","America/Danmarkshavn","America/Dawson","America/Dawson_Creek","America/Denver","America/Detroit","America/Dominica","America/Edmonton","America/Eirunepe","America/El_Salvador","America/Fort_Nelson","America/Fortaleza","America/Glace_Bay","America/Goose_Bay","America/Grand_Turk","America/Grenada","America/Guadeloupe","America/Guatemala","America/Guayaquil","America/Guyana","America/Halifax","America/Havana","America/Hermosillo","America/Indiana/Indianapolis","America/Indiana/Knox","America/Indiana/Marengo","America/Indiana/Petersburg","America/Indiana/Tell_City","America/Indiana/Vevay","America/Indiana/Vincennes","America/Indiana/Winamac","America/Inuvik","America/Iqaluit","America/Jamaica","America/Juneau","America/Kentucky/Louisville","America/Kentucky/Monticello","America/Kralendijk","America/La_Paz","America/Lima","America/Los_Angeles","America/Lower_Princes","America/Maceio","America/Managua","America/Manaus","America/Marigot","America/Martinique","America/Matamoros","America/Mazatlan","America/Menominee","America/Merida","America/Metlakatla","America/Mexico_City","America/Miquelon","America/Moncton","America/Monterrey","America/Montevideo","America/Montserrat","America/Nassau","America/New_York","America/Nome","America/Noronha","America/North_Dakota/Beulah","America/North_Dakota/Center","America/North_Dakota/New_Salem","America/Nuuk","America/Ojinaga","America/Panama","America/Paramaribo","America/Phoenix","America/Port-au-Prince","America/Port_of_Spain","America/Porto_Velho","America/Puerto_Rico","America/Punta_Arenas","America/Rankin_Inlet","America/Recife","America/Regina","America/Resolute","America/Rio_Branco","America/Santarem","America/Santiago","America/Santo_Domingo","America/Sao_Paulo","America/Scoresbysund","America/Sitka","America/St_Barthelemy","America/St_Johns","America/St_Kitts","America/St_Lucia","America/St_Thomas","America/St_Vincent","America/Swift_Current","America/Tegucigalpa","America/Thule","America/Tijuana","America/Toronto","America/Tortola","America/Vancouver","America/Whitehorse","America/Winnipeg","America/Yakutat","Antarctica/Casey","Antarctica/Davis","Antarctica/DumontDUrville","Antarctica/Macquarie","Antarctica/Mawson","Antarctica/McMurdo","Antarctica/Palmer","Antarctica/Rothera","Antarctica/Syowa","Antarctica/Troll","Antarctica/Vostok","Arctic/Longyearbyen","Asia/Aden","Asia/Almaty","Asia/Amman","Asia/Anadyr","Asia/Aqtau","Asia/Aqtobe","Asia/Ashgabat","Asia/Atyrau","Asia/Baghdad","Asia/Bahrain","Asia/Baku","Asia/Bangkok","Asia/Barnaul","Asia/Beirut","Asia/Bishkek","Asia/Brunei","Asia/Chita","Asia/Choibalsan","Asia/Colombo","Asia/Damascus","Asia/Dhaka","Asia/Dili","Asia/Dubai","Asia/Dushanbe","Asia/Famagusta","Asia/Gaza","Asia/Hebron","Asia/Ho_Chi_Minh","Asia/Hong_Kong","Asia/Hovd","Asia/Irkutsk","Asia/Jakarta","Asia/Jayapura","Asia/Jerusalem","Asia/Kabul","Asia/Kamchatka","Asia/Karachi","Asia/Kathmandu","Asia/Khandyga","Asia/Kolkata","Asia/Krasnoyarsk","Asia/Kuala_Lumpur","Asia/Kuching","Asia/Kuwait","Asia/Macau","Asia/Magadan","Asia/Makassar","Asia/Manila","Asia/Muscat","Asia/Nicosia","Asia/Novokuznetsk","Asia/Novosibirsk","Asia/Omsk","Asia/Oral","Asia/Phnom_Penh","Asia/Pontianak","Asia/Pyongyang","Asia/Qatar","Asia/Qostanay","Asia/Qyzylorda","Asia/Riyadh","Asia/Sakhalin","Asia/Samarkand","Asia/Seoul","Asia/Shanghai","Asia/Singapore","Asia/Srednekolymsk","Asia/Taipei","Asia/Tashkent","Asia/Tbilisi","Asia/Tehran","Asia/Thimphu","Asia/Tokyo","Asia/Tomsk","Asia/Ulaanbaatar","Asia/Urumqi","Asia/Ust-Nera","Asia/Vientiane","Asia/Vladivostok","Asia/Yakutsk","Asia/Yangon","Asia/Yekaterinburg","Asia/Yerevan","Atlantic/Azores","Atlantic/Bermuda","Atlantic/Canary","Atlantic/Cape_Verde","Atlantic/Faroe","Atlantic/Madeira","Atlantic/Reykjavik","Atlantic/South_Georgia","Atlantic/St_Helena","Atlantic/Stanley","Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Eucla","Australia/Hobart","Australia/Lindeman","Australia/Lord_Howe","Australia/Melbourne","Australia/Perth","Australia/Sydney","Europe/Amsterdam","Europe/Andorra","Europe/Astrakhan","Europe/Athens","Europe/Belgrade","Europe/Berlin","Europe/Bratislava","Europe/Brussels","Europe/Bucharest","Europe/Budapest","Europe/Busingen","Europe/Chisinau","Europe/Copenhagen","Europe/Dublin","Europe/Gibraltar","Europe/Guernsey","Europe/Helsinki","Europe/Isle_of_Man","Europe/Istanbul","Europe/Jersey","Europe/Kaliningrad","Europe/Kirov","Europe/Kyiv","Europe/Lisbon","Europe/Ljubljana","Europe/London","Europe/Luxembourg","Europe/Madrid","Europe/Malta","Europe/Mariehamn","Europe/Minsk","Europe/Monaco","Europe/Moscow","Europe/Oslo","Europe/Paris","Europe/Podgorica","Europe/Prague","Europe/Riga","Europe/Rome","Europe/Samara","Europe/San_Marino","Europe/Sarajevo","Europe/Saratov","Europe/Simferopol","Europe/Skopje","Europe/Sofia","Europe/Stockholm","Europe/Tallinn","Europe/Tirane","Europe/Ulyanovsk","Europe/Vaduz","Europe/Vatican","Europe/Vienna","Europe/Vilnius","Europe/Volgograd","Europe/Warsaw","Europe/Zagreb","Europe/Zurich","Indian/Antananarivo","Indian/Chagos","Indian/Christmas","Indian/Cocos","Indian/Comoro","Indian/Kerguelen","Indian/Mahe","Indian/Maldives","Indian/Mauritius","Indian/Mayotte","Indian/Reunion","Pacific/Apia","Pacific/Auckland","Pacific/Bougainville","Pacific/Chatham","Pacific/Chuuk","Pacific/Easter","Pacific/Efate","Pacific/Fakaofo","Pacific/Fiji","Pacific/Funafuti","Pacific/Galapagos","Pacific/Gambier","Pacific/Guadalcanal","Pacific/Guam","Pacific/Honolulu","Pacific/Kanton","Pacific/Kiritimati","Pacific/Kosrae","Pacific/Kwajalein","Pacific/Majuro","Pacific/Marquesas","Pacific/Midway","Pacific/Nauru","Pacific/Niue","Pacific/Norfolk","Pacific/Noumea","Pacific/Pago_Pago","Pacific/Palau","Pacific/Pitcairn","Pacific/Pohnpei","Pacific/Port_Moresby","Pacific/Rarotonga","Pacific/Saipan","Pacific/Tahiti","Pacific/Tarawa","Pacific/Tongatapu","Pacific/Wake","Pacific/Wallis","UTC"]},"DocumentFileInfo":{"type":"object","description":"Informazioni dettagliate sul file (disponibili per i PDF)","properties":{"pdfVersion":{"type":"string","description":"Versione PDF del documento","example":"1.7"},"pageCount":{"type":"integer","description":"Numero di pagine del documento","example":3},"pageDetails":{"type":"array","items":{"type":"object","properties":{"pageNumber":{"type":"integer","example":1},"width":{"type":"integer","example":595},"height":{"type":"integer","example":842}}}},"metadata":{"type":"object","properties":{"title":{"type":"string","example":"Untitled 1"},"author":{"type":"string","example":"Mario Rossi"},"creator":{"type":"string","example":"LibreOffice"},"producer":{"type":"string","example":"macOS Version 15.6.1 (Build 24G90) Quartz PDFContext"},"creationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"},"modificationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"}}},"acroFormFields":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"PDFSignature"},"name":{"type":"string","example":"signatureField1"},"value":{"type":"string","nullable":true,"example":null},"isReadOnly":{"type":"boolean","example":false},"isRequired":{"type":"boolean","example":false},"widgets":{"type":"array","items":{"type":"object","properties":{"pageIndex":{"type":"integer","example":1},"rect":{"type":"array","items":{"type":"integer"},"example":[100,100,200,200]}}}}}}},"signatureFields":{"type":"array","items":{"type":"object"}},"fonts":{"type":"array","items":{"type":"string"}},"textContent":{"type":"string","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}}}},"examples":{"InputDocumentUrl":{"value":"https://my-domain.com/remoteResource.pdf"},"InputDocumentObject":{"value":{"sourceType":"remote","url":"https://my-domain.com/remoteResource.pdf","headers":null,"method":"get","postData":null,"payload":null}},"SignatureObjectDone":{"summary":"actionType:Detail - Procedura di firma completata","value":{"id":"67af24c5af9b55291406e946","updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_automatic","signatureType":"pades","state":"DONE","options":{"asyncDocumentsValidation":true,"asyncSignature":false},"document":{"title":"MyDocument Title","description":"","inputDocuments":[{"sourceType":"base64","createdAt":"2025-02-14 11:12:33.819+00:00","mimetype":"application/pdf","extension":"pdf","size":339,"id":"67af252164f60538280f70fb","md5":"694be78a9eaa52d602bec92e211fa5dc","name":"694be78a9eaa52d602bec92e211fa5dc.pdf"}],"validatedDocument":{"mimetype":"application/pdf","extension":"pdf","size":1458,"createdAt":"2026-03-23 10:20:39.351+00:00","fileInfo":{"type":"object","description":"Informazioni dettagliate sul file (disponibili per i PDF)","properties":{"pdfVersion":{"type":"string","description":"Versione PDF del documento","example":"1.7"},"pageCount":{"type":"integer","description":"Numero di pagine del documento","example":3},"pageDetails":{"type":"array","items":{"type":"object","properties":{"pageNumber":{"type":"integer","example":1},"width":{"type":"integer","example":595},"height":{"type":"integer","example":842}}}},"metadata":{"type":"object","properties":{"title":{"type":"string","example":"Untitled 1"},"author":{"type":"string","example":"Mario Rossi"},"creator":{"type":"string","example":"LibreOffice"},"producer":{"type":"string","example":"macOS Version 15.6.1 (Build 24G90) Quartz PDFContext"},"creationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"},"modificationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"}}},"acroFormFields":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"PDFSignature"},"name":{"type":"string","example":"signatureField1"},"value":{"type":"string","nullable":true,"example":null},"isReadOnly":{"type":"boolean","example":false},"isRequired":{"type":"boolean","example":false},"widgets":{"type":"array","items":{"type":"object","properties":{"pageIndex":{"type":"integer","example":1},"rect":{"type":"array","items":{"type":"integer"},"example":[100,100,200,200]}}}}}}},"signatureFields":{"type":"array","items":{"type":"object"}},"fonts":{"type":"array","items":{"type":"string"}},"textContent":{"type":"string","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}}},"id":"69c113f7962df6cee50c951f","md5":"1c5b0d7253c7998f1ed79b6f7596ae18","name":"1c5b0d7253c7998f1ed79b6f7596ae18.pdf"},"signedDocument":{"createdAt":"2025-02-14 11:12:34.229+00:00","mimetype":"application/pdf","extension":"pdf","size":59594,"id":"69c113f9962df6cee50c9522","md5":"08da164b44a7f4701aba0f4b714abc86","sha256":"9e093c7fc456cdfe89e9b75d06b4e4a65e943856694136f162ee3d7f53d97361","name":"69c113f7962df6cee50c951d.pdf"}},"errorNumber":null,"errorMessage":null}},"SignatureObjectWaitValidation":{"summary":"actionType:Detail - In attesa della convalida del file di input","value":{"id":"67af24c5af9b55291406e946","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_automatic","state":"WAIT_VALIDATION","signatureType":"pades","options":{"asyncDocumentsValidation":true,"asyncSignature":false},"document":{}}},"SignatureObjectWaitSign":{"summary":"actionType:Detail - In attesa del completamento della procedura di firma","value":{"id":"67af24c5af9b55291406e946","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_automatic","state":"WAIT_SIGN","signatureType":"pades","options":{"asyncDocumentsValidation":true,"asyncSignature":false},"document":{"title":"MyDocument Title","description":"","inputDocuments":[{"sourceType":"base64","createdAt":"2025-02-14 11:12:33.819+00:00","mimetype":"application/pdf","extension":"pdf","size":339,"id":"67af252164f60538280f70fb","md5":"694be78a9eaa52d602bec92e211fa5dc","name":"694be78a9eaa52d602bec92e211fa5dc.pdf"}],"validatedDocument":{"mimetype":"application/pdf","extension":"pdf","size":1458,"createdAt":"2026-03-23 10:20:39.351+00:00","fileInfo":{"type":"object","description":"Informazioni dettagliate sul file (disponibili per i PDF)","properties":{"pdfVersion":{"type":"string","description":"Versione PDF del documento","example":"1.7"},"pageCount":{"type":"integer","description":"Numero di pagine del documento","example":3},"pageDetails":{"type":"array","items":{"type":"object","properties":{"pageNumber":{"type":"integer","example":1},"width":{"type":"integer","example":595},"height":{"type":"integer","example":842}}}},"metadata":{"type":"object","properties":{"title":{"type":"string","example":"Untitled 1"},"author":{"type":"string","example":"Mario Rossi"},"creator":{"type":"string","example":"LibreOffice"},"producer":{"type":"string","example":"macOS Version 15.6.1 (Build 24G90) Quartz PDFContext"},"creationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"},"modificationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"}}},"acroFormFields":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"PDFSignature"},"name":{"type":"string","example":"signatureField1"},"value":{"type":"string","nullable":true,"example":null},"isReadOnly":{"type":"boolean","example":false},"isRequired":{"type":"boolean","example":false},"widgets":{"type":"array","items":{"type":"object","properties":{"pageIndex":{"type":"integer","example":1},"rect":{"type":"array","items":{"type":"integer"},"example":[100,100,200,200]}}}}}}},"signatureFields":{"type":"array","items":{"type":"object"}},"fonts":{"type":"array","items":{"type":"string"}},"textContent":{"type":"string","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}}},"id":"69c113f7962df6cee50c951f","md5":"1c5b0d7253c7998f1ed79b6f7596ae18","name":"1c5b0d7253c7998f1ed79b6f7596ae18.pdf"}}}},"SignatureObjectError":{"summary":"actionType:Detail - Errore durante il processo di firma","value":{"id":"67af24c5af9b55291406e946","errorNumber":110,"errorMessage":"Wrong Certificate Credentials","updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_automatic","signatureType":"pades","state":"ERROR","options":{"asyncDocumentsValidation":true,"asyncSignature":false},"document":{"title":"MyDocument Title","description":"","inputDocuments":[{"sourceType":"base64","createdAt":"2025-02-14 11:12:33.819+00:00","mimetype":"application/pdf","extension":"pdf","size":339,"id":"67af252164f60538280f70fb","md5":"694be78a9eaa52d602bec92e211fa5dc","name":"694be78a9eaa52d602bec92e211fa5dc.pdf"}]}}},"SignatureList":{"value":{"data":[{"id":"67af252164f60538280f70f9","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:12:53.699+00:00","createdAt":"2025-02-14 11:12:34.218+00:00","certificateType":"EU-QES_automatic","state":"DONE","signatureType":"pades","documentTitle":"MyDocument Title"},{"id":"67af24c5af9b55291406e946","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_automatic","state":"WAIT_VALIDATION","documentTitle":"MyDocument Title"},{"id":"67af238164f60538280f70f2","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:05:37.691+00:00","createdAt":"2025-02-14 11:05:37.691+00:00","certificateType":"EU-QES_automatic","state":"WAIT_SIGN","signatureType":"pades","documentTitle":"MyDocument Title"}],"success":true,"message":"","error":null}},"SignatureAuditJSON":{"summary":"actionType:Audit - Cronologia di controllo della firma in formato JSON","value":{"data":{"SignatureData":{"id":"67af252164f60538280f70f9","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:12:53.699+00:00","createdAt":"2025-02-14 11:12:34.218+00:00","certificateType":"EU-QES_automatic","state":"DONE","signatureType":"pades","options":{"asyncDocumentsValidation":false,"asyncSignature":false,"level":"B","hashAlgorithm":"SHA256","encryptInAnyCase":false,"page":1,"withSignatureField":false},"document":{"title":"MyDocument Title","description":"","inputDocuments":[{"sourceType":"base64","createdAt":"2025-02-14 11:12:33.819+00:00","mimetype":"application/pdf","extension":"pdf","size":339,"id":"67af252164f60538280f70fb","md5":"694be78a9eaa52d602bec92e211fa5dc","name":"694be78a9eaa52d602bec92e211fa5dc.pdf"}],"validatedDocument":{"mimetype":"application/pdf","extension":"pdf","size":339,"createdAt":"2025-02-14 11:12:33.819+00:00","id":"67af252164f60538280f70fb","md5":"694be78a9eaa52d602bec92e211fa5dc","name":"694be78a9eaa52d602bec92e211fa5dc.pdf"},"signedDocument":{"createdAt":"2025-02-14 11:12:34.229+00:00","mimetype":"application/pdf","extension":"pdf","size":50133,"id":"67af252264f60538280f70fe","md5":"363cfdb141fe0e1a3f598e1d6377a4f5","name":"67af252164f60538280f70f9.pdf"}}},"AuditData":[{"id":"67af252164f60538280f70fa","createdAt":"2025-02-14 11:12:33.806+00:00","log":"New Signature Request From IP:93.150.88.183"},{"id":"67af252264f60538280f70fc","createdAt":"2025-02-14 11:12:34.021+00:00","log":"New Input Document. MD5:694be78a9eaa52d602bec92e211fa5dc"},{"id":"67af252264f60538280f70fd","createdAt":"2025-02-14 11:12:34.211+00:00","log":"New Validated Document. MD5:694be78a9eaa52d602bec92e211fa5dc"},{"id":"67af253564f60538280f70ff","createdAt":"2025-02-14 11:12:53.693+00:00","log":"New Signed Document. MD5:363cfdb141fe0e1a3f598e1d6377a4f5"}]},"success":true,"message":"","error":null}},"SignatureAuditHTML":{"summary":"actionType:Audit - Cronologia di controllo della firma in formato HTML","value":"\n\n\n\n \n \n Signature Data\n \n\n\n\n
\n

Signature Data

\n\n
\n
General Information
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
ID67af252164f60538280f70f9
Updated At2025-02-14 11:12:53.699+00:00
Created At2025-02-14 11:12:34.218+00:00
Certificate TypeEU-QES_automatic
StateDONE
Signature Typepades
\n
\n\n
\n
Signature Options
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
asyncDocumentsValidationfalse
asyncSignaturefalse
level\"B\"
hashAlgorithm\"SHA256\"
encryptInAnyCasefalse
page1
withSignatureFieldfalse
\n
\n\n
\n
Document
\n \n \n \n \n \n \n \n \n \n
TitleMyDocument Title
Description
\n
\n
\n
Signed Document
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
ID67af252264f60538280f70fe
Created At2025-02-14 11:12:34.229+00:00Mimetypeapplication/pdf
Name67af252164f60538280f70f9.pdfExtensionpdf
MD5363cfdb141fe0e1a3f598e1d6377a4f5Size50133
\n
\n\n\n
\n
Validated Document
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
ID67af252164f60538280f70fb
Created At2025-02-14 11:12:33.819+00:00Mimetypeapplication/pdf
Name694be78a9eaa52d602bec92e211fa5dc.pdfExtensionpdf
MD5694be78a9eaa52d602bec92e211fa5dcSize339
\n
\n
\n
\n
Input Documents
\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n
ID67af252164f60538280f70fbSource Typebase64
Created At2025-02-14 11:12:33.819+00:00Mimetypeapplication/pdf
Name694be78a9eaa52d602bec92e211fa5dc.pdfExtensionpdf
MD5694be78a9eaa52d602bec92e211fa5dcSize339
\n\n
\n\n\n
\n
Audit Data
\n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n
Operation IDOperation TimestampOperation Detail
67af252164f60538280f70fa2025-02-14 11:12:33.806+00:00New Signature Request From IP:93.150.88.183
67af252264f60538280f70fc2025-02-14 11:12:34.021+00:00New Input Document. MD5:694be78a9eaa52d602bec92e211fa5dc
67af252264f60538280f70fd2025-02-14 11:12:34.211+00:00New Validated Document. MD5:694be78a9eaa52d602bec92e211fa5dc
67af253564f60538280f70ff2025-02-14 11:12:53.693+00:00New Signed Document. MD5:363cfdb141fe0e1a3f598e1d6377a4f5
\n
\n\n
\n\n\n\n"},"SignatureAuditTXT":{"summary":"actionType:Audit - Cronologia di controllo della firma in formato TXT","value":"SignatureAuditReport:\n SignatureData:\n id: 67af252164f60538280f70f9\n errorNumber: null\n errorMessage: null\n updatedAt: '2025-02-14 11:12:53.699+00:00'\n createdAt: '2025-02-14 11:12:34.218+00:00'\n certificateType: EU-QES_automatic\n state: DONE\n signatureType: pades\n options:\n asyncDocumentsValidation: false\n asyncSignature: false\n level: B\n hashAlgorithm: SHA256\n encryptInAnyCase: false\n page: 1\n withSignatureField: false\n document:\n title: 'MyDocument Title'\n description: ''\n inputDocuments:\n -\n sourceType: base64\n createdAt: '2025-02-14 11:12:33.819+00:00'\n mimetype: application/pdf\n extension: pdf\n size: 339\n id: 67af252164f60538280f70fb\n md5: 694be78a9eaa52d602bec92e211fa5dc\n name: 694be78a9eaa52d602bec92e211fa5dc.pdf\n validatedDocument:\n mimetype: application/pdf\n extension: pdf\n size: 339\n createdAt: '2025-02-14 11:12:33.819+00:00'\n id: 67af252164f60538280f70fb\n md5: 694be78a9eaa52d602bec92e211fa5dc\n name: 694be78a9eaa52d602bec92e211fa5dc.pdf\n signedDocument:\n createdAt: '2025-02-14 11:12:34.229+00:00'\n mimetype: application/pdf\n extension: pdf\n size: 50133\n id: 67af252264f60538280f70fe\n md5: 363cfdb141fe0e1a3f598e1d6377a4f5\n name: 67af252164f60538280f70f9.pdf\n AuditData:\n -\n id: 67af252164f60538280f70fa\n createdAt: '2025-02-14 11:12:33.806+00:00'\n log: 'New Signature Request From IP:93.150.88.183'\n -\n id: 67af252264f60538280f70fc\n createdAt: '2025-02-14 11:12:34.021+00:00'\n log: 'New Input Document. MD5:694be78a9eaa52d602bec92e211fa5dc'\n -\n id: 67af252264f60538280f70fd\n createdAt: '2025-02-14 11:12:34.211+00:00'\n log: 'New Validated Document. MD5:694be78a9eaa52d602bec92e211fa5dc'\n -\n id: 67af253564f60538280f70ff\n createdAt: '2025-02-14 11:12:53.693+00:00'\n log: 'New Signed Document. MD5:363cfdb141fe0e1a3f598e1d6377a4f5'\n"},"SignatureAuditPDF":{"summary":"actionType:Audit - Cronologia di controllo della firma in formato PDF","externalValue":"https://docs.openapi.it/esignature/auditExample.pdf"},"SignedDocument":{"summary":"actionType:DocumentoFirmato","externalValue":"https://docs.openapi.it/esignature/padesExample.pdf"},"ValidatedDocument":{"summary":"actionType:Documento convalidato","value":"BINARY DATA"}},"responses":{"signatures200":{"description":"Operazione riuscita","content":{"*/*":{"schema":{"type":"string","format":"binary"},"examples":{"detail SIGNED":{"$ref":"#/components/examples/SignedDocument"},"detail VALIDATED":{"$ref":"#/components/examples/ValidatedDocument"}}},"application/json":{"schema":{"$ref":"#/components/schemas/SignatureObject"},"examples":{"detail DONE":{"$ref":"#/components/examples/SignatureObjectDone"},"detail WAIT_VALIDATION":{"$ref":"#/components/examples/SignatureObjectWaitValidation"},"detail WAIT_SIGN":{"$ref":"#/components/examples/SignatureObjectWaitSign"},"detail ERROR":{"$ref":"#/components/examples/SignatureObjectError"},"audit JSON":{"$ref":"#/components/examples/SignatureAuditJSON"}}},"text/plain":{"schema":{"type":"string"},"examples":{"detail audit txt":{"$ref":"#/components/examples/SignatureAuditTXT"}}},"text/html":{"schema":{"type":"string","format":"html"},"examples":{"detail audit html":{"$ref":"#/components/examples/SignatureAuditHTML"}}},"application/pdf":{"schema":{"type":"string","format":"binary"},"examples":{"detail audit pdf":{"$ref":"#/components/examples/SignatureAuditPDF"}}}}},"EU-QES_automatic200":{"description":"Operazione riuscita","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EU-QES_POST"},"examples":{"wait_validation":{"summary":"In attesa di convalida","value":{"data":{"id":"67af24c5af9b55291406e946","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_automatic","state":"WAIT_VALIDATION","signatureType":"pades","options":{"asyncDocumentsValidation":true,"asyncSignature":false,"timezone":"UTC"},"document":{}},"message":"Created","success":true,"error":null}},"done":{"summary":"Procedura di firma completata","value":{"data":{"id":"67af24c5af9b55291406e946","updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_automatic","signatureType":"pades","state":"DONE","options":{"asyncDocumentsValidation":true,"asyncSignature":false,"timezone":"UTC"},"document":{"title":"MyDocument Title","description":"","inputDocuments":[{"sourceType":"base64","createdAt":"2025-02-14 11:12:33.819+00:00","mimetype":"application/pdf","extension":"pdf","size":339,"id":"67af252164f60538280f70fb","md5":"694be78a9eaa52d602bec92e211fa5dc","name":"694be78a9eaa52d602bec92e211fa5dc.pdf"}],"validatedDocument":{"mimetype":"application/pdf","extension":"pdf","size":1458,"createdAt":"2026-03-23 10:20:39.351+00:00","fileInfo":{"type":"object","description":"Informazioni dettagliate sul file (disponibili per i PDF)","properties":{"pdfVersion":{"type":"string","description":"Versione PDF del documento","example":"1.7"},"pageCount":{"type":"integer","description":"Numero di pagine del documento","example":3},"pageDetails":{"type":"array","items":{"type":"object","properties":{"pageNumber":{"type":"integer","example":1},"width":{"type":"integer","example":595},"height":{"type":"integer","example":842}}}},"metadata":{"type":"object","properties":{"title":{"type":"string","example":"Untitled 1"},"author":{"type":"string","example":"Mario Rossi"},"creator":{"type":"string","example":"LibreOffice"},"producer":{"type":"string","example":"macOS Version 15.6.1 (Build 24G90) Quartz PDFContext"},"creationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"},"modificationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"}}},"acroFormFields":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"PDFSignature"},"name":{"type":"string","example":"signatureField1"},"value":{"type":"string","nullable":true,"example":null},"isReadOnly":{"type":"boolean","example":false},"isRequired":{"type":"boolean","example":false},"widgets":{"type":"array","items":{"type":"object","properties":{"pageIndex":{"type":"integer","example":1},"rect":{"type":"array","items":{"type":"integer"},"example":[100,100,200,200]}}}}}}},"signatureFields":{"type":"array","items":{"type":"object"}},"fonts":{"type":"array","items":{"type":"string"}},"textContent":{"type":"string","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}}},"id":"69c113f7962df6cee50c951f","md5":"1c5b0d7253c7998f1ed79b6f7596ae18","name":"1c5b0d7253c7998f1ed79b6f7596ae18.pdf"},"signedDocument":{"createdAt":"2025-02-14 11:12:34.229+00:00","mimetype":"application/pdf","extension":"pdf","size":59594,"id":"69c113f9962df6cee50c9522","md5":"08da164b44a7f4701aba0f4b714abc86","sha256":"9e093c7fc456cdfe89e9b75d06b4e4a65e943856694136f162ee3d7f53d97361","name":"69c113f7962df6cee50c951d.pdf"}},"errorNumber":null,"errorMessage":null},"message":"Created","success":true,"error":null}},"wait_sign":{"summary":"In attesa del completamento della procedura di firma","value":{"success":true,"message":"Created","error":null,"data":{"id":"67af24c5af9b55291406e946","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_automatic","state":"WAIT_SIGN","signatureType":"pades","options":{"asyncDocumentsValidation":true,"asyncSignature":false,"timezone":"UTC"},"document":{"title":"MyDocument Title","description":"","inputDocuments":[{"sourceType":"base64","createdAt":"2025-02-14 11:12:33.819+00:00","mimetype":"application/pdf","extension":"pdf","size":339,"id":"67af252164f60538280f70fb","md5":"694be78a9eaa52d602bec92e211fa5dc","name":"694be78a9eaa52d602bec92e211fa5dc.pdf"}],"validatedDocument":{"mimetype":"application/pdf","extension":"pdf","size":1458,"createdAt":"2026-03-23 10:20:39.351+00:00","fileInfo":{"type":"object","description":"Informazioni dettagliate sul file (disponibili per i PDF)","properties":{"pdfVersion":{"type":"string","description":"Versione PDF del documento","example":"1.7"},"pageCount":{"type":"integer","description":"Numero di pagine del documento","example":3},"pageDetails":{"type":"array","items":{"type":"object","properties":{"pageNumber":{"type":"integer","example":1},"width":{"type":"integer","example":595},"height":{"type":"integer","example":842}}}},"metadata":{"type":"object","properties":{"title":{"type":"string","example":"Untitled 1"},"author":{"type":"string","example":"Mario Rossi"},"creator":{"type":"string","example":"LibreOffice"},"producer":{"type":"string","example":"macOS Version 15.6.1 (Build 24G90) Quartz PDFContext"},"creationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"},"modificationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"}}},"acroFormFields":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"PDFSignature"},"name":{"type":"string","example":"signatureField1"},"value":{"type":"string","nullable":true,"example":null},"isReadOnly":{"type":"boolean","example":false},"isRequired":{"type":"boolean","example":false},"widgets":{"type":"array","items":{"type":"object","properties":{"pageIndex":{"type":"integer","example":1},"rect":{"type":"array","items":{"type":"integer"},"example":[100,100,200,200]}}}}}}},"signatureFields":{"type":"array","items":{"type":"object"}},"fonts":{"type":"array","items":{"type":"string"}},"textContent":{"type":"string","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}}},"id":"69c113f7962df6cee50c951f","md5":"1c5b0d7253c7998f1ed79b6f7596ae18","name":"1c5b0d7253c7998f1ed79b6f7596ae18.pdf"}}}}}}}}},"EU-QES_otp200":{"description":"Operazione riuscita","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EU-QES_POST"},"examples":{"wait_validation":{"summary":"In attesa di convalida","value":{"data":{"id":"67af24c5af9b55291406e946","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_otp","state":"WAIT_VALIDATION","signatureType":"pades","options":{"asyncDocumentsValidation":true,"asyncSignature":false,"timezone":"UTC"},"document":{}},"message":"Created","success":true,"error":null}},"done":{"summary":"Procedura di firma completata","value":{"data":{"id":"67af24c5af9b55291406e946","updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_otp","signatureType":"pades","state":"DONE","options":{"asyncDocumentsValidation":true,"asyncSignature":false,"timezone":"UTC"},"document":{"title":"MyDocument Title","description":"","inputDocuments":[{"sourceType":"base64","createdAt":"2025-02-14 11:12:33.819+00:00","mimetype":"application/pdf","extension":"pdf","size":339,"id":"67af252164f60538280f70fb","md5":"694be78a9eaa52d602bec92e211fa5dc","name":"694be78a9eaa52d602bec92e211fa5dc.pdf"}],"validatedDocument":{"mimetype":"application/pdf","extension":"pdf","size":1458,"createdAt":"2026-03-23 10:20:39.351+00:00","fileInfo":{"type":"object","description":"Informazioni dettagliate sul file (disponibili per i PDF)","properties":{"pdfVersion":{"type":"string","description":"Versione PDF del documento","example":"1.7"},"pageCount":{"type":"integer","description":"Numero di pagine del documento","example":3},"pageDetails":{"type":"array","items":{"type":"object","properties":{"pageNumber":{"type":"integer","example":1},"width":{"type":"integer","example":595},"height":{"type":"integer","example":842}}}},"metadata":{"type":"object","properties":{"title":{"type":"string","example":"Untitled 1"},"author":{"type":"string","example":"Mario Rossi"},"creator":{"type":"string","example":"LibreOffice"},"producer":{"type":"string","example":"macOS Version 15.6.1 (Build 24G90) Quartz PDFContext"},"creationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"},"modificationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"}}},"acroFormFields":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"PDFSignature"},"name":{"type":"string","example":"signatureField1"},"value":{"type":"string","nullable":true,"example":null},"isReadOnly":{"type":"boolean","example":false},"isRequired":{"type":"boolean","example":false},"widgets":{"type":"array","items":{"type":"object","properties":{"pageIndex":{"type":"integer","example":1},"rect":{"type":"array","items":{"type":"integer"},"example":[100,100,200,200]}}}}}}},"signatureFields":{"type":"array","items":{"type":"object"}},"fonts":{"type":"array","items":{"type":"string"}},"textContent":{"type":"string","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}}},"id":"69c113f7962df6cee50c951f","md5":"1c5b0d7253c7998f1ed79b6f7596ae18","name":"1c5b0d7253c7998f1ed79b6f7596ae18.pdf"},"signedDocument":{"createdAt":"2025-02-14 11:12:34.229+00:00","mimetype":"application/pdf","extension":"pdf","size":59594,"id":"69c113f9962df6cee50c9522","md5":"08da164b44a7f4701aba0f4b714abc86","sha256":"9e093c7fc456cdfe89e9b75d06b4e4a65e943856694136f162ee3d7f53d97361","name":"69c113f7962df6cee50c951d.pdf"}},"errorNumber":null,"errorMessage":null},"message":"Created","success":true,"error":null}},"wait_sign":{"summary":"In attesa del completamento della procedura di firma","value":{"success":true,"message":"Created","error":null,"data":{"id":"67af24c5af9b55291406e946","errorNumber":null,"errorMessage":null,"updatedAt":"2025-02-14 11:11:01.892+00:00","createdAt":"2025-02-14 11:11:01.892+00:00","certificateType":"EU-QES_otp","state":"WAIT_SIGN","signatureType":"pades","options":{"asyncDocumentsValidation":true,"asyncSignature":false,"timezone":"UTC"},"document":{"title":"MyDocument Title","description":"","inputDocuments":[{"sourceType":"base64","createdAt":"2025-02-14 11:12:33.819+00:00","mimetype":"application/pdf","extension":"pdf","size":339,"id":"67af252164f60538280f70fb","md5":"694be78a9eaa52d602bec92e211fa5dc","name":"694be78a9eaa52d602bec92e211fa5dc.pdf"}],"validatedDocument":{"mimetype":"application/pdf","extension":"pdf","size":1458,"createdAt":"2026-03-23 10:20:39.351+00:00","fileInfo":{"type":"object","description":"Informazioni dettagliate sul file (disponibili per i PDF)","properties":{"pdfVersion":{"type":"string","description":"Versione PDF del documento","example":"1.7"},"pageCount":{"type":"integer","description":"Numero di pagine del documento","example":3},"pageDetails":{"type":"array","items":{"type":"object","properties":{"pageNumber":{"type":"integer","example":1},"width":{"type":"integer","example":595},"height":{"type":"integer","example":842}}}},"metadata":{"type":"object","properties":{"title":{"type":"string","example":"Untitled 1"},"author":{"type":"string","example":"Mario Rossi"},"creator":{"type":"string","example":"LibreOffice"},"producer":{"type":"string","example":"macOS Version 15.6.1 (Build 24G90) Quartz PDFContext"},"creationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"},"modificationDate":{"type":"string","example":"2025-09-24T12:51:18.000Z"}}},"acroFormFields":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"PDFSignature"},"name":{"type":"string","example":"signatureField1"},"value":{"type":"string","nullable":true,"example":null},"isReadOnly":{"type":"boolean","example":false},"isRequired":{"type":"boolean","example":false},"widgets":{"type":"array","items":{"type":"object","properties":{"pageIndex":{"type":"integer","example":1},"rect":{"type":"array","items":{"type":"integer"},"example":[100,100,200,200]}}}}}}},"signatureFields":{"type":"array","items":{"type":"object"}},"fonts":{"type":"array","items":{"type":"string"}},"textContent":{"type":"string","example":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."}}},"id":"69c113f7962df6cee50c951f","md5":"1c5b0d7253c7998f1ed79b6f7596ae18","name":"1c5b0d7253c7998f1ed79b6f7596ae18.pdf"}}}}}}}}},"POSTsignature422":{"description":"Unprocessable Entity. Questa risposta viene restituita quando la convalida non va a buon fine o quando la richiesta non può essere elaborata.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se la richiesta è andata a buon fine (sempre falso in caso di ERROR).","example":false},"message":{"type":"string","description":"Un messaggio di facile comprensione che spiega l'ERROR specifico."},"error":{"type":"integer","description":"Un codice di errore specifico definito dall'applicazione."},"data":{"type":"object","nullable":true,"description":"Contiene dati aggiuntivi relativi agli ERROR oppure il valore null se non applicabile.","example":null}},"required":["success","message","error","data"]},"examples":{"MissingCertificateUsername":{"summary":"Esempio: nome utente del certificato mancante","value":{"success":false,"message":"certificateUsername required","error":635,"data":null}},"MissingCertificatePassword":{"summary":"Esempio: password del certificato mancante","value":{"success":false,"message":"certificatePassword required","error":640,"data":null}},"InvalidSignatureType":{"summary":"Esempio: Tipo di firma non valido","value":{"success":false,"message":"invalid signatureType","error":622,"data":null}},"InvalidOptionsProperty":{"summary":"Esempio: proprietà \"options\" non valida","value":{"success":false,"message":"invalid options property","error":625,"data":null}},"InputDocumentsRequired":{"summary":"Esempio: documenti di input richiesti","value":{"success":false,"message":"inputDocuments required","error":615,"data":null}}}}}},"EU-SES200":{"description":"Operazione riuscita","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID di Signature.","example":"693957bddcc141c34e03fcd9"},"errorNumber":{"example":null,"description":"Numero dell'errore interno; se non si verifica alcun errore, il valore sarà nullo."},"errorMessage":{"example":null,"description":"Messaggio di ERROR visualizzato se presente; se non vi sono errori, il valore sarà nullo."},"updatedAt":{"type":"string","description":"Data di aggiornamento.","example":"2025-12-10 11:21:33.653+00:00"},"createdAt":{"type":"string","description":"Data di creazione.","example":"2025-12-10 11:21:33.653+00:00"},"certificateType":{"type":"string","description":"Type di certificato.","example":"EU-SES"},"state":{"type":"string","description":"Indica i vari stati possibili dell'operazione.","example":"WAIT_VALIDATION"},"signatureType":{"type":"string","description":"Type di firma utilizzata per l'operazione. EU-SES utilizza esclusivamente dispositivi PAD.","example":"pades"},"signers":{"type":"array","description":"Elenco di tutti i firmatari.","items":{"type":"object","properties":{"authentication":{"type":"array","items":{"type":"string","enum":["email","sms"]},"description":"Metodi di autenticazione utilizzati."},"name":{"type":"string","example":"Mario"},"surname":{"type":"string","example":"Rossi"},"state":{"type":"string","example":"NEW"},"email":{"type":"string","format":"email","example":"example@email.com"},"id":{"type":"string","format":"uuid","example":"ec37f0c7-4f6e-4185-b2a8-5860277b762c"},"url":{"type":"string","format":"uri","example":"https://dev.esign.openapi.com/..."},"language":{"type":"string","example":"browser"},"message":{"type":"string","example":"Hi, this is your OTP: "},"signatures":{"type":"array","items":{"type":"object","properties":{"page":{"type":"integer"},"x":{"type":"integer"},"y":{"type":"integer"}}}},"emailValidation":{"type":"object","properties":{"domain":{"type":"string"},"host":{"type":"string"},"otpAttempts":{"type":"integer"},"mxRecords":{"type":"array","items":{"type":"object","properties":{"host":{"type":"string"},"class":{"type":"string"},"ttl":{"type":"integer"},"type":{"type":"string"},"pri":{"type":"integer"},"target":{"type":"string"}}}}}}}}},"options":{"type":"object","description":"Tutte le opzioni relative all'operazione; alcune sono impostate sui valori predefiniti se chi effettua la chiamata non le ha specificate.","example":{"asyncDocumentsValidation":true,"asyncSignature":false,"signatureMode":["typed"],"ui":{"cancelUrl":"google.com","completeUrl":"google.com","hideSidebar":false},"timezone":"UTC"}},"document":{"type":"object","description":"Questo oggetto contiene tutti i dettagli relativi al documento passato con la chiamata"}}}}}},"certificateOwner400":{"description":"Campi obbligatori mancanti","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CertificateOwnerErrorResponse400"},"examples":{"missingFields":{"summary":"Mancano tutti i campi obbligatori","value":{"status":400,"errors":[{"field":"certificateOwner","errorCode":201,"message":"certificateOwner required"},{"field":"name","errorCode":300,"message":"name required"},{"field":"surname","errorCode":301,"message":"surname required"},{"field":"email","errorCode":302,"message":"email required"},{"field":"mobile","errorCode":303,"message":"mobile required"},{"field":"fiscalCode","errorCode":304,"message":"fiscalCode required"},{"field":"birthDate","errorCode":305,"message":"birthDate required"},{"field":"gender","errorCode":306,"message":"gender required"},{"field":"birthTown","errorCode":307,"message":"birthTown required"},{"field":"birthProvince","errorCode":308,"message":"birthProvince required"},{"field":"birthCountry","errorCode":309,"message":"birthCountry required"},{"field":"address","errorCode":310,"message":"address required"},{"field":"town","errorCode":311,"message":"town required"},{"field":"province","errorCode":312,"message":"province required"},{"field":"zip","errorCode":313,"message":"zip required"},{"field":"country","errorCode":314,"message":"country required"},{"field":"shippingName","errorCode":315,"message":"shippingName required"},{"field":"shippingEmail","errorCode":316,"message":"shippingEmail required"},{"field":"shippingMobile","errorCode":317,"message":"shippingMobile required"},{"field":"shippingAddress","errorCode":318,"message":"shippingAddress required"},{"field":"shippingTown","errorCode":319,"message":"shippingTown required"},{"field":"shippingProvince","errorCode":320,"message":"shippingProvince required"},{"field":"shippingZip","errorCode":321,"message":"shippingZip required"},{"field":"idCardType","errorCode":322,"message":"idCardType required"},{"field":"idCardNumber","errorCode":323,"message":"idCardNumber required"},{"field":"idCardIssuer","errorCode":324,"message":"idCardIssuer required"},{"field":"idCardIssuingDate","errorCode":325,"message":"idCardIssuingDate required"},{"field":"idCardExpiryDate","errorCode":326,"message":"idCardExpiryDate required"}]}}}}}}},"requestBodies":{"SignatureCallback":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SignatureObject"},"custom":{"type":"object","description":"Dati personalizzati","properties":{"key":{"type":"string","description":"Tasto personalizzato","example":"value"}}}},"required":["data"]}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"data":{"type":"string","description":"Dati della firma in formato JSON"},"custom":{"type":"string","description":"Dati personalizzati in formato JSON"}}}}},"description":"URL di callback per ricevere lo stato della firma","required":true}}}}