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

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

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

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.

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.

Pré-requisitos

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

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.

Pré-requisitos

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

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

Data	Autor	Versão	Descrição das Alterações
26/10/2017	Davi Leles Braga Pereira Lacerda	1.0	Documento Inicial
27/11/2017	Ana Carolina Eleutério Abras	2.0	Ajustes durante entrega