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

Uma etapa de Assinatura eletrônica gera um aviso quando um signatário não pode ou não quer assinar: ele se recusa a assinar, fica sem códigos ou não pode ser associado a uma identidade verificada, ou um documento deixa de corresponder ao que lhe foi mostrado. Todo aviso interrompe a assinatura desse signatário, portanto nenhum documento assinado é emitido para ele. O efeito do aviso sobre o veredito fica a seu critério.

Visão geral

Um aviso aparece em dois lugares:

No item 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, marcada com o recurso SIGNATURE, com seu título e descrição. O console o exibe na aba Signature da sessão, e additional_data.signature_id aponta para o signatário.

Cada código corresponde a uma regra. Defina a regra como DECLINE, REVIEW ou NO_ACTION por etapa do fluxo de verificação (workflow), na aba Rules do console ou na configuração da etapa. A regra define o verdict do signatário (Declined, In Review ou Approved) e a severidade do aviso (error, warning ou information). As regras de status personalizadas da etapa são aplicadas após essa regra.

Uma regra decide o veredito, não se os documentos estão assinados. NO_ACTION permite que o fluxo prossiga, mas o signatário continua sem ter assinado. Verifique se status é signed antes de confiar em uma assinatura.

Avisos gerados

Código	Quando é gerado	Regra e padrão
`SIGNATURE_DECLINED`	O signatário recusou-se a assinar. Nenhuma cópia assinada é emitida e nada é cobrado.	`signature_declined_action`, padrão `REVIEW`
`SIGNATURE_OTP_FAILED`	O signatário digitou 3 códigos errados ou solicitou mais de 5 códigos.	`signature_otp_failed_action`, padrão `DECLINE`
`SIGNATURE_NAME_MISMATCH`	KYB: o nome declarado para a pessoa-chave não corresponde ao nome verificado dela, desconsiderando maiúsculas, minúsculas e espaços.	`signature_name_mismatch_action`, padrão `DECLINE`
`SIGNATURE_IDENTITY_NOT_VERIFIED`	O signatário não tem uma verificação de identidade aprovada que contenha um nome, uma verificação de prova de vida na sessão dele não está aprovada, ou a verificação de identidade mudou depois que o signatário começou.	`signature_identity_not_verified_action`, padrão `DECLINE`
`SIGNATURE_DOCUMENT_CHANGED`	Um documento não corresponde mais ao SHA-256 registrado quando foi mostrado ao signatário.	`signature_document_changed_action`, padrão `DECLINE`

As verificações de identidade e de nome são executadas quando o signatário solicita o código e novamente quando ele o digita, portanto esses avisos aparecem nesse momento, e não quando a etapa é aberta.

Recusas podem ser reabertas

SIGNATURE_DECLINED é o único aviso que um signatário pode desfazer. Enquanto o link de assinatura for válido, um signatário que recusou pode reabrir a etapa e assinar. Reabrir apaga o aviso do signatário e a leitura e a concordância dele em cada documento, portanto, ele precisa revisar os documentos novamente. O aviso sai da atividade da sessão assim que nenhum signatário da etapa estiver mais recusando. Reabrir não redefine as tentativas de código. Os demais avisos são definitivos para esse signatário.

Problemas que o signatário vê

Estes impedem o signatário de prosseguir sem gerar um aviso. O fluxo informa a ele o que aconteceu.

Situação	O que acontece
O link de assinatura expirou	A etapa não pode ser aberta nem concluída após `expires_at`. O link dura `signature_link_validity_days` a partir da criação da sessão.
O código expirou	Os códigos duram 5 minutos. O signatário solicita um novo.
Um novo código foi solicitado cedo demais	O signatário aguarda 60 segundos entre os códigos.
Nenhum contato verificado	O código é enviado somente para um e-mail ou telefone verificado anteriormente na sessão. Adicione Verificação de e-mail ou Verificação de telefone antes da etapa de assinatura.
Um campo obrigatório está vazio	O signatário não pode concluir um documento até que todos os campos obrigatórios dele tenham um valor. O fluxo mostra quantos faltam e leva ao primeiro.
O valor de um campo é recusado	Um valor que não atende à validação do campo, por exemplo, longo demais ou que não é um número, é recusado, e o fluxo informa o motivo.
O app é antigo demais para campos	Uma versão do SDK nativo sem suporte a campos não consegue exibir um documento com campos, e a etapa mostra um erro. Documentos sem campos continuam funcionando. 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 severidade de cada aviso segue a regra que você define. As severidades se dividem em três categorias:

Autenticação

Verificação

Monitoramento

Plataforma

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

Visão geral

Avisos gerados

Recusas podem ser reabertas

Problemas que o signatário vê

Exemplo

Tipos de aviso

Conteúdo relacionado

​Visão geral

​Avisos gerados

​Recusas podem ser reabertas

​Problemas que o signatário vê

​Exemplo

​Tipos de aviso

​Conteúdo relacionado

Visão geral

Avisos gerados

Recusas podem ser reabertas

Problemas que o signatário vê

Exemplo

Tipos de aviso

Conteúdo relacionado