Integração com DocuSign

Neste capítulo, falaremos sobre como configurar a integração com a empresa DocuSign para permitir a assinatura digital de termos de acordo com validade jurídica.

DocuSign

DocuSign, Inc. é uma empresa americana com sede em San Francisco, Califórnia, que permite que as organizações gerenciem contratos eletrônicos. Como parte do DocuSign Agreement Cloud, a DocuSign oferece eSignature, uma forma de assinar eletronicamente em diferentes dispositivos.

É possível contratar um plano de assinaturas digitais por meio do site da empresa: https://www.docusign.com. O plano escolhido deverá ser um plano de API, para permitir a integração com sistemas de terceiros, que é o caso do Recuperador CRM. No momento da escrita dessa documentação, o site https://www.docusign.com/products-and-pricing/api-plans apresenta planos de API compatíveis com o Recuperador CRM.

Dica: pode-se criar uma conta de desenvolvedor grátis no DocuSign para configurar a integração, fazer os testes em ambiente de homologação e depois contratar um plano real para entrar em produção.

Configuração inicial

Para utilizar o módulo de integração com DocuSign, deve-se ativar o parâmetro HABILITA INTEGRAÇÃO COM DOCUSIGN no perfil do administrador. Para isso, acesse o menu User > Perfil > aba DocuSign, modifique o campo HABILITA INTEGRAÇÃO COM DOCUSIGN para Sim e clique em Salvar.

Após isso, acesse sua área no DocuSign, entre em Settings > Apps and Keys e obtenha os dados para completar os demais campos da integração. É necessário iniciar em ambiente de Homologação, fazer pelo menos 15 assinaturas de teste para depois migrar para o ambiente de produção. Não esqueça de clicar em Salvar após o término do preenchimento.

Tela de configuração da integração com DocuSign no perfil do administrador

Dica: homologação significa testes. Ou seja, todas as assinaturas colhidas em homologação não possuem validade jurídica e servem apenas para configurar a integração e avaliar o produto.

Habilitando o acesso em ambiente de homologação

Após preencher os campos da integração com DocuSign em ambiente de homologação e salvar, é necessário acessar o link abaixo para autorizar a autenticação da conta:

https://account-d.docusign.com/oauth/auth?response_type=code&scope=signature%20impersonation&client_id=INFORMAR_AQUI_O_INTEGRATION_KEY&state=a39fh23hnf23&redirect_uri=http://localhost:8080/ds/callback

Note que no link há um código escrito INFORMAR_AQUI_O_INTEGRATION_KEY. Substitua esse código pelo Integration Key da sua conta do DocuSign antes de acessar o link. Ao acessar o link, o sistema do DocuSign pedirá uma confirmação e solicitará seu login e senha para autorizar o acesso à API.

Chave RSA

Além da segurança pela autenticação, o Docusign também exige uma chave RSA. Dentro da área do desenvolvedor no site do DocuSign, clique em Settings > Apps and Keys > Edit em frente ao aplicativo criado. Clique em Upload RSA e informe a chave RSA a ser obtida com o suporte do Recuperdor CRM por meio do e-mail contato@recuperador.com.br.

Testando a assinatura

A partir do momento que a integração do DocuSign estiver habilitada e todos os campos da integração estiverem preenchidos, será exibido um novo botão Solicitar assinatura do termo de acordo na tela de detalhes do acordo para enviar a solicitação da assinatura do devedor no termo de acordo via DocuSign. Com isso, o termo de acordo será gravado em PDF no DocuSign e será enviado um e-mail para o devedor para assinatura.

Tela de detalhes do acordo com destaque para o botão Solicitar assinatura do termo de acordo

Importante: é necessário configurar o modelo do termo de acordo do credor em Cadastros > Credores > ícone alt. (alterar) em frente ao credor > botão Modelo do termo de acordo para viabilizar a geração do termo de acordo.

Acompanhando assinaturas solicitadas

O relatório de acordos, presente em Financeiro > Negociações > Relatório de acordos, possui um filtro ASSINATURA SOLICITADA VIA DOCUSIGN para permitir o acompanhamento de acordos que possuem assinatura solicitada. Com isso, é possível acessar o ícone vis. (visualizar) de acordos que não tenham assinatura solicitada e rapidamente solicitar a assinatura.

Também, é possível conferir o campo EnvelopeID DocuSign para saber o código da assinatura no DocuSign. o Campo Solicitante da assinatura DocuSign para saber o login do responsável pela solicitação da assinatura e a data/hora da solicitação da assinatura.

Por fim, deve-se acompanhar o status da assinatura diretamente pelo portal do DocuSign. Nele, é possível configurar retentativas e lembretes de assinatura em documentos pendentes.

Habilitando o acesso em ambiente de produção

Após finalizar as 15 assinaturas no ambiente de homogação, será possível migrar para o ambiente de produção.

Para tal, altere o campo AMBIENTE DOCUSIGN para Produção na aba DocuSign no perfil do administrador e salve. Logo após, é necessário acessar o link abaixo para autorizar a autenticação da conta:

https://account.docusign.com/oauth/auth?response_type=code&scope=signature%20impersonation&client_id=INFORMAR_AQUI_O_INTEGRATION_KEY&state=a39fh23hnf23&redirect_uri=http://localhost:8080/ds/callback

Note que no link há um código escrito INFORMAR_AQUI_O_INTEGRATION_KEY. Substitua esse código pelo Integration Key da sua conta do DocuSign antes de acessar o link. Ao acessar o link, o sistema do DocuSign pedirá uma confirmação e solicitará seu login e senha para autorizar o acesso à API de produção.