Mudanças entre as edições de "Integração com DocuSign"
Linha 6: Linha 6:
 
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.  
 
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 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.
+
É 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 ==
 
== Configuração inicial ==
  
−
Para utilizar o módulo de blacklist, deve-se ativar o parâmetro '''HABILITA BLACKLIST''' no perfil do administrador. Para isso, acesse o menu '''User > Perfil > aba Personalização''', modifique o campo '''HABILITA BLACKLIST''' para Sim e clique em Salvar.
+
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.
  
  
−
== Cadastro de telefones ==
+
Após isso, acesse sua área no DocuSign 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.
  
  
−
Quando o parâmetro '''HABILITA BLACKLIST''' estiver marcado como Sim, o sistema exibirá o botão '''Blacklist''' na tela de negociação do devedor, conforme ilustra a imagem abaixo.
+
== 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:
  
−
Dica: a tela de negociação do devedor pode ser acessada pelo administrador por meio do menu '''Cadastros > Devedores > ícone Neg. (negociar) em frente ao devedor em questão'''.
+
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 ==
  
 
[[Arquivo:TelaNegBlacklist.png | none | 900px]]
 
[[Arquivo:TelaNegBlacklist.png | none | 900px]]
 
''[[:imagem:TelaNegBlacklist.png| Tela de negociação do devedor com destaque para o botão Blacklist ]]''
 
''[[:imagem:TelaNegBlacklist.png| Tela de negociação do devedor com destaque para o botão Blacklist ]]''
 +
 +
== Habilitando o acesso em ambiente de produção ==

Edição das 14h04min de 3 de novembro de 2021

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 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.


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

TelaNegBlacklist.png

Tela de negociação do devedor com destaque para o botão Blacklist

Habilitando o acesso em ambiente de produção

Disponível em "http://docs.recuperador.com.br/index.php?title=Integração_com_DocuSign&oldid=821"