Árvore de páginas
Ir para o final dos metadados
Ir para o início dos metadados

Integração Protheus . Novo Modelo

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

Integração

Melhoria na integração dos sistemas TOTVS Educacional 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.


 Definição de Mensagem Única – TotvsMessage 

 Com o objetivo de padronizar as integrações com os produtos foi definida a utilização da diretriz para os projetos de integração, de 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: 


    • TOTVS (Educacional, Processo Seletivo, Biblioteca, Financeiro) -> 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): O Protheus consume o WebService TOTVS Conector para recebimento de mensagens únicas. Sendo também responsável por encaminhar as mensagens para o TOTVS Conector, que processa e encaminha o retorno de acordo com o tipo de comunicação definida (síncrona ou assíncrona).


Para mais informações sobre o fluxo dos dados internos ao TBC, vide documentação:  TOTVS Business Connect: http://tdn.totvs.com.br/display/public/rm/TBC


Assim como definido no protocolo de comunicação de mensagens únicas, a comunicação pode ser efetuada de duas formas: 


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

  

Como configurar ( RM e Protheus ) para utilizar a Integração , campos complementares, parâmetros e cadastros obrigatórios : Segue o Link como fazer: http://tdn.totvs.com/pages/viewpage.action?pageId=210045861  


Configurando WS do RM : Segue o Link como fazer: http://tdn.totvs.com/pages/viewpage.action?pageId=210045767

  

Como Configurar EAI do Protheus : Segue o Link como fazer: http://tdn.totvs.com/pages/viewpage.action?pageId=210045023


Adpters da Integração :

 Novos Adpters ( LISTTOFACCUNTRECEIVABLESETTLEMENTS e LISTOFCOMPLENTARYVALUE )


  •  Caso alguma mensagem esteja configurada com o método Assíncrono, acesse o Configurador (SIGACFG) em Ambiente / Schedule / Schedule e configure um agente e um agendamento, conforme abaixo:

http://tdn.totvs.com/pages/viewpage.action?pageId=210045023



Novo código de Identificador da Integração : 1021 


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 os registros De-Para que serão registrados ao enviar ou receber uma mensagem, como exemplo:



Cadastros ( De-Para )

Cadastros Especiais    ( GFILIAL )

É necessário realizar o cadastro manualmente no Protheus e no RM e posteriormente configurar o de/para para a integração correspondente. Ambos produtos, RM e Protheus, possuem interfaces específicas para esta finalidade

Cadastro de De/Para no RM 



Módulo ( Integração )



Integrações | RM Conector | Mensagem Única | De-Para 



Tabela = GFILIAL

Chave Primária RM = CODCOLIGADA|CODFILIAL

Valor Chave Primária RM = COLIGADA E FILIAL DO RM

Sistema Integrado = PROTHEUS

Valor Chave Integração = Empresa e Filial do Protheus


Cadastro De/Para ( Protheus )

Módulo ( SIGACFG )



Ambiente | Schedule | Emp.filial Mensagem Única




Cadastros  - MOEDA

Cadastros Comuns    ( Moeda )

 ( Protheus )


Módulo ( SIGACTB )



Atualizações | Cadastros | Moedas Contábeis



Cadastrode Moeda Realizado no Protheus



Moeda

Identificador da Mensagem: Currency

Versão: 2.001

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono




Cadastros - Centro de Custos

Cadastros Comuns  ( Centro de Custos )

( Protheus )



Módulo ( SIGACTB )



Atualizações | Entidades | Custos 




Centro de Custo Cadastrado no Protheus



Caminho para acesso ao cadastro do Centro de Custo, no sistema:




Acesse BackOffice / Gestão Financeira / Contabilidade / Centro de Custo


Centro de custo

Identificador da Mensagem: CostCenter

Versão: 2.000

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono


Cadastros - Classe de Valor

Cadastros Comuns    ( Classe de Valor )

 ( Protheus )



Módulo ( SIGACTB )



Atualizações | Entidades | Custos



Cod Cl Val



Classe de Valor cadastrada 



Integrações | Protheus | Classe de Valor



Classe de Valor cadastrada no TOTVS Educacional



Classe de valor é vinculada ao cadastro da Matriz Aplicada .

Matriz Aplicada | < Anexos > | Dados Financeiros – Integração Protheus 



Ao se gerar Contabilização por Competência , o evento contábil é parametrizado para buscar a informação de Classe de valor da Matriz Aplicada.


Classe de Valor

Identificador da Mensagem: ClassValue

Versão: 1.000

Módulo Educacional: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono

Cadastros - ITEM CONTÁBIL

Cadastros Comuns  ( Item Contábil )

( Protheus )



Módulo ( SIGACTB )


Atualizações | Entidades | Custos

Item Conta




Item Contábil enviado para o RM



tem Contábil  é vinculado ao cadastro da Matriz Aplicada .

Matriz Aplicada | < Anexos > | Dados Financeiros – Integração Protheus 



Ao se gerar Contabilização por Competência , o evento contábil é parametrizado para buscar a informação de Item Contábil da Matriz Aplicada.


Item contábil

Identificador da Mensagem: AccountingItem

Versão: 1.000

Módulo Educacional: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono


Cadastros - CLIENTE / FORNECEDOR

Cadastros Comuns  ( Cliente / Fornecedor )

( Protheus )



Módulo ( SIGACFG )

Configurar Protheus para uso do cadastro de Cliente / Fornecedor



Base de dados | Dicinário | Bases de Dados



Grupo de Campos = Alterar o tamanho 




Dicionário de Dados 

Localizar as Tabelas ( SA1 e SA2 )



Editar ambas as Tabelas 


Localizar o campo ( A1_LOJA ) = Editar


Aba ( Opções )

Preencher o Inicializador Pradrão  = “01”



( A1_COD ) = Editar



Se o Incializador Padrão estiver preenchido conforme o Print acima , tem que deixar este campo em Branco conforme Print abaixo.


Se o Incializador Padrão estiver preenchido conforme o Print acima , tem que deixar este campo em Branco conforme Print abaixo.


Informações importantes sobre o cadastro de clientes: 

O cadastro de cliente/fornecedor é utilizado por ambos os lados. Os cadastrados podem ser realizados no BackOffice Protheus ou no TOTVS Gestão Financeira.

O código de Cliente/Fornecedor é gerado de acordo com a parametrização do TOTVS Gestão Financeira. É gerado um código incremental de acordo com a máscara cadastrada. Se o sistema estiver integrado ao Protheus por mensageria única, será permitido a inclusão de uma máscara vazia.



O tamanho máximo do código de cliente/fornecedor não deve ultrapassar 9 caracteres.

Se for definida uma máscara vazia no Financeiro e no Educacional, para o cadastro do Cliente/Fornecedor, ao gerar um responsável financeiro no cadastro de Alunos, internamente, será adotada uma máscara numérica com 09 posições.

O parâmetro para utilização de código sequencial numérico deve ser desabilitado caso a integração Educacional x BackOffice Protheus esteja ativa.

O sistema permite a alteração da máscara para vazio, quando integrado, porém, não será permitido a alteração de nulo para outro valor.

Parâmetro para cadastro da máscara de cliente:

Acesse: Módulo Gestão Financeira / Ambiente / Parâmetros / TOTVS Gestão Financeira / 02.02 – Contas a receber / 02.02.01 – Manutenção de Lançamentos / 02.02.01.01 – Lançamento / Cliente / Fornecedor / Máscara do código



Para o cenário em que o Protheus tiver um compartilhamento por Empresa, o TOTVS Gestão Financeira deve ser parametrizado para utilizar clientes globais.
Acesse: BackOffice / Gestão Financeira / Ambiente / Parâmetros / TOTVS Gestão Financeira
02.02 – Contas a receber / 02.02.01 – Manutenção de Lançamentos / 02.02.01.01 – Lançamento / Cliente / Fornecedor / Default Cli/For Globais



Importante

A configuração para cliente global é realizada somente caso o Protheus tenha um compartilhamento por Empresa.



Cadastro do Cliente Forncedor do RM

3


Gestão Financeira 



Cliente / Fornecedor cadastrado no RM


OBS:Para se gerar um lançamento a Pagar é preciso vincular um Forncedor no cadastro do Cliente.




Integrações | Integração Protheus | Fornecedor



Módulo ( SIGAFIN )  


Verificando cadastro do Cliente / Fornecedor no Protheus



Atualizações | Cadastros | Clientes 



Cliente enviado para Protheus

Obs: Cadastro de Cliente e Fornecedor pode ser feito no BackOffice Protheus e enviado para o RM


Cliente/Fornecedor

Identificador da Mensagem: CustomerVendor

Versão: 2.002

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono



Cadastros - NATUREZA FINANCEIRA

Cadastros Comuns  ( Natureza Financeira )

( Protheus )



Módulo ( SIGAFIN ) 



Atualizações | Cadastros | Naturezas



Natureza Cadastrada no BackOffice Protheus 



Caminho para acesso ao cadastro de naturezas no sistema: 

BackOffice / Gestão Financeira 




Cadastros | Natureza Orçamentária Financeira

Vincular a Natureza Financeira cadastrada no BackOffice Protheus ao Serviço do TOTVS Educacional



TOTVS Educacional

Financeiro / Contábil | Serviços

Selecionar o Serviço desejado ( Editar ) Anexos | Dados financeiros – Integração Protheus 



Vinculado ao Serviço do TOTVS Educacional a Natureza Financeira cadastrada no BackOffice Protheus.

  


Natureza Financeira

Identificador da Mensagem: FinancialNature

Versão: 2.000

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono


Cadastros - BANCO

Cadastros Comuns  ( BANCO )

( Protheus )



Informações importantes sobre o cadastro de bancos: 

A mensagem de Banco é utilizada para realizar o cadastro de Bancos, Agências, Contas Correntes, Conta Caixas e Convênios.

Como o cadastro é realizado no Protheus, os cadastros do TOTVS Gestão Financeira são desabilitados para inclusão e exclusão, caso o parâmetro utilize integração com Protheus  e esteja habilitado tendo a integração Educacional x BackOffice Protheus ativa.

Os campos preenchidos pela integração são desabilitados e apenas informações pertinentes do TOTVS Gestão Financeira podem ser editados.

Cadastro de Banco / Agência / Conta Corrente no BackOffice Protheus


Obs : Tem que estar preenchido o campo : Nome Comercial da Empresa para que possa ser enviado o convênio ao TOTVS Educacional e a TAG obrigatória se preenchida como Código Cedente explicado anteriormente.



SIGACFG ( Ambiente | Empresa | Filial ) 




Módulo ( SIGAFIN )



Atualizações | Cadastros | Bancos 


Importante: Os campos, do XML, número do contrato, nome do cedente e código do cedente devem ser preenchidos para que o cadastro do convênio seja realizado.   

                                      Ao receber a mensagem de banco, caso uma dessas três informações estejam em branco o cadastro não é realizado não sendo gerada a mensagem de validação. 


Cadastro Bancário no Protheus .

  • Código Bancário
  • Número da Agência
  • Número da Conta
  • Número do Banco
  • Código Cedente 



Banco | Agencia | Conta Corrente enviado para o RM ( Gestão Financeira )

Movimentações Bancárias | Bancos e Agências



Cadastro do Contrato Bancário e Parâmetro Bancário no BackOffice Protheus  = Convênio no RM

Atualizações | Cadastros | Contrato Bancário


Informar o Número do Contrato bancário ( Será utilizado no cadastro do Parâmetro Bancário )



Atualizações | Cadastros | Parâmetros de Bancos


Na Aba ( Cadastrais )

Informar :

  • Banco
  • Agência
  • Conta
  • Sub Conta 



Na Aba ( Outros )

  • Contrato ( Informar o número do contrato criado no Contrato Bancário )


Totvs Gestão Financeira 

Movimentações Bancárias | Controle Bancário | Contas / Caixa

Conta Caixa enviada para o Gestão Financeira.



Movimentações Banárias | Convênio

Convênio enviado para o Gestão Financeiro


Bancos

Identificador da Mensagem: Bank

Versão: 2.001

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono




Cadastros - PERÍODO CONTÁBIL

Cadastros Comuns  ( PERÍODO CONTÁBIL )

No processo de integração, o RM atualiza as datas do período contábil sempre de acordo com a menor data inicial e a maior data final enviada pelo Protheus. No Protheus, essas informações são armazenadas em um cadastro, e no RM essas informações são armazenadas nos parâmetros, sendo assim, apenas há espaço para armazenar somente uma dataIncial e uma dataFinal.



Cadastrando peíodo Contábil no Módulo Contábil Protheus ( SIGACTB ).



Atualizações | Cadastros | Calendário Contábil


Calendário cadastrado .



Para vefiricar o Cadastro do Calendário no RM o caminho é :

Acesse: BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros / TOTVS Contabilidade Gerencial 

01.04 – Fechamento / 01.04.01 – Fechamento Mensal



Período Contábil 

Identificador da Mensagem: AccountingCalendar

Versão: 1.000

Módulo Educacional: RM

Módulo Protheus: Protheus

Tipo de Envio:




Cadastros - PLANO DE CONTAS

Cadastros Comuns  ( PLANO DE CONTAS )

A máscara parametrizada da conta contábil no TOTVS Contabilidade Gerencial é validada no processo de inclusão da conta contábil. Portanto, o parâmetro de máscara contábil deve ser cadastrado de acordo com o formato do código da conta a ser enviado pelo Protheus. Caso o Protheus não envie máscara no código de conta, exemplo: 1011214, então o parâmetro Não utiliza máscara nas contas deve ser marcado. Caso contrário, ocorrerá um erro no processo de inclusão da conta.

Caminho para acesso ao parâmetro para não utilizar máscara:                                              

Acesse: BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros 

01.01   – Plano de Contas / 01.01.01 – Plano de Contas contábil / Plano de Contas Contábil / Não utilizar máscara nas contas





Cadastrando Plano de Contas no Módulo Contábil do Protheus ( SIGACTB ).



Atualizações | Entidades | Plano de Contas



Plano de Contas cadastrada no Protheus



Verificando cadastro do Plano de Contas no RM.       

Acesse: BackOffice / Contabilidade Gerencial / Cadastros / Contábil

Plano de Contas enviado para RM.





Plano de Contas

Identificador da Mensagem: AccountAntAccount

Versão: 2.000

Módulo Gestão Contábil: RM

Módulo Protheus: Protheus




Processos - CONTABILIZAÇÃO POR COMPETÊNCIA

Contabilização por Competência 

Documentação de configuração da integração Contábil encontra-se no Link ao lado:  http://tdn.totvs.com/display/INT/DI_MANUAL_TOTVS_Educacional_BackOffice_Protheus_Contabil

 Entrando no Módulo TOTVS Educacional



Financeiro / Contábil | Contabilidade | Eventos Contábis 

Criando evento Contábil no TOTVS Educacional 



Eventos cadastrados no TOTVS Educacional .

  • Evento Contrato
  • Evento Parcela 



Plano de contas informado no cadastro do Evento ( Plano de Contas cadastrado no SIGACTB do Protheus



Parametrizado no Evento contábil para buscar a informação de Item Contábil e Classe de Valor da Matriz Aplicada , conforme já foi explicado no cadastro de Ambos.



Gerando a contabilização :

Pelo Contrato em Processos | Gerar Contabilização ou em :



Financeiro / Contábil | Contabilidade



Contabilização Gerada 



Verifiando Lançamento Contábeis no Protheus ( SIGACTB )

Atualizações | Movimentos | Lancam Contabeis



Lançamentos enviados para o Protheus 




Processos - Geração de Lançamentos

Geração de Lançamentos


  O padrão para geração de Lançamentos ( Integração TOTVS Educacional X BackOffice Protheus ) em Típo Contábil é ( NÃO CONTÁBIL )

Como é mostrado na imagem abaixo:


TOTVS Educacional| Ambiente | Parâmetros | Educacional | 15.05.03.01 - Educacional | Fin - Geral 2/4

Campo fica bloqueado apenas para este padrão ( Não Contábil )


  Com a Nova Integração agora passou a ser obrigatório o envio dos Campos Complementares do TOTVS Gestão Financeira para BackOffice Protheus ( Valor Acessório )





BackOffice | Gestão Fianceira



Ambiente | Parâmetros | TOTVS Gestão Financeira




02.02 – Contas a Receber



Valores Opcionais cadastrados no TOTVS Gestão Financeira


Agora é enviada a mensagem do Novo Adpter com o Valor Opcionais para o Protheus




 Verificando os Valores Acessários no BackOffice Protheus



( SIGAFIN )

Atualizações | Cadastros | Tipos de Valores Acessórios 



Valores acessórios preenchidos com os Valores Opcionais enviados pelo TOTVS Gestão Financeira



Após efetuar a parametrização dos Campos opcionais e Valores acessórios , gerar o Título para o BackOffice Protheus



Módulo ( SIGAFIN )

Atualizações | Contas a Receber | Contas a Receber



Título enviado para o Protheus



Verificar Valores Acessórios , Selecionar a Parcela e em Outras Ações | Valores Acessórios



Valores Acessórios 


Baixando o Título pelo RM 


Baixa que antes era no Prothesu passou a ser pelo RM 

Selecionando o Lançamento : Processos | Baixa | Baixar Lançamento 



Baixa efetuada 



Lançamento com Status de Baixado 



Baixa atualizada no BackOffice Protheus


 Tentando efetuar a Baixa no BackOffice Protheus

Tentar efetuar a baixa no BackOffice Protheus o Sistema mostra a mensagem abaixo: Efetua a baixa através do sistema RM Classis


Baixa utilizando Valores Opcionais

Efetuando pagamento a Menor  ( Utilizando agora os Valores Opcionais )




Valor pago a Menor de 200 Reais 



Baixa realizada com valor a menor. 




Cliente / Fornecedor encontra-se com um Débito de R$ 200,00 Reais 



O Título no BackOffice Protheus levando em Valores Acessórios o débito de R$ 200,00 Reais