Histórico da Página

Provedor - Dados da declaração mensal de serviços educacionais

Esse provedor de dados tem o objetivo de gerar a declaração mensal de serviços educacionais para a prefeitura de Salvador conforme o decreto e baseado o layout fornecido pela prefeitura.

Aviso

title	ATENÇÃO

Disponível a partir dos patches:

12.1.2302.240 ou superior
12.1.2306.187 ou superior
12.1.2310.121 ou superior

Para a geração correta do relatório da declaração mensal de serviços educacionais, antes devem ser realizadas algumas configurações no sistema para a sua geração.

Expandir

title	Parametrizações

A seguir vamos descrever tais configurações:Executar o script de marcação

1 - Executar os script's de marcações

CN.2023.11_05 e CN.2023.12_02 na base de dados.

Esse execução é obrigatória, após execução do script é aconselhável deletar o Host e subir novamente para aparecer no Campo Complementar o cadastro de Serviço.

O script CN.2023.12_02 é obrigatório para base de dados Oracle.

2 - Nas permissões do Perfil liberar acesso no Campo Complementar do cadastro de Serviço.

Image Added Image Added

3 - Criação do campo complementar CTISS para o serviço. Esse campo deve ter obrigatoriamente o nome de CTISS ser do tipo

texto

alfanumérico com tamanho 10

. O

, e subtipo do campo texto igual a texto. Após a criação do campo, deverá ir no cadastro de serviços e editar o serviço desejável, e na aba campos complementares o campo deverá ser preenchido conforme as regras presentes na documentação da declaração mensal de serviços educacionais.

3 - Criação do campo complementar CODIGOBENEFICIO para a bolsa. Esse campo deve ter obrigatoriamente o nome de CODIGOBENEFICIO ser do tipo

texto

alfanumérico com tamanho 10

. O

, e subtipo do campo texto igual a texto. Após a criação do campo, deverá ir no cadastro de bolsas e editar a bolsa desejável, e na aba campos complementares o campo deverá ser preenchido conforme as regras presentes na documentação da declaração mensal de serviços educacionais

.
Image Added		Image Added
4 - Após criar os campos complementares dar permissão no Nível de Ensino Image Added

Expandir

title	Relatório Declaração Mensal de Serviços

Os relatórios para a Educação Superior e Básica serão disponibilizados no TOTVS Compartilhamento presente no Menu Gestão → Utilitários dentro do módulo Educacional.

Image Added

No campo "Buscar" informar o nome do relatório e mandar pesquisar. Após a conclusão da pesquisa clicar na opção "Baixar Arquivo"

Serão disponibilizados dois relatórios, um para a educação superior e outro para educação básica

EDUREL0084 - Declaração Mensal de Serviços Educação Superior.TotvsReport
EDUREL0085 - Declaração Mensal de Serviços Educação Básica.TotvsReport

Aviso

title	ATENÇÃO

Após a importação dos relatórios é importante vincular os relatórios importados com a fonte de dados "Declaração Mensal de Serviço".

Image Added

Expandir

label	personalizado
title	Criar Relatórios Personalizados

Caso os relatórios presentes no TOTVS Compartilhamento não atende as suas necessidades, pode-se criar relatórios personalizados.

A seguir como criar

O primeiro passo é criar

um novo relatório informando a fonte de dados que é o novo provedor criado, a Declaração Mensal de Serviços

Educacionais

.

Aviso
Vale lembrar que este provedor somente funciona se vinculado ao cadastro do relatório conforme abaixo e apenas para relatório da declaração mensal de serviços

educacionais

.

Uma vez vinculado não é possível remover a fonte de dados, para remover, será necessário criar um novo relatório.

Image Removed

Ao abrir o layout do relatório e ir na lista de campos

, uma

da tabela

irá

SDECLARACAOMENSALSERVICO irá aparecer

, SDECLARACAOMENSALSERVICO

com os seus respectivos campos.

Image Modified

SDECLARACAOMENSALSERVICO

Tabela de dados da declaração mensal de serviço, segue os campos possíveis:

- - - - NOMEALUNO: Nome do aluno.
        NOMESOCIALALUNO: Nome social do aluno.
        NOMECURSO: Nome do curso ou etapa de ensino vinculado ao contrato do aluno.
        NUMEROMATRICULA: Número da matrícula. O número da matrícula será o registro acadêmico do aluno.
        NOMERESPONSAVEL: Nome do responsável financeiro informado no cadastro do aluno.
        NOMEFANTASIARESPONSAVEL: Nome fantasia do responsável financeiro informado no cadastro do aluno.
        CPFRESPONSAVEL: CPF do responsável financeiro informado no cadastro do aluno.
        VALORCONTRATO: Valor total do contrato do aluno.
        MESCOMPETENCIA: Mês de competência da declaração mensal de serviços. Será o mês de competência informado no parâmetro DATACOMPETENCIADMS.
        ANOCOMPETENCIA: Ano de competência da declaração mensal de serviços. Será o ano de competência informado no parâmetro DATACOMPETENCIADMS.
        VALORMENSALIDADE: Valor da mensalidade do serviço da parcela presente no contrato do aluno.
        CODIGOBENEFICIO: Código do benefício

que é a bolsa presente no contrato do aluno. Esse código deve ser

- - - - informado no campo complementar conforme descrição acima na bolsa presente no contrato do aluno.
        VALORBENEFICIO: Valor do benefício que é

a

- - - - o valor da bolsa presente no contrato do aluno.
        CTISS: Valor do CTISS

do

- - - - informado no campo complementar conforme descrição acima no serviço presente na parcela do contrato do valor

. Esse código deve ser informado no campo complementar conforme descrição acima

- - - - .
        CODCURSO: Código do curso do aluno

presente no

- - - - vinculado ao contrato do aluno.
        CODCOLIGADACFO: Código da coligada do responsável financeiro informado no cadastro do aluno.
        CODCFO: Código do financeiro informado no cadastro do aluno.
        CODCOLIGADA: Código da coligada do contrato do aluno.
        RA: Registro acadêmico do aluno.
        CODCONTRATO: Código do contrato do aluno.
        IDPERLET: Identificador do período letivo

presente no

- - - - vinculado ao contrato do aluno.
        IDHABILITACAOFILIAL: Identificador da habilitação filial

presente no

- - - - vinculada ao contrato do aluno.
        CODFILIAL: Código da filial do contrato do aluno.
        CODTIPOCURSO: Código do nível de ensino do contrato do aluno
        CODSERVICO: Código do serviço presente da parcela do contrato do aluno.
        CODBOLSA: Código da bolsa presente no contrato do aluno.

A partir daí é montar o layout conforme a solicitação do layout da declaração mensal de serviços solicitada pela prefeitura de Salvador.

Aviso

title	ATENÇÃO

O relatório deve gerar um arquivo com extensão xlsx ou xls.

O layout apresentado na imagem abaixo está considerado a educação superior.

Image Added

Expandir

title	Utilização do Relatório

Com o relatório pronto, basta agora executar o mesmo informados os dados dos parâmetros.

Selecionar o relatório na tela do RM Reports e ir no processo de gerar relatório, o sistema irá abrir a tela de geração de relatório.

Nessa etapa basta clicar no botão avançar

Image Added

Na tela de parâmetros informar os valores para cada parâmetro.

A Origem só é permitido Valor Fixo.
A competência deve ser informada no formatado MM/yyyy. Ex: 11/2023, 01/2024

Image Added

Na tela de tipo de geração deve selecionar a opção exportação para arquivo Na tela de tipo de saída selecionar a opção Microsoft Excel (XLSX) ou Microsoft Excel (XLS).

Image Added

Na tela de caminho selecionar o caminho que o arquivo será gravado, e ajustar o nome do arquivo conforme a documentação do layout fornecido pela prefeitura de Salvador.

Image Added

O relatório irá gerar o arquivo considerando as informações presente na tabela SDECLARACAOMENSALSERVICO que o provedor fornece. A regra de preenchimento dos dados na tabela SDECLARACAOMENSALSERVICO será:

Os contratos ativos pertencentes à coligada, filial, nível de ensino e que tenha parcela com data de vencimento na competência informada.
- As parcelas com lançamentos gerados serão considerado o valor original do lançamento e os valores das bolsas vinculadas aos lançamentos gerados que estão não estão cancelados ou gerados por acordo. Isso por questão de performance para a geração do relatório.
- As parcelas sem lançamentos gerados os valores serão simulados para obter o valor da parcela e os valores das bolsas. Simulação de valores utilizará as mesmas regras presentes no sistema nos processos de simulação de valores das parcelas
Será criada uma linha para cada serviço e bolsa presente no contrato do aluno.

Exemplo 1:

No contrato do aluno temos o serviço A e as bolsas X e Y. Então no arquivo terá uma linha para o serviço A para a bolsa X, e uma outra linha com o serviço A para a bolsa Y.

Nome do Aluno	Nome do Curso	Nº de Matrícula	Nome Responsável	CPF Responsável	Valor Contrato	Mês	Ano	Valor Mensalidade	Código Benefício	Valor Benefício	CTISS
Aluno 1	Curso 1	RA-0001	Responsável financeiro 1	111.111.111-11	1000,00	11	2023	100,00	Bolsa X	10,00	CTISS Serviço A
Aluno 1	Curso 1	RA-0001	Responsável financeiro 1	111.111.111-11	1000,00	11	2023	100,00	Bolsa Y	15,00	CTISS Serviço A

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 3

Nova versão Atual

Chave

Provedor - Dados da declaração mensal de serviços educacionais