Child pages
  • DI_MANUAL_TOTVS_Educacional_BackOffice_Protheus - Integração 1021 (contas a receber no RM)
Skip to end of metadata
Go to start of metadata

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 Gestão Bibliotecária – Módulo Educacional que gerencia as bibliotecas das escolas e faculdades (com diferentes unidades bibliotecárias). 
  • 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 as operações financeiras das escolas e faculdades, por meio de ferramentas que permitem maior agilidade nos processo que envolvem contas a pagar/receber, fluxo de caixa entre outros. 
  • BackOffice Protheus (Financeiro).

Integração

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.

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


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.


Pré-requisitos instalação/implantação/utilizaçã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)


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 


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:

Rotina

Mensagem

Envia

Recebe

Canal

Operação

Versão

Alias

ATFA012ASSETSSim Não EAITodas 1.001SN1 
CTBA010ACCOUNTINGCALENDARSim Não EAITodas1.000CTG 
CTBA020ACCOUNTANTACCOUNTSim Não EAI Todas2.000CT1
CTBA030COSTCENTERSim Não EAI Todas2.000CTT 
CTBA040ACCOUNTINGITEMSim Não EAI Todas1.000CTD
CTBA060CLASSVALUESim Não EAI Todas1.000CTH
CTBA102ACCOUNTINGENTRYNãoSimEAI Todas2.000CT2
CTBA140CURRENCY SimNão EAI Todas2.001CTO
FINA010FINANCIALNATURESimNãoEAI Todas2.000SED
FINA040ACCOUNTRECEIVABLEDOCUMENTSimSimEAI Todas2.002SE1
FINA050ACCOUNTPAYABLEDOCUMENT NãoSim EAITodas 2.001SE2 
FINA070ACCOUNTRECEIVABLEDOCUMENTDISCHARGESimSimEAI Atualização2.001-
FINA070REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGESimNãoEAI Exclusão2.000-
FINA130BANKSimNãoEAI Todas2.001SA6
FINA280FINANCINGTRADINGSimNãoEAI Atualização1.002-
FINA280REVERSALOFFINANCINGTRADING                       SimNãoEAI Exclusão1.000-
FINA460FINANCINGTRADINGSimNãoEAI Atualização1.002-
FINA460REVERSALOFFINANCINGTRADING                    SimNãoEAI Exclusão1.000-
FINI070AUPDATECONTRACTPARCEL                             SimNãoEAI Todas1.002-
FINI150AOURNUMBERBANKING                                 SimNãoEAI Todas1.000-
INTXATU01INTERNALIDLOADNãoSimEAI Todas1.000-
MATA010ITEMSimNãoEAI Todas3.007SB1
MATA020CUSTOMERVENDORSimSimEAI Todas2.002SA2
MATA030CUSTOMERVENDORSimSimEAI Todas2.002SA1
MATA035STOCKGROUPSimNãoEAI Todas1.000SBM
MATA070BANKSimNãoEAI Todas2.001SA6
QIEA030UNITOFMEASURESimNãoEAI Todas2.000SAH
FINI070LSTLISTOFACCOUNTRECEIVABLESETTLEMENTSNãoSimEAITodas1.000-
FINI035LSTLISTOFCOMPLEMENTARYVALUENãoSimEAITodas1.000-

 Novos Adapters ( 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.
      (Mais detalhes acesso o documento Configuração EAI Protheus)


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




Nível de compartilhamento

 Caso o Protheus esteja configurado para utilizar o compartilhamento das tabelas por Grupo de Empresa, deve ser realizada as configurações necessárias conforme documentação Compartilhamento por grupo de empresas

 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:


Mensagem Currency (Moeda)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

GMOEDA

SIMBOLO

R$

PROTHEUS

01||01

GMOEDA

SIMBOLO

US$

PROTHEUS

01||02


Mensagem CostCenter (Centro de Custo)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

GCCusto

CODCOLIGADA|CODCCUSTO

1|100000000

PROTHEUS

01|01AM    |100000000

GCCusto

CODCOLIGADA|CODCCUSTO

1|100000002

PROTHEUS

01|01AM    |100000002


Mensagem CustomerVendor (Cliente/Fornecedor)

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


Mensagem Bank (Banco/Agência/Conta Corrente/Conta Caixa/Convênio)

Banco / Agência / Conta Corrente 

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

FConta

CODCOLIGADA|NUMBANCO|NUMAGENCIA|NROCONTA

2|001|0455 |012453

PROTHEUS

01|02AM0001|001|0455|012453

FConta

CODCOLIGADA|NUMBANCO|NUMAGENCIA|NROCONTA

2|033|4268 |01001459

PROTHEUS

01|01AM0001|033|4268|01001459


Conta Caixa

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

FCxa

CODCOLIGADA|CODCXA

2|01001459

PROTHEUS

01|01AM0001|033|4268|01001459

FCxa

CODCOLIGADA|CODCXA

2|012453

PROTHEUS

01|02AM0001|001|0455|012453


Convênio

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

FCONVENIO

CODCOLIGADA|IDCONVENIO

2|19

PROTHEUS

01|02AM0001|001|0455|012453

FCONVENIO

CODCOLIGADA|IDCONVENIO

2|22

PROTHEUS

01|01AM0001|033|4268|01001459


Mensagem AccounReceivableDocument (Lançamentos a receber)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

FLAN

CODCOLIGADA|IDLAN

2|1380

PROTHEUS

01|01AM0001||68|1|002

FLAN

CODCOLIGADA|IDLAN

2|1381

PROTHEUS

01|01AM0001||69|2|002

Mensagem FinancialTrading (Negociação de Lançamentos a receber)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

FACORDO

CODCOLIGADA|IDACORDO

2|36

PROTHEUS

01|01AM0001|L000016

FACORDO

CODCOLIGADA|IDACORDO

2|37

PROTHEUS

01|01AM0001|L000017


Mensagem OurNumberBanking (Nosso Número Bancário )

Não haverá registro na tabela De-Para para essa requisição.


Mensagem AccountingItem (Item Contábil)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

SITEMCONTABILPROTHEUS

CODCOLIGADA|IDITEMCONTABIL

2|10

PROTHEUS

01|01AM    |02

SITEMCONTABILPROTHEUS

CODCOLIGADA|IDITEMCONTABIL

2|11

PROTHEUS

01|01AM    |03


Mensagem ClassValue (Classe de Valor)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

SCLASSEVALORPROTHEUS

CODCOLIGADA|IDCLASSEVALOR

2|10

PROTHEUS

01|01AM0001|01

SCLASSEVALORPROTHEUS

CODCOLIGADA|IDCLASSEVALOR

2|11

PROTHEUS

01|01AM0001|01.01


Mensagem Item (Produto)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

TPRODUTO

CODCOLIGADA|IDPRD

2|16

PROTHEUS

01||1

TPRODUTO

CODCOLIGADA|IDPRD

2|17

PROTHEUS

01||2

Observação

Caso o RM estiver configurado para produto global, o cadastrado do “de/para” do produto no RM irá considerar a coligada corrente para a montagem do “de/para”. E na geração do lançamento financeiro da parcela do contrato onde o serviço foi vinculado ao produto. A integração irá enviar o produto conforme o “de/para” do produto durante o seu cadastro. Vale ressaltar quando o produto é global no RM, os seus dados são replicados para cada coligada configurada para a integração com o Protheus. Esse comportamento estar presente somente na versão do EAI 1.0.

Exemplo:

No Protheus temos o produto “Caixa Box” com código 19 da entidade 01. O valor da chave de integração é 01||19. No momento do cadastro do produto “Caixa Box” no Protheus, a integração cadastrar o “de/para” desse produto no RM na coligada 1 com o seu identificador 100. Assim o valor da primária no RM será 1|100.

O produto “Caixa Box” presente no sistema da RM é vinculado aos serviços “mensalidade” da coligada 1, e “mensalidade padrão” da coligada 9. Assim na geração do lançamento financeiro para a parcela do contrato da coligada 1 e 9 com seus respectivos serviços, a integração ao irá enviar o “de/para” “1|100” para o Protheus gerar o título de cobrança. Visto que esse “de/para” estar presente nos dois sistemas.


Mensagem StockGroup (Grupo de Produtos)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

TTb2

CODCOLIGADA|CODTB2FAT

1|0076

PROTHEUS

01||0076

TTb2

CODCOLIGADA|CODTB2FAT

1|0077

PROTHEUS

01||0077


Mensagem UnitOfMeasure (Unidade de Medida)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

TUnd

CODUND

TS

PROTHEUS

01||TS

TUnd

CODUND

T1

PROTHEUS

01||T1


Mensagem OurNumberBanking (Nosso Número Bancário )

Não haverá registro na tabela De-Para para essa requisição.


Mensagem Assets (Ativos Fixos)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

IPATRIMONIO

CODCOLIGADA|IDPATRIMONIO

1|1

PROTHEUS

01||01

IPATRIMONIO

CODCOLIGADA|IDPATRIMONIO

1|1

PROTHEUS

01||02


Mensagem AccountPayableDocument (Contas a Pagar)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

FLAN

CODCOLIGADA|IDLAN

2|1380

PROTHEUS

01|01AM0001||68|1|002

FLAN

CODCOLIGADA|IDLAN

2|1381

PROTHEUS

01|01AM0001||69|2|002


Mensagem LISTOFACCOUNTRECEIVABLEDOCUMENTSETTLEMENTS (Contas a Receber)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

FLAN

CODCOLIGADA|IDLAN

2|1380

PROTHEUS

01|01AM0001||68|1|002

FLAN

CODCOLIGADA|IDLAN

2|1381

PROTHEUS

01|01AM0001||69|2|002


Mensagem LISTOFCOMPLEMENTARYVALUE (Valores Complementares do Contas a Receber)

Tabela RM

Chave Primária RM

Valor Chave Primária RM

Sistema Integrado

Valor Chave Integração

FLAN

CODCOLIGADA|IDLAN

2|1380

PROTHEUS

01|01AM0001||68|1|002

FLAN

CODCOLIGADA|IDLAN

2|1381

PROTHEUS

01|01AM0001||69|2|002


Cadastros

Cadastros Especiais

É 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

Empresa e Filial

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 comuns

Cadastros MOEDA - Protheus

Módulo ( SIGACTB ) 



Atualizações | Cadastros | Moedas Contábeis



Cadastro de 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 - 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 - 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 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 - Protheus

Módulo ( SIGACTB )



Atualizações | Entidades | Custos



Item Conta



Item Contábil enviado para o RM



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

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



Ao 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 - Protheus

Configurar Protheus para uso do cadastro de Cliente / Fornecedor

Módulo ( SIGACFG )



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 Padrão  = “01”




( A1_COD ) = Editar



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

Inicializador Padrão em branco


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.



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


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





Cadastro do Cliente Fornecedor do RM

Gestão Financeira 



Cliente / Fornecedor cadastrado no RM




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

Para gerar um lançamento a pagar é preciso vincular um Fornecedor no cadastro do Cliente.



Verificando cadastro do Cliente / Fornecedor no Protheus

Módulo ( SIGAFIN ) 



Atualizações | Cadastros | Clientes 



Cliente enviado para Protheus

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

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



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


OBSERVAÇÃO

Na geração do lançamento financeiro pela parcela do contrato a natureza financeira é buscada primeiro no anexo "Dados financeiros - Integração Protheus" e caso não tiver busca a natureza cadastrada no serviço no campo "Código da Natureza Financeira".

Na geração do acordo do lançamento financeiro a natureza financeira é buscada primeiro no anexo "Dados financeiros - Integração Protheus" e caso não tiver busca a natureza cadastrada no serviço no campo "Código da Natureza Financeira", e por último no rateio por centro de custo.


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


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 


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

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

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




Contabilização por Competência 

Documentação de configuração da integração Contábil encontra-se no Link ao lado:  TOTVS Educacional x BackOffice Protheus - Contábil

 Entrando no Módulo TOTVS Educacional


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

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 



Geração de Lançamentos

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 Adapter 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 Protheus 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

AccountReceivableDocumentInternalId

Baixando o Título a pagar pelo RM 

No RM para realização da baixa do lançamento a pagar deve usar o processo "Protheus - Lançamentos a Pagar → Registrar  Lançamentos" conforme imagem abaixo.

O cancelamento da baixa do lançamento a pagar deve usar o processo "Protheus - Lançamentos a Pagar - Cancelar Lançamentos" conforme a imagem abaixo.