DocuSign - Assinatura Eletrônica de Documentos
No Next BP existe a possibilidade de integração com a DocuSign para assinaturas eletrônicas de documentos do GED e de anexos de solicitações de processo.
Quais as premissas para configurar a integração com o Next BP
Para habilitar esta integração é necessário que você (administrador do sistema) possua uma conta da DocuSign com acesso à API (eSignature).
A integração autentica com um usuário de serviço da conta (OAuth JWT Grant): os envelopes são enviados em nome desse usuário, que precisa autorizar o Next BP uma única vez (consentimento).
O Next BP precisa estar acessível pela internet, em HTTPS, para que a DocuSign avise o andamento das assinaturas (webhook). O endereço usado é o APP_URL_EXT da configuração do servidor, ou o APP_URL quando ele não estiver definido. Sem HTTPS, os documentos são enviados normalmente, mas a situação e o arquivo assinado não voltam para o Next BP.
O que preparar na DocuSign
Todos os itens ficam no painel administrativo da DocuSign (Settings). Em contas de testes, use o ambiente de demonstração (apps-d.docusign.com); em produção, apps.docusign.com.
- Em Apps and Keys, anote o User ID e o API Account ID exibidos no topo da página.
- Clique em Add App and Integration Key, dê um nome (ex.: Next BP) e anote a Integration Key.
- No app criado, em Authentication, clique em Generate RSA e copie a chave privada completa (incluindo as linhas
BEGIN e END). A DocuSign exibe a chave somente uma vez.
- Ainda no app, em Additional settings > Redirect URIs, adicione o endereço exibido no campo Redirect URI da tela de configuração do Next BP.
- Em Connect > Connect Keys (HMAC), clique em Add Secret Key e copie a chave gerada.
Onde eu configuro a DocuSign no Next BP?
Acesse Configurações > DocuSign Assinaturas.
Onde:
- Ambiente: Demonstração (contas de desenvolvedor) ou Produção
- Integration Key: chave do app criado na DocuSign
- User ID: identificador do usuário de serviço, que envia os envelopes
- API Account ID: identificador da conta
- Chave privada RSA: chave gerada no app. Depois de salva, não é exibida novamente; cole uma nova chave somente para substituí-la
- Redirect URI: endereço que deve ser cadastrado no app da DocuSign
- Conceder consentimento: abre a página da DocuSign em que o usuário de serviço autoriza o Next BP. Faça logado na DocuSign com esse usuário
- Webhook URL Next BP: endereço que recebe os eventos das assinaturas. É enviado pelo próprio Next BP em cada envelope, não precisa ser cadastrado na DocuSign
- Connect HMAC Secret: chave gerada em Connect Keys, usada para validar que os eventos recebidos vieram da DocuSign
- Habilitar assinaturas de documentos com a DocuSign: ao salvar habilitado, o Next BP autentica na DocuSign. Se a autenticação falhar, as configurações ficam salvas e a integração continua desabilitada
O botão Testar conexão autentica com as configurações salvas e mostra o nome da conta.
Passo a passo da primeira configuração
- Preencha Ambiente, Integration Key, User ID, API Account ID, Chave privada RSA e Connect HMAC Secret e salve sem habilitar a integração.
- Clique em Conceder consentimento, faça login na DocuSign com o usuário de serviço e clique em Allow Access. Ao final, a DocuSign redireciona para o Next BP.
- Marque Habilitar assinaturas de documentos com a DocuSign e salve.
Como eu solicito a assinatura de documentos?
Com a integração habilitada, no módulo GED, clique com o botão direito sobre um documento e escolha Assinaturas (DocuSign). Será exibido o histórico de envios do documento, com o botão Solicitar Assinaturas.
Na tela de signatários:
- Email e Nome Completo: obrigatórios
- Assinar Como: Assinar, Acusar recebimento (o destinatário só confirma que recebeu o documento) ou Receber cópia (recebe o documento assinado ao final, sem precisar agir)
- CPF e Celular: informativos, ficam registrados no Next BP
- Solicitar assinaturas na ordem especificada: o documento só segue para o próximo destinatário depois da ação do anterior. Arraste as linhas para mudar a ordem
- Enviar lembrete a cada: a DocuSign reenvia o e-mail aos destinatários pendentes no intervalo escolhido
- Mensagem: texto incluído no e-mail enviado pela DocuSign
Nas solicitações de processo, o campo de anexo tem a opção Assinaturas (DocuSign). Com o anexo já salvo, abre o histórico do documento. Antes de salvar, os signatários ficam guardados e o envio acontece quando a atividade é enviada.
Os destinatários assinam pelo e-mail da DocuSign. Como o Next BP não posiciona campos de assinatura no documento, a própria DocuSign pede que o signatário escolha onde assinar.
Histórico de envios
- Situação do envio: Aguardando, Finalizado, Recusado (algum destinatário recusou) ou Cancelado
- Situação de cada destinatário: Aguardando, Finalizado, Recusado, E-mail não entregue ou Recebe cópia
- Enquanto o envio estiver aguardando, é possível cancelá-lo. O envelope é anulado na DocuSign e os destinatários são avisados
- Quando todos assinam, o Next BP baixa o PDF assinado (com o certificado de conclusão) e envia um e-mail ao solicitante. O download fica disponível no histórico
Se o download do documento assinado falhar, ele é refeito pelo Job Sign_Reprocessar_Finalizados_Sem_Download.job.php, que precisa estar ativo no Job Scheduler.
Considerações Finais
- Documentos com extensões diferentes de doc, docx ou pdf não podem ser enviados à DocuSign pelo Next BP.
- Para usar a integração em produção, o app precisa passar pela revisão de produção da DocuSign (Go-Live), feita no painel da DocuSign depois de alguns envios bem-sucedidos no ambiente de demonstração. Depois de aprovado, gere na conta de produção a chave RSA, o HMAC, copie o User ID e o API Account ID de produção, troque o Ambiente para Produção e conceda o consentimento novamente.