Páginas filhas
  • Manual Operacional da Customização - SGE x Protheus – Parte 3

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Manual Operacional da Customização – SGE x Protheus – Parte 3

...

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

...


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

...

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.

...

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

...

3

...

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.
Image Removed Fig. 01 – Instalador Passo 1
Image Removed
Fig. 02 – Instalador Passo 2
Image Removed
Fig. 03 – Instalador Passo 3
Image Removed
Fig.04 – Instalador Passo 4
Após a instalação o usuário poderá consistir os arquivos correspondentes a customização.

Nome do arquivo

Diretório

RM.Cst.CNI_DR_RS.IntegracaoSGExProtheus.Plugin.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.CNI_DR_RS.IntegracaoSGExProtheus.Data.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.CNI_DR_RS.IntegracaoSGExProtheus.Form.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.CNI_DR_RS.IntegracaoSGExProtheus.Intf.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.CNI_DR_RS.IntegracaoSGExProtheus.Server.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.TemplatesRM.Parametros.Data.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.TemplatesRM.Parametros.Form.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.TemplatesRM.Parametros.Intf.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.Lib.Data.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.Lib.dll

X:\totvs\CorporeRM\RM.Net\Custom

RM.Cst.Lib.Form.dll

X:\totvs\CorporeRM\RM.Net\Custom

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:
Image Removed
Fig. 05 – Conclusão da instalação

...

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

...

  • 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).

...

  • 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.

Image Removed
Fig. 08 – Liberando acesso

...

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" />.

...

.  


Expandir
titleExportaçã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

...

Pré-requisitos


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.

...


Descrição do processo


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.


Detalhamento 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.

...


Nota

...

titlePontos 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.

...

Expandir

...

titleImportação de Acordo (Protheus

...

TOTVS RM

...

)

...

...

Pré-

...

requisitos

  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).

...


Descrição do processo


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.


Detalhamento 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.

...


Nota
titlePontos 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.

...

Expandir

...

titleImportaçã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.

...

Pré-requisitos

  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.

...


Descrição do processo


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.


Detalhamento 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.

...

Nota
titlePontos 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.

...

...


Histórico de Atualização das Versões do Documento

...

_Toc455758374
_Toc455758372_Toc455758372

Data

Âncora

Autor

Âncora_Toc455758373

_Toc455758373_Toc455758375Descrição das alterações Âncora_Toc455758376_Toc455758376Requer. aprov. Âncora_Toc455758377_Toc455758377Seção Âncora_Toc455758378_Toc455758378Pag.

Versão

Âncora_Toc455758375

Descrição das Alterações

26/10/2017

Davi Leles Braga Pereira Lacerda

1.0

Documento Inicial

Sim

 

 

27/11/2017Ana Carolina Eleutério Abras2.0Ajustes durante entrega

Sim

 

 

...

Data

Nome

Assinatura