Projeto: FS007780 (873247-874083) – Integração RM com Protheus – Parte 3 (SESI-SENAI)
Cliente: FIERGS
Data: 26/10/2017

Sumário

1. Objetivo do documento
2. Síntese
3. Instalando a customização
3.1. Ambiente necessário
3.2. Executando o instalador de arquivos
3.3. Executando os scripts
3.4. Permissao de acesso a telas
3.4.1. Verificando o perfil do usuário
3.4.2. Liberando acesso aos menus
4. Observações importantes
5. Requisitos
5.1. Req. 01 – Exportação de Cancelamento de Lançamento Financeiro (TOTVS RM  Protheus)
5.2. Req. 02 – Importação de Acordo (Protheus  TOTVS RM)
5.3. Req. 03 – Importação de Baixa (Protheus  TOTVS RM)
6. Histórico de Atualização do Documento
6.1. Histórico de Versões
6.2. Aprovação

1. Objetivo do documento

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 no documento "Especificação Anexo I – Detalhamento Funcional – FS007779 – Parte 3.

2. 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 visa orientar sobre os passos iniciais para utilização da Customização.

3. Instalando a customização

3.1. Ambiente necessário

• Sistema base: TOTVS Educacional
• Banco de dados: Oracle
• Versão do ERP: 12.1.14

3.2. Executando o instalador de arquivos

O instalador é gerado com o nome "TOTVS Customização - Integração Protheus - CNI DR Rio Grande do Sul - 12.01.14.exe" e esse copiará todos os arquivos referentes a customização para a máquina do usuário. O instalador de arquivos deverá ser executado em todas as máquinas que utilizarão a Customização.
Fig. 01 – Instalador Passo 1













Fig. 02 – Instalador Passo 2

Fig. 03 – Instalador Passo 3

Fig.04 – Instalador Passo 4



Após a instalação o usuário poderá consistir os arquivos correspondentes a customização.

PONTO DE ATENÇÃO:
Conforme descrito na especificação, ressaltamos que plug-ins e dlls desenvolvidos para a versão acima podem apresentar algum tipo de incompatibilidade nas próximas versões oficiais, precisando assim serem recompilados(as). Portanto, qualquer mudança de versão deve ser previamente comunicada à TOTVS. A forma dessa comunicação é a seguinte:

• Abertura de uma ocorrência junto ao suporte (suporte.totvs.com) com no mínimo 15 dias de antecedência da data marcada para conversão, solicitando ao departamento de customização a conversão do plug-in.
• Após recebimento do mesmo executar a validação de suas funcionalidades em um ambiente de testes da nova versão.

No Painel de Controle, a instalação é gerada conforme abaixo:

Fig. 05 – Conclusão da instalação

3.3. Executando os scripts

• Executar o script 'TOTVS_Custom_Register_Action.sql';
• Executar o script 'TOTVS_Custom_Consolidate_All_Parte3.sql;

3.4. Permissao de acesso a telas

3.4.1. Verificando o perfil do usuário

• O usuário deve acessar o RM.exe em X:\totvs\CorporeRM\RM.Net.
• Acessar TOTVS Serviços Globais | Segurança | Usuário.
• No campo (Sistema: ) selecione o produto correto.
• Busque pelo usuário desejado e clique em editar.
• Navegue até a aba Segurança.
• Verifique qual é o perfil do usuário (Como mostra na imagem exemplo abaixo o perfil é DBA).

Fig. 06 – Permissão – Passo 01

Fig. 07 – Permissão – Passo 02

3.4.2. Liberando acesso aos menus

• TOTVS Serviços Globais | Segurança | Perfis.
• No campo (Sistema: ) selecione o produto correto.
• Busque pelo perfil desejado e clique em editar (como no exemplo acima o perfil será DBA).
• Navegue até a aba Acesso a Menus.
• Procure pelas customizações e selecione as desejadas.
• Clique em Permitir Acesso e depois em Ok.

Fig. 08 – Liberando acesso

4. Observações importantes

Para o correto funcionamento do Novo Gerenciador de Jobs algumas configurações devem ser observadas. Dentro da pasta "X:\totvs\CorporeRM\RM.Net" cinco arquivos precisam ser verificados. São eles:

• RM.Host.exe.config.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Adicionar: <add key="IsolateProcess" value="true" />
Adicionar: <add key="EnableProcessIsolation" value="true" />

• RM.Host.Service.exe.config.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Adicionar: <add key="IsolateProcess" value="true" />
Adicionar: <add key="EnableProcessIsolation" value="true" />

• RM.exe.config.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.

• Alias.dat.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Servidores de (Servidores de JOB e APP) para que as customizações  sejam carregadas: <RunService>true</RunService>.

• RM.Host.JobRunner.exe.config  (SOMENTE SERVIDORES JOB).

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Para carregar os plug-ins de processos customizados: <add key="LoadCustomSlave" value="true" />.

5. Requisitos

5.1. Req. 01 – Exportação de Cancelamento de Lançamento Financeiro (TOTVS RM  Protheus)

Este requisito detalha a exportação de cancelamento de títulos financeiros a ser realizada entre o TOTVS Gestão Financeira e o Protheus. Esse processo é automático e não precisa ser agendado.

5.1.1 Pré-Requisitos / Parametrizações

1- Configurar o código do Tipo de Baixa que será exportado para o Protheus no TOTVS Educacional, menu Customização | Parâmetros | Código do Tipo da Baixa – Cancelamento. Esse valor será utilizado no envio do cancelamento (baixa) no Protheus.

5.1.2 Descrição do Processo

A customização acionará a função FINA070 (pacote IIFR_CLIENTE_PCK) quando um Lançamento for cancelado no sentido TOTVS RM  Protheus. Neste momento a integração enviará o registro para o Barramento IIF de onde serão lidos pelo Protheus.
O processo "Cancelar Contrato" acionado através do menu Educacional | Financeiro/Contábil | Contratos | Processos, quando a opção "Cancelar lançamentos em aberto e não vencidos" do processo estiver marcada, efetuará o cancelamento dos lançamentos financeiros no RM e com isso, a customização será acionada.
O cancelamento do Lançamento será concretizado no TOTVS independente do retorno recebido pelo Protheus. Caso ocorra erro na integração, o usuário poderá efetuar o reenvio do registro através da interface de log.

PONTOS DE ATENÇÃO:

• Se for identificado que um Lançamento cancelado no RM já foi baixado no Protheus, ficará a cargo do usuário resolver a situação manualmente.
• Ao cancelar um Acordo no RM, os lançamentos gerados pelo Acordo são cancelados e os lançamentos originais são reabertos. No entanto, por estarem associados a um Contrato do tipo Acordo, o cancelamento destes títulos não serão enviados para o Protheus. Quando essa operação for necessária (cancelamento do Acordo), será preciso efetuar o cancelamento da negociação no Protheus manualmente, já que não está prevista integração para cancelamento de Acordo/Negociação entre os dois sistemas.

5.2. Req. 02 – Importação de Acordo (Protheus  TOTVS RM)

Este requisito detalha a integração de Acordos Financeiros a ser realizada entre TOTVS RM e Protheus. A integração será realizada de forma automática (Job Server), respeitando os intervalos de tempo pré-definidos pelo usuário no agendamento. O Processo deverá ser agendado no TOTVS Educacional, menu Customização | Importação de Acordo.

5.2.1 Pré-Requisitos / Parametrizações

1. Template de Acordo: Criar o template do acordo chamado "Acordo SGE" no módulo TOTVS Gestão Financeira, menu Contas a Pagar / Receber | Acordo | Template de Acordo. A classificação financeira (aba Defaults) precisa obrigatoriamente ser preenchida. Depois disso, é necessário parametrizar o identificador do template nos parâmetros da customização.
2. Parametrizar o TOTVS Gestão Financeira e Educacional para gerar apenas lançamentos financeiros do tipo Não Contábeis. Essa parametrização é por Coligada e Filial.
3. Informar parâmetros de Acordo que se encontram nos parâmetros gerais do TOTVS Educacional, menu Ambiente | Parâmetros |Tesouraria | Avançar, aba Geral ½ : Informar os Serviços (Inadimplência e Processo Seletivo).

5.2.2 Descrição do Processo

As renegociações (acordos) referente a débitos dos alunos serão realizadas diretamente no Protheus, através de rotina customizada pela FIERGS para este fim específico. Os títulos gerados pelas negociações serão enviados para o barramento IIF para serem importados no TOTVS Educacional.
Ao ser disparada, a rotina customizada de integração irá ler as informações dos Acordos Financeiros que estarão disponíveis no barramento e acionar rotina nativa para Geração de Acordo disponível em TOTVS Gestão Financeira | Contas a Pagar / Receber | Lançamentos | Processos | Gerar Acordo. Este processo, por sua vez, irá baixar os Lançamentos de origem por acordo e criar os novos, além de gerar um novo Contrato Educacional para o aluno (Contrato do tipo Acordo).
As visões consultadas no barramento para importação de Acordo são:

• Cabeçalho: DDA_IIF.IIFR_RENEGOCIACAO_OUT_VW

Contém informações como Data do Acordo e Valor Total.

• Parcelas Geradas: DDA_IIF.IIFR_TIT_RENEGOCIACAO_OUT_VW

Contém informações das Parcelas geradas, como: Data de Vencimento, Nosso Número e Valor.

• Lançamentos Originais: DDA_IIF.IIFR_TIT_BAIXADO_OUT_VW

Contém o Nosso Número dos lançamentos originais, que precisam ser baixados no RM para geração do Acordo.
Após importação, o RM informará ao Protheus o status da execução de cada registro, através da função "AtualizaMensagem", disponível no barramento. No caso de Sucesso, o Protheus deverá retirar da visão os registros já processados pelo RM.
Os dados da importação estarão disponíveis na interface de log, detalhada no manual da Parte 2 - Req.08.
PONTOS DE ATENÇÃO:

• A Negociação no Protheus realiza os processos de baixa dos títulos de origem e criação dos novos títulos em momentos distintos, ao contrário do TOTVS RM, que realiza esses passos em um só momento. Por isso, para que seja possível acionar a rotina nativa de Geração de Acordos do TOTVS RM, o Protheus não deverá enviar a baixa dos títulos do tipo Acordo ao barramento. A integração será realizada em um só momento, quando o Protheus enviar os novos títulos gerados pela Negociação, disponibilizando as informações descritas neste requisito.
• Ao cancelar um Acordo no RM, os lançamentos gerados pelo Acordo são cancelados e os lançamentos originais são reabertos. Quando essa operação for necessária (cancelamento do Acordo), será preciso efetuar o cancelamento da negociação no Protheus manualmente, já que não está prevista integração para cancelamento de Acordo/Negociação entre os dois sistemas.

5.3. Req. 03 – Importação de Baixa (Protheus  TOTVS RM)

Este requisito detalha a integração de Baixa de Lançamentos Financeiros a ser realizada entre TOTVS RM e Protheus. A integração será realizada de forma automática (Job Server), respeitando os intervalos de tempo pré-definidos pelo usuário no agendamento. O Processo deverá ser agendado no TOTVS Educacional, menu Customização | Importação de Baixa.

5.3.1 Pré-Requisitos / Parametrizações

1. Parametrizar o TOTVS Gestão Financeira e Educacional para gerar apenas lançamentos financeiros do tipo Não Contábeis. Essa parametrização é por Coligada e Filial.
2. Meio de Pagamento: Informar o código do Meio de Pagamento que será utilizado em todos os Acordos no TOTVS Educacional, menu Customização | Parâmetros | Meio de Pagamento.

5.3.2 Descrição do Processo

A Baixa dos Lançamentos Financeiros será realizada diretamente no Protheus e as informações dos títulos baixados deverão ser enviados para o barramento IIF para serem importados no TOTVS RM.
Ao ser disparada, a rotina customizada de integração irá ler as informações dos Lançamentos Financeiros baixados no Protheus que estarão disponíveis na visão DDA_IIF.IIFR_BAIXA_P11_RM_OUT_VW, que contém os dados necessários para realização da baixa no RM. Através do Nosso Número disponível na visão, a customização irá localizar os lançamentos financeiros correspondentes no TOTVS RM e acionar rotina nativa para inclusão da Baixa, que por sua vez, irá baixar os lançamentos no TOTVS RM.
Após importação, o RM informará ao Protheus o status da execução de cada registro, através da função "AtualizaMensagem", disponível no barramento. No caso de Sucesso, o Protheus deverá retirar da visão os registros já processados pelo RM.
Os dados da importação estarão disponíveis na interface de log, detalhada no manual da Parte 2 - Req.08.
PONTOS DE ATENÇÃO:

• Não está prevista integração de estorno de baixa.
• Baixas de títulos nativos do Protheus não deverão ser enviadas ao barramento e por isso, não serão importadas pelo TOTVS RM.
• Baixas de títulos por Acordo não poderão ser enviadas ao barramento e por isso, não serão importadas pelo TOTVS RM. De acordo com a FIERGS, baixas do tipo Acordo possuem um tipo de mensagem específico no barramento IIF e tratamento diferenciado.
• 
  

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

6.1. Histórico de Versões

6.2. Aprovação