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

Un paso de Firma electrónica 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.
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 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.

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

Ejemplo

{
  "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 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:

Autenticación

Verificación

Monitorización

Plataforma

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

Visión general

Advertencias generadas

Los rechazos se pueden reabrir

Problemas que ve el firmante

Ejemplo

Tipos de advertencia

Relacionado

​Visión general

​Advertencias generadas

​Los rechazos se pueden reabrir

​Problemas que ve el firmante

​Ejemplo

​Tipos de advertencia

​Relacionado

Visión general

Advertencias generadas

Los rechazos se pueden reabrir

Problemas que ve el firmante

Ejemplo

Tipos de advertencia

Relacionado