Avisos e códigos de risco de assinatura eletrónica

Um passo de Assinatura eletrónica gera um aviso quando um signatário não pode ou não quer assinar: recusa, esgota os códigos ou não é possível associá-lo a uma identidade verificada, ou um documento já não corresponde ao que lhe foi apresentado. Cada aviso interrompe a assinatura desse signatário, pelo que nenhum documento assinado é emitido para esse signatário. O efeito do aviso no veredito cabe a si decidir.

Visão geral

Um aviso surge em dois locais:

No elemento do signatário em signatures[], como { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" } em warnings[]. Consulte o Relatório de assinatura eletrónica.
Na atividade da sessão, etiquetado com a funcionalidade SIGNATURE, com o respetivo título e descrição. A consola apresenta-o no separador Assinatura da sessão, e additional_data.signature_id aponta para o signatário.

Cada código mapeia para uma regra. Defina a regra como DECLINE, REVIEW ou NO_ACTION para cada passo do fluxo, no separador Regras da consola ou na configuração do passo. A regra define o verdict do signatário (Declined, In Review ou Approved) e a gravidade do aviso (error, warning ou information). As regras de estado personalizadas no passo aplicam-se posteriormente.

Uma regra decide o veredito, mas não determina se os documentos são assinados. NO_ACTION permite que o fluxo continue, mas o signatário continua sem ter assinado. Verifique se o status está como signed antes de confiar numa assinatura.

Avisos gerados

Código	Quando é gerado	Regra e predefinição
`SIGNATURE_DECLINED`	O signatário recusou assinar. Nenhuma cópia assinada é emitida e nada é cobrado.	`signature_declined_action`, predefinição `REVIEW`
`SIGNATURE_OTP_FAILED`	O signatário introduziu 3 códigos errados ou pediu mais de 5 códigos.	`signature_otp_failed_action`, predefinição `DECLINE`
`SIGNATURE_NAME_MISMATCH`	KYB: o nome declarado para a pessoa-chave não corresponde ao seu nome verificado, ignorando maiúsculas/minúsculas e espaçamento.	`signature_name_mismatch_action`, predefinição `DECLINE`
`SIGNATURE_IDENTITY_NOT_VERIFIED`	O signatário não tem uma verificação de identidade aprovada com um nome, uma verificação de prova de vida na sua sessão não está aprovada ou a verificação de identidade foi alterada após o signatário ter começado.	`signature_identity_not_verified_action`, predefinição `DECLINE`
`SIGNATURE_DOCUMENT_CHANGED`	Um documento já não corresponde ao SHA-256 registado quando foi apresentado ao signatário.	`signature_document_changed_action`, predefinição `DECLINE`

As verificações de identidade e de nome são executadas quando o signatário pede o seu código e novamente quando o introduz, pelo que estes avisos surgem nesse momento e não quando o passo é aberto.

Recusas podem ser reabertas

SIGNATURE_DECLINED é o único aviso que um signatário pode anular. Enquanto a ligação de assinatura for válida, um signatário que tenha recusado pode reabrir o passo e assinar. A reabertura limpa o aviso do signatário e a respetiva leitura e aceitação em cada documento, pelo que este percorre novamente os documentos. O aviso deixa a atividade da sessão assim que nenhum signatário do passo estiver a recusar. A reabertura não reinicia as suas tentativas de código. Os outros avisos são finais para esse signatário.

Problemas que o signatário visualiza

Estes problemas impedem o signatário sem gerar um aviso. O fluxo informa-o sobre o que aconteceu.

Situação	O que acontece
A ligação de assinatura expirou	O passo não pode ser aberto nem concluído após `expires_at`. A ligação dura `signature_link_validity_days` a contar da criação da sessão.
O código expirou	Os códigos duram 5 minutos. O signatário pede um novo.
Um novo código foi pedido demasiado cedo	O signatário aguarda 60 segundos entre códigos.
Nenhum contacto verificado	O código é enviado apenas para um e-mail ou telefone verificado anteriormente na sessão. Adicione Verificação de e-mail ou Verificação de telefone antes do passo de assinatura.
Um campo obrigatório está vazio	O signatário não pode concluir um documento até que todos os campos obrigatórios no mesmo tenham um valor. O fluxo mostra quantos faltam e salta para o primeiro.
O valor de um campo é recusado	Um valor que viole a validação do respetivo campo, por exemplo por ser demasiado longo ou não ser um número, é recusado e o fluxo indica o motivo.
A aplicação é demasiado antiga para campos	Uma versão do SDK nativo sem suporte para campos não consegue apresentar um documento com campos, e o passo apresenta um erro. Os documentos sem campos continuam a funcionar. Consulte A experiência de assinatura.

Exemplo

{
  "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
    }
  ]
}

O exemplo mostra apenas os campos que mudam. Todos os outros campos do objeto de assinatura continuam presentes.

Tipos de aviso

A gravidade de cada aviso segue a regra que definir. As gravidades dividem-se em três categorias:

Autenticação

Verificação

Monitorização

Plataforma

Avisos e códigos de risco de assinatura eletrónica

Visão geral

Avisos gerados

Recusas podem ser reabertas

Problemas que o signatário visualiza

Exemplo

Tipos de aviso

Conteúdo relacionado

​Visão geral

​Avisos gerados

​Recusas podem ser reabertas

​Problemas que o signatário visualiza

​Exemplo

​Tipos de aviso

​Conteúdo relacionado

Visão geral

Avisos gerados

Recusas podem ser reabertas

Problemas que o signatário visualiza

Exemplo

Tipos de aviso

Conteúdo relacionado