> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Avvisi e codici di rischio della firma elettronica > Consulta tutti gli avvisi della firma elettronica di Didit, da SIGNATURE_DECLINED a SIGNATURE_DOCUMENT_CHANGED, con trigger e regole. Un passaggio di [Firma elettronica](https://docs.didit.me/it/core-technology/electronic-signature/overview.md) 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](https://docs.didit.me/it/core-technology/electronic-signature/report-electronic-signature.md). * 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](https://docs.didit.me/it/management-api/workflows/feature-configs.md#e-signature) 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. > [!WARNING] > > 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](https://docs.didit.me/it/core-technology/electronic-signature/overview.md#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](https://docs.didit.me/it/core-technology/electronic-signature/overview.md#l’esperienza-di-firma). | ## Esempio ```json theme={null} { "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](https://docs.didit.me/it/core-technology/electronic-signature/report-electronic-signature.md#l’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: ## Correlati * [Panoramica sulla Firma elettronica](https://docs.didit.me/it/core-technology/electronic-signature/overview.md) * [Report di Firma elettronica](https://docs.didit.me/it/core-technology/electronic-signature/report-electronic-signature.md) * [Configurazioni delle funzionalità del workflow](https://docs.didit.me/it/management-api/workflows/feature-configs.md#e-signature) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.