Projeto: FS008375(AAAKH4) – Integração com TOTVS Assinatura Eletrônica (TAE)
Nome do Cliente: Confederação Nacional da Indústria - SENAI
__________________________________________________________________________________________________________________________________________________________________
Objetivo
Orientar o usuário sobre as implementações realizadas para sua empresa. Todas as funcionalidades descritas neste manual têm como base do que está descrito nos documentos:
Detalhamento Funcional - FS008375(AAAKH4)
Pré-requisitos
Table Excerpt |
---|
|
- Customização instalada e todos os scripts gerados com sucesso;
Expandir |
---|
title | Permissões de perfil |
---|
| Devem ser liberadas nas permissões de perfil dos usuários, os menus do TOTVS Assinatura Eletrônica. Para mais detalhes de como liberar no perfil dos usuários acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.
Para liberar o acesso aos menus do TAE acesse o módulo Serviços Globais | Perfil em perfil selecione o sistema Educacional acesse o perfil que deseja realizar a liberação, na aba Acesso a Menus expanda os seguintes itens: Sistema Industria | Mais | TAE:
![](/download/attachments/568921092/image2023-8-28_9-17-56.png?version=1&modificationDate=1693225390720&api=v2) |
|
Expandir |
---|
|
Table Excerpt |
---|
| Para fazer uso da Customização TAE, é necessário iniciar o processo com algumas parametrizações essenciais. Os Parâmetros TAE podes ser acessados através do seguinte caminho: TOTVS Educacional | Sistema Industrial | Parâmetros TAE.
![](/download/attachments/568921092/Parametros1.png?version=1&modificationDate=1692899123103&api=v2)
A interface exibirá alguns campos para serem configurados, sendo eles: Identificação: Consultar e criar usuário na API TAE User, caso não exista: Se esta opção não estiver marcada, ocorrerá um erro durante a integração dos documentos caso o usuário não exista no portal; Utilizar um único usuário para a geração do Token: Define um usuário padrão responsável pela geração do token de acesso. Caso não seja especificado, será solicitado no momento da integração dos documentos; Usuário Token: Insira o usuário para autenticação na API Token; Senha Token: Forneça a senha do usuário para autenticação na API Token;
![Parâmetros para integração Parâmetros para integração](/download/attachments/568921092/image2023-8-24_14-47-8.png?version=1&modificationDate=1692899228690&api=v2)
Aviso |
---|
| A permissão de acesso ao menu será feita através de configuração de controle de perfil de usuário (nativa). |
|
|
Expandir |
---|
title | Parâmetros Educacionais |
---|
|
Table Excerpt |
---|
| Table Excerpt |
---|
name | ParametrosEducacionaisIntro |
---|
| Dentro da interface personalizada de Parâmetros Educacionais, será possível efetuar a integração dos relatórios de acordo com a modalidade do curso. Para essa finalidade, foi desenvolvida uma configuração que engloba Modalidade, Relatórios e Assinaturas, permitindo que o usuário estabeleça os valores essenciais para a realização da integração. Você pode acessar os Parâmetros Educacionais por meio do seguinte caminho: TOTVS Educacional | Sistema Industrial | Parâmetros Educacionais
![](/download/attachments/568921092/ParametrosEducacionais1.png?version=1&modificationDate=1692900160263&api=v2)
A interface exibirá seis abas para serem configurados: Modalidade, Parâmetros da Filial, Relatórios, Situação de Matrícula, Resp. Assinatura e E-mail. |
Deck of Cards |
---|
| Card |
---|
| Table Excerpt |
---|
name | ParametrosEducacionaisModalidade |
---|
| Será necessário informar todas as modalidades que farão parte da integração TAE. Além de informar a modalidade o usuário deverá informar qual o tipo de relatório de certificado que será utilizado em cada modalidade. Esses parâmetros serão gravados por coligada. ![](/download/attachments/568921092/Modalidade1.png?version=2&modificationDate=1692901275943&api=v2)
- Modalidade: Campo utilizado para informação da modalidade a ser utilizada. Apenas as modalidades informadas terão seus relatórios enviados para assinatura no TAE. Preenchimento obrigatório.
- Relatório de Certificado: Campo utilizado para informação do relatório de certificado da modalidade. Essa informação será buscada da tabela de relatórios do RM (RptReports).
- Tipo de Certificado Padrão: Parâmetro do tipo lookup que irá retornar a lista da tabela STIPOCERTIFICADO. Neste parâmetro, o usuário deverá informar qual o tipo de certificado será considerado como padrão para o processo de geração e assinaturas. O Tipo de Certificado deverá ser parametrizado por modalidade.
- Relatório de Saída Intermediária: Parâmetro do tipo lookup que irá retornar a lista de relatórios existentes no RM Reports. Neste parâmetro, o usuário deverá informar qual o relatório será considerado para geração caso o tipo do mesmo seja o definido no parâmetro acima ‘Tipo de Certificado Saídas Intermediárias’. O Certificado deverá ser parametrizado por modalidade.
- Tipo de Certificado Saídas Intermediárias: Parâmetro do tipo lookup que irá retornar a lista da tabela STIPOCERTIFICADO. Neste parâmetro, o usuário deverá informar qual o tipo de certificado será considerado como Saída Intermediária para o processo de geração e assinaturas. O Tipo de Certificado deverá ser parametrizado por modalidade.
- Relatório de Contrato: Campo utilizado para informação do relatório de contrato da modalidade. Essa informação será retornada da tabela de relatórios do RM (RptReports).
- Responsável pela assinatura do Contrato de Matrícula: Campo para seleção do Responsável pelo Contrato de Matrícula na Unidade Operacional (cadastro de Pessoa), de onde serão buscados o e-mail, nome e CPF. Campo de preenchimento obrigatório e indica que o usuário correspondente será utilizado como aprovador/validador do Contrato de Matrícula.
![](/download/attachments/568921092/image2023-8-29_9-32-46.png?version=1&modificationDate=1693312366477&api=v2)
Informações |
---|
| A tela de Parâmetros de Modalidade necessita que pelo menos um relatório seja parametrizado, ou seja, deve ser informado o Relatório de Certificado, o Relatório de Contrato ou ambos.. |
Aviso |
---|
| O relatório que não possuir filtro ou parâmetro SCERTIFICADO, não será enviado. |
|
|
Card |
---|
| Table Excerpt |
---|
| Será necessário informar o Responsável pela Unidade Operacional. Essa parametrização é por filial. - Responsável pela Unidade Operacional: Campo para seleção do Responsável pela Unidade Operacional (cadastro de Pessoa), de onde serão buscados o e-mail, nome e CPF. Campo de preenchimento opcional e indica que o usuário correspondente será enviado como aprovador/validador do Certificado, que no TAE tem o poder de veto do documento. Ele não precisará assinar o documento;
- Integra Contrato de Rematrícula: Campo para informar se os contratos de rematrícula serão integrados ao TAE;
- Protocolo de Assinatura Simplificado: Permite usar assinatura simplificada, além do protocolo completo nativo de assinaturas. Isso permite que as informações sejam inseridas na última página do certificado e não em uma pagina a parte;
![](/download/attachments/568921092/Filial1.png?version=1&modificationDate=1692901334953&api=v2)
Dica |
---|
title | Atualizado recentemente |
---|
| A aba Parâmetro da Filial, recebeu um novo parâmetro, que quando marcado, gera um protocolo de assinatura simplificado ao certificado. Maiores informações descritas no Manual Protocolo de assinatura Certificado. |
|
|
Card |
---|
| Table Excerpt |
---|
| Nesta aba será necessário informar quais relatórios de Diário de Classe que serão utilizados. Os relatórios serão parametrizados por coligada. - Relatório de Diário de Classe - Frequência: Campo utilizado para informação do relatório de diário de classe de frequência. Essa informação será buscada da tabela de relatórios do RM (RptReports).
- Relatório de Diário de Classe - Nota: Campo utilizado para informação do relatório de diário de classe de notas. Essa informação será buscada da tabela de relatórios do RM (RptReports).
![](/download/attachments/568921092/Relat%C3%B3rios.png?version=1&modificationDate=1692901585873&api=v2)
|
|
Card |
---|
| Table Excerpt |
---|
| Nesta aba será necessário informar quais Status de Matrícula a customização deverá considerar para realizar a integração do Relatório do Contrato de Matrícula com o TAE. ![](/download/attachments/568921092/SituacaoMatricula1.png?version=1&modificationDate=1692901897347&api=v2)
Nota |
---|
| - Não serão criados parâmetros customizados para informar os assinadores. Esses dados serão obtidos no Cadastro da Filial | Anexos | Dados Educacionais | Anexos | Instituição do MEC | Anexos | Diretores por Instituição. A customização identificará os assinadores pelas campos Diretor, Secretário 1 e Secretário 2.
- A permissão de acesso ao menu será feita através de configuração de controle de perfil de usuário (nativa).
- Para o envio do e-mail para os responsáveis, todos os dados deverão ser parametrizados corretamente.
|
|
|
Card |
---|
| Table Excerpt Include |
---|
name | ParamsEduRespAssinatura |
---|
merge-tables | true |
---|
page | Manual - Central de Certificação |
---|
type | page |
---|
|
|
Card |
---|
| Table Excerpt |
---|
| ![](/download/attachments/568921092/image2023-8-29_9-26-5.png?version=1&modificationDate=1693311966720&api=v2)
|
|
|
|
|
Expandir |
---|
title | Processo de Integração de relatório de Diário de Classe (SGE) |
---|
|
O processo Enviar Diário de Classe para Assinatura está disponível em: TOTVS Educacional | Currículo e Oferta | Turmas/disciplinas | Anexos | Etapas | Processos | Enviar Diário de Classe para assinatura. ![](/download/attachments/568921092/image2023-8-24_15-56-18.png?version=1&modificationDate=1692903378817&api=v2)
Deck of Cards |
---|
| Card |
---|
| Inicia a execução do processo:
|
Card |
---|
| Processo finalizado ![](/download/attachments/568921092/image2020-10-21_17-30-59.png?version=1&modificationDate=1603312259653&api=v2)
|
|
Ao ser acionado a customização identificará as etapas selecionadas para geração do relatório. Para cada etapa selecionada a customização realizará a geração de um relatório, ou seja, a execução de um único processo poderá diversos relatórios. A customização realizará também uma consulta nas Parametrizações da Interface customizada "Parâmetros Educacionais | Modalidade", para identificar se a modalidade do curso do diário selecionado está parametrizada se os relatórios de Diário de Classe (Nota e Frequência) foram informados. Caso não exista essa parametrização a execução do processo não será realizada.
- Etapa de Notas: Caso a etapa selecionada seja de Notas, será gerado o relatório informado no parâmetro "Diário de Classe - Notas" definido nos Parâmetros Educacionais.
- Etapa de Faltas: Caso a etapa selecionada seja de Faltas, será gerado o relatório informado no parâmetro "Diário de Classe - Frequência" definido nos Parâmetros Educacionais.
Aviso |
---|
| - O usuário poderá selecionar qualquer etapa, independentemente de estar marcada como Etapa final (resultado).
- Para que o Processo seja executado o Campo nativo "Disponível para os Alunos" no cadastro da etapa deverá está marcado. Caso não esteja, o processo não poderá ser executado.
|
Os documentos integrados ficarão disponíveis no Portal TAE para assinatura e validação, quando necessário, pelos seguintes usuários: - Professor responsável pela disciplina: A customização identificará o Professor responsável pela disciplina através do cadastro do Professor, definido em TOTVS Educacional | Currículo e Oferta | Turmas/Disciplinas | Anexos | Professores.
- Secretários: A customização identificará os Secretários através do cadastro do Diretor da Filial, definido no Cadastro da Filial | Anexos | Dados Educacionais | Anexos Instituição do MEC | Anexos | Diretores por instituição | Campos Secretário 1 e Secretário 2.
- Coordenador da matriz aplicada: A customização identificará o Coordenador da Matriz Curricular através do cadastro da comissão coordenadora, definido em: TOTVS Educacional | Currículo e Oferta | Matriz Curricular | Anexos | Matriz Aplicada | Anexos | Comissão Coordenadora.
Ao ser integrado, o TAE enviará um e-mail automático para o Professor Responsável pela disciplina, Secretários Coordenador l, avisando da necessidade de assinatura do Diário no portal.
Nota |
---|
| O nome do arquivo deve ser “DiarioDeClasse” + IdTurmaDisc + “Etapa” + Número da etapa .PDF |
|
Expandir |
---|
title | Processo de Integração de relatório de Certificado (SGE) |
---|
|
O processo Enviar Certificado para assinatura está disponível em: TOTVS Educacional | Atividades Acadêmicas | Certificados/Diplomas | Processos | Enviar Certificado para assinatura. ![](/download/attachments/568921092/image2023-8-24_16-0-58.png?version=1&modificationDate=1692903658927&api=v2)
Informações |
---|
| Deck of Cards |
---|
| Card |
---|
| Inicia a execução do processo:
![](/download/attachments/568921092/image2023-8-24_16-9-30.png?version=1&modificationDate=1692904170323&api=v2)
|
Card |
---|
| Processo finalizado
![](/download/attachments/568921092/image2020-10-21_11-26-27.png?version=1&modificationDate=1603290387717&api=v2)
|
|
|
Ao ser executado, este processo realizará uma consulta nas Parametrizações da Interface customizada "Parâmetros Educacionais | Modalidade", para identificar se a modalidade do curso do certificado selecionado está parametrizada. Caso não exista essa parametrização a execução do processo não será realizada. Será gerado um PDF do Certificado do curso que o aluno concluiu (Iniciação, Aperfeiçoamento, Qualificação e Aprendizagem) e o documento ficará disponível para assinatura no Portal de Assinaturas TAE. Os documentos integrados ficarão disponíveis no Portal TAE para assinatura e validação, quando necessário, pelos seguintes usuários: - Diretor responsável pela filial: A customização identificará o Diretor através do cadastro do Diretor da Filial, definido no Cadastro da Filial | Anexos | Dados Educacionais | Anexos Instituição do MEC | Anexos | Diretores por instituição | Campo Diretor.
- Secretários: A customização identificará os Secretários através do cadastro do Diretor da Filial, definido no Cadastro da Filial | Anexos | Dados Educacionais | Anexos Instituição do MEC | Anexos | Diretores por instituição | Campos Secretário 1 e Secretário 2.
- Responsável pela unidade operacional: A customização identificará o responsável pela Unidade Operacional através do Parâmetro Responsável Unidade Operacional, definido em TAE | Parâmetros Educacionais.
Ao ser integrado, o TAE enviará um e-mail automático para Diretor, Secretários e Responsável, avisando da necessidade de assinatura do Certificado no portal.
![](/download/attachments/568921092/image2020-10-14_6-49-54.png?version=1&modificationDate=1602774622473&api=v2)
|
Expandir |
---|
title | Processo de Integração de relatório de Contrato de Matrícula (SGE) - Manual |
---|
|
O processo Enviar Contrato para assinatura está disponível em: TOTVS Educacional | Financeiro / Contábil | Contratos | Processos | Enviar Contrato para assinatura Informações |
---|
Para execução deste processo é necessário selecionar o(s) registro(s) para geração do relatório e integração para assinatura no TAE. |
![](/download/attachments/568921092/image2023-8-24_16-15-58.png?version=1&modificationDate=1692904558830&api=v2)
Informações |
---|
| Deck of Cards |
---|
| Card |
---|
| Inicia a execução do processo:
|
Card |
---|
| Processo finalizado ![](/download/attachments/568921092/image2020-12-10_17-35-31.png?version=1&modificationDate=1607636131390&api=v2)
|
|
|
Ao ser executado, este processo realizará uma consulta nas Parametrizações da Interface customizada "Parâmetros Educacionais | Modalidade", para identificar se a modalidade do curso selecionado para a matrícula está parametrizada. Caso não exista essa parametrização a execução do processo não será realizada. Será gerado um PDF do Contrato de Matrícula e o documento ficará disponível para assinatura no Portal de Assinaturas TAE. Ao ser integrado, o TAE enviará um e-mail automático para os responsáveis pela assinatura do contrato de matrícula, avisando da necessidade de assinatura do Contrato no portal.
![](/download/attachments/568921092/image2020-12-10_17-9-33.png?version=1&modificationDate=1607634573510&api=v2)
Aviso |
---|
O relatório que não possuir filtro ou parâmetro SCONTRATO, não será enviado. |
|
Expandir |
---|
title | Processo de Integração de relatório de Contrato de Matrícula (SGE) - Automático |
---|
|
Ao realizar a matrícula de um aluno no Processo Seletivo, será gerado o contrato do mesmo. A customização buscará o relatório de contrato parametrizado e realizará a integração com o TAE seguindo os mesmos modelos da Integração de Relatórios de Contrato de Matrícula - Manual. Aviso |
---|
O relatório que não possuir filtro ou parâmetro SCONTRATO, não será enviado. |
|
Expandir |
---|
title | Tela de Monitoramento de Relatórios - SGE |
---|
|
Através da interface customizada "Monitor de Relatórios" será possível realizar o acompanhamento dos status de assinatura dos relatórios enviados para assinatura. A Interface Monitor de Relatórios está disponível em: TOTVS Educacional | TAE | Monitor de Relatórios. ![](/download/attachments/568921092/Monitor.png?version=1&modificationDate=1692905512530&api=v2)
Ao acessar o Monitor de Relatórios será retornado uma tela de visão, onde serão listados os respectivos processos de integração de relatórios. Nessa visão estarão dispostos os relatórios gerados e as informações sobre o processo de integração. ![](/download/attachments/568921092/image2023-8-24_16-54-4.png?version=1&modificationDate=1692906845210&api=v2)
- Tipo de relatório: Nesta coluna será exibido o tipo de relatório enviado para assinatura.
- Status: Exibirá o status do documento/relatório. Um relatório pode ter os seguintes status:
![image2021-4-6_14-52-31.png](https://tdn.totvs.com/download/attachments/607590599/image2021-4-6_14-52-31.png?version=1&modificationDate=1617731551840&api=v2)
- Job relatório: Número do Job de execução do relatório.
- Arquivo assinatura: Identificador do arquivo na Api de assinatura.
- Remetente: Usuário responsável pelo processo principal.
- Destinatários: E-mails dos usuários que devem assinar o relatório.
- Mensagem: Mensagem de erro ou informação retornada pelo processo ou Api.
- Nome do arquivo: Nesta coluna será exibido o nome do arquivo gerado.
- Campos chave: Campos que compõem a chave para geração do relatório.
- Valores chave: Valores que compõem o campo chave.
- Job Principal: Identificador do Job responsável por disparar a geração dos relatórios (Diário de Classe ou Certificado).
- Criado por: Usuário de criação do processo.
- Criado em: Data de criação do processo.
- Modificado por: Usuário de modificação (alteração de status) do registro.
- Modificado em: Data de modificação (alteração de status) do registro.
Será possível realizar a edição de um registo para visualizar os dados detalhados. ![](/download/attachments/568921092/image2020-10-14_7-9-54.png?version=1&modificationDate=1602774622737&api=v2)
|
Expandir |
---|
title | Assinatura no Portal TAE |
---|
|
Informações |
---|
É necessário que os responsáveis pela assinatura e validação dos relatórios/certificados integrados ao TAE acessem o Portal de assinatura para validar e assinar. |
Para mais informações sobre como acessar e utilizar o portal TAE acesso o link abaixo: Manual Operacional - TAE |