La soluzione di Firma Elettronica API può essere integrata in gestionali, software e siti web, per rendere più immediata e sicura la firma di ordini, preventivi, richieste di attivazione, contratti.

L'implementazione della firma elettronica tramite API consente di offrire ai propri dipendenti o utenti un'esperienza semplificata di firma da remoto di qualsiasi documento, garantendo allo stesso tempo sicurezza e validità europea. La firma elettronica è infatti riconosciuta dalla legge dell’Unione Europea tramite la regolamentazione eIDAS. 

1) Richiesta di Firma Elettronica (POST /firma_elettronica/base)

La soluzione prevede l'autenticazione forte grazie all'utilizzo delle OTP (One Time Password) e serve per aumentare il livello di sicurezza della firma e proteggere ulteriormente i documenti firmati. Questo perché il numero di telefono e' associato al firmatario e, grazie al dossier di prova, permette di collegare un firmatario specifico alla firma di un documento.

{
 {
	"title": "string",
	"description": "string",
	"filename": "fes_{timestamp}.pdf",
	"content": "string",
- 	"members": [
	- {
		"firstname": "string",
		"lastname": "string",
		"email": "string",
		"phone": "string",
		"signs": [
	- {
		"page": 0,
		"position": "10,15,45,35"
	  }
	]
   }
],
-	"callback": {
		"field": "string",
		"url": "https://www.mysite.it/callback.php",
		"headers": {
		"key": "value"
	  }
	}
 }

2) Personalizzazione Interfaccia (POST /firma_elettronica_ui)

Sempre tramite API, è possibile personalizzare l'interfaccia di firma: puoi ad esempio cambiare i colori, aggiungere il tuo logo, nascondere gli altri firmatari o consentire o meno il download del documento. Inoltre, a completamento della firma, si può anche impostare anche un link di redirect ad una pagina web.

{
  "data": [
{
  "name": "My first template for Signature-UI",
  "description": "Here is the Signature-UI template for Yousign Developers.",
  "defaultZoom": 100,
  "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQU [...] IwU3i6foIAAAAAElFTkSuQmCC",
  "languages": [
    "fr",
    "en",
    "es",
    "de",
     "it",
     "pt",
    "nl"
  ],
  "defaultLanguage": "en",
  "signImageTypesAvailable": [
    "name",
    "draw"
  ],
  "enableHeaderBar": true,
  "enableHeaderBarSignAs": true,
  "enableSidebar": true,
  "enableMemberList": true,
  "enableDocumentList": true,
  "enableDocumentDownload": true,
  "enableActivities": true,
  "authenticationPopup": true,
  "enableRefuseComment": true,
  "labels": [
    {
      "name": "NAME OF THE LABEL",
      "languages": {
        "en": "Label en",
        "fr": "Label fr"
      }
    }
  ],
  "fonts": [
    "Roboto",
    "Lato"
  ],
  "style": "Just a CSS string for customize all of our iFrame.",
  "redirectCancel": {
    "url": "https://YOUR_FORWARDING_URL.com",
    "target": "_top or _blank or _self or _parent",
    "auto": false
  },
  "redirectError": {
    "url": "https://YOUR_FORWARDING_URL.com",
    "target": "_top or _blank or _self or _parent",
    "auto": false
  },
  "redirectSuccess": {
    "url": "https://YOUR_FORWARDING_URL.com",
    "target": "_top or _blank or _self or _parent",
    "auto": false
  }
}

3) Audit Trail (GET /firma_elettronica/{id}/audit)

Alla fine della procedura di firma sarà possibile richiedere tramite API sia il documento firmato che la copia dell'audit trail.
L'audit trail è il documento che contiene tutte le informazioni che hanno portato al buon esito della firma. Nel caso di controversie, questo file permetterà di riprodurre tecnicamente ogni passaggio della procedura. 

L'audit trail contiene dati su procedura (id, data creazione, invio e scadenza), su firmatari (nome, cognome, email, numero di telefono, indirizzo IP) e modalità di autenticazione firmatari (metodo di autenticazione, messaggio inviato e ora di convalida)
L'audit trail come da normativa viene conservato in originale 10 anni.

La firma elettronica è stata già integrata per la firma di documenti come pre-contratti, preventivi, contratti di vendita o noleggi e generici.

Vuoi un esempio di come funziona la firma elettronica tramite API? Prova il nuovo servizio direttamente nella tua area privata nella sezione Getting Started > The Sandbox