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

Un pas de Signatura electrònica 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.
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ó 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.

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

Exemple

{
  "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 continuen presents.

Tipus d’advertència

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

Autenticació

Verificació

Monitoratge

Plataforma

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

Visió general

Advertències generades

Els rebutjos es poden reobrir

Problemes que veu el signant

Exemple

Tipus d’advertència

Relacionat

​Visió general

​Advertències generades

​Els rebutjos es poden reobrir

​Problemes que veu el signant

​Exemple

​Tipus d’advertència

​Relacionat

Visió general

Advertències generades

Els rebutjos es poden reobrir

Problemes que veu el signant

Exemple

Tipus d’advertència

Relacionat