Versões comparadas

Chave

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

...

O objetivo deste manual é descrever a integração entre o TOTVS Educacional com o BackOffice Protheus e suas formas sua forma de integração entre os seus processos e cadastrados. Atualmente temos três formas de  

Atualmente a integração entre os dois sistemas é com a utilização do EAI – Enterprise Application Integration.

Essas formas são:

...

.

...

  • Pacote de integração 1012: Nesse pacote os lançamentos a receber e a pagar são gerados pelo TOTVS Educacional e enviado para o BackOffice Protheus para serem baixados quando é realizado o pagamento dos lançamentos pelo responsável financeiro do aluno. Os cadastros básicos são realizados no BackOffice e enviados para o TOTVS Educacional. Exceto o cadastro de cliente e fornecedor que podem ser realizados nos dois sistemas. Os cadastros básicos são: banco, centro de custo, moeda, natureza financeira, plano de contas, item contábil, classe de valor, e etc. Para realização da conversão dessa integração para o EAI 2.0 clique aqui.Pacote de integração 1021: Nesse : nesse pacote os lançamentos a receber e a pagar são gerados pelo TOTVS Educacional e enviado para o BackOffice Protheus. Porém a baixa desses títulos a receber e os títulos a pagar gerados pela integração do lado do RM, é realizada no TOTVS Educacional. Os cadastros básicos continuam sendo realizados no BackOffice Protheus. Exceto o cadastro de cliente e fornecedor que podem ser realizados nos dois sistemas.EAI 2.0Nessa integração terá o mesmo comportamento do pacote de integração 1021 presente no EAI 1.0. Isso quer dizer que os lançamentos a receber e a pagar são gerados pelo TOTVS Educacional e enviado para o BackOffice Protheus. Porém a baixa desses títulos a receber e os títulos a pagar gerados pela integração do lado do RM, é realizada no TOTVS Educacional. Os cadastros básicos continuam sendo realizados no BackOffice Protheus. Exceto , exceto o cadastro de cliente e fornecedor que podem ser realizados nos dois sistemas.

Aviso
titleAtenção

A utilização da integração TOTVS Educacional x BackOffice Protheus no EAI 2.0 só poderá ser ativada quando todos os módulos do RM estiverem com seus adapters (mensagem única) convertido para o EAI 2.0. Isso quer dizer que caso a base de dados tiver outras integrações entre os módulos do RM com os módulos do Protheus, todas as integrações devem estar migradas para o EAI 2.0. 

A liberação da integração do EAI 2.0 é realizada a partir da liberação de script para conversão da integração no EAI 1.0 para o EAI 2.0. 


Sistemas Envolvidos

  • TOTVS Processo Seletivo – Módulo Educacional que gerencia os processos seletivos das escolas e faculdades, possibilitando o ingresso de alunos nas instituições por meio de vestibulares. 

...

  • TOTVS Educacional – Módulo Educacional que gerencia escolas e faculdades (ensino básico e superior), por meio de ferramentas que permitem maior agilidade nos processos que envolvem os alunos, responsáveis, professores e os funcionários. 
  • TOTVS Gestão Financeira – Módulo Financeiro que gerencia , Gestão Contábil e Gestão de Estoque/Compras e Faturamento – Módulos que gerenciam as operações financeiras, contábeis e fiscais das escolas e faculdades, por meio de ferramentas que permitem maior agilidade nos processos que envolvem contas a pagar/receber, fluxo de caixa entre outros. 

  • BackOffice Protheus (Financeiro).

...

      • TOTVS (Educacional, Processo Seletivo, Biblioteca, Financeiro, Contábil e Fiscal) -> PROTHEUS: Os dados são trafegados pelo fluxo normal até a fila de integração TBC, em que este irá consumir o WebService do EAI do Protheus para envio da(s) mensagem(s). Após a resposta do Protheus, o TOTVS Conector atualiza o registro com o status de processamento e demais dados, no monitor da fila de Mensagem Única. 
      • PROTHEUS -> TOTVS (Educacional, Processo Seletivo, Biblioteca, Financeiro, Contábil e Fiscal): O Protheus consume Protheus consume o WebService TOTVS Conector para recebimento de mensagens únicas. Sendo também responsável também responsável por encaminhar as mensagens para o TOTVS Conector, que processa e processa e encaminha o retorno de acordo com o tipo de comunicação definida (síncrona ou assíncrona).

Assim como definido no protocolo de comunicação de mensagens únicas, a comunicação pode ser efetuada de duas formasda seguinte forma

    •  Síncrona: O sistema de origem gera uma mensagem de integração na fila e envia ao WebService de destino. O processo na origem aguarda o processamento da mensagem no destino e ao receber o retorno, atualiza o status do processamento na fila de integração. Assíncrona: O sistema de origem gera uma mensagem de integração na fila, envia ao WebService de destino e aguarda somente a confirmação de recebimento da mensagem. O processo na origem não fica parado aguardando o processamento da mensagem de destino.

Ao término do processamento da mensagem por parte do sistema de destino, este envia outra mensagem de retorno ao retorno ao sistema de origem com status do processamento. Lembrando que as mensagens assíncronas podem ser processadas (status pendente) ou reprocessadas (status erro) manualmente por meio do monitor da fila de integração 

Aviso

Nas integrações entre o RM x Protheus as configurações devem seguir como determinado pelo Configurador EAI 2.0, e este sempre configura no método síncrono.

Pré-requisitos instalação/implantação/utilização

Instalação do Biblioteca RM

Atenção: Para instalar qualquer módulo da linha RM, é necessário instalar da Biblioteca RM o pacote o pacote que contém a maioria dos arquivos necessários para o funcionamento de todos os módulos, inclusive do TBC. (Mais detalhes acesso o documento Orientações para instalar BibliotecaRM). Os pré-requisitos instalação/implantação/utilização da integração pacote 1012 no EAI 1.0 clique aqui


Configurando WS do RM

Para informações da instalação do TBC, consulte os documentos de apoio abaixo: 

...

Para a configuração do EAI acesso documento Configuração EAI Protheus   

Configurar (RM e Protheus) para utilizar a Integração, campos complementares, parâmetros e cadastros obrigatórios 

Acesso documento de apoio Configurações da Integração - Mensagem única TOTVS Educacional e Protheus   

Adapters da Integração: 

A seguir a listagem dos adapters da integração com a informação de envio e recebimento para cada sistemaClique aqui para saber mais dos adapters do EAI 2.0 

Rotina

Mensagem

Descrição


ProtheusRMCanal

Operação

Versão

Alias do Protheus

Envia

Recebe

EnviaRecebe
ATFA012ASSETSAtivo FixoSim Não NãoSimEAITodas 1.001SN1 
CTBA010ACCOUNTINGCALENDARCalendário ContábilSim Não NãoSimEAITodas1.000CTG 
CTBA020ACCOUNTANTACCOUNTPlano de ContaSim Não NãoSimEAITodas2.
000
001CT1
CTBA030COSTCENTERCentro de CustoSim Não NãoSimEAITodas2.000CTT 
CTBA040
CTBA040AACCOUNTINGITEMItem ContábilSim Não NãoSimEAITodas1.000CTD
CTBA060CLASSVALUEClasse de ValorSim Não NãoSimEAITodas1.000CTH
CTBA102ACCOUNTINGENTRYLançamento ContábilNãoSimSimSimEAITodas2.
000
001CT2
CTBA140CURRENCYMoeda SimNão NãoSimEAITodas2.001CTO
FINA010FINANCIALNATURENatureza FinanceiraSimNãoNãoSimEAITodas2.000SED
FINA040ACCOUNTRECEIVABLEDOCUMENTLançamento a receberNãoSimSimNãoEAITodas2.
002
005SE1
FINA050ACCOUNTPAYABLEDOCUMENTLançamento a pagar NãoSim SimNãoEAITodas 2.001SE2 
FINA130BANKBancoSimNãoNãoSimEAITodas2.001SA6
FINA280FINANCINGTRADINGNegociação lançamento a receberNãoSimSimNãoEAIAtualização1.002FINA280REVERSALOFFINANCINGTRADING                       Cancelamento negociação lançamento a receberNãoSimSimNãoEAIExclusão1.000-
-1
FINA460FINANCINGTRADINGNegociação (e cancelamento) de lançamento a receberNãoSimSimNãoEAIAtualização
1.002-FINA460REVERSALOFFINANCINGTRADING                    Cancelamento negociação lançamento a receberNãoSimSimNãoEAIExclusão
2.000
-
FO1
INTXATU01INTERNALIDLOADSincronização DE - PARANãoSimSimNãoEAITodas1.000-
MATA010ITEMProdutoSimNãoNãoSimEAITodas
3
4.
007
005SB1
MATA020
MATA030CUSTOMERVENDORCliente
ou Fornecedor
SimSimSimSimEAITodas2.002
SA2
SA1
MATA030
MATA020CUSTOMERVENDOR
Cliente ou
FornecedorSimSimSimSimEAITodas2.002
SA1
SA2
MATA035STOCKGROUPGrupo de ProdutoSimNãoNãoSimEAITodas1.000SBM
MATA070BANKBancoSimNãoNãoSimEAITodas2.001SA6
QIEA030UNITOFMEASUREUnidade de medidaSimNãoNãoSimEAITodas2.000SAH
FINI070LSTLISTOFACCOUNTRECEIVABLESETTLEMENTSBaixa a receberNãoSimSimNãoEAITodas1.
000
005
-
FK1
FINI035LSTLISTOFCOMPLEMENTARYVALUEValores AcessóriosNãoSimSimNãoEAITodas1.000
-
FKC
AGRA045WAREHOUSELocal de EstoqueSimNãoNãoSimEAITodas1.000NNR
MATA360PAYMENTCONDITIONCondição de PagamentoSimNãoNãoSimEAITodas2.000SE4
MATA410ORDERPedido de VendasNãoSimSimNãoEAITodas4.003SC5

Tabelas De-Para

Todas as movimentações de mensagens, com algumas exceções, tanto para envio quanto para recebimento, resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. Considerando as mensagens envolvidas nessas integrações, seguem as informações presentes no de-para e as observações devidas em cada uma.

Integração EAI 2.0Observação
AplicativoNome do aplicativo responsável pela integração entre os dois sistemas
Tabela RMTabela de origem no RM onde os dados são enviados ou recebidos
Campos RMCampos da tabela que são utilizados na montagem da chave interna no sistema RM
Valor RMValores dos campos da tabela que são utilizados na montagem da chave interna no sistema RM.
Valores ExternosValores dos campos da tabela do sistema que está sendo integrado com o sistema RM
TransaçãoNome na mensagem - adapter responsável por gerar e gerenciar o de-para
Identificador GlobalIdentificador enviado na mensagem - adapter como chave de integração no de-para entre o sistema RM e o sistema de destino. Caso esse identificador estiver vazio, a integração envia o valor presente no campo "Valor RM".


Documento para acessar os Parâmetros de Integração EAI 2.0

Seguir a descrição de cada adapters da integração e sua responsabilidade

...

Deck of Cards
idMensagens - Adapters da Integração
Finaneiro

Carga Inicial

Para utilização da rotina de carga inicial dos dados, acesse o documento Carga inicial dos dados de cadastro.

Configurador 
Configurador do EAI 2.0 deve ser executado por aqueles que desejam implantar a integração entre os sistemas RM x PROTHEUS.
Para utilização da rotina de configurador, acesse o documento RM x PROTHEUS - Configurador EAI 2.0.