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 maneiras sua forma de comunicação integração entre os seus processos e cadastrados. Atualmente temos três maneiras de  

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

  • EAI 12.0Pacote de integração 1012: Nesse 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. E 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.Pacote de integração 1021: 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 . 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).

...

Atualmente já existe uma integração entre os produtos, mas que é restrita a troca de algumas outras informações que são enviadas pelo Protheus. Feito a reestruturação e adequação com a criação desta nova integração para envio de informações do TOTVS Educacional para o Protheus.

...

      • 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  Para informações da instalação do TBC, consulte os documentos de apoio abaixo: 

...


Como Configurar configurar EAI do Protheus

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 sistema. Clique aqui para saber mais dos adapters do EAI 2.0 

Rotina

Mensagem

Descrição

Envia


Protheus
Recebe
RMCanal

Operação

Versão

Alias

Integração Pacote 1021 - EAI 1.0Integração EAI 2.0

do Protheus

Envia

Recebe

EnviaRecebe
ATFA012ASSETSAtivo FixoSim Não NãoSimEAITodas 1.001SN1 
UsaUsa
CTBA010ACCOUNTINGCALENDARCalendário ContábilSim Não NãoSimEAITodas1.000CTG 
UsaUsa
CTBA020ACCOUNTANTACCOUNTPlano de ContaSim Não NãoSimEAITodas2.
000
001CT1
UsaUsa
CTBA030COSTCENTERCentro de CustoSim Não NãoSimEAITodas2.000CTT 
Usa
CTBA040A
Usa
ACCOUNTINGITEM
CTBA040
Item Contábil
ACCOUNTINGITEM
Sim Não NãoSimEAITodas1.000CTD
UsaUsa
CTBA060CLASSVALUEClasse de ValorSim Não NãoSimEAITodas1.000CTH
Usa
Usa
CTBA102ACCOUNTINGENTRYLançamento ContábilNãoSimSimSimEAITodas2.
000
001CT2
Usa
Usa
CTBA140CURRENCYMoeda SimNão NãoSimEAITodas2.001CTO
UsaUsa
FINA010FINANCIALNATURENatureza FinanceiraSimNãoNãoSimEAITodas2.000SED
Usa
FINA040
Usa
ACCOUNTRECEIVABLEDOCUMENT
FINA040
Lançamento a receber
ACCOUNTRECEIVABLEDOCUMENT
NãoSimSimNãoEAITodas2.
002
005SE1
UsaUsa
FINA050ACCOUNTPAYABLEDOCUMENTLançamento a pagar NãoSim 
EAITodas 2.001SE2 UsaUsaFINA070ACCOUNTRECEIVABLEDOCUMENTDISCHARGE
Sim
Sim
NãoEAI
Atualização
Todas 2.001
-
SE2 
Usa
FINA130
Usa
BANK
FINA070REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGEFINA130BANKSimNão
BancoSimNão
EAIExclusão2.000-UsaUsa
NãoSim
EAITodas2.001SA6
UsaUsaFINA280
FINA460FINANCINGTRADINGNegociação (e cancelamento) de lançamento a receberNãoSim
FINANCINGTRADING
SimNãoEAIAtualização
1
2.
002
000FO1
-
INTXATU01
UsaUsaFINA280REVERSALOFFINANCINGTRADING                       
INTERNALIDLOADSincronização DE - PARANãoSimSimNãoEAI
Exclusão
Todas1.000-
Usa
MATA010
Usa
ITEM
FINA460
Produto
FINANCINGTRADING
SimNão
EAIAtualização1.002-UsaUsaFINA460REVERSALOFFINANCINGTRADING                    SimNãoEAIExclusão1.000-UsaUsaFINI070AUPDATECONTRACTPARCEL                             Sim
NãoSimEAITodas4.005SB1
MATA030CUSTOMERVENDORClienteSimSimSimSim
Não
EAITodas
1
2.002SA1
-
MATA020
Usa
CUSTOMERVENDOR
Usa
Fornecedor
FINI150A
Sim
OURNUMBERBANKING                                 
SimSim
Não
SimEAITodas
1
2.
000
002SA2
-
MATA035
Usa
STOCKGROUP
Usa
Grupo de Produto
INTXATU01
Sim
INTERNALIDLOAD
NãoNãoSimEAITodas1.000
-
SBM
Usa
MATA070
Usa
BANK
MATA010
Banco
ITEM
Sim
Sim
NãoNãoSimEAITodas
3
2.
007
001SA6
SB1
QIEA030
Usa
UNITOFMEASURE
Usa
Unidade de medida
MATA020
Sim
CUSTOMERVENDOR
Não
Sim
NãoSimEAITodas2.
002
000
SA2
SAH
Usa
FINI070LST
Usa
LISTOFACCOUNTRECEIVABLESETTLEMENTS
MATA030
Baixa a receber
CUSTOMERVENDOR
NãoSimSimNãoEAITodas
2
1.
002
005FK1
SA1
FINI035LST
Usa
LISTOFCOMPLEMENTARYVALUE
Usa
Valores Acessórios
MATA035
Não
STOCKGROUP
SimSimNãoEAITodas1.000
SBM
FKC
Usa
AGRA045
UsaMATA070BANK
WAREHOUSELocal de EstoqueSimNão
EAITodas2.001SA6UsaUsaQIEA030UNITOFMEASURESimNão
NãoSimEAITodas
2
1.000
SAH
NNR
MATA360
Usa
PAYMENTCONDITION
Usa
Condição de Pagamento
FINI070LST
Sim
LISTOFACCOUNTRECEIVABLESETTLEMENTS
NãoNãoSimEAITodas
1
2.000
-
SE4
Usa
MATA410
Usa
ORDER
FINI035LST
Pedido de Vendas
LISTOFCOMPLEMENTARYVALUE
Não
Não
SimSimNãoEAITodas
1
4.
000
003
-
SC5
UsaUsa

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  Considerando as mensagens envolvidas nessas integrações, seguem as informações presentes no de-para em ambas integrações e as observações devidas em cada uma. Tabela entre o De-Para das integrações 1021 e EAI 2.0

Integração EAI 2.0
Integração 1021
Observação
AplicativoNome do aplicativo responsável pela integração entre os dois sistemas
, presente somente no EAI 2.0
Tabela RMTabela
RMTabela
de origem no RM onde os dados são enviados ou recebidos
Campos RM
Chave Primária RM
Campos da tabela que são
utilizado
utilizados na montagem da chave interna no sistema
RMValor
RM
Valor
Chave Primária
RMValores dos campos da tabela que
são utilizado
são utilizados na montagem da chave interna no sistema RM.
Valores Externos
Valor Chave Integração
Valores 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
, presente somente no EAI 2.0
Sistema IntegradoNo sistema integrado com o RM, presente somente na integração 1021.
Identificador GlobalIdentificador enviado na mensagem - adapter como chave de integração no de-para entre o sistema
RM 
RM e o sistema de destino. Caso esse identificador estiver vazio, a integração envia o valor presente no campo "Valor RM".
Presente somente no


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

...

idMensagens - Adapters da Integração

...

idCUSTOMERVENDOR
labelCUSTOMERVENDOR

No cadastro de coligada do RM deve ser configurado o campo Código Externo com o mesmo código do Grupo de Empresa do Protheus.

Assim, se tiver algum cadastro do RM relacionado a integração com o Protheus que não permite cadastro global, ao receber a mensagem de integração o RM irá realizar a replicação dos dados para todas as coligadas com código externo preenchido.

A replicação será conforme o tipo de compartilhamento configurado no Protheus, como por exemplo compartilhado compartilhado por empresa

A mensagem CUSTOMERVENDOR é responsável por enviar e receber os dados do cliente e do fornecedor entre a integração TOTVS Educacional com BackOffice Protheus. A mensagem no Protheus atende as rotinas MATA020 e MATA030. A versão utilizada na integração é a 2.002 com o tipo de envio síncrono. Os cadastros do cliente e do fornecedor podem ser realizados no RM no TOTVS Gestão FInanceira e no BackOffice Protheus.

...

.

Configurar Protheus para uso do cadastro de Cliente / Fornecedor  no Módulo ( SIGACFG )

Image Removed

Base de dados | Dicionário | Bases de Dados

Image Removed

Grupo de Campos = Alterar o tamanho 

Image Removed

Dicionário de Dados deve localizar as Tabelas ( SA1 e SA2 )

Image Removed

Editar ambas as Tabelas 

Image Removed

Localizar o campo ( A1_LOJA ) = Editar

Image Removed

Aba ( Opções ) deve preencher o Inicializador Padrão  = “01”

Image Removed

( A1_COD ) = Editar

Image Removed

Se o Inicializador Padrão estiver preenchido deve ser deletado a informação para ficar em branco, como mostra a segunda print abaixo.

Inicializador Padrão preenchido

Image Removed

Inicializador Padrão em branco

Image Removed

Verificando cadastro do Cliente / Fornecedor no Protheus no Módulo ( SIGAFIN ) 

Image Removed

Atualizações | Cadastros | Clientes 

Image Removed

Cliente enviado para Protheus

Image Removed

Todas as movimentações da mensagem CUSTOMERVENDOR tanto no seu envio quanto para o seu recebimento, resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. Desta forma, o sistema de origem envia seu código de identificação do cliente/fornecedor para o sistema de destino juntamente com seu  código de identificação. 

De-Para na integração 1021

De-Para na integração EAI 2.0

CUSTOMERVENDOR
Deck of Cards
id
inforclifor
Card
idprotheusclifor
labelProtheus
Card
idrmclifor
labelRM
Card
iddeparaclifor
labelDe/para

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

FCFO

CODCOLIGADA|CODCFO

0|000000001

PROTHEUS

01||000000001|01|C

FCFO

CODCOLIGADA|CODCFO

0|000000110

PROTHEUS

01||000000110|01|F

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

FCFO

CODCOLIGADA|CODCFO

0|000000001

01||000000001|01|C

CUSTOMERVENDOR

B96F1F8B-CAD3-484B-9903-1FB2BE635888
TOTVS Educacional x BackOffice Protheus

FCFO

CODCOLIGADA|CODCFO

0|000000110

01||000000110|01|F

Mensagens - Adapters da Integração

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.