> ## 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 e códigos de risco de assinatura eletrónica > Conheça os avisos de assinatura eletrónica da Didit, de SIGNATURE_DECLINED a SIGNATURE_DOCUMENT_CHANGED, os seus acionadores e regras. Um passo de [Assinatura eletrónica](https://docs.didit.me/pt/core-technology/electronic-signature/overview.md) 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](https://docs.didit.me/pt/core-technology/electronic-signature/report-electronic-signature.md). * 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](https://docs.didit.me/pt/management-api/workflows/feature-configs.md#assinatura-eletrónica) 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. > [!WARNING] > > 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](https://docs.didit.me/pt/core-technology/electronic-signature/overview.md#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](https://docs.didit.me/pt/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/core-technology/electronic-signature/report-electronic-signature.md#o-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: ## Conteúdo relacionado * [Visão geral da assinatura eletrónica](https://docs.didit.me/pt/core-technology/electronic-signature/overview.md) * [Relatório de assinatura eletrónica](https://docs.didit.me/pt/core-technology/electronic-signature/report-electronic-signature.md) * [Configurações de funcionalidades do fluxo](https://docs.didit.me/pt/management-api/workflows/feature-configs.md#assinatura-eletrónica) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.