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 |
|---|
|
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 | A seguir vamos descrever tais configurações: |
|---|
| 1 - Executar o script de marcação CN.2023.11_05 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. | 2 - Nas permissões do Perfil liberar acesso no Campo Complementar do cadastro de Serviço.  
| 3 - Criação do campo complementar CTISS para o serviço. Esse campo deve ter obrigatoriamente o nome de CTISS ser do tipo alfanumérico com tamanho 10, e subtipo do campo texto igual a texto. 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 alfanumérico com tamanho 10, e subtipo do campo texto igual a texto. O campo deverá ser preenchido conforme as regras presentes na documentação da declaração mensal de serviços educacionais | | | 4 - Após criar os campos complementares dar permissão no Nível de Ensino 
|
|
|
| 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. 
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 |
|---|
| 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". 
|
|
| Expandir |
|---|
| label | personalizado |
|---|
| title | Criar Relatórios personalizadosPersonalizados |
|---|
|
Caso os relatórios presentes no TOTVS Compartilhamento não atende as suas necessidades, pode-se criar relatórios personalizados. A seguir como criar um novo relatório informando a fonte de dados que é o novo provedor criado, a Declaração Mensal de Serviços.
| 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. Uma vez vinculado não é possível remover a fonte de dados, para remover, será necessário criar um novo relatório. |
Ao abrir o layout do relatório e ir na lista de campos da tabela SDECLARACAOMENSALSERVICO irá aparecer com os seus respectivos campos.
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 informado no campo complementar conforme descrição acima na bolsa presente no contrato do aluno.
- VALORBENEFICIO: Valor do benefício que é o valor da bolsa presente no contrato do aluno.
- CTISS: Valor do CTISS informado no campo complementar conforme descrição acima no serviço presente na parcela do contrato do valor.
- CODCURSO: Código do curso do aluno 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 vinculado ao contrato do aluno.
- IDHABILITACAOFILIAL: Identificador da habilitação filial 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 |
|---|
| 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. 
|
| 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 , o sistema irá abrir a tela de geração de relatório.
Nessa etapa basta clicar no botão avançar |
Na tela de parâmetros informar os valores para cada parâmetro.
Na tela de parâmetros informar os valores para cada parâmetro, em Origem só é permitido Valor Fixo.  Image Modified
|
 Image Modified
Na tela de tipo de geração deve selecionar a opção exportação para arquivo |
Image Removed
Na Na tela de tipo de saída selecionar a opção Microsoft Excel (XLSX) ou Microsoft Excel (XLS). Image Added  Image Modified
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 Modified
|
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 |
