Histórico da Página
Tempo aproximado para leitura: 20 min
| Índice | ||||
|---|---|---|---|---|
|
01. VISÃO GERAL
No Workflow de Solicitação de Contratos, foi implementada a funcionalidade de Assinatura Digital de Contratos. Esta funcionalidade possibilita realizar a assinatura digital dos contratos através do Fluig, eliminando a necessidade de ter uma versão em papel do documento a ser assinado, otimizando assim o processo de aprovação dos mesmos.
A assinatura do documento é feita através do o plug-in Vertsign e poderá ocorrer de duas formas: com ou sem certificado digital.
Nota: Funcionalidade disponível a partir da versão 12.1.24.
02. DOWNLOAD E ATIVAÇÃO
2.1 Realizar o download do componente
Ação | Descrição |
|---|---|
Acesse a TOTVS Store - https://totvs.store/br/vertsign.html - e faça o download do componente. |
|
2.2 Ativação do componente
Ação | Descrição |
|---|---|
No fluig, com um usuário admin, acesse: Painel de Controle / Aplicativos / Central de Componentes; | Escolha o arquivo baixado e clique em “Enviar”
|
Buscar o componente e ativar | Ainda na Central de Componentes, após o deploy do componente, busque por “Vert_Component”.
Selecione o componente e clique em "Ativar"
|
Verifique se o componente foi ativado corretamente | Após a ativação, recarregue a página e veja se a opção de menu “Vertsign” foi criada.
|
03. INSTALAÇÃO
3.1 Formulários
Nesta etapa os formulários serão instalados para realizar o cadastro de assinantes, cadastro de parâmetros gerais do app e formulário para auxiliar no envio e retorno de documentos enviados para assinatura.
Cadastro de Assinantes: Formulário responsável por armazenar os dados dos assinantes inseridos através da widget. O fluig irá armazenar o nome, e-mail e CPF.
Parâmetros Gerais:Formulário responsável por armazenar os parâmetros do app. Ele será atualizado conforme a instalação é realizada.
Formulário Auxiliar: Formulário responsável por registrar cada documento enviado para assinatura, trazendo em cada registro informações relevantes sobre o documento enviado. Este formulário não será acessado de forma direta pelo usuário.
Ação | Descrição |
|---|---|
Instalar os Formulários Acessar o Menu: Vertsign
Instalação e Configuração
| Na sessão 1. Formulários clique no botão Instalar.
|
Visualizar a pasta Vertsign | Feita a instalação, será criada uma pasta chamada Vertsign dentro da pasta raiz do fluig.
|
3.2 Datasets
Esta etapa é responsável por realizar a instalação dos datasets que farão a integração entre o fluig e a Certisign.
Abaixo estão os datasets que serão instalados:
ds_upload_vertsign: Lista todos os documentos do formulário auxiliar que estão pendentes de envio e envia para a Certisign.
ds_package_vertsign: Verifica se os documentos foram assinados no portal de assinaturas da Certisign e retorna o manifesto para o ECM do fluig.
ds_documents_vertsign: Lista todos os documentos que foram enviados para a Certisign. Posteriormente será utilizado para realizar o cancelamento de um documento enviado.
ds_upload_vertsign_manual: Dataset responsável por enviar os documentos para assinatura. É executado após cada envio.
ds_auxiliar_vertsign: Dataset responsável por auxiliar a widget executando os webservices do fluig.
ds_delete_vertsign: Deleta um arquivo do Portal de Assinaturas da Certisign.
ds_documents_autocomplete_vertsign: Dataset responsável por listar todos os arquivos disponíveis para envio.
ds_admin_vertsign: Dataset responsável por listar todos os usuários administradores da plataforma.
ds_signers_vertsign: Dataset responsável por listar todos os assinantes cadastrados.
Ação | Descrição |
|---|---|
Instalar os Datasets Acessar o Menu: Vertsign
Instalação e Configuração
| Na sessão 2. Datasets clique no botão Instalar.
|
3.2.1 Agendador de tarefas
Após a instalação, os datasets marcados como Sincronizado = Sim serão criados no Agendador de tarefas do fluig. Por padrão serão executados uma ver por dia, mas pode ser editado.
Ação | Descrição |
|---|---|
Para visualizar os datasets no Agendador de tarefas basta acessar: Painel de Controle > Parâmetros Técnicos > Agendador de tarefas |
|
3.3 Serviços
Nesta etapa será realizada a instalação dos serviços utilizados pelo app:
ECMCardService_Vertsign: Webservice responsável por realizar operações referentes a formulários no fluig.
ECMCustomFieldsService_Vertsign: Webservice responsável por interagir com os campos customizados do fluig.
ECMDocumentService_Vertsign: Webservice responsável por realizar operações referentes a documentos do fluig.
ECMFolderService_Vertsign: Webservice responsável por realizar operações referentes a pastas no fluig.
ECMTokenService_Vertsign: Webservice responsável por interagir com os token’s do fluig. Pode ser utilizado para pesquisar e validar os token’s existentes.
Ação | Descrição |
|---|---|
Instalar os Serviços Acessar o Menu: Vertsign
Instalação e Configuração
| Na sessão 3. Serviços clique no botão Instalar.
|
Feita a instalação dos serviços, eles poderão ser encontrados em: Painel de Controle > Desenvolvimento > Serviços |
|
3.4 Campo Customizado
Nesta etapa da instalação será instalado o campo customizado que será atualizado a cada alteração de status do documento enviado para assinatura.
Ação | Descrição |
|---|---|
Instalar os Serviços Acessar o Menu: Vertsign
Instalação e Configuração
| Na sessão 4. Campo Customizado clique no botão Instalar.
|
04. CONFIGURAÇÃO
4.1 Parâmetros
Os parâmetros são obrigatórios na instalação a fim de definir todas as configurações iniciais necessárias para começar a utilizar o app. Abaixo encontra-se a descrição de cada campo:
Ação | Descrição |
|---|---|
Instalar os Serviços Acessar o Menu: Vertsign
Instalação e Configuração
| Na sessão 5. Parâmetros preencha os campos conforme orientações abaixo:
O Token é uma informação de controle de acesso no Portal de Assinaturas Certisign. Na contratação do app Vertsign dois ambientes do Portal de Assinaturas Certisign são liberados: um ambiente de homologação e um ambiente de produção. Cada ambiente possui o seu respectivo token. O Token será enviado por email pela Vertsign para o administrador do sistema cadastrado na TOTVS. Caso a empresa não tenha recebido o token, favor encaminhar um email para[email protected].
Usuário admin do fluig responsável pelas integrações.
Senha do usuário de integração.
Definir se a integração será feita no ambiente de homologação ou no ambiente de produção da Certisign.
|
4.2 Serviço externo
Após preencher todos os campos e clicar em “Salvar”, o formulário de parâmetros gerais será atualizado com as novas informações e o serviço vertsignServiceRest será criado no fluig.
O campo token é utilizado para realizar as integrações entre o fluig e a Certisign. O serviço vertsignServiceRest é o responsável por fazer esta integração. Caso o token seja alterado, este serviço será removido e criado novamente com o novo token.
Os endereços abaixo devem ser liberados para que as integrações sejam realizadas:
https://api-sbx.portaldeassinaturas.com.br
https://api.portaldeassinaturas.com.br
4.3 Usuário de integração
Na última etapa da instalação deve ser definido nos Parâmetros um usuário administrador para realizar as integrações internas do fluig.
Caso o fluig esteja configurado com o Identity, o campo “Senha de integração (fluig)” deve ser preenchido com a senha do Identity do usuário de integração.
| Informações | ||
|---|---|---|
| ||
Caso a senha do usuário de integração seja alterada, deve-se lembrar de alterar também nos parâmetros. Outro cuidado que deve ser tomado é caso o usuário de integração seja desativado da plataforma. Nesse caso, deve-se acessar os parâmetros do app e definir outro usuário |
4.4 Rotinas de integração
A integração entre fluig e Certisign ocorrem através de datasets sincronizados que verificam o status da assinatura dos documentos e realizam as integrações. Por padrão esses scripts são executados uma vez por dia, mas também podem ser executados manualmente acessado o Agendador de Tarefas no Painel de Controle. O fluig permite também alterar esse tempo de agendamento.
Os datasets responsáveis por realizar o envio/download dos documentos são:
- ds_upload_vertsign: Envia os documentos para assinatura.
- ds_package_vertsign: Baixa os documentos assinados.
4.4 Configurações do Agendamento
Após a instalação dos datasets, as rotinas de integração serão configuradas para executar uma vez por dia. Essas rotinas são responsáveis por enviar e baixar os documentos do Portal de Assinaturas da Certisign.
- Mas existe a possibilidade de alterar a frequência de execução. Abaixo será explicado como o usuário administrador da plataforma pode realizar essa alteração:
- Acesse o Painel de Controle do fluig
- Acesse o Agendador de tarefas
- Localize as duas rotinas de integração (ds_package_vertsign e ds_upload_package)
- Selecione a rotina que deseja alterar
- Clique em Deletar
- Clique em Adicionar
- Insira uma descrição e selecione a opção "Sincronização de dataset"
- Selecione o dataset ds_package_vertsign
- Feito isso, selecione a frequência de execução e clique em Confirmar. Mais detalhes em fluig help.
Agora a rotina que baixa os documentos assinados do Portal de Assinaturas da Certisign será executada com a frequência determinada.
A data da próxima sincronização é exibida do lado superior direito do Quadro de Status como na imagem abaixo:
05. ASSINATURA DE CONTRATO
5.1 (Fluig) Solicitação de Contratos - Encaminhar para Assinatura
Ação | Descrição | |||||
|---|---|---|---|---|---|---|
Encaminhar para assinatura | Quando a Solicitação estiver no passo de "Gerar Minuta Final", o usuário terá a opção de "Encaminhar para Assinatura"
| |||||
| Selecionar documento | Na fase de "Encaminhar para Assinatura" será apresentado uma Área de "Assinatura Digital".
| |||||
| Selecionar assinadores | Ao clicar em Assinadores, serão apresentados os Assinadores cadastrados na Widget da Vertsign
Ao selecionar um assinador, o e-mail do usuário será apresentado na área de texto abaixo. Se forem selecionados mais Assinadores, ele serão concatenados, separados por ";"
| |||||
| Validar assinatura | Ao enviar para etapa "Valida Assinatura" a solicitação será enviada para a Vertsign. Os assinadores receberão um e-mail com o link para assinatura do documento.
| |||||
| Realizar a assinatura | Os assinadores receberão um e-mail para realizar a assinatura do documento
Ao clicar no link, o assinador será direcionado para a Vertsign, onde poderá visualizar o arquivo se for um .pdf. Caso seja um .doc ou .docx, será necessário realizar o download do arquivo para visualizar. A assinatura do arquivo é feita através do botão "Estou pronto para assinar".
Ao clicar em "Estou pronto para assinar" irá abrir uma área para fazer a rubrica.
| |||||
| Finalizar validação de assinatura | Após a assinatura de todos os Assinadores, o Responsável do Fluxo poderá clicar em "Enviar" no Fluig para movimentar o fluxo da solicitação.
Quando o sistema identificar o documento assinado, irá automaticamente movimentar o fluxo para "Finaliza contrato"
O documento original terá um "Manifesto" anexado que será baixado junto com o documento ao realizar o download.
|
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas