Integração com DocuSign - Histórico de revisão

Suporte em 14h48min de 3 de novembro de 2021

2021-11-03T14:48:23Z

Suporte em 14h40min de 3 de novembro de 2021

2021-11-03T14:40:31Z

Suporte em 14h37min de 3 de novembro de 2021

2021-11-03T14:37:14Z

Suporte em 14h29min de 3 de novembro de 2021

2021-11-03T14:29:13Z

Suporte em 14h22min de 3 de novembro de 2021

2021-11-03T14:22:47Z

Suporte em 14h21min de 3 de novembro de 2021

2021-11-03T14:21:16Z

Suporte em 14h20min de 3 de novembro de 2021

2021-11-03T14:20:13Z

Suporte em 14h04min de 3 de novembro de 2021

2021-11-03T14:04:08Z

Suporte em 13h48min de 3 de novembro de 2021

2021-11-03T13:48:51Z

Suporte: Criou página com '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. == Conf...'

2021-11-03T13:44:33Z

Criou página com '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. == Conf...'

Página nova

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.

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

== Cadastro de telefones ==

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.

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

[[Arquivo:TelaNegBlacklist.png | none | 900px]]
''[[:imagem:TelaNegBlacklist.png| Tela de negociação do devedor com destaque para o botão Blacklist ]]''

@@ Linha 35: / Linha 35: @@
-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.
+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.
+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'''.
@@ Linha 71: / Linha 71: @@
-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:
+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.
+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.

@@ Linha 58: / Linha 58: @@
 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.
@@ Linha 65: / Linha 67: @@
 == Habilitando o acesso em ambiente de produção ==

← Edição anterior		Edição das 14h37min de 3 de novembro de 2021
Linha 52:		Linha 52:


−	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 de termo de acordo''' para viabilizar a geração 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 ==		== Habilitando o acesso em ambiente de produção ==

← Edição anterior		Edição das 14h29min de 3 de novembro de 2021
Linha 45:		Linha 45:
	== Testando a assinatura ==		== 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.
		+
		+
		+	[[Arquivo:DetalhesAcordoSolicitarAss.png \| none \| 900px]]
		+	''[[:imagem:DetalhesAcordoSolicitarAss.png\| 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 de termo de acordo''' para viabilizar a geração do termo de acordo.


	== Habilitando o acesso em ambiente de produção ==		== Habilitando o acesso em ambiente de produção ==

← Edição anterior		Edição das 14h22min de 3 de novembro de 2021
Linha 18:		Linha 18:


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

← Edição anterior		Edição das 14h21min de 3 de novembro de 2021
Linha 23:		Linha 23:
	[[Arquivo:ConfiguracaoDocusignPerfil.png \| none \| 900px]]		[[Arquivo:ConfiguracaoDocusignPerfil.png \| none \| 900px]]
	''[[:imagem:ConfiguracaoDocusignPerfil.png\| Tela de configuração da integração com DocuSign no perfil do administrador ]]''		''[[:imagem:ConfiguracaoDocusignPerfil.png\| 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.

@@ Linha 19: / Linha 19: @@
 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.
@@ Linha 38: / Linha 42: @@
 == Testando a assinatura ==
-[[Arquivo:TelaNegBlacklist.png | none | 900px]]
 == Habilitando o acesso em ambiente de produção ==

@@ 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.
-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.
 == 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 ==
-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
 [[Arquivo:TelaNegBlacklist.png | none | 900px]]
 ''[[:imagem:TelaNegBlacklist.png| Tela de negociação do devedor com destaque para o botão Blacklist ]]''

← Edição anterior		Edição das 13h48min de 3 de novembro de 2021
Linha 1:		Linha 1:
	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.		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 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.