Projetos: FS008137
Nome do cliente: FIEP
O manual a seguir tem por objetivo orientar o usuário sobre as implementações realizadas para sua empresa. Todas as funcionalidades descritas neste manual se baseiam no que está descrito nos documentos de especificação dos projetos abaixo e alterações de escopo:
FS008137 - Assistência Estudantil
Disponível em: TOTVS Educacional | Customização| Pagamentos PRONATEC | Parâmetros PRONATEC.
Neste local o usuário realizará todas as parametrizações referente às Assistências Estudantis. Dessa forma, será possível a realização dos cálculos e controle dos pagamentos dos diferentes tipos de benefícios: Benefício por Dia, Benefício por Premiação e Benefício por Hora/Aula.
Na interface de Parâmetros o usuário deverá efetuar as seguintes parametrizações:
Imagem 1: Dados Gerais
Situação de matrícula: será exibida uma lista da tabela padrão de situação de matrícula (SSTATUS) para que seja informado quais situações de matrículas que serão consideradas no cálculo da Assistência Estudantil.
Observação: Para o cálculo de qualquer tipo de benefício da Assistência Estudantil pelo menos uma situação de matrícula deverá estar parametrizada.
Imagem 2: Situação de Matrícula
Situação de Reprovado Será exibida uma lista da tabela padrão de situação de matricula (SSTATUS) para que seja informado quais situações de matrículas que indicam reprovação.
Importante: Caso não seja preenchido nenhum valor neste campo, a customização entenderá que não existe número máximo de alunos para o benefício que está sendo parametrizado.
Importante: Caso o aluno tenha 2 aulas em um mesmo dia e falte apenas em uma aula o sistema não considerará como falta.
Será considerado falta em um dia, somente para os alunos que não compareceram a nenhuma aula do dia.
O preenchimento deste campo é obrigatório.
Aba Condição do aluno (Campo exclusivo Pronatec)
Aba: Valor Hora/Aula (Campo exclusivo Pronatec)
Importante:
Disponível em:
TOTVS Educacional | Currículo e Oferta | Turmas | Aba Campos Complementares
Este anexo tem como objetivo permitir informar qual o tipo da Assistência Estudantil que será aplicada para aquela turma, sendo eles:
IMAGEM TURMA campo complementar
Para as turmas que possuem um dos dois tipos de benefício da Assistência Estudantil, existe uma interface no anexo da turma, disponível em: TOTVS Educacional | Currículo e Oferta | Turmas | Anexos | Assistência Estudantil.
Neste anexo fica registrado o vínculo e o cancelamento dos benefícios aos alunos matriculados na turma.
Na interface são gravadas as seguintes informações:
Além dos campos citados, ficará registrado todo o histórico de vinculação e cancelamento dos benefícios associados aos alunos matriculados naquela turma.
Não será possível incluir, editar ou excluir um cadastro manualmente nesta interface, todos os dados serão apenas para visualização.
Importante:
Disponível em: TOTVS Educacional | Matrícula e Avaliação | Matrícula no Período Letivo | Aba Campos Complementares.
Permite que seja informado qual o tipo da Assistência Estudantil que será aplicada para o aluno. Sendo os tipos de benefício:
O novo anexo da Matrícula no Período Letivo esta disponível em TOTVS Educacional | Matrícula e Avaliação | Matrículas | Anexos | Assistência Estudantil.
Seu uso é limitado apenas aos alunos que possuem algum tipo de benefício da Assistência Estudantil (Beneficio por Dia | Benefício por Premiação | Benefício por hora/aula).
Este anexo armazena todos os vínculos e cancelamentos dos benefícios do aluno. Dessa maneira, serão gravadas as seguintes informações:
Além das informações descritas anteriormente, também fica registrado todo o histórico de vinculação e cancelamento dos benefícios associados ao aluno.
Não é possível incluir, editar ou excluir um cadastro manualmente nesta interface, todos os dados são apenas para visualização.
Importante:
Disponível em: TOTVS Educacional | Currículo e Oferta | Aluno | Anexos | Assistência Estudantil.
Seu uso é limitado apenas aos alunos que possuem algum tipo de benefício da Assistência Estudantil (Beneficio por Dia | Benefício por Premiação | Benefício por hora/aula).
O anexo mantém todos os vínculos e cancelamentos dos benefícios associado ao aluno. Dessa maneira, são gravadas as seguintes informações:
Além das informações descritas anteriormente, também é registrado todo o histórico de vinculação e cancelamento dos benefícios associados ao aluno.
Não é possível incluir, editar ou excluir um cadastro manualmente nesta interface, todos os dados são apenas para visualização.
Importante:
Para realização do processo customizado Vincular/Cancelar Assistência Estudantil do benefício aos alunos matriculados em uma turma, deve ser executado o processo disponível em: TOTVS Educacional | Currículo e Oferta | Turmas | Anexos | Assistência Estudantil | Processos | Vincular/Cancelar Assistência Estudantil.
Ao clicar no menu customizado, é exibida uma nova tela onde fica disponível dois processos customizados, sendo eles:
Deve ser selecionado apenas um processo customizado e em seguida clicar no botão Avançar.
Importante: A customização permite a seleção de apenas de um processo por vez.
Caso seja selecionado o processo customizado vincular benefício em todos os alunos matriculados na turma a tela seguinte será para selecionar o benefício que deverá ser vinculado a todos os alunos matriculados naquela turma. Estes benefícios serão listados pela customização de acordo com os dados configurados nos parâmetros.
Ao selecionar o Nome do Benefício o usuário deve clicar no botão avançar e posteriormente é exibida uma nova tela. Nesta tela a customização retorna dois filtros para seleção de alunos, sendo eles:
Importante: São considerados para exibição dos alunos, as matrículas cujo situações de matrículas estejam definidas no parâmetro Situação de Matrícula.
Ao finalizar o processo customizado com sucesso, os dados da execução (usuário, data e hora, etc.), os dados da Turma TOTVS Educacional e dados do benefício são gravados em tabela customizada e ficam disponíveis para consulta através do anexo da turma e também no cadastro do aluno.
Para realização do processo de cancelamento do benefício de todos os alunos matriculados na turma, é necessário selecionar a opção: Cancelar benefício dos alunos matriculados na turma.
Dessa forma, a customização retorna uma tela que exibe o (s) nome (s) do (s) benefício (s) vinculados aos alunos matriculados naquela turma.
O usuário deve selecionar qual(is) o(s) benefício (s) que deseja cancelar e o motivo do cancelamento.
Importante: A customização habilitará o botão Avançar somente se for selecionado pelo menos um benefício e informado o motivo do cancelamento.
Preenchido os dados, deve-se avançar a tela para que seja feita a seleção dos alunos matriculados na turma. Há duas possibilidades de filtro:
Importante: São consideradas para exibição dos alunos, as matrículas cujo situações de matrículas estejam definidas no parâmetro Situação de Matrícula.
Ao finalizar o processo customizado com sucesso, os dados da execução (usuário, data e hora, etc.), os dados da Turma e os dados do cancelamento do benefício são gravados em tabela customizada e ficam disponíveis para consulta através do anexo da turma.
Para realização do processo customizado Vincular/Cancelar Assistência Estudantil de benefício aos alunos matriculados, deve ser executado o processo disponível em: TOTVS Educacional| Educacional |Matrícula e Avaliação |Matrícula |Processos | Vincular/Cancelar Assistência Estudantil. Para execução do processo, deve ser selecionado pelo menos um registro na tela de matrícula no período letivo.
Importante: Para realização do vínculo do benefício em diversas matrículas, todos os alunos selecionados deverão possuir o mesmo benefício da Assistência Estudantil. Para cada nome de benefício o processo de vínculo deve ser realizado.
Ao clicar no processo, é exibida uma nova tela onde ficam disponíveis duas ações:
Deve ser selecionado apenas um processo customizado e posteriormente clicar no botão Avançar.
Importante: A customização permite a seleção apenas de um processo por vez.
Selecionando a opção vincular benefício no (s) aluno (s) selecionado (s) a customização retorna uma nova tela. Nela tela, o usuário deve selecionar o benefício a ser vinculado aos alunos selecionados.
Para seleção do benefício, o usuário deve buscar o nome de todos os benefícios cadastrados e parametrizados.
Importante: Caso seja selecionado um benefício que o pagamento seja por premiação, a customização habilitará uma opção, onde é retornada todas as colocações e valores preenchidos.
A customização retorna somente as colocações que possuem valores preenchidos e permite apenas uma colocação por aluno para cada benefício.
Deve-se selecionar o Benefício e caso seja selecionado um benefício que o tipo seja por premiação, deve ser selecionada a colocação da premiação, somente após a seleção é habilitado o botão Executar. Ao clicar em Executar o processo é finalizado.
Dessa forma, o sistema se encarregará de gravar os dados do benefício, bem como usuário, data e hora, na tabela criada para essa finalidade.
Para realização do processo de cancelamento do benefício dos alunos matriculados, deve ser selecionada a opção: Cancelar benefício (s) do (s) aluno (s) selecionado (s).
Ao clicar no item, o sistema retorna em tela o (s) nome (s) do (s) benefício (s) vinculados aos alunos matriculados selecionados. Assim, deve-se selecionar qual (is) o (s) benefício (s) que deseja cancelar.
Importante: A customização habilitará o botão Avançar somente se for selecionado pelo menos um benefício e informar o motivo do cancelamento.
Após finalização do processo, as informações da execução (usuário, data e hora, etc.), bem como os dados do benefício, são gravados em uma tabela customizada e ficam disponíveis para consulta através do anexo da Matrícula Período Letivo .
Validações do processo:
Se não houver matrícula no período letivo corrente, a customização não permite vincular e retorna uma mensagem: “Para participação na Assistência Estudantil é necessário que o aluno esteja matriculado no período letivo ativo”.
TOTVS Educacional | Currículo e Oferta | Período Letivo | Período Letivo.
Exemplo: O aluno João Francisco está matriculado no período letivo 2020 em dois cursos distintos, sendo Curso A e Curso B. Neste cenário a customização permite a utilização do benefício nas matrículas do aluno João Francisco. Porém o usuário deverá dar um aceite no alerta emitido pela customização.
Caso o usuário tente utilizar o mesmo benefício para o mesmo aluno no mesmo período letivo e mesmo curso mais de uma vez a customização retorna a seguinte mensagem: Benefício já associado ao aluno.
Importante:
O objetivo deste requisito é detalhar como é realizado o cadastro das informações do responsável pelo aluno e seus dados bancários e como posteriormente esses dados são enviados para o ERP.
Para as definições dos dados bancários da Assistência Estudantil, foi criado um anexo com o nome de Dados Bancários Assistência Estudantil na tela de Matrícula no Período Letivo. Sua interface faz referência à integração do Pronatec já existente (TOTVS Educacional | Matricula e Avaliação | Matrícula no período letivo | Anexos | Dados Pronatec).
Dessa forma, os campos a seguir serão demonstrados sem a possibilidade de edição com finalidade apenas de visualização:
Em seguida é necessário cadastrar as informações do Titular da Conta (Nome + CPF). Estes dados são de preenchimento obrigatório:
Sobre as informações do Titular da Conta, atente para os itens importantes:
Após a seleção do Responsável Legal (Titular da Conta) existem as informações dos Dados Bancários para recebimento dos valores do benefício:
Caso queira realizar o cadastro das informações bancárias em outro momento, é necessário que desmarque a opção referente aos Dados Bancários. Ao realizar esse procedimento a customização desabilita os campos Banco, Tipo de Conta, Agência e Conta. Entretanto, se houver necessidade, em qualquer momento poderá ser marcado para preenchimento e/ou alterações.
É permitido apenas um registro no anexo Dados Bancários da Assistência Estudantil para cada registro de matrícula no período letivo vinculados a um benefício da Assistência Estudantil.
Se a opção Dados Bancários foi marcada, são habilitados os campos de Banco, Agência, Conta e Tipo de Conta:
Os campos de Banco e Agência, fazem referência às tabelas nativas do sistema (GBANCO e GAGENCIA). Desta forma, como premissa, é necessário este Menu esteja habilitado e preenchido no TOTVS.
Assim como os demais, será habilitado somente se a Flag Dados Bancários estiver marcada. Entretanto, existem outras validações para permitir sua edição:
Ao salvar os dados a customização valida se todas as informações obrigatórias foram preenchidas.
Importante:
Aqui objetivo é detalhar como ocorre o envio das atualizações dos Dados Bancários de um responsável legal do SGE para o ERP.
O objetivo é detalhar como é realizado o cadastro das informações referente aos Períodos de Cálculo da Assistência Estudantil.
É utilizada a interface já existente na integração do Pronatec (TOTVS Educacional | Customização | Pagamentos PRONATEC | Períodos PRONATEC).
Podem ser cadastrados/parametrizados os períodos de cálculos para cada tipo de benefício parametrizado nos parâmetros. Os dados abaixo devem ser parametrizados para cada tipo de benefício, sendo eles:
Todos os campos acima são de preenchimento obrigatório e devem ser parametrizados por coligada, filial e nível de ensino.
Caso exista algum registro na tabela referente ao Pagamento da Assistência Estudantil, a customização não permite nenhum tipo de alteração.
Importante:
Aqui serão detalhadas as regras dos cálculos nos diferentes tipos de assistências estudantis. Esses cálculos determinam o valor a ser pago para os alunos que possuem algum benefício da Assistência Estudantil. Para que ocorra de maneira correta é necessário que previamente sejam realizadas todas as parametrizações dos tipos de assistências nos parâmetros independe de qual seja.
A apuração do benefício deverá calcular o valor (monetário) a ser pago ao aluno. Para realizar este processo haverá uma tela dentro do Menu Customização, cujo nome é Calcular Valor. Ela será uma adaptação da interface já existente (Calcular subsídio).
Ao acessar o processo customizado “calcular valor” a customização retorna uma tela customizada onde deverá ser informado os seguintes dados:
Importante: Para os benefícios referentes ao Pronatec, retornará com o nome do benefício como Pronatec.
Os campos Data Início | Data Fim | Data Início Apuração | Data Fim Apuração | Data Pagamento são de preenchimento automático a partir da seleção dos campos informados acima (Benefício e Id Período).
A informações desses campos são apenas para visualização, conforme parametrizações, sendo assim, a customização não permitirá nenhum tipo de alterações/inclusões desses dados neste processo.
Ao clicar no botão Avançar, é retornada uma segunda tela customizada, onde a customização retorna apenas os alunos que estiverem dentro das seguintes regras:
Os alunos são listados apenas para visualização, não podendo ser adicionado/excluído nenhum registro da lista. Nas colunas constam as seguintes informações:
CPF: A customização retorna o CPF do responsável legal do aluno.
O usuário deve selecionar um ou mais alunos retornados pela customização para a execução do processo de apuração customizado.
Para execução do processo de apuração a customização exige a seleção de pelo menos um aluno.
Ao clicar no botão executar a customização inicia o cálculo do valor da assistência estudantil a ser pago para cada aluno retornado na lista.
Este cálculo depende das configurações realizadas no parâmetro.
Benefício por Dia
Quando o benefício é por Dia, são calculados os dias de aula conforme o período selecionado na apuração.
Exemplo:
Entenda a seguir as nuances deste tipo de cálculo:
Aluno A ausentou em 2 aulas.
Não é considerado falta para o cálculo.
Valor a receber: R$ 200 reais de Benefício.
Ou seja, caso na parametrização esteja para desconsiderar as faltas abonadas e exista algum registro de falta de ausência justificada, está ausência não será considerada no cálculo.
Benefício por Premiação
Quando o benefício é por premiação, o valor do prêmio a ser pago corresponde ao valor base multiplicado pelo fator de premiação em que o aluno foi classificado.
Dessa forma, nos parâmetros foram cadastrados os valores para cada colocação.
Cada aluno irá receber conforme o valor do prêmio da sua colocação.
Benefício por Hora-Aula
Para o benefício por Hora-Aula o sistema calcula o valor da hora/aula cadastrada nos parâmetros e multiplica pela quantidade de hora/aula que o aluno cursou.
Exemplo:
Se não foi registrado nenhuma ausência, o aluno receberá R$ 400,00 reais de Benefício.
Entenda a seguir as nuances deste tipo de cálculo:
Ou seja, caso na parametrização esteja para desconsiderar as faltas abonadas e exista algum registro de falta de ausência justificada, está ausência não será considerada no cálculo.
Importante:
Detalhe de como os registros referente aos Pagamentos dos tipos de benefícios da Assistência Estudantil serão exibidos no TOTVS. Para visualização desses registros é utilizada as duas Interfaces já existentes e utilizadas pela integração Pronatec que estão disponíveis em:
Cada interface possui um objetivo, sendo eles:
Ao acessar uma das opções Pagamento – Geral ou Pagamento - Unidade, são listados todos os registros de Pagamento para todos os tipos de benefícios da Assistência Estudantil.
Assim, a interface é composta por duas grids, sendo que a Grid da esquerda retorna todos os Períodos de Cálculos para os tipos de Assistência Estudantil e a Grid da direita retorna todos os Pagamentos da Assistência Estudantil gerados através do processo calcular valor.
No Grid referente aos Períodos de Cálculos da Assistência Estudantil, a customização retorna os seguintes campos:
No Grid referente aos Pagamentos Assistência Estudantil, a customização retorna os seguintes campos:
Importante: Ao navegar no grid Períodos de Cálculos da Assistência Estudantil os dados da grid Pagamentos Assistência Estudantil são atualizados de acordo com o período selecionado.
Ainda nesta interface, é possível executar os seguintes processos:
Para execução deste processo customizado deve ser selecionado no grid Períodos de Cálculos da Assistência Estudantil um ou mais registro (s) e acessar o menu Processos | Libera ou Bloqueia Pagamentos do Período.
Ao executar o processo, a customização verifica:
Importante: A customização executa este processo apenas para os registros com o status Calculado ou Bloqueado. Caso seja executado o processo para os demais status, a customizarão retorna uma mensagem informando que o processo não poderá ser executado para aquele status.
Para execução deste processo customizado o usuário deve selecionar no grid Períodos de Cálculos da Assistência Estudantil um ou mais registro (s) e acessar o menu Processos | Impressão de relatório de conferência.
Ao executar esse processo a customização verifica o relatório de conferência parametrizado e exibe o relatório com os dados do (s) registro (s) selecionado (s) em formato de PDF.
Caso não exista nenhum relatório parametrizado no Req.01 a customização retorna uma mensagem informando que não existe relatório parametrizado.
Importante:
Através do grid de Períodos Assistência Estudantil o campo Valor Total exibirá o valor total da assistência estudantil na forma pecuniária apurado por período.
Para consulta dos status de pagamento será utilizado a mesma interface da Integração do Pronatec que está disponível em: TOTVS Educacional | Customização | Pagamentos PRONATEC | Consultar Status Pagamento ERP.
O pagamento é realizado através do ERP, porém todos os pagamentos realizados e recusados devem ser retornados para o SGE (TOTVS Educacional).
Para realizar a consulta a customização utiliza o WebService informado no parametrizador e consume o método atual utilizado pelo ERP no momento da consulta.
Ao acessar o menu Consultar Status Pagamento ERP a customização retorna uma interface customizada, onde deve ser informado obrigatoriamente o período da consulta e opcionalmente o nome do benefício a ser consultado o status de pagamento no ERP.
Importante: Caso não seja informado o nome do benefício a customização retorna todos os benefícios no Período selecionado.
O registro do pagamento realizado com sucesso é enviado para o SGE (TOTVS Educacional) com o status Liquidado.
O registro que o pagamento foi recusado, é enviado para o SGE (TOTVS Educacional) com o Status Recusado.
Abaixo segue resumo de todas os Status:
Importante:
Foi criado um processo Monitor de Log da Assistência Estudantil no menu Customização do TOTVS Educacional. Neste local é possível consultar os LOGs das operações de importação e exportação executadas pela integração do SGE com o ERP e também o processo de reenvio dos registros.
É utilizada a funcionalidade de log genérico padrão. Os históricos das exportações e importação de dados para o ERP são registrados e podem ser visualizados no menu TOTVS Educacional | Customização | Assistência Estudantil | Monitor de Log.
Na tela de log estão disponíveis os seguintes campos:
É apresentada uma visão com a relação de registros importados e exportados.
Obs: Não é possível incluir, editar ou excluir informações através dessa interface.
O campo processo é exibido de acordo com os respectivos códigos:
Ao acessar o anexo de um registro é possível visualizar todos os registros relacionados ao cadastro integrado. Estão disponíveis os seguintes campos: