Pular para o conteúdo
Sistemas próprios. Conhecimento aplicado.
Agência A2CRConte seu projeto
Automação

Assinatura eletrônica integrada ao sistema: documento enviado não é documento assinado

Desenhe documentos, signatários, estados e evidências de uma integração de assinatura, com confirmação no provedor e tratamento de recusa, expiração e reenvio.

Assinatura eletrônica integrada ao sistema: documento enviado não é documento assinado

O sistema gera um contrato, envia uma solicitação ao provedor e mostra “concluído”. No entanto, uma pessoa ainda não abriu o documento e outra recusou a assinatura. O erro não está necessariamente na tecnologia de assinatura. Ele pode estar na aplicação, que confundiu a criação do envio com a conclusão do processo.

Uma integração confiável precisa relacionar versão do documento, participantes, estados e evidências. Este guia trata dessa engenharia. A escolha do tipo de assinatura e sua adequação ao documento, às partes e ao contexto deve ser definida com os responsáveis competentes. A existência de uma API ou de um arquivo assinado não autoriza prometer validade universal para qualquer contratação.

1. Defina o que o processo precisa demonstrar

Antes de selecionar o provedor, descreva quais documentos serão assinados, quem deve participar, em qual ordem e qual etapa do negócio depende da conclusão. Uma proposta pode exigir um aceite; outro documento pode possuir requisitos diferentes de identidade e formalização.

Separe assinatura, aprovação interna e autorização de execução. Um gerente pode aprovar o texto antes do envio sem ser signatário. Um cliente pode assinar sem que todas as condições para iniciar o serviço tenham sido atendidas. A aplicação precisa representar esses fatos de forma distinta.

O ITI explica que o serviço VALIDAR verifica aspectos de autoria e integridade, dentro de seu escopo técnico, e não assume responsabilidade pelo conteúdo do documento. Essa distinção é importante: a verificação da assinatura não substitui a análise das obrigações descritas no texto.

2. Congele a versão que será enviada

Uma assinatura precisa estar vinculada ao documento efetivamente apresentado. Se a aplicação permite editar o arquivo depois do envio sem criar outra versão, a equipe pode perder a referência de qual conteúdo foi submetido às partes.

Registre uma versão imutável de envio, com identidade interna e referência do arquivo. Um resumo criptográfico pode ajudar a conferir os bytes preservados, mas não substitui autenticação do signatário nem interpretação jurídica do documento. Cada mecanismo possui uma finalidade específica.

O guia de gestão e versionamento de documentos aprofunda essa preparação. Na integração de assinatura, acrescente a relação entre a versão aprovada, a solicitação criada no provedor e o arquivo final obtido após o processo.

3. Modele a solicitação como uma entidade própria

A documentação de envelopes da Docusign descreve um contêiner que reúne documentos, destinatários e acompanhamento de situação. Outros provedores podem utilizar nomes e modelos diferentes. A aplicação deve conservar a referência recebida da plataforma concreta que utiliza.

ObjetoInformações principaisVerificação necessária
DocumentoVersão e arquivo de origemO conteúdo enviado corresponde ao aprovado?
SolicitaçãoProvedor, identificador e situaçãoQual processo está sendo acompanhado?
ParticipantePapel, ordem e referênciaEsta pessoa deve assinar ou apenas receber cópia?
AtualizaçãoEvento, origem e momentoA mudança é autêntica e aplicável?
Evidência finalArquivo e registros disponíveisO conjunto pode ser localizado e conferido?

Não guarde somente um endereço de assinatura em um campo de texto. O link pode expirar ou mudar. A identidade do processo é o vínculo que permite consultar sua situação e recuperar os documentos conforme as regras do provedor.

4. Diferencie os estados da jornada

Preparado, enviado, acessado, parcialmente assinado, concluído, recusado e expirado podem representar situações diferentes. Utilize os estados realmente fornecidos pela integração e mantenha uma tradução explícita para o vocabulário da empresa.

Não trate uma notificação por e-mail enviada com sucesso como confirmação de assinatura. Da mesma forma, abrir o documento não demonstra conclusão. O sistema deve mostrar o que sabe e qual participante ou condição ainda falta.

Defina quais estados permitem a próxima ação. Em um fluxo, somente a conclusão de todos os signatários exigidos pode liberar uma etapa. Em outro, ainda é necessária uma aprovação adicional. A regra deve estar no servidor e ser testada com estados intermediários.

5. Planeje ordem, identidade e representação dos participantes

Uma assinatura pode ocorrer em paralelo ou em sequência. Se a ordem faz parte da regra do negócio, ela deve aparecer na configuração e ser conferida. Uma mudança de signatário não pode acontecer silenciosamente porque o responsável original deixou de responder.

Defina como os participantes serão identificados e quais mecanismos de autenticação são adequados ao caso. Não utilize os dados recebidos de um formulário público como prova suficiente de que a pessoa possui poderes para assumir uma obrigação em nome de uma organização.

Os papéis também precisam ser claros. Assinante, aprovador, testemunha e destinatário de cópia podem exigir tratamento distinto. A aplicação não deve contar todos os nomes associados ao processo como se fossem assinaturas necessárias à conclusão.

6. Receba notificações com verificação de origem

Uma notificação informa que algo pode ter mudado no provedor. Ela não deve ser aceita apenas porque possui um identificador conhecido no corpo. A integração precisa verificar origem e integridade segundo o mecanismo oferecido.

A documentação HMAC do Docusign Connect apresenta uma forma de autenticar notificações e conferir seu conteúdo. A implementação deve seguir o procedimento do provedor adotado e proteger as credenciais no servidor.

Depois da validação, aplique a mudança com uma identidade de processamento. A mesma atualização pode ser reenviada. O conteúdo sobre webhooks e idempotência ajuda a separar uma repetição técnica de uma nova ação empresarial. Um aviso repetido não deve abrir duas ordens de execução.

7. Confirme situações críticas antes de agir

Eventos podem chegar fora de ordem ou após uma interrupção. Para liberar uma ação relevante, a aplicação pode precisar consultar a situação atual no provedor, conforme o desenho e as capacidades da integração. O objetivo é evitar que uma mensagem antiga retroceda ou conclua indevidamente o processo.

Mantenha data da última consulta e estado confirmado. Se a verificação falhar, deixe a etapa pendente e mostre o motivo operacional. Não transforme falta de resposta em aprovação automática para manter o fluxo andando.

Também controle as consultas periódicas. Repetir chamadas sem necessidade pode consumir limites e dificultar a operação. Utilize notificações, reconciliação e tentativas limitadas de maneira coordenada, respeitando as orientações da plataforma utilizada.

8. Caso fictício: três participantes e um reenvio

A empresa fictícia Porto Consultoria prepara uma solicitação com dois signatários obrigatórios e um destinatário de cópia. O primeiro signatário conclui sua etapa. O segundo recusa o documento. A pessoa em cópia abre a mensagem. Nesse cenário, há uma assinatura concluída, uma recusa e uma visualização, não três assinaturas.

A equipe corrige uma condição comercial e cria outra versão do documento. O novo envio deve possuir referência própria e apontar a versão anterior, que permanece com sua situação histórica. Copiar a marcação de conclusão do primeiro signatário para o novo documento seria incorreto, pois o conteúdo mudou.

No teste, o provedor reenvia duas vezes o evento de conclusão do novo processo. O sistema registra a atualização sem liberar duas execuções. Todos os nomes e acontecimentos deste caso são fictícios e servem para demonstrar critérios de integração.

9. Organize o pacote de evidências e sua recuperação

Ao concluir o processo, localize o documento final e os registros disponibilizados pelo provedor. Preserve a relação com a versão enviada e com a solicitação. O arquivo não deve ficar acessível apenas por um link temporário copiado para uma mensagem.

Defina armazenamento, acesso, retenção e exportação. O prazo adequado depende das obrigações e do contexto da empresa; a equipe técnica precisa receber essa política. Evite guardar indiscriminadamente dados pessoais que não sejam necessários à finalidade aprovada.

Na recuperação, uma pessoa autorizada deve conseguir localizar o conjunto correto sem pesquisar manualmente em várias contas. Teste a exportação e a conferência do arquivo, incluindo uma situação em que o fornecedor esteja temporariamente indisponível. A continuidade não pode depender apenas de lembrar quem realizou o envio.

10. Trate recusa, expiração e correção como fluxos completos

Uma recusa exige um destino: análise, encerramento ou nova negociação. Uma expiração pode exigir reenvio ou cancelamento. Cada decisão deve preservar o contexto anterior, em vez de simplesmente colocar tudo de volta no estado “aguardando”.

Para correções, declare quando é permitido ajustar a solicitação e quando um novo processo é necessário. Essas possibilidades variam entre produtos e configurações. O teste deve utilizar a capacidade efetivamente contratada, não uma suposição baseada em outra plataforma.

Se a empresa utiliza um procedimento manual pequeno e controlado, talvez uma integração extensa ainda não seja prioritária. Compare volume, retrabalho, necessidade de evidência e custo de operação. Uma automação proporcional ao risco pode começar com geração controlada e conferência antes de ampliar o escopo.

11. Oficina de homologação e checklist

Use documentos sintéticos, participantes de teste e ambiente de homologação apropriado. Não envie solicitações reais a clientes para verificar se a integração funciona. Prepare casos de assinatura completa, recusa, expiração, alteração de documento e repetição de atualização.

Para cada cenário, escreva o estado esperado e a ação permitida. Ao terminar, peça a outra pessoa que encontre a versão enviada, a situação confirmada e as evidências correspondentes. O processo deve ser explicável sem acesso irrestrito à conta do fornecedor.

  • O tipo de assinatura foi definido para o contexto com os responsáveis competentes.
  • O documento enviado possui versão preservada.
  • A solicitação mantém a referência do provedor.
  • Papéis e ordem dos participantes estão explícitos.
  • Envio, visualização e assinatura são estados distintos.
  • Notificações têm origem e integridade verificadas.
  • Repetições não duplicam ações posteriores.
  • Estados críticos podem ser reconciliados com o provedor.
  • Recusa e expiração possuem procedimentos definidos.
  • Documentos finais e evidências são recuperáveis por pessoas autorizadas.
  • Correções preservam o histórico e a versão apropriada.

Perguntas frequentes

Colocar uma imagem de assinatura no PDF resolve a integração?

Não demonstra o mesmo processo. Uma imagem não informa, por si só, quem realizou uma ação, em qual contexto e com quais evidências. O projeto precisa atender ao método de assinatura e às verificações definidos para o documento, e não apenas produzir uma aparência visual.

O retorno de sucesso da API significa que o documento foi assinado?

Não necessariamente. Ele pode confirmar apenas a criação ou o envio de uma solicitação. A conclusão deve ser verificada pelos estados e registros fornecidos pela integração, considerando os participantes efetivamente exigidos.

Um relatório de validação garante qualquer contrato?

Não. A verificação técnica de autoria e integridade possui um escopo. Ela não substitui a avaliação do conteúdo, da representação das partes ou dos requisitos aplicáveis ao caso. A empresa deve definir essas condições com seus responsáveis antes de automatizar a etapa.

Integre a assinatura à jornada completa do documento

Para discutir uma automação e integração de sistemas com a Agência A2CR, organize versões, participantes, estados e ações posteriores. Esses elementos permitem criar uma cerimônia de assinatura acompanhável, com pendências visíveis e evidências que a equipe consiga recuperar quando precisar.

Modelo para aplicar na sua empresa

Baixar o checklist de integração de assinatura eletrônica no sistema. Use-o para registrar evidências, responsáveis e pendências da avaliação.

Fontes consultadas

Revisão documental: 18/11/2026. Cenários e números didáticos não representam resultados medidos de clientes. A aplicação exige conferir a documentação e as condições do projeto.

Compartilhar