Next BP

Manual do Usuário

Integrações

Manual Técnico

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.

  1. Em Apps and Keys, anote o User ID e o API Account ID exibidos no topo da página.
  2. Clique em Add App and Integration Key, dê um nome (ex.: Next BP) e anote a Integration Key.
  3. 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.
  4. 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.
  5. 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:

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

  1. Preencha Ambiente, Integration Key, User ID, API Account ID, Chave privada RSA e Connect HMAC Secret e salve sem habilitar a integração.
  2. 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.
  3. 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:

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

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

Índice do Manual
Next BP versão 24.194.1