Avvisi e codici di rischio della firma elettronica

Un passaggio di Firma elettronica genera un avviso quando un firmatario non può o non vuole firmare: rifiuta, esaurisce i codici, non può essere associato a un’identità verificata oppure un documento non corrisponde più a quello che gli è stato mostrato. Ogni avviso blocca la firma di quel firmatario, quindi per quel firmatario non viene emesso alcun documento firmato. L’effetto dell’avviso sulla decisione dipende da te.

Panoramica

Un avviso compare in due punti:

Nell’elemento del firmatario all’interno di signatures[], come { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" } in warnings[]. Consulta il report di Firma elettronica.
Nelle attività della sessione, contrassegnato con la funzionalità SIGNATURE, insieme a titolo e descrizione. La console lo mostra nella scheda Firma della sessione, e additional_data.signature_id punta al firmatario.

A ogni codice corrisponde una regola. Imposta la regola su DECLINE, REVIEW o NO_ACTION per ogni passaggio del workflow, nella scheda Regole della console o nella configurazione del passaggio. La regola imposta il verdict del firmatario (Declined, In Review o Approved) e la gravità dell’avviso (error, warning o information). Le regole di stato personalizzate sul passaggio vengono applicate successivamente.

Una regola stabilisce la decisione, non se i documenti sono firmati. NO_ACTION consente al workflow di proseguire, ma il firmatario non ha ancora firmato. Verifica che status sia signed prima di fare affidamento su una firma.

Avvisi generati

Codice	Quando viene generato	Regola e valore predefinito
`SIGNATURE_DECLINED`	Il firmatario ha rifiutato di firmare. Non viene emessa alcuna copia firmata e non viene addebitato alcun costo.	`signature_declined_action`, valore predefinito `REVIEW`
`SIGNATURE_OTP_FAILED`	Il firmatario ha inserito 3 codici errati o ha richiesto più di 5 codici.	`signature_otp_failed_action`, valore predefinito `DECLINE`
`SIGNATURE_NAME_MISMATCH`	KYB: il nome dichiarato per la persona chiave non corrisponde al nome verificato, ignorando maiuscole/minuscole e spazi.	`signature_name_mismatch_action`, valore predefinito `DECLINE`
`SIGNATURE_IDENTITY_NOT_VERIFIED`	Il firmatario non ha una Verifica dell’identità approvata con un nome, un Rilevamento della vitalità nella sua sessione non è approvato, oppure la Verifica dell’identità è cambiata dopo che il firmatario ha iniziato.	`signature_identity_not_verified_action`, valore predefinito `DECLINE`
`SIGNATURE_DOCUMENT_CHANGED`	Un documento non corrisponde più allo SHA-256 registrato quando è stato mostrato al firmatario.	`signature_document_changed_action`, valore predefinito `DECLINE`

I controlli di identità e del nome vengono eseguiti quando il firmatario richiede il codice e di nuovo quando lo inserisce, quindi questi avvisi compaiono in quel momento anziché all’apertura del passaggio.

I rifiuti possono essere riaperti

SIGNATURE_DECLINED è l’unico avviso che un firmatario può annullare. Finché il link di firma è valido, un firmatario che ha rifiutato può riaprire il passaggio e firmare. La riapertura cancella l’avviso del firmatario, nonché la lettura e l’accettazione di ciascun documento, costringendolo a esaminare nuovamente i documenti. L’avviso scompare dalle attività della sessione quando nessun firmatario del passaggio rifiuta più. La riapertura non azzera i tentativi di inserimento del codice. Gli altri avvisi sono definitivi per quel firmatario.

Problemi riscontrati dal firmatario

Questi problemi bloccano il firmatario senza generare un avviso. Il flusso comunica cosa è successo.

Situazione	Cosa accade
Il link di firma è scaduto	Il passaggio non può essere aperto o completato dopo `expires_at`. Il link dura per `signature_link_validity_days` a partire dalla creazione della sessione.
Il codice è scaduto	I codici durano 5 minuti. Il firmatario richiede un nuovo codice.
È stato richiesto un nuovo codice troppo presto	Il firmatario attende 60 secondi tra un codice e l’altro.
Nessun recapito verificato	Il codice viene inviato solo a un’email o a un telefono verificati in precedenza nella sessione. Aggiungi Verifica email o Verifica telefonica prima del passaggio di firma.
Un campo obbligatorio è vuoto	Il firmatario non può completare un documento finché ogni campo obbligatorio non ha un valore. Il flusso mostra quanti ne rimangono e passa direttamente al primo.
Il valore di un campo viene rifiutato	Un valore che viola la validazione del campo, ad esempio perché troppo lungo o non numerico, viene rifiutato e il flusso ne indica il motivo.
L’app è troppo vecchia per supportare i campi	Una versione dell’SDK nativo senza supporto per i campi non può mostrare un documento con campi e il passaggio mostra un errore. I documenti senza campi continuano a funzionare. Consulta L’esperienza di firma.

Esempio

{
  "signatures": [
    {
      "id": "0e6c2a8e-6c2f-4b8e-9a51-3f2f6a7d9b10",
      "node_id": "feature_signature",
      "status": "declined",
      "verdict": "In Review",
      "warnings": [
        { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }
      ],
      "declined_at": "2026-11-03T10:41:40.320Z",
      "declined_action": "REVIEW",
      "signed_at": null,
      "certificate": null,
      "timestamp": null,
      "evidence_file": null
    }
  ]
}

L’esempio mostra solo i campi che cambiano. Tutti gli altri campi dell’oggetto della firma rimangono presenti.

Tipi di avviso

La gravità di ciascun avviso segue la regola che hai impostato. I livelli di gravità si dividono in tre categorie:

Autenticazione

Verifica

Monitoraggio

Piattaforma

Avvisi e codici di rischio della firma elettronica

Panoramica

Avvisi generati

I rifiuti possono essere riaperti

Problemi riscontrati dal firmatario

Esempio

Tipi di avviso

Correlati

​Panoramica

​Avvisi generati

​I rifiuti possono essere riaperti

​Problemi riscontrati dal firmatario

​Esempio

​Tipi di avviso

​Correlati

Panoramica

Avvisi generati

I rifiuti possono essere riaperti

Problemi riscontrati dal firmatario

Esempio

Tipi di avviso

Correlati