> ## 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. # Avisos de assinatura eletrônica e códigos de risco > Todos os avisos de assinatura eletrônica da Didit, de SIGNATURE_DECLINED a SIGNATURE_DOCUMENT_CHANGED: o que os aciona e a regra que os controla. Uma etapa de [Assinatura eletrônica](https://docs.didit.me/pt-br/core-technology/electronic-signature/overview.md) 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](https://docs.didit.me/pt-br/core-technology/electronic-signature/report-electronic-signature.md). * 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](https://docs.didit.me/pt-br/management-api/workflows/feature-configs.md#assinatura-eletrônica) 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. > [!WARNING] > > 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](https://docs.didit.me/pt-br/core-technology/electronic-signature/overview.md#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](https://docs.didit.me/pt-br/core-technology/electronic-signature/overview.md#a-experiência-de-assinatura). | ## Exemplo ```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 } ] } ``` O exemplo mostra apenas os campos que mudam. Todos os outros campos do [objeto de assinatura](https://docs.didit.me/pt-br/core-technology/electronic-signature/report-electronic-signature.md#o-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: ## Conteúdo relacionado * [Visão geral da assinatura eletrônica](https://docs.didit.me/pt-br/core-technology/electronic-signature/overview.md) * [Relatório de assinatura eletrônica](https://docs.didit.me/pt-br/core-technology/electronic-signature/report-electronic-signature.md) * [Configurações de recursos do fluxo de verificação](https://docs.didit.me/pt-br/management-api/workflows/feature-configs.md#assinatura-eletrônica) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.