O objetivo deste manual é descrever a integração entre o TOTVS Educacional com o BackOffice Protheus e suas formas de integração entre os seus processos e cadastrados. Atualmente temos três formas de integração entre os dois sistemas com a utilização do EAI – Enterprise Application Integration.
Essas formas são:
Nessa 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 o cadastro de cliente e fornecedor que podem ser realizados nos dois sistemas.
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. |
Melhoria na integração dos sistemas TOTVS Educacional, TOTVS Processo Seletivo, TOTVS Gestão Bibliotecária e o BackOffice do Protheus (Financeiro), por meio da mensagem única.
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.
Com o objetivo de padronizar as integrações com os produtos, foi definida a utilização da diretriz para os projetos de integração que todos os produtos devem trabalhar com a mensagem XML única, evitando desta forma, o processo de transformação de mensagens.
Neste cenário, temos o seguinte quadro:
Qualquer dos produtos são executados com o mesmo XML para uma mesma entidade, ou seja, caso um arquivo XML corresponda a mensagem de clientes, pode ser enviado para qualquer um dos produtos que suporte o recebimento desta entidade, como no diagrama abaixo:
A mensagem única torna uniforme a execução destes arquivos XML pelos aplicativos, principalmente para a capacidade de rastreamento.
Todos os processos devem respeitar o fluxo normal de troca de mensagens no padrão de Mensagem Única TOTVS.
Este fluxo pode ocorrer nos seguintes sentidos:
Assim como definido no protocolo de comunicação de mensagens únicas, a comunicação pode ser efetuada de duas formas:
Ao término do processamento da mensagem por parte do sistema de destino, este envia outra mensagem de 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.
Atenção: Para instalar qualquer módulo da linha RM, é necessário instalar da Biblioteca RM 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:
Instalação do Protheus V12 e configuração do AppServer e Dbaccess
Acesse os documentos de apoio abaixo para instalação e configuração.
Como configurar EAI do Protheus
Para a configuração do EAI acesso documento Configuração EAI Protheus
Acesso documento de apoio Configurações da Integração - Mensagem única TOTVS Educacional e Protheus
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 | Protheus | RM | Canal | Operação | Versão | Alias do Protheus | ||
Envia | Recebe | Envia | Recebe | |||||||
ATFA012 | ASSETS | Ativo Fixo | Sim | Não | Não | Sim | EAI | Todas | 1.001 | SN1 |
CTBA010 | ACCOUNTINGCALENDAR | Calendário Contábil | Sim | Não | Não | Sim | EAI | Todas | 1.000 | CTG |
CTBA020 | ACCOUNTANTACCOUNT | Plano de Conta | Sim | Não | Não | Sim | EAI | Todas | 2.000 | CT1 |
CTBA030 | COSTCENTER | Centro de Custo | Sim | Não | Não | Sim | EAI | Todas | 2.000 | CTT |
CTBA040 | ACCOUNTINGITEM | Item Contábil | Sim | Não | Não | Sim | EAI | Todas | 1.000 | CTD |
CTBA060 | CLASSVALUE | Classe de Valor | Sim | Não | Não | Sim | EAI | Todas | 1.000 | CTH |
CTBA102 | ACCOUNTINGENTRY | Lançamento Contábil | Não | Sim | Sim | Sim | EAI | Todas | 2.000 | CT2 |
CTBA140 | CURRENCY | Moeda | Sim | Não | Não | Sim | EAI | Todas | 2.001 | CTO |
FINA010 | FINANCIALNATURE | Natureza Financeira | Sim | Não | Não | Sim | EAI | Todas | 2.000 | SED |
FINA040 | ACCOUNTRECEIVABLEDOCUMENT | Lançamento a receber | Não | Sim | Sim | Não | EAI | Todas | 2.005 | SE1 |
FINA050 | ACCOUNTPAYABLEDOCUMENT | Lançamento a pagar | Não | Sim | Sim | Não | EAI | Todas | 2.001 | SE2 |
FINA130 | BANK | Banco | Sim | Não | Não | Sim | EAI | Todas | 2.001 | SA6 |
FINA280 | FINANCINGTRADING | Negociação lançamento a receber | Não | Sim | Sim | Não | EAI | Atualização | 1.002 | - |
FINA280 | REVERSALOFFINANCINGTRADING | Cancelamento negociação lançamento a receber | Não | Sim | Sim | Não | EAI | Exclusão | 1.000 | - |
FINA460 | FINANCINGTRADING | Negociação lançamento a receber | Não | Sim | Sim | Não | EAI | Atualização | 1.002 | - |
FINA460 | REVERSALOFFINANCINGTRADING | Cancelamento negociação lançamento a receber | Não | Sim | Sim | Não | EAI | Exclusão | 1.000 | - |
INTXATU01 | INTERNALIDLOAD | Sincronização DE - PARA | Não | Sim | Sim | Não | EAI | Todas | 1.000 | - |
MATA010 | ITEM | Produto | Sim | Não | Não | Sim | EAI | Todas | 4.005 | SB1 |
MATA020 | CUSTOMERVENDOR | Cliente ou Fornecedor | Sim | Sim | Sim | Sim | EAI | Todas | 2.002 | SA2 |
MATA030 | CUSTOMERVENDOR | Cliente ou Fornecedor | Sim | Sim | Sim | Sim | EAI | Todas | 2.002 | SA1 |
MATA035 | STOCKGROUP | Grupo de Produto | Sim | Não | Não | Sim | EAI | Todas | 1.000 | SBM |
MATA070 | BANK | Banco | Sim | Não | Não | Sim | EAI | Todas | 2.001 | SA6 |
QIEA030 | UNITOFMEASURE | Unidade de medida | Sim | Não | Não | Sim | EAI | Todas | 2.000 | SAH |
FINI070LST | LISTOFACCOUNTRECEIVABLESETTLEMENTS | Baixa a receber | Não | Sim | Sim | Não | EAI | Todas | 1.000 | - |
FINI035LST | LISTOFCOMPLEMENTARYVALUE | Valores Acessórios | Não | Sim | Sim | Não | EAI | Todas | 1.000 | - |
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.0 | Observação |
Aplicativo | Nome do aplicativo responsável pela integração entre os dois sistemas |
Tabela RM | Tabela de origem no RM onde os dados são enviados ou recebidos |
Campos RM | Campos da tabela que são utilizados na montagem da chave interna no sistema RM |
Valor RM | Valores dos campos da tabela que são utilizados na montagem da chave interna no sistema RM. |
Valores Externos | Valores dos campos da tabela do sistema que está sendo integrado com o sistema RM |
Transação | Nome na mensagem - adapter responsável por gerar e gerenciar o de-para |
Identificador Global | Identificador 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 Parametros de Integração EAI 2.0
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.
Carga Inicial
Para utilização da rotina de carga inicial dos dados, acesse o documento Carga inicial dos dados de cadastro.