Histórico da Página

Projeto: FS008375(AAAKH4) – Integração com TOTVS SignIntegração MarketPlace

Nome do Cliente:

...

 SENAI DN

A customização Marketplace permite estender o conjunto de funcionalidades disponíveis no escopo Oferta de Cursos Online. Com ela, é possível que o candidato inicie sua inscrição na plataforma MarketPlace e finalize no Portal de Processo Seletivo do SGE sem que redigite seus dados. As informações também são enviadas automaticamente para o contrato do candidato em forma de bolsa, com os possíveis cupons de descontos oferecidos pela plataforma MarketPlace.

Expandir
title Parametrizações MarketPlace no SGE (Totvs Educacional)
Parâmetro - Utiliza Oferta MarketPlace: Disponível em:  TOTVS Educacional | Processo Seletivo | Cadastro | Processo Seletivo | Aba Identificação, o parâmetro "Utiliza oferta MarketPlace" tem a finalidade de definir se o processo seletivo utilizará ou não a customização (SGE -TOTVS Educacional) referente ao MarketPlace. Image Added Informações title Observações Para o correto funcionamento do parâmetro é necessário que esteja marcada a opção "Utiliza Oferta Online de Curso". Não é possível marcar/desmarcar a flag "Utiliza Oferta MarketPlace" caso já exista algum candidato inscrito ou alguma área de interesse ofertada cadastrada. Ao marcar a flag "Utiliza Oferta MarketPlace", será validado se existe algum curso parametrizado na Área de Interesse Ofertada | Aba Venda On-Line de Cursos | Acadêmico  Bolsas MarketPlace: São parametrizadas através do anexo Bolsa MarketPlace no cadastro nativo de bolsas do SGE (TOTVS Educacional | Financeiro/contábil | Bolsas | Anexos). Image Added Image Added Image Added Obs:  O campo desconto da bolsa deve ser do tipo tipo percentual e possuir o valor zerado conforme imagens acima Somente é permitida a inclusão de uma bolsa MarketPlace por Coligada e nível de ensino. Uma bolsa cadastrada em uma filial terá seu cadastro compartilhado entre todas as filiais da mesma Coligada e mesmo Nível de ensino. Não é permitido qualquer alteração no cadastro da bolsa parametrizada como "Oferta VTEX (anteriormente Marketplace)" conforme imagem abaixo: Image Added O valor de desconto do cupom distribuído pela plataforma MarketPlace é aplicados ao contrato do aluno automaticamente via inserção da bolsa MarketPlace. A bolsa será aplicada em todos os serviços existes no contrato do aluno conforme pode ser observado nas imagens abaixo: Image Added Image Added As parcelas do contrato são geradas automaticamente e cabe ao regional, caso necessário, realizar a manutenção nas datas de vencimento das parcelas. Cadastro de Plano de Pagamento no SGE e parametrização na Área de Interesse do Processo Seletivo: Para todos os cursos independente se possuem gratuidade ou não será necessário o cadastro de um plano de pagamento para o correto funcionamento da customização. Os planos de pagamento deverão ser cadastrados de forma nativa através do TOTVS Educacional | Financeiro/Contábil | Planos de Pagamento. Para os cursos de gratuidade, o plano de pagamento poderá ser criado com valor zerado (sem vínculo de parcelas). Image Added O plano de pagamento deverá ser informado no cadastro da área de interesse ofertada do processo seletivo. Todos os processos seletivos que estiverem com o campo Utiliza MarketPlace marcado terão a funcionalidade: Cadastrar o contrato marcada como padrão. Caso queira descartar o contrato a ser gerado para uma determinada área de interesse ofertada, deverá ser marcada a opção Descartar Contrato. Image Added Obs: Será apresentado a mensagem de validação na tela para o usuário apenas uma vez a cada edição de tela caso a Área de Interesse Ofertada esteja desativada ou possua a turma de interesse inativa  ou inexistente. Image Added Anexo Tipo de Financiamento na Área de Interesse Ofertada do Processo Seletivo: Disponível no cadastro de Área de Interesse Ofertada do Processo Seletivo, o Anexo Tipos de financiamento tem o objetivo de cadastrar os vários tipos de financiamentos que poderão ser utilizados irão compor o cadastro do aluno no campo Complementar Condição do Aluno no Cursos/Habilitações e Matrículas no Período Letivo. O usuário poderá inserir diversos itens, conforme imagens abaixo: Image Added Image Added O valor utilizado no momento da matrícula será enviado de forma transparente ao usuário pelo Marketplace, e deverá estar cadastrado no anexo acima para poder ser utilizado nos campos complementares. Da mesma forma, quando o tipo do cupom do candidato for proveniente de CNPJ é preenchido automaticamente o campo complementar CNPJ da Empresa presente no menu Currículo e Oferta | Aluno | Anexos | Cursos/Habilitações | aba Campos Complementares| CNPJ da Empresa com o numero do CNPJ. Nota title Nota O cadastro do campo é obrigatório para prosseguimento da inscrição no Processo Seletivo: Image Added Anexo Turmas na Área de Interesse Ofertada do Processo Seletivo: Disponível no cadastro de Área de Interesse Ofertada do Processo Seletivo, o Anexo Turmas da Área de Interesse tem o objetivo de informar as turmas que poderão ser utilizados para escolha do candidato no momento da inscrição no processo seletivo. Para que as turmas sejam exibidas no portal, é necessário que o usuário adicione e ative as turmas no anexo. O usuário poderá inserir diversos itens, conforme imagens abaixo: Image Added  Por padrão o campo Ativo ao adicionar a turma sempre será apresentado marcado, sendo necessário o usuário desmarca manualmente, caso deseja que a turma esteja desativada. Ao acessar a tela de inscrição as turmas ativas serão exibidas para seleção. Image Added Obs: Mais informações como por exemplo: ativar/desativar turmas na área de interesse, acesse o manual do Oferta Online de Cursos. Parametrização nativa Código da Turma - Não Utilizar: A parametrização nativa Código da turma existente no cadastro da Área de Interesse Ofertada do Processo Seletivo, só deverá ser preenchida se o regional não utilizar a customização de Oferta Online de cursos e  MarketPlace. Para regionais que utilizam as customizações, a forma correta de parametrização de turmas é a indicada no tópico acima: Anexo Turmas na Área de Interesse Ofertada do Processo Seletivo. Image Added Obs: Caso o regional Utilize  a customização de Oferta Online de cursos e  MarketPlace, e informar  a turma em Venda online de de Cursos | Acadêmico, ao salvar será apresentada uma mensagem impedindo com que a turma seja cadastrada, informando o local correto para que a turma seja informada.  Image Added Matricula do aluno gerada no SGE: Finalizada a inscrição no processo seletivo, no SGE é gerada a matricula do aluno. Para as inscrições que possuírem cupons distribuídos pela plataforma MarketPlace, foram criados três campos não editáveis  no menu Currículo e Oferta | Aluno | Anexos | Cursos/Habilitações | aba Ingresso que armazenam os código do cupom, percentual de desconto e valor final do curso provenientes do MarketPlace conforme imagem abaixo. O Campo Tipo de ingresso também é preenchido automaticamente, com base no Parâmetro Tipo de Ingresso do MarketPlace Image Added Importante: Esses campos são meramente informativos e não possuem funcionalidade de inclusão, edição e/ou exclusão. Dica Caso o campo complementar não esteja visível, siga o roteiro de ativação dos campos complementares.

__________________________________________________________________________________________________________________________________________________________________

Prezados Senhores,

O documento a seguir tem por 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

  Customização instalada e todos os scripts gerados com sucesso. 

Detalhamento do Processo

Para a utilização da Customização "Integração com TOTVS Sign" será necessário primeiramente realizar algumas parametrizações.

A interface de Parâmetros está disponível em: TOTVS Educacional | TOTVS Sign | Parâmetros TOTVS Sign.

Image Removed

A interface exibirá duas abas para serem configurados, sendo eles:

Aba Identificação:

• URL API Assinatura: Campo para informação do endereço da API para onde os documentos serão enviados para serem assinados. 
• Endpoint para envio de dados: Identificação do endpoint responsável pelo recebimento dos dados dos arquivos a serem assinados. 
• Endpoint para consulta de dados: Identificação do endpoint responsável pela consulta dos dados dos arquivos enviados e retorno dos status das assinaturas. 
• Consultar documentos pendentes e atualizar status dos documentos ao abrir visão de monitoramento: Após o documento ser enviado para o portal de assinaturas será possível acompanhar se o mesmo já foi assinado ou não através de uma visão de monitoramento. Ao marcar esse campo quando a visão for aberta, a customização identificará os documentos que estiverem como pendentes de assinatura e realizará uma consulta na API de assinatura para identificar se os mesmos foram assinados e atualizar o status apresentado na tela caso tenham sofrido alterações de status (se foram assinados ou rejeitados).      
• Ao abrir visão mostrar apenas dados solicitados pelo usuário logado: Caso seja marcado esse parâmetro apenas documentos enviados por processos solicitados pelo usuário logado, serão exibidos na tela, não sendo possível consultar o status de documentos solicitados por outros usuários. 
• Assinar documento ao enviá-lo: Caso marcado, indica que o documento será assinado pelo usuário da inclusão dos documentos assim que os documentos forem incluídos para assinatura. 
• Testar conexão API: Funcionalidade utilizada pra testar a conexão com os serviços do portal de assinaturas.

Image Removed

Aba API Totvs Sing User:

• Utilizar token (API Totvs Sing User) para execução de assinatura: Identificador para utilização de um token fixo ou utilização de API para obtenção do Token de autenticação.
• Token Fixo: Caso o campo “Utiliza API Token para execução de assinatura” esteja desmarcado, esse campo ficará habilitado para ser preenchido com o token de autenticação.
• Url API Token: Informe a Url da API responsável pela autenticação do usuário e geração do Token para envio dos documentos.
• Endpoint para obtenção do Token: Identificação do endpoint responsável pela geração do token. 
• Utilizar único usuário para geração do Token: define um usuário padrão para geração do token de acesso. Caso não seja definido, será solicitado no momento da integração dos documentos.
• Usuário Token: Informe o usuário para autenticação na Api Token. 
• Senha Token: Informe a senha do usuário na Api Token. 
• Consultar e criar usuário na API TOTVS Sign User caso não exista: Se desmarcado, caso o usuário não exista no portal, ocorrerá erro no momento da integração dos documentos.
• Endpoint para criação de usuário: Texto com a identificação do Endpoint responsável pelo recebimento dos dados dos usuários a serem criados no TOTVS Sign. 
• Endpointo para consulta de usuário: Texto com a identificação do endpoint responsável pela consulta de usuário no TOTVS Sign a fim de identificar a existência do mesmo.
• Testar conexão Sign: Funcionalidade utilizada pra testar a conexão com o portal de assinaturas.

Image Removed

Pré-requisitos

  Customização instalada e todos os scripts gerados com sucesso. 

Detalhamento do Processo

Na interface customizada de "Parâmetros Educacionais" realizará a integração dos relatórios de acordo com a modalidade do curso. 

Para isso foi criado uma parametrização de Modalidade, Relatórios e Assinaturas onde o usuário definirá os valores utilizados pela integração. 

A interface de Parâmetros está disponível em: TOTVS Educacional | TOTVS Sign | Parâmetros Educacionais.

Image Removed

A interface exibirá três abas para serem configurados: Modalidade, Parâmetros da Filial e Relatórios. 

Aba Modalidade: Será necessário informar todas as modalidades que estarão farão parte da integração TOTVS Sign. 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.

• Modalidade: Campo utilizado para informação da modalidade a ser utilizada. Apenas as modalidades informadas terão seus relatórios enviados para assinatura no TOTVS Sign. Preenchimento obrigatório. 
• 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). Preenchimento obrigatório.

Image Removed

Aba Parâmetros da Filial: 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 TOTVS SIGN tem o poder de veto do documento. Ele não precisará assinar o documento.

Image Removed

Aba Relatórios: 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).

Image Removed

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

Pré-requisitos

• Customização instalada e todos os scripts gerados com sucesso. 
• Parametrizações realizadas com sucesso.

Detalhamento do Processo

Foi desenvolvido a funcionalidade Integração do Relatórios de Diário de Classe de Notas e Diário de Classe de Frequência com o TOTVS Sign. 

A funcionalidade de Integração dos relatórios com o TOTVS Sign está disponível em: TOTVS Educacional | Currículo e Oferta | Turmas/disciplinas | Anexos | Etapas | Processos | Enviar Diário de Classe para assinatura.

Image Removed

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. 

Os documentos integrados ficarão disponíveis no Portal TOTVS SIGN 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 TOTVS Sign 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.

Pré-requisitos

• Customização instalada e todos os scripts gerados com sucesso. 
• Parametrizações realizadas com sucesso.

Detalhamento do Processo

Foi desenvolvido a funcionalidade Integração do Relatórios de Certificado com o TOTVS Sign. 

A funcionalidade de Integração do Certificado com o TOTVS Sign  está disponível em: TOTVS Educacional | Atividades Acadêmicas | Certificados/Diplomas | Processos | Enviar Certificado para assinatura.

Image Removed

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

Os documentos integrados ficarão disponíveis no Portal TOTVS SIGN 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 TOTVS Sign | Parâmetros Educacionais. 

Ao ser integrado, o TOTVS Sign enviará um e-mail automático para Diretor, Secretários e Responsável, avisando da necessidade de assinatura do Certificado no portal.

Image Removed

• A identificação dos responsáveis e assinadores será feita de acordo com a filial do certificado/habilitação, caso não sejam localizados assinadores para a filial o processo não poderá ser executado.

• O nome do arquivo no Certificado no TOTVS Sifgn será “Certificado” + RA+ Nome sem espaços + CodCurso + .PDF.

Pré-requisitos

• Customização instalada e todos os scripts gerados com sucesso. 
• Parametrizações realizadas com sucesso.

Detalhamento do Processo

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 | TOTVS Sign | Monitor de Relatórios.

Image Removed

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.

Image Removed

• 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:

Image Removed

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

Image Removed

Pré-requisitos

• Customização instalada e todos os scripts gerados com sucesso. 
• Parametrizações realizadas com sucesso.

Detalhamento do Processo

Através da interface customizada "Monitor de Relatórios" será possível consultar o status de arquivos/relatórios enviados para o TOTVS Sign.

O processo para consultar o status de arquivos/relatórios enviados para o TOTVS Sign poderá ser executado automaticamente ao abrir a tela de visão. O processo será executado automaticamente caso o parâmetro "Consultar e atualizar status do documento ao abrir tela de monitoramento" disponível nos Parâmetros TOTVS Sign esteja marcado. 

Image Removed

A segunda opção para consulta será através do Processo "Consultar Status de Assinatura" que está disponível em: TOTVS Educacional | TOTVS Sign | Monitor de Relatórios | Processos | Consultar status de assinatura.

Image Removed

Pré-requisitos

• Customização instalada e todos os scripts gerados com sucesso. 
• Parametrizações realizadas com sucesso.

Detalhamento do Processo

Será necessários que os responsáveis pela assinatura e validação dos relatórios/certificados integrados ao TOTVS Sign acessem o Portal de assinatura para validar e assinar. 

Ao acessar o Portal de assinatura o usuário deverá clicar na opção Externo.

Image Removed

O usuário deverá informar os dados de e-mail (login) e senha de acesso:

Image Removed

No Portal de Assinatura através do  menu documentos será possível visualizar três pastas com todos documentos: Pendentes, Finalizados e Rejeitado e os documentos pendentes de validação/assinatura do usuário logado. 

Image Removed

Para visualizar o documento para assinatura e assinatura o responsável deverá dar um duplo clique no documento.

Image Removed

Será disponibilizado na aba ao lado direito do documento três menus: Informações, Destinatários e Anexo.

O usuário Responsável pela Unidade Operacional, após validar o documento deverá clicar em “Próxima etapa” e realizar a liberação para os demais destinatários assinar.

Image Removed

Clique na opção concordo em usar assinaturas e registros eletrônicos e no botão assinar eletronicamente:

Image Removed

Caso o responsável queira Rejeitar o documento, será necessário clicar na opção Rejeitar e deverá informar o motivo da rejeição.

Image Removed

Image Removed