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

# Advertencias y códigos de riesgo de la firma electrónica

> Cada advertencia de firma electrónica de Didit, de SIGNATURE_DECLINED a SIGNATURE_DOCUMENT_CHANGED: qué la activa y qué regla la controla.

Un paso de [Firma electrónica](https://docs.didit.me/es/core-technology/electronic-signature/overview.md) genera una advertencia cuando un firmante no puede o no quiere firmar: rechaza la firma, agota los códigos o no se puede asociar a una identidad verificada, o bien un documento ya no coincide con lo que se le mostró. Toda advertencia detiene la firma de ese firmante, por lo que no se emite ningún documento firmado para él. Tú decides cómo afecta la advertencia al veredicto.

## Visión general

Una advertencia aparece en dos lugares:

* En el elemento del firmante dentro de `signatures[]`, como `{ "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }` en `warnings[]`. Consulta el [informe de Firma electrónica](https://docs.didit.me/es/core-technology/electronic-signature/report-electronic-signature.md).
* En la actividad de la sesión, etiquetada con la función `SIGNATURE`, con su título y su descripción. La consola la muestra en la pestaña **Signature** de la sesión, y `additional_data.signature_id` apunta al firmante.

Cada código corresponde a una regla. Configura la regla como `DECLINE`, `REVIEW` o `NO_ACTION` para cada paso del flujo de trabajo, en la pestaña **Rules** de la consola o en la [configuración](https://docs.didit.me/es/management-api/workflows/feature-configs.md#firma-electrónica) del paso. La regla establece el `verdict` del firmante (`Declined`, `In Review` o `Approved`) y la gravedad de la advertencia (`error`, `warning` o `information`). Las reglas de estado personalizadas del paso se aplican después.

> [!WARNING]
>
> Una regla decide el veredicto, no si los documentos se han firmado. `NO_ACTION` permite que el flujo continúe, pero el firmante sigue sin haber firmado. Comprueba que `status` sea `signed` antes de confiar en una firma.

## Advertencias generadas

| Código | Cuándo se genera | Regla y valor predeterminado |
| - | - | - |
| `SIGNATURE_DECLINED` | El firmante se negó a firmar. No se emite ninguna copia firmada y no se cobra nada. | `signature_declined_action`, predeterminado `REVIEW` |
| `SIGNATURE_OTP_FAILED` | El firmante introdujo 3 códigos incorrectos o solicitó más de 5 códigos. | `signature_otp_failed_action`, predeterminado `DECLINE` |
| `SIGNATURE_NAME_MISMATCH` | KYB: el nombre declarado para la persona clave no coincide con su nombre verificado, sin tener en cuenta mayúsculas ni espacios. | `signature_name_mismatch_action`, predeterminado `DECLINE` |
| `SIGNATURE_IDENTITY_NOT_VERIFIED` | El firmante no tiene una verificación de identidad aprobada que incluya un nombre, una comprobación de prueba de vida de su sesión no está aprobada o la verificación de identidad cambió después de que el firmante iniciara el proceso. | `signature_identity_not_verified_action`, predeterminado `DECLINE` |
| `SIGNATURE_DOCUMENT_CHANGED` | Un documento ya no coincide con el SHA-256 registrado cuando se le mostró al firmante. | `signature_document_changed_action`, predeterminado `DECLINE` |

Las comprobaciones de identidad y de nombre se ejecutan cuando el firmante solicita su código y de nuevo cuando lo introduce, por lo que estas advertencias aparecen en ese momento y no cuando se abre el paso.

## Los rechazos se pueden reabrir

`SIGNATURE_DECLINED` es la única advertencia que un firmante puede deshacer. Mientras el enlace de firma sea válido, un firmante que rechazó la firma puede reabrir el paso y firmar. Al reabrirlo se eliminan la advertencia del firmante y su lectura y aceptación de cada documento, de modo que vuelve a revisar los documentos. La advertencia desaparece de la actividad de la sesión en cuanto ningún firmante del paso sigue rechazando. Reabrir el paso no restablece sus intentos de código. Las demás advertencias son definitivas para ese firmante.

## Problemas que ve el firmante

Estos casos detienen al firmante sin generar una advertencia. El flujo le indica qué ha ocurrido.

| Situación | Qué ocurre |
| - | - |
| El enlace de firma expiró | El paso no se puede abrir ni completar después de `expires_at`. El enlace dura `signature_link_validity_days` desde la creación de la sesión. |
| El código expiró | Los códigos duran 5 minutos. El firmante solicita uno nuevo. |
| Se solicitó un código nuevo demasiado pronto | El firmante debe esperar 60 segundos entre códigos. |
| No hay un contacto verificado | El código se envía solo a un correo electrónico o teléfono verificado previamente en la sesión. Añade Verificación de correo electrónico o Verificación de teléfono antes del paso de firma. |
| Un campo obligatorio está vacío | El firmante no puede terminar un documento hasta que todos sus campos obligatorios tengan un valor. El flujo muestra cuántos faltan y salta al primero. |
| Se rechaza el valor de un campo | Un valor que incumple la [validación](https://docs.didit.me/es/core-technology/electronic-signature/overview.md#validación) de su campo, por ejemplo por ser demasiado largo o no ser un número, se rechaza y el flujo indica el motivo. |
| La aplicación es demasiado antigua para los campos | Una versión del SDK nativo sin soporte para campos no puede mostrar un documento con campos, y el paso muestra un error. Los documentos sin campos siguen funcionando. Consulta [La experiencia de firma](https://docs.didit.me/es/core-technology/electronic-signature/overview.md#la-experiencia-de-firma). |

## Ejemplo

```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
    }
  ]
}
```

El ejemplo muestra solo los campos que cambian. Todos los demás campos del [objeto de firma](https://docs.didit.me/es/core-technology/electronic-signature/report-electronic-signature.md#el-objeto-de-firma) siguen presentes.

## Tipos de advertencia

La gravedad de cada advertencia depende de la regla que configures. Los niveles de gravedad se dividen en tres categorías:

## Relacionado

* [Descripción general de la firma electrónica](https://docs.didit.me/es/core-technology/electronic-signature/overview.md)
* [Informe de firma electrónica](https://docs.didit.me/es/core-technology/electronic-signature/report-electronic-signature.md)
* [Configuraciones de las funciones del flujo de trabajo](https://docs.didit.me/es/management-api/workflows/feature-configs.md#firma-electrónica)


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