Projeto FS007779 (873247-874083) - Integração SGE x Protheus – Parte1

Fábrica de Software
Especificadores: Ana Carolina Eleutério Abras
Alice Viana Machado
24/07/2017
ESPECIFICAÇÃO ANEXO I Sumário
1.1. Síntese
1.2. Requisitos
1.2.1. Escopo
1.2.2. Restrições
1.2.3. Infraestrutura e Ambiente de Desenvolvimento
1.3. Modelo de Solução
Req. 01 – Parâmetros da Customização
Req. 02 – Anexo Customizado no Cadastro de Serviços
Req. 03 – Processo Automático de Importação de Cadastros Básicos (Protheus => SGE)
Req. 04 – Anexo customizado de Item Contábil no cadastro de Modalidade
Req. 05 – Anexo customizado de Dados Financeiros no cadastro de Matriz Aplicada
Req. 06 – Processo customizado para validar Item Contábil e Centro de Custo no cadastro de Matriz Aplicada
Req. 07 – Anexo customizado de Dados Financeiros no cadastro de Turma
Req. 08 – Processo customizado para validar Item Contábil e Centro de Custo no cadastro de Turma
1.4. Histórico de Atualização do Documento
1.4.1. Histórico de Versões
1.4.2. Aprovação

1.1. Síntese

O cliente FIERGS solicita customização para atender a demanda de integração entre SGE e Protheus.
A integração será realizada via banco de dados, utilizando o barramento IIF (Interface de Integração FIERGS) que será disponibilizado pela FIERGS, onde:
Para exportação de dados, o TOTVS Educacional irá escrever em tabelas de um banco de dados previamente parametrizado utilizando Pacotes (Procedures, Functions) disponibilizadas pela FIERGS para este fim. A equipe técnica da FIERGS será responsável por ler os dados deste banco e gerenciar/enviar para o ERP Protheus, que irá executar funcionalidades nativas, sendo validadas todas as regras de negócios, para que os dados sejam inseridos/atualizados no banco de dados do ERP Protheus.
Para importação de dados, o TOTVS Educacional irá ler informações das tabelas do mesmo banco de dados através de Views e executar funcionalidades nativas, sendo validadas todas as regras de negócios, para que os dados sejam inseridos/atualizados no banco de dados do TOTVS Educacional.
Este documento tem como objetivo descrever de forma detalhada a solução a ser implementada pela TOTVS.

1.2. Requisitos

1.2.1. Escopo

Req. 01 – Parâmetros da Customização
Req. 02 – Anexo Customizado no Cadastro de Serviços
Req. 03 – Processo Automático de Importação de Cadastros Básicos (Protheus => SGE)
Req. 04 – Anexo Customizado de Item Contábil no Cadastro de Modalidade
Req. 05 – Anexo Customizado de Dados Financeiros no Cadastro de Matriz Aplicada
Req. 06 – Processo Customizado para Validar Item Contábil e Centro de Custo no Cadastro de Matriz Aplicada
Req. 07 – Anexo Customizado de Dados Financeiros no Cadastro de Turma
Req. 08 – Processo Customizado para Validar Item Contábil e Centro de Custo no Cadastro de Turma

1.2.2. Restrições

Não estão contemplados nesta proposta:

1. Funcionalidades não contempladas no escopo deste documento ou qualquer informação que esteja implícita na documentação.
2. Desenvolvimento de help on-line.
3. Criação e manutenção de usuários do sistema.
4. Elaboração ou alteração de qualquer relatório.
5. Desenvolvimento de rotinas ou programas para carga de dados nos demais sistemas que proverão interfaces com o projeto desenvolvido além de Produtos/Serviços e Fornecedores.
6. Seleção, instalação e configuração de infraestrutura, banco de dados, hardware e ambiente operacional necessário à implementação do projeto desenvolvido, seja em ambiente de testes ou ambiente oficial.
7. Manutenções em outros Sistemas não descritos na Proposta.
8. Procedimentos de backup do sistema ou banco de dados.
9. Disponibilidade do projeto desenvolvido em outras línguas.
10. Instalação do sistema em outras localidades.
11. Não está previsto neste escopo desenvolvimento de funcionalidades no Protheus e/ou Barramento FIERGS.
12. Não faz parte do escopo deste projeto o desenvolvimento de funcionalidades que permitam a integração Histórico Padrão, Condição de Pagamento, TES, Tipo de Documento e outros cadastros que não estejam explícitos nos requisitos que compõem a solução customizada.
13. Não faz parte do escopo deste projeto o desenvolvimento de funcionalidades que permitam a integração de estorno de baixa. Caso aconteça alguma exceção com esta necessidade, o estorno deverá ser realizado manualmente nos dois sistemas.
14. Não faz parte do escopo deste projeto a criação de Views, Functions, Procedures e Packages no barramento IIF.
15. Não está previsto no escopo deste projeto o desenvolvimento de funcionalidades que permitam a integração de cancelamento de negociações. Caso necessário, a operação deverá ser realizada nos dois sistemas.
16. Não está previsto no escopo deste projeto horas para atualização do manual e cenários de testes disponibilizados para o projeto SGE.

1.2.3. Infraestrutura e Ambiente de Desenvolvimento

O presente documento considera os itens abaixo como premissas técnicas referentes à infraestrutura e ambiente da sua empresa. Todo o projeto de desenvolvimento será feito tomando como base as informações colocadas abaixo:

• Sistema Base: TOTVS Educacional
• Base de Dados: Oracle
• Linguagem: .NET
• Versão ERP: 12.1.17

1.3. Modelo de Solução

Importante: Observe que no modelo de solução apresentado, conforme solicitado pela FIERGS, não existe comunicação direta entre o TOTVS EDUCACIONAL e o PROTHEUS. Toda integração será via barramento IIF, sendo este responsável por integrar a informação no Protheus.
Nos requisitos descritos abaixo, é mencionado que o TOTVS Educacional disponibiliza ou consulta dados das tabelas do banco de integração. Para tal, serão utilizados Views, Functions, Procedures e Packages a serem disponibilizados pela equipe FIERGS, não sendo realizadas operações (insert, update, delete) diretamente no banco de dados.

Req. 01 – Parâmetros da Customização

• Fluxo do Processo

• Descrição do Processo

1. Usuário acessa o TOTVS Educacional, menu Customização | Parâmetros da Integração – TOTVS Educacional (SGE) x Protheus
2. É exibida tela customizada de parâmetros.
3. Usuário preenche as parametrizações e clica em "salvar".
4. Rotina Customizada armazena informação em tabela customizada.
5. Fim do Processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

O objetivo deste requisito é detalhar os parâmetros necessários para a Integração de dados entre o TOTVS Educacional (SGE) e o Protheus. A tela de parâmetros estará disponível em TOTVS Educacional | Customização | Parâmetros da Integração - TOTVS Educacional (SGE) x Protheus.
A tela exibirá uma visão com a lista de parâmetros disponíveis para configuração (Fig. 1). São eles:

• Servidor Barramento: endereço de acesso ao banco de dados correspondente ao barramento IIF disponibilizado pelo cliente.

• Usuário: usuário para conexão com o banco de dados do barramento IIF.

• Senha: senha do usuário informado para conexão com banco de dados do barramento IIF. O campo será salvo criptografado.

• Empresa Protheus: código da Empresa do Protheus correspondente à Coligada da parametrização no TOTVS Educacional. Este campo será utilizado para efetuar o De-Para entre Coligada e Empresa.

• Habilita Integração: campo que definirá se a integração estará habilitada (valor igual a um) ou desabilitada (valor igual a zero). Este parâmetro será verificado antes de cada gatilho que efetua importação ou exportação de dados referentes à integração (plug-ins, processos customizados). Caso esteja desmarcado, os gatilhos não serão executados.

• Condição de Pagamento: código da condição de pagamento que será utilizada ao enviar o Pedido para o Protheus. O cadastro de condição de pagamento do Protheus não será sincronizado com o TOTVS Educacional (SGE) sendo sempre enviado no pedido o valor parametrizado neste campo (Atualmente o cliente utiliza a condição de pagamento = 9).

• Código do Tipo de Baixa – Cancelamento: código do tipo de baixa por cancelamento que será enviado ao Protheus, nas situações de cancelamento de lançamentos.

• Código do Tipo de Baixa – Cartão de Crédito: código do tipo de baixa por cartão de crédito que será enviado ao Protheus, nas situações de baixa de lançamento com a forma de pagamento igual a cartão de crédito.

Os campos acima serão de preenchimento livre. Não existirá lista para buscar os cadastros e selecionar os códigos. Os códigos deverão ser informados diretamente nos campos e seus valores serão utilizados na integração.
Será necessário fazer o cadastro dos parâmetros em todas as Coligadas que utilizarão a integração. As informações serão armazenadas em tabela customizada (ZPARAMETROTEMPLATE), por coligada, onde cada parâmetro corresponde a um registro na tabela.
Para editar os parâmetros, o usuário deverá selecionar a linha da visão correspondente ao parâmetro desejado e clicar em editar (ou duplo clique). Será exibido formulário com o campo selecionado para edição (Fig. 2).
O acesso à parametrização será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.
Importante: O preenchimento dos parâmetros é de responsabilidade do cliente. Para o correto funcionamento da customização, todos os dados deverão estar parametrizados corretamente.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig. 1 – Visão de Parâmetros

Fig. 2 – Formulário de edição

Req. 02 – Anexo Customizado no Cadastro de Serviços

• Fluxo do Processo

• Descrição do Processo

1. Usuário acessa o TOTVS Educacional, menu Financeiro/Contábil | Serviços | Anexos – Integração Protheus.
2. O anexo customizado de parâmetros de Serviços é exibido para o usuário.
3. Usuário preenche os campos da parametrização e clica em "Salvar".
4. Customização armazena informações em tabela customizada.
5. Fim do processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

Será criado um anexo customizado no cadastro de serviços, disponível em TOTVS Educacional | Financeiro/Contábil | Serviços, onde o usuário fará a parametrização de informações necessárias para criação do pedido de venda no Protheus.
O usuário deverá selecionar o Serviço para o qual deseja informar os parâmetros, clicar em Anexos – Integração Protheus (Fig.1). Será exibida tela (Fig.2) com os seguintes campos disponíveis:

• Natureza Financeira: campo em formato lista, onde o usuário poderá selecionar o código da natureza financeira que será utilizada para Serviço. A lista de Naturezas será obtida através da tabela nativa de Natureza Orçamentária Financeira do TOTVS Educacional (TTBORCAMENTO), que será preenchida com os dados do cadastro de Natureza do Protheus, através do processo definido no Req.03.

• Produto: campo em formato lista, onde o usuário poderá selecionar o código do produto que será utilizado para o Serviço. A lista de Produtos será obtida através da tabela nativa do TOTVS Educacional (TPRODUTO), que será preenchida com os dados do cadastro de Produtos do Protheus, através do processo definido no Req.03.

• TES: campo em formato lista, onde o usuário poderá selecionar um código de TES que será utilizado para o Serviço. Para seleção da TES, a customização irá consultar a View IIFR_SF4010_VW do barramento IIF que retornará uma lista de registros para o usuário selecionar um item.

• Série: campo texto onde o usuário informará a série que será utilizada pelo Serviço, quando gerar o Pedido no Protheus.

• Prefixo: campo texto onde o usuário informará a o prefixo do documento que será utilizada pelo Serviço, quando gerar o Pedido no Protheus.

Os dados informados nesta interface serão armazenados em tabela customizada, por Serviço e Coligada. Será necessário informar estes parâmetros para cada serviço que for utilizado pela Integração Protheus.
Cada Serviço poderá ter somente um registro de anexo vinculado. O serviço "MENSALIDADE BALCÃO" por exemplo, na coligada SESI terá apenas uma natureza financeira, produto, TES, serie e prefixo associado. Mas dentro da mesma coligada poderemos ter outro serviço "MENSALIDADE INDUSTRIA' e nele teremos outros anexos, natureza financeira, produto, TES, serie e prefixo associado.
Os dados do cadastro da TES não serão armazenados em tabelas do TOTVS Educacional. A consulta para mostrar a lista será feita diretamente no barramento IIF.
O acesso a esta interface será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig.1 – Menu do Anexo

Fig.2 – Formulário de Edição

Req. 03 – Processo Automático de Importação de Cadastros Básicos (Protheus => SGE)

• Fluxo do Processo

• Descrição do Processo

1. No TOTVS Educacional usuário acessa o menu Customização | Importação de Cadastros Básicos do Protheus para o TOTVS Educacional (SGE).
2. É exibida tela customizada de Job para agendamento ou execução imediata.
Se usuário desejar executar o processo imediatamente:
3. Rotina customizada executa processo de importação de cadastros básicos.
4. Caso contrário, usuário preenche as parametrizações de agendamento e os dados são gravados nas tabelas do gerenciamento de processos (para posterior execução quando forem atingidas as condições (data/hora) do agendamento.
5. Fim do Processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

O objetivo deste requisito é efetuar a importação de cadastros básicos do barramento IIF para o TOTVS Educacional.
Será criado um processo customizado que poderá ser executado manualmente ou agendado para executar com intervalos de tempo parametrizados pelo usuário. A tela para agendamento/execução do processo estará disponível no menu TOTVS Educacional | Customização | Importação – Cadastros Básicos.
Ao ser executado, o processo irá consultar Views disponíveis no barramento IIF referentes aos cadastros do Protheus. São elas:

Todos os registros das Views consultadas deverão retornar o código da Empresa no Protheus. Através dele, será buscada a Coligada do TOTVS Educacional, na tabela de parâmetros ZPARAMETROSTEMPLATE. O registro será gerado no TOTVS Educacional para a Coligada associada à Empresa do Protheus. São exceções os cadastros de Natureza Financeira, Moeda e Produto que serão globais.
Segue abaixo detalhamento dos campos de cada entidade à ser importada para o TOTVS Educacional.

• • Centro de Custo (CTT):

Além dos campos detalhados na coluna Campo TOTVS Educacional, será necessário preencher:

• • • "Envia para SPED Contábil" (GCCUSTO.ENVIASPED) com valor = F.
    • "Data da Inclusão" (GCCUSTO.DATAINCLUSAO) com a data corrente.

• • Item Contábil (CTD):

• • Classe de Valor (CTH):

• • Natureza Financeira (SED):

• • Moeda (CTO):

• • Banco (SA6):

Ao importar o cadastro de Bancos do Protheus, serão preenchidas quatro tabelas no TOTVS Educacional: GBANCO, GAGENCIA, FCONTA e FCXA.
Importante: O cadastro de Bancos do Protheus é por Empresa e Filial. O cadastro de banco de TOTVS Educacional é por Coligada. Para resolver este conflito, o cliente disponibilizará na View as informações consolidadas por Empresa, de modo que possam ser importadas para o TOTVS Educacional por Coligada.

Importante: No cadastro do Protheus, o Banco se repete para cada Agência e Conta cadastrada. Ele deverá ser gravado na tabela GBANCO do TOTVS Educacional apenas uma vez, verificando se já foi importado através do código A6_COD igual a GBANCO.NUMBANCO. O mesmo vale para Agência do Banco, que só precisa ser gravada na tabela GAGENCIA quando não existir outro registro para o mesmo Banco (GAGENCIA.NUMBANCO) com o campo A6_AGENCIA igual a GAGENCIA.NUMAGENCIA.
Cada Conta importada (vínculo entre Banco, Agência e Conta) deverá gerar uma Conta Caixa no TOTVS Educacional.
Ao gerar a Conta Caixa, será necessário preencher os campos básicos (a aba Integração bancária. Os campos serão preenchidos conforme abaixo:

• • Produto (SB1):

O cadastro de Produtos do TOTVS Educacional será Global, equivalente ao cadastro compartilhado do Protheus.
Todos os registros serão importados com o tipo igual a Serviço (TPRODUTO.TIPO = S). Todos serão importados como último nível (TPRODUTO.ULTIMONIVEL = 1) e não serão importados grupos e subgrupos do Protheus.
Além dos campos definidos acima, será preenchido ainda o campo TPRODUTO.DTCADASTRAMENTO, com a data corrente.
Importante: todos os produtos que estiverem disponíveis no barramento (View) serão importados para o TOTVS Educacional. É responsabilidade do Cliente/Protheus classificar os produtos cadastrados a fim de identificar os que precisam ser enviados ao TOTVS Educacional.

• • Plano de Contas (CT1):

Além dos campos definidos acima, serão preenchidos os campos:

• "Natureza da Conta para Emissão de SPED" (CCONTA.NATSPED) com o valor "Não Informada";
• "Data de Inclusão" (CCONTA.DATAINCLU) com a data corrente.

Ao executar, o processo customizado irá fazer a conexão com o barramento IIF e consultar as Views pré-definidas para cada cadastro. Para cada registro selecionado em cada uma das Views, será executada funcionalidade nativa do TOTVS Educacional para inclusão/atualização do registro no banco de dados, sendo validadas todas as regras de negócio padrão. Após validações, as tabelas correspondentes do TOTVS Educacional serão preenchidas com os dados das Views.
As Views do barramento deverão retornar apenas registros ainda não importados pelo TOTVS Educacional. Para isso, ao finalizar a importação dos dados, a customização deverá executar uma procedure do barramento (IIFR_STATUS_REPLICACAO_PRC) que será responsável por marcar o registro como já integrado. Desta forma, o barramento conseguirá mostrar nas Views apenas os registros pendentes de integração.
A procedure IIFR_STATUS_REPLICACAO_PRC deverá receber o mnemônico da tabela, o R_E_C_N_O_ do registro do Protheus e o status do registro: 'C' para Concluído ou 'F' para Falha.
Assinatura da Procedure: IIFR_STATUS_REPLICACAO_PRC(TABELA, R_E_C_N_O_, STATUS DEFAULT 'C').
Exemplo: IIFR_STATUS_REPLICACAO_PRC('CTT', 1807, 'C').
Ao final do processo, será gerado um log da execução, contendo informações como: Views consultadas, número de registros importados e mensagem de erro, caso ocorra. Este log será gravado em tabelas nativas do TOTVS Educacional e estará disponível para visualização através da interface - menu Ambiente, Gerenciamento de Jobs.
Importante:

1. Somente os cadastros mencionados acima serão sincronizados de forma automática através do processo de importação.
2. As informações de Empresa/Coligada e Filial não serão sincronizadas entre os dois sistemas, sendo necessário realizar o cadastro manual nos dois sistemas. As Views consultadas nestes requisitos deverão trazer o código da Empresa (duas primeiras posições do campo Filial-Protheus), possibilitando a associação entre a Empresa (Protheus) e a Coligada (TOTVS Educacional).
3. A regra para ocultar/mostrar registros integrados ou não nas Views e a criação do pacote para atualização de registros processados são tratados pelo barramento e é de responsabilidade do Cliente.
4. A pedido do cliente, a chave R_E_C_N_O_ do Protheus não será armazenada no TOTVS Educacional. Segundo o cliente, como este é um número sequencial, ele poderá não refletir o código correto em determinadas situações.
5. Não será necessário preencher o Código da Filial no cadastro das entidades importadas acima no TOTVS Educacional. Portanto, não utilizaremos o Código da Filial do Protheus nesta importação.
6. Não está prevista integração de dados de Parâmetros de Banco, Contrato de Banco e Dados do convênio. Estas parametrizações deverão ser informadas manualmente nos dois sistemas.
7. Não está prevista integração de dados de Tipo de Documento (X5), já que será utilizado apenas um código que será fixo no Protheus.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig.1 – Tela de Agendamento e Execução do Job

Req. 04 – Anexo customizado de Item Contábil no cadastro de Modalidade

• Fluxo do Processo

• Descrição do Processo

1. No TOTVS Educacional usuário acessa menu Currículo e Oferta | Estrutura curricular | Mais | Modalidades do Curso | Anexos | Item Contábil.
2. Visão customizada do Anexo é exibida.
3. Usuário insere/altera/exclui registro.
4. Rotina armazena informações em tabela customizada.
5. Fim do processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

No TOTVS Educacional por meio do menu Currículo e Oferta | Estrutura curricular | Mais | Modalidades do Curso, será criado um anexo customizado para que sejam informados os Itens Contábeis vinculados às Modalidades do Curso.
Neste anexo, será disponibilizado um campo do tipo lookup que referenciará a tabela SITEMCONTABILPROTHEUS. Os registros exibidos no lookup serão filtrados pela Coligada do contexto.
As informações serão armazenadas em uma tabela customizada (ZIPMODALIDADEITEMCONTABIL) cujo detalhamento de dados segue abaixo.

PONTOS DE ATENÇÃO:
1. Nesta interface, o usuário poderá incluir, editar e excluir registros. O usuário poderá selecionar somente Itens Contábeis vindos do Protheus, não podendo incluir manualmente novo Item Contábil sem que seja validado na tabela SITEMCONTABILPROTHEUS.
2. As informações serão armazenadas em uma tabela customizada (ZIPMODALIDADEITEMCONTABIL).
3. Para cada Modalidade poderão ser vinculados vários Itens Contábeis de acordo com a necessidade do usuário.
4. O acesso a esta interface será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig.1 – Menu do Anexo

Fig.2 – Visão do Anexo


Fig.3 – Formulário de Edição

Req. 05 – Anexo customizado de Dados Financeiros no cadastro de Matriz Aplicada

• Fluxo do Processo

• Descrição do Processo

1. No TOTVS Educacional usuário acessa menu Currículo e Oferta | Estrutura curricular | Matriz curricular | Anexos | Matriz Aplicada | Anexos | Dados Financeiros – Integração Protheus.
2. Interface customizada do anexo é exibida.
3. Usuário insere/altera registro.
4. Rotina armazena informações em tabela customizada.
5. Fim do processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

No TOTVS Educacional por meio do menu Currículo e Oferta | Estrutura curricular | Matriz curricular | Anexos | Matriz Aplicada, será criado um anexo customizado para que seja informado o Item Contábil e a Classe de Valor vinculados às Matrizes Aplicadas.
Neste anexo, serão disponibilizados dois campos do tipo lista que farão referência às tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS. Os registros exibidos nas listas serão filtrados pela Coligada do contexto.
As informações serão armazenadas em uma tabela customizada (ZIPMATRIZDADOSFINANCEIROS) cujo detalhamento de dados segue abaixo.

No momento que o usuário salvar o anexo de Dados Financeiros se o Item Contábil estiver preenchido serão realizadas as seguintes validações:

1. O Curso da Matriz Aplicada associada ao anexo que está sendo salvo possui Modalidade?
2. O Item Contábil informado está vinculado à Modalidade do Curso (Req. 04)?

Se o Curso da Matriz Aplicada não possuir Modalidade de Curso associada, ou se a Modalidade do Curso da Matriz Aplicada não estiver associada ao Item Contábil informado (Req.04), será exibida mensagem de erro, impossibilitando salvar o anexo.
Portanto, só será possível salvar o anexo se o Item Contábil e a Modalidade estiverem vinculados no TOTVS Educacional.
PONTOS DE ATENÇÃO:
1. Nesta interface, o usuário poderá incluir e editar registros. O usuário poderá selecionar somente Itens Contábeis e Classes de Valor vindos do Protheus, não podendo incluir manualmente sem que sejam validados nas tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS respectivamente.
2. As informações serão armazenadas em uma tabela customizada (ZIPMATRIZDADOSFINANCEIROS).
3. Para cada Matriz Aplicada poderá ser vinculado apenas um Item Contábil e uma Classe de Valor.
4. O acesso a esta interface será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig.1 – Menu Anexo


Fig.2 – Anexo Dados financeiros – Integração Protheus

Req. 06 – Processo customizado para validar Item Contábil e Centro de Custo no cadastro de Matriz Aplicada

• Fluxo do Processo

• Descrição do Processo

1. No TOTVS Educacional usuário acessa Currículo e Oferta | Estrutura Curricular | Matrizes curriculares | Anexos | Matriz Aplicada.
2. Visão nativa é exibida.
3. Usuário inclui/altera registro e clica em salvar.
4. Item Contábil e Modalidade vinculados?
4.1. Sim. Executa passo 5.
4.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Matriz Aplicada.
5. Item Contábil e Centro de Custo vinculados?
5.1. Sim. Informações da Matriz Aplicada são salvas.
5.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Matriz Aplicada
6. Fim do processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

Será criado um plugin customizado que interceptará o evento do botão Salvar/OK do cadastro de Matriz Aplicada acessado através do menu TOTVS Educacional | Currículo e Oferta | Estrutura curricular | Matriz curricular | Anexos | Matriz Aplicada.
No momento que o usuário salvar uma Matriz Aplicada e se houver Item Contábil vinculado à ela, serão realizadas as seguintes validações.

1. O Curso da Matriz Aplicada que está sendo salva possui Modalidade?
2. O Item Contábil da Matriz Aplicada (Req. 05) está vinculado à Modalidade do Curso (Req. 04)?
3. A Matriz Aplicada que está sendo salva possui Centro de Custo?
4. O Item Contábil e o Centro de Custo da Matriz Aplicada estão associados entre si no Protheus?

Se alguma das condições acima não for satisfeita, uma mensagem customizada será exibida ao usuário e ele será impossibilitado de salvar a Matriz Aplicada. Portanto, o usuário só conseguirá salvar as informações se o Item Contábil e a Modalidade estiverem vinculados no SGE e se o Item Contábil e o Centro de Custo estiverem vinculados no Protheus.
Para essa validação, o Protheus disponibilizará uma View (IIFR_CTA010_VW) que informará o vínculo entre Item Contábil e Centro de Custo. A consulta deverá ser feita por Coligada. Para isso, será considerada a Empresa Protheus parametrizada através do Req. 01. O valor do campo EMPRESAPROTHEUS deverá ser recuperado da tabela ZPARAMETROTEMPLATE e passado como filtro para a View.

• Protótipo

Não se aplica.

Req. 07 – Anexo customizado de Dados Financeiros no cadastro de Turma

• Fluxo do Processo

• Descrição do Processo

1. No TOTVS Educacional usuário acessa Currículo e Oferta | Oferta | Turmas | Anexos | Dados Financeiros – Integração Protheus.
2. Interface customizada é exibida.
3. Usuário insere/altera/exclui registro.
4. Rotina armazena informações em tabela customizada.
5. Fim do fluxo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

No TOTVS Educacional por meio do menu Currículo e Oferta | Oferta | Turmas, será criado um anexo customizado para que seja informado o Item Contábil e a Classe de Valor vinculados às Turmas.
Neste anexo, serão disponibilizados dois campos do tipo lista que farão referência às tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS. Os registros exibidos nas listas serão filtrados pela Coligada do contexto.
As informações serão armazenadas em uma tabela customizada (ZIPTURMADADOSFINANCEIROS) cujo detalhamento de dados segue abaixo.

No momento que o usuário salvar o anexo de Dados Financeiros se o Item Contábil estiver preenchido serão realizadas as seguintes validações:

1. O Curso da Turma associada ao anexo que está sendo salvo possui Modalidade?
2. O Item Contábil informado está vinculado à Modalidade do Curso (Req. 04)?

Se o Curso da Turma não possuir Modalidade de Curso associada, ou se a Modalidade do Curso da Turma não estiver associada ao Item Contábil informado (Req.04), será exibida mensagem de erro, impossibilitando salvar o anexo.
Portanto, só será possível salvar o anexo se o Item Contábil e a Modalidade estiverem vinculados no TOTVS Educacional.
PONTOS DE ATENÇÃO:
1. Nesta interface, o usuário poderá incluir e editar registros. O usuário poderá selecionar somente Itens Contábeis e Classes de Valor vindos do Protheus, não podendo incluir manualmente sem que sejam validados nas tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS respectivamente.
2. As informações serão armazenadas em uma tabela customizada (ZIPTURMADADOSFINANCEIROS).
3. Para cada Turma poderá ser vinculado apenas um Item Contábil e uma Classe de Valor.
4. Dependendo da situação, o Item Contábil pode ser informado na Turma ou na Matriz Aplicada. Nos casos onde for informado em ambos, o Item Contábil da Turma deve prevalecer para a integração.
5. O acesso a esta interface será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig.1 – Menu do Anexo


Fig.2 – Anexo Dados financeiros – Integração Protheus

Req. 08 – Processo customizado para validar Item Contábil e Centro de Custo no cadastro de Turma

• Fluxo do Processo

• Descrição do Processo

1. No TOTVS Educacional usuário acessa Currículo e Oferta | Oferta | Turmas.
2. Visão nativa é exibida.
3. Usuário inclui/altera registro e clica em salvar.
4. Item Contábil e Modalidade vinculados?
4.1. Sim. Executa passo 5.
4.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Turma.
5. Item Contábil e Centro de Custo vinculados?
5.1. Sim. Informações da Turma são salvas.
5.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Turma
6. Fim do processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

Será criado um plugin customizado que interceptará o evento do botão Salvar/OK do cadastro de Turma acessado através do menu TOTVS Educacional | Currículo e Oferta | Oferta | Turmas.
No momento que o usuário salvar uma Turma e se houver Item Contábil vinculado à ela, serão realizadas as seguintes validações.

1. O Curso da Turma que está sendo salva possui Modalidade?
2. O Item Contábil da Turma (Req. 07) está vinculado à Modalidade do Curso (Req. 04)?
3. A Turma que está sendo salva possui Centro de Custo?
4. O Item Contábil e o Centro de Custo da Turma estão associados entre si no Protheus?

Se alguma das condições acima não for satisfeita, uma mensagem customizada será exibida ao usuário e ele será impossibilitado de salvar a Turma. Portanto, o usuário só conseguirá salvar as informações se o Item Contábil e a Modalidade estiverem vinculados no SGE e se o Item Contábil e o Centro de Custo estiverem vinculados no Protheus.
Para essa validação, o Protheus disponibilizará uma View (IIFR_CTA010_VW) que informará o vínculo entre Item Contábil e Centro de Custo. A consulta deverá ser feita por Coligada. Para isso, será considerada a Empresa Protheus parametrizada através do Req. 01. O valor do campo EMPRESAPROTHEUS deverá ser recuperado da tabela ZPARAMETROTEMPLATE e passado como filtro para a View.

• Protótipo

Não se aplica.

1.4. Histórico de Atualização do Documento

1.4.1. Histórico de Versões

1.4.2. Aprovação