> ## 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.

# Advertències i codis de risc de Signatura electrònica

> Totes les advertències de Signatura electrònica a Didit, de SIGNATURE_DECLINED a SIGNATURE_DOCUMENT_CHANGED, què les activa i la seva regla.

Un pas de [Signatura electrònica](https://docs.didit.me/ca/core-technology/electronic-signature/overview.md) genera una advertència quan un signant no pot o no vol signar: rebutja signar, es queda sense codis o no es pot associar a una identitat verificada, o bé un document ja no coincideix amb el que se li va mostrar. Cada advertència atura la signatura d'aquest signant, de manera que no s'emet cap document signat per a aquesta signatura. L'efecte de l'advertència en la decisió depèn de tu.

## Visió general

Una advertència apareix en dos llocs:

* A l'element del signant de `signatures[]`, com a `{ "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }` a `warnings[]`. Consulta l'[informe de Signatura electrònica](https://docs.didit.me/ca/core-technology/electronic-signature/report-electronic-signature.md).
* A l'activitat de la sessió, etiquetada amb la funcionalitat `SIGNATURE`, amb el seu títol i descripció. La consola la mostra a la pestanya **Signatura** de la sessió, i `additional_data.signature_id` apunta al signant.

Cada codi s'associa a una regla. Configura la regla a `DECLINE`, `REVIEW` o `NO_ACTION` per a cada pas del flux de treball, a la pestanya **Regles** de la consola o a la [configuració](https://docs.didit.me/ca/management-api/workflows/feature-configs.md#e-signature) del pas. La regla defineix el `verdict` del signant (`Declined`, `In Review` o `Approved`) i la gravetat de l'advertència (`error`, `warning` o `information`). Les regles d'estat personalitzades del pas s'apliquen després d'aquesta regla.

> [!WARNING]
>
> Una regla determina la decisió, no si els documents estan signats. `NO_ACTION` permet que el flux de treball continuï, però el signant encara no ha signat. Comprova que `status` sigui `signed` abans de confiar en una signatura.

## Advertències generades

| Codi | Quan es genera | Regla i valor per defecte |
| - | - | - |
| `SIGNATURE_DECLINED` | El signant ha rebutjat signar. No s'emet cap còpia signada i no es cobra res. | `signature_declined_action`, per defecte `REVIEW` |
| `SIGNATURE_OTP_FAILED` | El signant ha introduït 3 codis incorrectes o ha sol·licitat més de 5 codis. | `signature_otp_failed_action`, per defecte `DECLINE` |
| `SIGNATURE_NAME_MISMATCH` | KYB: el nom declarat per a la persona clau no coincideix amb el seu nom verificat, sense distingir majúscules ni espais. | `signature_name_mismatch_action`, per defecte `DECLINE` |
| `SIGNATURE_IDENTITY_NOT_VERIFIED` | El signant no té cap verificació d'identitat aprovada amb un nom, una prova de vida a la seva sessió no està aprovada o la verificació d'identitat ha canviat després que el signant comencés el pas. | `signature_identity_not_verified_action`, per defecte `DECLINE` |
| `SIGNATURE_DOCUMENT_CHANGED` | Un document ja no coincideix amb el SHA-256 registrat quan es va mostrar al signant. | `signature_document_changed_action`, per defecte `DECLINE` |

Les comprovacions d'identitat i de nom s'executen quan el signant sol·licita el seu codi i novament quan l'introdueix, de manera que aquestes advertències apareixen en aquest moment i no quan s'obre el pas.

## Els rebutjos es poden reobrir

`SIGNATURE_DECLINED` és l'única advertència que un signant pot desfer. Mentre l'enllaç de signatura sigui vàlid, un signant que hagi rebutjat pot reobrir el pas i signar. Reobrir neteja l'advertència del signant i la seva lectura i acceptació de cada document, de manera que torna a revisar els documents. L'advertència desapareix de l'activitat de la sessió un cop cap signant del pas continuï rebutjant. Reobrir no restableix els seus intents de codi. Les altres advertències són definitives per a aquest signant.

## Problemes que veu el signant

Aquests problemes aturen el signant sense generar cap advertència. El flux li indica què ha passat.

| Situació | Què passa |
| - | - |
| L'enllaç de signatura ha caducat | El pas no es pot obrir ni completar després d'`expires_at`. L'enllaç dura `signature_link_validity_days` des que es va crear la sessió. |
| El codi ha caducat | Els codis duren 5 minuts. El signant en sol·licita un de nou. |
| S'ha demanat un codi nou massa aviat | El signant ha d'esperar 60 segons entre codis. |
| Cap contacte verificat | El codi només s'envia a un correu electrònic o telèfon verificat prèviament a la sessió. Afegeix Verificació de correu electrònic o Verificació de telèfon abans del pas de signatura. |
| Un camp obligatori està buit | El signant no pot finalitzar un document fins que tots els camps obligatoris tinguin un valor. El flux mostra quants en queden i salta al primer. |
| Es rebutja el valor d'un camp | Un valor que no compleix la [validació](https://docs.didit.me/ca/core-technology/electronic-signature/overview.md#validació) del camp, per exemple per ser massa llarg o no ser un número, es rebutja i el flux n'indica el motiu. |
| L'aplicació és massa antiga per als camps | Una versió de l'SDK natiu sense compatibilitat amb camps no pot mostrar un document amb camps, i el pas mostra un error. Els documents sense camps continuen funcionant. Consulta [L'experiència de signatura](https://docs.didit.me/ca/core-technology/electronic-signature/overview.md#l’experiència-de-signatura). |

## Exemple

```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'exemple només mostra els camps que canvien. Tots els altres camps de l'[objecte de signatura](https://docs.didit.me/ca/core-technology/electronic-signature/report-electronic-signature.md#l’objecte-de-signatura) continuen presents.

## Tipus d'advertència

La gravetat de cada advertència segueix la regla que configuris. Les gravetats es divideixen en tres categories:

## Relacionat

* [Visió general de Signatura electrònica](https://docs.didit.me/ca/core-technology/electronic-signature/overview.md)
* [Informe de Signatura electrònica](https://docs.didit.me/ca/core-technology/electronic-signature/report-electronic-signature.md)
* [Configuracions de funcionalitats del flux de treball](https://docs.didit.me/ca/management-api/workflows/feature-configs.md#e-signature)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.