Manual criação de Conta para API Docusing

Acessamos o site https://account-d.docusign.com/logout e clicamos em No account? Sign up for free.

Preenchemos os campos e clicamos em Get Started.

 

Receberemos um alerta por email.

Clicamos em Activate.

Preenchemos o campo senha e clicamos em log in.

Acessaremos a tela principal do sistema, clique em Settings.

Clique no menu Apps and Keys.

Acessaremos a tela principal de Apps and Keys onde iremos criar uma “Aplicação” (que é composta por alguns parâmetros que utilizaremos)

Podemos notar o User Id na aba My Account Information.

Este user ID deve ser informado na Conta da empresa, pois o mesmo será utilizado posteriormente na tarefa da API Docusing.

OBS: A senha pode ser um valor aleatório, pois a autenticação será feita pela chave primaria.

Clique em Add App And Integration KEY para criarmos a aplicação. 

Digite um nome, e clique em Create APP.

Após a criação do “App”, no inicio da tela, visualizaremos as informações da integration Key, este valor deve ser preenchido na chave de configuração do sworks URL_WS_DOCU_SIGN_INTEGRATOR_KEY.

Rolamos a tela para baixo, devemos criar o RSA que será a chave privada do usuário. 

Clique no botão Generate RSA.

Na próxima tela será exibido as chaves do usuário, devemos copiar a chave Private Key e inserir na chave de configuração do sworks DOCU_SIGN_PRIVATE_KEY.

OBS: Para a segurança, recomenda se marcar a chave como protegida. 

Rolando a pagina, clique no botão ADD URL e insira o link http://localhost no campo Redirect URL.

OBS: Anote este link, pois ele será utilizado para darmos autorização a aplicação. 

Role até o final e clique em Salvar.

Na pagina principal, clique no menu Connect.

Clique para Add Configuration do tipo Custom.

Preencha o campo nome. 

No campo URL To Publish, vamos inserir o link da API do Sworks que receberá o retorno do Docusing após a assinatura do documento. 

O link deve ser composto da seguinte forma: 

https://hml-sworks.sinqia.com.br/Sworks.WebApiV25/api/callback/docusign/enviardocumentoparaassinatura

Sendo que a primeira parte muda de acordo com a versão do sworks, porém da /api em diante, o valor deve ser igual. 

Rolando a pagina, no campo Event Settings, devemos selecionar a opção Legacy.

Rolando a pagina para baixo, na aba Envelope and Recipients devemos marcar as opções conforme o print. 

Role até o final da pagina e clique em ADD CONFIGURATION.

Feito a configuração, agora precisamos dar permissão na aplicação para que ele possa fazer solicitações de assinatura. 

Atraves da url podemos observar como é feito esta liberação: https://www.docusign.com/blog/developers/oauth-jwt-granting-consent

Basicamente, iremos utilizar a url padrão: 

SERVER/oauth/auth?response_type=code &scope=signature%20impersonation&client_id=CLIENT_ID &redirect_uri=REDIRECT_URI

- O SERVER deve ser composto pelo link https://account.docusign.com (produção) ou https://account-d.docusign.com (homologação). 

- O CLIENT_ID é o valor do Integration Key da aplicação que criamos, que neste exemplo seria cbb9ee1d-be8a-4494-b994-54c7caec2a7f.

O REDIRECT_URL é aquela URL criada dentro da aplicação, exemplo http://localhost.

OBS: Esta URL precisa ser codificada. Para isso acesse o site https://www.urlencoder.org/, insira a url na parte de cima e clique em ENCODE.

Devemos substituir os valores de exemplo da URL padrão, conforme os valores acima. A url ficará desta forma.

https://account-d.docusign.com/oauth/auth?response_type=code &scope=signature%20impersonation&client_id= cbb9ee1d-be8a-4494-b994-54c7caec2a7f&redirect_uri=http%3A%2F%2Flocalhost

Copiamos este link e colamos no navegador. 

Devemos clicar no botão ALLOW ACESS para darmos autorização. 

Será apresentado a tela de confirmação abaixo.

Feito isso, vamos até o SWorks.

Além das chaves de configuração criadas que foram informadas durante este manual, será necessário criar outras chaves com os seguintes dados. 

URL_WS_DOCU_SIGN_URL com o valor https://demo.docusign.net/restapi/

URL_WS_DOCU_SIGN_ACCOUNT_URL com o valor account-d.docusign.com (se homolog).

URL_WS_DOCU_SIGN_VERSAO com o valor 2.

Acessamos a tela de Definições de Objetos e criamos um objeto conforme os dados abaixo.

Feito isso, criaremos um WF.

Criaremos um Relacionamento para este WF.

Este WF terá uma tarefa com o método CriarObjetoComExpressão.

Os valores serão preenchidos através dos dados de entrada. 

Posteriormente criaremos uma tarefa com a API Sworks.Docusing.API.ddd e o método EnviarDocumentoParaAssinatura

Devemos preencher os campos conforme o exemplo abaixo.

OBS: O WF precisa de uma tarefa de tipificação para tipificar o documento de acordo com o formulário necessário. 

Criaremos um WF, o telefone precisa está no formato +55xxxxxxxxxx

OBS: No teste, informe um telefone valido, pois será necessário receber uma sms para a autenticação. 

Executamos um processo, tipificamos um documento antes do envio, podemos notar que a tarefa de assinatura está com status aguardando, ou seja, o documento foi enviado para assinatura e agora o sistema está aguardando a assinatura por parte do cliente. 

 

Recebemos um email com o link que acessará o documento que deve ser assinado. 

Clicamos no botão “Review Document” do email, fomos direcionados a uma tela de autenticação, onde deveremos escolher a forma que desejamos autenticar o acesso. 

Selecionaremos a autenticação via SMS

Digitamos o código que recebemos por sms e clicamos em “Confirm Code”

Somos direcionados a uma tela onde visualizaremos o documento enviado, devemos clicar em Continue.

Depois devemos clicar no botão Sign.

Devemos selecionar o tipo de assinatura que iremos usar, posteriormente clique em Adopt and Sign

A assinatura será inserida, posteriormente devemos clicar no botão Finish.

Clicamos no botão No Thanks.

Podemos visualizar a confirmação da assinatura. 

Neste momento podemos verificar que a tarefa foi aprovada com sucesso. 

Alem disto, receberemos uma copia do documento assinado por email.

Ao acessarmos o painel de gerenciamento do Docusing, poderemos observar que o aplicativo possui um limite de 20 requisições. Após ultrapassarmos este limite, será necessário criarmos um novo aplicativo.

OBS: Quando criarmos uma nova aplicação, devemos dar permissão para a mesma, utilizando sua nova integration key como informado nas paginas 24 e 25 deste manual.