Adapters da Integração Financeiro

Recomendamos a parametrização no Protheus

Rotina

Mensagem

Descrição


ProtheusRMCanal

Operação

Versão

Alias

do Protheus

Envia

Recebe

EnviaRecebe
CTBA140CURRENCYMoeda SimNão NãoSimEAITodas2.001CTO
FINA010FINANCIALNATURENatureza FinanceiraSimNãoNãoSimEAITodas2.000SED
FINA040ACCOUNTRECEIVABLEDOCUMENTLançamento a receberNãoSimSimNãoEAITodas2.005SE1
FINA050ACCOUNTPAYABLEDOCUMENTLançamento a pagar NãoSim SimNãoEAITodas 2.001SE2 
FINA130BANKBancoSimNãoNãoSimEAITodas2.001SA6
FINA460FINANCINGTRADINGNegociação lançamento a receberNãoSimSimNãoEAIAtualização2.000FO1
MATA020CUSTOMERVENDORCliente ou FornecedorSimSimSimSimEAITodas2.002SA2
MATA030CUSTOMERVENDORCliente ou FornecedorSimSimSimSimEAITodas2.002SA1
MATA070BANKBancoSimNãoNãoSimEAITodas2.001SA6
FINI070LSTLISTOFACCOUNTRECEIVABLESETTLEMENTSBaixa a receberNãoSimSimNãoEAITodas1.005FK1
FINI035LSTLISTOFCOMPLEMENTARYVALUEValores AcessóriosNãoSimSimNãoEAITodas1.000FKC

Os cadastros do cliente e do fornecedor podem ser realizados no RM no TOTVS Gestão Financeira e no BackOffice Protheus.

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

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Configurar Protheus para uso do cadastro de Cliente / Fornecedor no Módulo "SIGACFG".

Base de dados | Dicionário | Bases de Dados

Grupo de Campos = Alterar o tamanho 

O valor precisa ser mesmo valor informado no RM na máscara do cliente fornecedor, caso seja necessário a alteração do valor entrar em contato com as equipes de Suporte do TOTVS Financeira e Protheus para análise de riscos das alterações.

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

Editar ambas as Tabelas 

Localizar o campo "A1_LOJA" = Editar

Aba "Opções" deve 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

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

Atualizações | Cadastros | Clientes 

Cliente enviado para Protheus



Na integração EAI 2.0 no cadastro do cliente/fornecedor do TOTVS Gestão Financeira tem três campos novos que são:

  • Código da Loja, Código Externo, Código da Filial de Integração

Para maiores informações consulte: https://tdn.totvs.com/display/public/INT/Cliente+x+Fornecedor

A geração do código do cliente/fornecedor na integração EAI 2.0 é gerado de duas formas, que são:

  • Utilização do parâmetro “Usar código sequencial (se máscara for numérica) ”:  O TOTVS Gestão Financeira irá gerar o código automaticamente de acordo com a parametrização.
  • Sem a utilização do parâmetro “Usar código sequencial (se máscara for numérica) ”: O código do cliente/fornecedor será criado automaticamente pelo TOTVS Gestão Financeira. O usuário deverá informar somente o código externo do cadastro. A criação do código do cliente/fornecedor será no seguinte formato separado por ponto e vírgula:
    • Código da loja + ; + C para cliente ou F para fornecedor + ; + Código Externo + ; + Código Filial Integração.

Vale ressaltar que a recomendação é a opção: Sem a utilização do parâmetro “Usar código sequencial (se máscara for numérica) ”


Ao integrar por mensagem única com o Protheus, o cliente/fornecedor não poderá ser cadastro como ambos, PAGREC igual a 3. Não sendo possível a alteração de uma classificação
de 
Cliente para Fornecedor ou vice-versa.

Definir a máscara no Financeiro e no Educacional para o cadastro do Cliente/Fornecedor, ao gerar um responsável financeiro no cadastro de Alunos.
Quando definido a mascará vazia, internamente será adotada uma máscara numérica com 09 posições. 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


E acesse também o Módulo TOTVS Educacional / Configurações/ Parâmetros / 15.02 - Tesouraria / Geral 1/2 / Responsável Financeiro / Máscara do código de Cliente/Fornecedor.


Cenário em que o Protheus tiver um compartilhamento por Empresa, o TOTVS Gestão Financeira deve ser parametrizado para utilizar clientes globais. Para isso 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 / Default Cli/For Globais

Cadastro do Cliente Fornecedor do RM no TOTVS Gestão Financeira 

Cliente / Fornecedor cadastrado no RM

Acesse Integrações opção "Integração Protheus" para vincular um fornecedor para no cadastro do cliente para geração de lançamento a pagar. Esse campo só ficará visível somente para o cadastro de cliente.


Para o envio e o recebimento do código do país do Cliente/Fornecedor é necessário a utilização da tabela de Classificação de País do módulo fiscal.

A Tabela de Classificação pode ser acessada pelo endereço: BackOffice / Gestão Fiscal / Cadastros / Globais / Mais... / Endereço / Classificação de País


Pelo anexo de codificação no cadastro de país do módulo fiscal é possível cadastrar um código de acordo com a tabela de classificação inclusa.

O cadastro de codificação de país pode ser acessado pelo endereço: BackOffice / Gestão Fiscal / Cadastros / Globais / Mais... / Países / Anexos / Codificação de País


Para identificação de qual tabela de classificação será utilizada, foi criado o parâmetro de integração CODCLASSIFICPAIS para incluir o código da tabela cadastrada. 

Caminho para o parâmetro de integração: Integração / EAI 2.0 / Parâmetros adapter


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. 

Exemplo:

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

CUSTOMERVENDOR


A restrição da mensagem está relacionada ao tipo de compartilhamento das tabelas SA1 e SA2 no Protheus, para mais informações clique aqui

Observação: Recomenda a utilização de cliente/fornecedor global somente quando no Protheus não utiliza múltiplos grupos de empresa. 

A recomendação na integração EAI 2.0 é utilizar o modo de compartilhamento exclusivo por empresa e o modo de compartilhamento compartilhado por filial no Protheus. O motivo dessa recomendação é porque atualmente no cadastro de cliente/fornecedor no TOTVS Gestão Financeira não tem a possibilidade de incluir o cliente ou o fornecedor por filial. Vale ressaltar que o campo "Código da Filial de Integração" somente informa a filial do cliente ou do fornecedor no Protheus quando o compartilhamento é exclusivo por filial.

Recomendamos a parametrização no Protheus do parâmetro MV_RMCLASS ( MV_RMCLASS  = .T. )

Quando existir a integração do Protheus x TOTVS Educacional, o campo (Cod. do Cliente) no Protheus não será mais editável. Será buscado o código sequencial na tabela de controle de numeração do TOTVS Educacional (RM).

Para maiores informações clique aqui

Para maiores informações clique aqui

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

O cadastro do banco é realizado no BackOffice Protheus e em seguida o cadastro é replicado para o TOTVS Gestão Financeira, através desta integração. 

Para realizar o cadastro de banco primeiramente deve ser realizado o cadastro de Moeda no SIGACTB

Como o cadastro é realizado no Protheus, os cadastros do TOTVS Gestão Financeira são desabilitados para inclusão e exclusão, caso a integração esteja ativa.

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Módulo SIGACFG ( Ambiente | Empresa | Filial ) 

Configuração no Protheus para cadastro do banco necessário para que o cadastro de convênio no TOTVS Gestão financeira possa ser criado.


Cadastro de banco no 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 

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)


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

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


TOTVS Gestão Financeira 

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

Conta Caixa enviada para o Gestão Financeira

Movimentações Bancárias | Convênio

Convênio enviado para o Gestão Financeiro


O parâmetro CONTACAIXAAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “FCXA.CODCXA”. Na falta do parâmetro ou ele marcado como true o código da conta/caixa sempre será auto incremental.
Com o auto incremental do código da conta/caixa se no Protheus estiver o modo de compartilhamento "exclusivo" para empresa, unidade de negócio e filial, o RM irá criar uma conta/caixa para cada filial do Protheus mapeada no de/para de filiais.


É importante lembrar que caso o parâmetro esteja configurado para não considerar o auto incremento, será gravado no campo “FCXA.CODCXA” o número da conta do banco.
Caso existe o mesmo número da conta corrente em bancos distintos não será possível realizar o cadastro.


O parâmetro CONVENIOPORCONTRATO definirá se no de/para do "BANK_CONVENIO" o código do contrato bancário, "FCONVENIO.CONVENIO", fará parte do valor externo vindo do Protheus, visto que no Protheus poderá ter vários contratos bancários para um mesmo banco.

Todas as movimentações da mensagem BANK resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. 

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

Banco / Agência / Conta Corrente

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

FCONTA

CODCOLIGADA|NUMBANCO|NUMAGENCIA|NROCONTA

1|104|1041|1234

T1||104|1041|1234

BANK

84043D1C-707C-4F5A-A961-48CDCBBE0267
TOTVS Educacional x BackOffice Protheus

FCONTA

CODCOLIGADA|NUMBANCO|NUMAGENCIA|NROCONTA

1|341|9598|01214

T1||341|9598|01214

BANK

1A46E902-3D5F-41B1-A1F6-8375CA82B28E


Convênio

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

FCONVENIO

CODCOLIGADA|IDCONVENIO

1|2

T1|D MG 01 |1

BANK_CONVENIO

84043D1C-707C-4F5A-A961-48CDCBBE0101
TOTVS Educacional x BackOffice Protheus

FCONVENIO

CODCOLIGADA|IDCONVENIO

1|3

T1|D MG |2

BANK_CONVENIO


A restrição da mensagem está relacionada ao tipo de compartilhamento da tabela SA6 no Protheus, para mais informações clique aqui

A recomendação na integração EAI 2.0 é utilizar o modo de compartilhamento exclusivo por empresa e o modo de compartilhamento compartilhado por filial no Protheus. O motivo dessa recomendação é porque atualmente no cadastro de Banco no TOTVS Gestão Financeira não tem a possibilidade de incluir o banco por filial. 

Quando no RM está cadastrado a coligada em Integração / EAI 2.0 / Aplicativos como:

  • Unidade de Negócio: não é permitido no Protheus o modo de compartilhamento "compartilhado" de Filial e Unidade de Negócio
  • Empresa: não é permitido no Protheus o modo de compartilhamento "compartilhado" somente de Filial
  • Grupo de Empresa: não é permitido no Protheus o "compartilhamento" compartilhado somente de Filial ou Filial e Unidade de Negócio

Não será possível a utilização de uma combinação de compartilhamento onde a tabela de Banco, no Protheus, esteja em um modo todo exclusivo e no RM a configuração de coligada, no cadastro de aplicativos, esteja definida como Grupo de empresa.

Será retornada uma mensagem de validação e nenhuma informação será cadastrada. 

Para esses casos, deverá ser configurada coligada como Empresa ou Unidade de negócio.

O cadastro da moeda é realizado no BackOffice Protheus e em seguida, o cadastro é replicado para o TOTVS Gestão Financeira, através desta integração.

Como o cadastro é realizado no Protheus, os cadastros do TOTVS Gestão Financeira são desabilitados para inclusão e exclusão, caso a integração esteja ativa.

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Configurar Protheus para cadastro do banco no Módulo (SIGACTB) 

Atualizações | Cadastros | Moedas Contábeis

Cadastro de Moeda Realizado no Protheus

Caminho para acesso ao cadastro do Moeda, no sistema:

Acesse BackOffice / Gestão Financeira / Movimentações Bancárias / Moedas e Índices


Moeda enviada para o RM.

Todas as movimentações da mensagem CURRENCY resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. 

Moeda

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

GMOEDA

SIMBOLO

R$

T1|D MG 01|01

CURRENCY

84043D1C-707C-4F5A-A961-48CDCBBE0102
TOTVS Educacional x BackOffice Protheus

GMOEDA

SIMBOLO

USD

T1|D MG 01|19

CURRENCY


A restrição da mensagem está relacionada ao tipo de compartilhamento da tabela CTO, para mais informações clique aqui

A recomendação na integração EAI 2.0 é utilizar o modo de compartilhamento exclusivo por empresa e o modo de compartilhamento compartilhado por filial no Protheus. O motivo dessa recomendação é porque atualmente no cadastro de Moeda no TOTVS Gestão Financeira não tem a possibilidade de incluir a moeda por filial. 


Quando no RM está cadastrado a coligada em Integração / EAI 2.0 / Aplicativos como:

  • Unidade de Negócio: não é permitido no Protheus o modo de compartilhamento "compartilhado" de Filial e Unidade de Negócio
  • Empresa: não é permitido no Protheus o modo de compartilhamento "compartilhado" somente de Filial
  • Grupo de Empresa: não é permitido no Protheus o "compartilhamento" compartilhado somente de Filial ou Filial e Unidade de Negócio
  • Nas coligada acima: não é permitido que a Filial, Unidade de Negocio e Empresa esteja cadastrado no modo de compartilhamento "exclusivo" no Protheus.

O cadastro dos valores acessórios é realizado no TOTVS Gestão Financeira, através da parametrização dos valores opcionais, e em seguida, o cadastro é replicado para o BackOffice Protheus, através desta integração.

Ao inserir um valor opcional no RM, criando um "Tipo de valor acessório" no Protheus, não será possível alterar a ação do valor opcional, e nem excluir o registro no Protheus. O sistema permite somente que o "Tipo de valor acessório" seja desativado. Ressaltamos que o sistema cria o "Tipo de valor acessório" somente se a ação definida no RM for igual a Somar ou Diminuir. Outras ações não terão a mensagem de integração disparada. 

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Verificação dos valores acessórios enviados para o Protheus no Módulo "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


Configurar TOTVS Gestão financeira para cadastro de Valores Acessórios


BackOffice | Gestão Financeira


Ambiente | Parâmetros | TOTVS Gestão Financeira | 02.02 – Contas a Receber | Valores Opcionais cadastrados no TOTVS Gestão Financeira


Serão enviados para a integração apenas os valores acessórios que estejam ativos ou que tenham uma ação no sistema.

Todas as movimentações da mensagem LISTOFCOMPLEMENTARYVALUE resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.

Mensagem LISTOFCOMPLEMENTARYVALUE (Valores Complementares do Contas a Receber)

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

FPARAM

CODCOLIGADA|CODIGO

1|VALOROP4

T1|D MG 01|000007

COMPLEMENTARYVALUE

84043D1C-707C-4F5A-A961-48CDCBBE0104
TOTVS Educacional x BackOffice Protheus

FPARAM

CODCOLIGADA|CODIGO

1|VALOROP5

T1|D MG 01|000008

COMPLEMENTARYVALUE


Os valores acessórios enviados para serem cadastrados no BackOffice Protheus são os valore opcionais parametrizados no TOTVS Gestão Financeira.


A mensagem FINANCIALNATURE é responsável por receber os dados de natureza orçamentária financeira entre a integração TOTVS Educacional com BackOffice Protheus. 

Os cadastros de natureza orçamentária financeira devem ser realizados no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no cadastro de natureza orçamentária financeira do lado do RM.

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Cadastros Natureza Financeira - Protheus

Módulo "SIGAFIN" 

Atualizações | Cadastros | Naturezas

Natureza Cadastrada no BackOffice Protheus 


A geração do código da natureza orçamentária financeira na integração EAI 2.0 é gerado utilizando o parâmetro NATUREZAFINANCEIRAAUTOINC


Nos parâmetros do TOTVS Gestão de Estoque, Compras e Faturamento marque a opção "Utiliza Natureza Orçamentária/Financeira".
Acesse: BackOffice / Gestão de Estoque, Compras e Faturamento / Ambiente / Parâmetros / Gestão de Estoque, Compras e Faturamento / Parâmetros Gerais / Tabelas / Natureza Orçamentária/Financeira

No Protheus se definir o cadastro de Natureza Financeira como tudo compartilhado no RM o parâmetro "Permite Globais" deve ser marcado em todas as coligadas que existe de/para. 


Caminho para acesso ao cadastro de naturezas no sistema: 

Acesse: BackOffice / Gestão de Estoque, Compras e Faturamento / Orçamento / Tabelas de Orçamento / Natureza Orçamentária Financeira


                                              


Natureza Orçamentária Financeira enviada para o RM


TOTVS Educacional - Financeiro / Contábil | Serviços

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

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.


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.

Todas as movimentações da mensagem FINANCIALNATURE resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. 

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

TOTVS Educacional x BackOffice Protheus

TTBORCAMENTO

CODCOLIGADA|CODTBORCAMENTO

1|1

T1|D MG 01 |1

FINANCIALNATURE

A restrição da mensagem está relacionada ao tipo de compartilhamento das tabelas SED no Protheus, para mais informações clique aqui

A recomendação na integração EAI 2.0 é utilizar o modo de compartilhamento exclusivo por empresa e o modo de compartilhamento compartilhado por filial no Protheus. O motivo dessa recomendação é porque atualmente no cadastro de Natureza Orçamentaria Financeira no TOTVS Gestão de Estoque, Compras e Faturamento não tem a possibilidade de ser incluída por filial. Já para a utilização de natureza Global no RM é realizada quando no BackOffice Protheus o tipo de compartilhamento for compartilhado por Empresa.

Quando no RM está cadastrado a coligada em Integração / EAI 2.0 / Aplicativos como:

  • Unidade de Negócio: não é permitido no Protheus o modo de compartilhamento "compartilhado" de Filial e Unidade de Negócio
  • Empresa: não é permitido no Protheus o modo de compartilhamento "compartilhado" somente de Filial
  • Grupo de Empresa: não é permitido no Protheus o "compartilhamento" compartilhado somente de Filial ou Filial e Unidade de Negócio
  • Nas coligada acima: não é permitido que a Filial, Unidade de Negocio e Empresa esteja cadastrado no modo de compartilhamento "exclusivo" no Protheus.

Vale ressaltar que ao marcar para Permitir Globais em: Módulo Gestão de Estoque / Ambiente / Parâmetros / Gestão Estoque, Compras e Faturamento / 04.01 – Parâmetros Gerais / 04.01.04 – Tabelas / 04.01.04.10 – Natureza Orçamentária Financeira, mesmo o Protheus sendo configurado como compartilhamento exclusivo por empresa, será cadastrado a natureza como global no RM. Quando o modo de compartilhamento for compartilhado por empresa e o parâmetro para Permitir Globais estiver desmarcado o RM irá replicar o cadastro para cada coligada.

A mensagem ACCOUNTRECEIVABLEDOCUMENT é responsável por enviar dados do lançamento a receber entre a integração TOTVS Educacional com BackOffice Protheus. 

O processo de geração de lançamentos a receber devem ser realizados no TOTVS Educacional, serão desabilitadas quaisquer alterações a serem feitas no titulo do lado do BackOffice Protheus.

Entidade

Pontos de Integração

Lançamentos a receber – TOTVS Educacional

  • Geração de lançamentos (Processo de Matrícula)
  • Geração de lançamentos (Visão de Contratos)
  • Geração de lançamentos (Visão de Parcelas)
  • Alteração de data de vencimento do boleto (Boletos)
  • Geração de lançamentos (Taxa de Inscrição no Processo Seletivo)


Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Para geração de lançamento a receber deve ser realizados primeiramente os cadastros abaixo: 

  • Cliente
  • Banco / Agencia / Conta Corrente / Conta Caixa e Convenio
  • Moeda
  • Natureza Orçamentaria Financeira - 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 lançamento financeiro pela taxa de inscrição do processo seletivo a natureza financeira é buscada na subAba "Geral 2" presente na aba "Informações Financeiras" no cadastro do processo seletivo.
  • Valor Acessórios 

    Serão enviados para a integração apenas os valores acessórios que estejam ativos ou que tenham uma ação no sistema.

  • Item Contábil / Classe de Valor - (Quando utiliza esses campos na geração de lançamento). Na geração do lançamento pelo parcela do contrato o item contábil e a classe de valor são buscados no anexo "Dados financeiros - Integração Protheus" da matriz aplicada vinculada ao contrato. 
    Na geração do lançamento financeiro pela taxa de inscrição do processo seletivo o item contábil e a classe de valor são buscados no anexo "Integração Protheus" no cadastro do processo seletivo 
  • Centro de Custo - (Quando utiliza o centro de custo na geração de lançamento). Na geração do lançamento financeiro pela parcela do contrato o centro de custo é buscado na matriz aplicada vinculada ao contrato. 
    Na geração do lançamento financeiro pela taxa de inscrição do processo seletivo o centro de custo é buscado na subAba "Geral 2" presente na aba "Informações Financeiras" no cadastro do processo seletivo.
  • Produto - (Quando utiliza o centro de custo na geração de lançamento). Na geração do lançamento financeiro pela parcela do contrato o produto é buscado no anexo "Dados financeiros - Integração Protheus" presente no cadastro de serviço da parcela.
  • Prefixo - Na geração do lançamento financeiro pela parcela do contrato o prefixo é buscado no anexo "Dados financeiros - Integração Protheus" presente no cadastro de serviço da parcela. 
    Na geração do lançamento financeiro pela taxa de inscrição do processo seletivo o prefixo é buscado no anexo "Integração Protheus" no cadastro do processo seletivo.

Inserir PREFIXO que será enviado ao Protheus na Geração dos ( Lançamentos – Títulos )

 image2019-8-7_15-17-26.png


  • Tipo de documento

O Tipo de Documento tem que  ser o  mesmo tipo cadastrado no Protheus.
SINCRONISMO COM MESMO CÓDIGO – O Tipo de Documento não vem do Protheus mas o cadastro tem que ser idêntico em ambos Sistemas


  • Tipo contábil

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 )

image2018-8-31_16-41-33.png


Geração de Lançamentos

Após efetuar todas as parametrizações necessárias gere o Título para o BackOffice Protheus


A associação da matrícula no período letivo com o itens de contrato é um recurso do sistema que permite a associar o contrato criado no TOTVS Gestão de Estoque, Compras e Faturamento com a matrícula do aluno no TOTVS Educacional. Desta forma, os lançamentos financeiros gerados pelo movimento desse contrato são enviado para o BackOffice Protheus. Para mais informações sobre o processo de associar a matrícula do aluno com o contrato do TOTVS Gestão de Estoque, Compras e Faturamento, por favor clique aqui.

Para gerar o lançamento da taxa de inscrição no Processo Seletivo integrado ao Protheus precisa ser habilitado o parâmetro "Utiliza integrações com o Protheus" dentro de TOTVS Educacional > Processo Seletivo -> Parâmetros -> Parâmetros do Sistema -> Integração → Protheus


Na geração do lançamento da taxa de inscrição no Processo Seletivo será possível selecionar o próprio candidato ou seu responsável financeiro para ser o cliente/fornecedor do lançamento gerado, para isso deve ser definido através do parâmetro “Criar o cliente/fornecedor da inscrição a partir do” Candidato ou Responsável Financeiro .
Esse parâmetro está disponível em Módulo Processo Seletivo -> Parâmetros -> Parâmetros do Sistema -> Acessar a aba Integração -> Estoque, Compras e Faturamento.


Se essa parametrização não tiver configurada o sistema manterá o seu comportamento atual, em utilizar o cliente/fornecedor informado no processo seletivo para ser o cliente/fornecedor do lançamento gerado da taxa de inscrição.


Para mais informações sobre Processo Seletivo e Integração Protheus, clique aqui.

Titulo gerado para o BackOffice Protheus

Módulo ( SIGAFIN )

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



Título enviado para o Protheus

O número da parcela para lançamentos comuns originados da parcela do aluno ou processo inscrição no processo seletivo, sempre enviamos o valor "1" para o Protheus


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

Tipo de documento

O Tipo de documento no Protheus deve ser cadastrado com o mesmo código no RM. No Protheus o tipo de documento deve ser cadastrado no SigaCFG pelo menu Ambiente -> Cadastros -> Tabelas.

Em Tabelas pesquisar pela tabela “00” e localizar a chave “NL”.

Edita a tabela e insere o tipo de documento desejado em Itens.


Todas as movimentações da mensagem ACCOUNTRECEIVABLEDOCUMENT resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. 

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

TOTVS Educacional x BackOffice Protheus

FLAN

CODCOLIGADA|IDLAN

1|43

T1|D MG 01|001|43|1|NF

ACCOUNTRECEIVABLEDOCUMENT

No envio de mensagem para o Protheus é executada ao longo da execução do processo no RM , se por ventura o processamento for interrompido pelo RM após acionado o envio da mensagem, o processo RM pode sofrer um rollback (desfazimento) automático, sem efeito no processo no Protheus, gerando inconsistência.

Por esse motivo foi implementado o novo processo de envio de mensagens que neste caso, o processo do RM é executado normalmente até o seu final levando a base a um ponto de consistência. Após o processo ser encerrado com sucesso, ocorre o disparo de um novo processo apenas para o envio da mensagem ao Protheus . Se a execução do envio da mensagem ao Protheus retornar um erro, a mensagem fica registrada no banco de dados do RM e poderá ser reenviada após uma ação corretiva. Para mais detalhes sobre o processo, clique aqui.

Ao executar o processo de cancelamento de lançamento no RM (TOTVS Gestão Financeira) o titulo será excluído no BackOffice Protheus, já no RM os lançamentos serão mantidos com status cancelado, na GEAIDEPARA também será mantido o DE/PARA da FLAN. 

Caso o usuário não queira deixar lixo no sistema, marque os lançamentos com status cancelado no RM e exclua, o mesmo pode realizado no DE/PARA da FLAN.



A mensagem LISTOFACCOUNTRECEIVABLESETTLEMENTS é responsável por enviar dados da baixa do lançamento a receber entre a integração TOTVS Educacional com BackOffice Protheus. 

O processo de baixa total, baixa parcial parcial de lançamentos a receber e cancelamento de baixa devem ser realizados no TOTVS Gestão Financeira, serão desabilitadas quaisquer alterações a serem feitas no titulo do lado do BackOffice Protheus.

No processo de baixa parcial os valores presente na opção "Posição" do título são apresentados conforme os dados da baixa parcial realizada no RM.

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Baixa de titulo no RM

No TOTVS Gestão Financeira a baixa do título é realizada conforme as imagens abaixo.


Lançamento com juros, multa e bolsa incondicional


O lançamento com status baixado na parcela vinculada.


Cancelamento da baixa do lançamento 

No Protheus para baixa de titulo a versão do adapter deve estar configurada com a versão 1.005, caso não esteja deve ser baixado o pacote de correção "DSERFINR-21093_12.1.23_Versao_1005".


Baixa de titulo no Protheus

Na efetivação da baixa do título no sistema RM, o mesmo é baixado no Protheus. 

Se a baixa do título for efetuada no Protheus, o sistema irá mostrar a mensagem abaixo para o usuário.

No Protheus a título é apresentado baixado.


Na opção de posição do título de conta a receber tem os valores de juros, multas, valor de bolsas, pagamento a maior e menor, acrescenta e desconta no liquido. 


Título com baixa cancelada no RM é cancelada também no Protheus.


Todas as movimentações da mensagem LISTOFACCOUNTRECEIVABLESETTLEMENTS resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. 


Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

TOTVS Educacional x BackOffice Protheus

FLANBAIXA

CODCOLIGADA|IDLAN|IDBAIXA

1|205|58

T1|D MG 01|EDU|162|1|NF|000000|01|03

LISTOFACCOUNTRECEIVABLESETTLEMENTS 

No envio de mensagem para o Protheus é executada ao longo da execução do processo no RM , se por ventura o processamento for interrompido pelo RM após acionado o envio da mensagem, o processo RM pode sofrer um rollback (desfazimento) automático, sem efeito no processo no Protheus, gerando inconsistência.

Por esse motivo foi implementado o novo processo de envio de mensagens que neste caso, o processo do RM é executado normalmente até o seu final levando a base a um ponto de consistência. Após o processo ser encerrado com sucesso, ocorre o disparo de um novo processo apenas para o envio da mensagem ao Protheus . Se a execução do envio da mensagem ao Protheus retornar um erro, a mensagem fica registrada no banco de dados do RM e poderá ser reenviada após uma ação corretiva. Para mais detalhes sobre o processo, clique aqui.

Para realizar as baixas de titulo no RM com pagamento a maior e menor, aproveitamento de conta corrente os Valores Opcionais no TOTVS Gestão Financeira devem ser parametrizados.

No Protheus esses valores poderão ser visualizados em Contas a Receber no anexo em Valores Acessórios ou depois de baixado dentro do titulo na opção Outras Ações / Posição na coluna Valores Acessórios.

Para saber mais informações sobre pagamento maior, menor e aproveitamento da conta corrente acesse o link, Conta Corrente do aluno.

Novidade: Na nova versão 1.005 do adapter LISTTOFACCUNTRECEIVABLESETTLEMENTS tem a nova tag "CustomPaymentMethod" para ter o motivo de baixa, personalizado pelo usuário, durante a baixa do lançamento financeiro no RM e enviar esse motivo para o Protheus. Desta forma, na tela da baixa do lançamento financeiro terá campo "Motivo de Baixa (RM)" nesse campo o usuário deverá informar o motivo de baixa que personalizou pelo cadastro presente no Protheus em "SigaFin → Miscelanea → Arquivos → Tabela Mot. Baixas" clique em Motivo de Baixa - Protheuspara mais detalhes. Assim ao usar o motivo de baixa personalizado a  tag "PaymentMethod" terá o valor fixo "999". Caso o motivo de baixa personalizado não ser utilizado, a tag "PaymentMethod" terá o comportamento normal. Isso é, terá o valor "007" para o motivo de baixa "NOR - Normal", ou o valor "015" para o motivo de baixa "BOL - Boleto".

Segue as versões do RM e do Protheus com essa nova versão do adapter:

Quando ocorrer erro na baixa automática de lançamentos com valor liquido igual a zero, o lançamento da parcela será gerado com sucesso e será apresentado no LOG as baixas que apresentaram erros, neste caso será orientando ao usuário que a execução deverá ser realizada manualmente no Gestão Financeira.

  • Parametrização do Motivo de Baixa para Baixa Automática

Podemos parametrizar motivos de baixa quando um lançamento tiver a baixa automática, assim ao ser gerado um lançamento que tiver a baixa automática será preenchido com o valor informado nesse parâmetro.


Caso esse parâmetro não esteja informado será enviado o o motivo de baixa código "015" (motivo de baixa "BOL - Boleto"), esse motivo deverá ser criado na Tabela de Motivo de Baixa do Protheus com código "BOL" - descrição "Boleto".

A mensagem FINANCINGTRADING é responsável por enviar dados do acordo entre a integração TOTVS Educacional com BackOffice Protheus. 


Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

No RM configurar para usar a versão 2.000, executar o processo presente no cadastro de transação e alterar na rota do aplicativo para somente enviar e usar a versão 2.000


Acordo de titulo no RM

No TOTVS Gestão Financeira em Parâmetros | Financeiro | Contas a Receber | Geração de Lançamento | Acordo marque a opção Lançamento origem 

No TOTVS Gestão Financeira o acordo do título é realizada conforme as imagens abaixo.

Definição de juros futuros, acréscimo e desconto no acordo, quantas parcelas o acordo será feito, data de vencimento inicial do acordo. 

No acordo é gerado um novo contrato para o aluno com Tipo do Contrato = Acordo com as parcelas definidas no processo. 


Cancelamento de Acordo no RM



Após o cancelamento do acordo o contrato criado do 'Tipo Acordo' é excluído do TOTVS Educacional.

No Protheus para baixa de titulo a versão do adapter deve estar configurada com a versão 2.000.


Acordo de titulo no Protheus

Na efetivação da acordo do título no sistema RM, o mesmo é lançamento é baixado no Protheus e criado as parcelas do acordo.

O número da parcela para lançamentos comuns originados da parcela do aluno ou processo inscrição no processo seletivo, sempre enviamos o valor "1" para o Protheus, já nós lançamentos de acordo enviamos um sequencial, conforme número de parcelas do acordo.


Cancelamento de Acordo

Após o cancelamento do acordo no RM os lançamentos de acordo são excluídos do Protheus e o título a receber volta com status em 'Titulo em Aberto'.

Todas as movimentações da mensagem resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. 


Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

TOTVS Educacional x BackOffice Protheus

FACORDO

CODCOLIGADA|IDACORDO

1|30

T1|D MG 01|000000000000020|0001

D000A915-B304-46E9-84E2-DAD348B5A1FA

No envio de mensagem para o Protheus é executada ao longo da execução do processo no RM , se por ventura o processamento for interrompido pelo RM após acionado o envio da mensagem, o processo RM pode sofrer um rollback (desfazimento) automático, sem efeito no processo no Protheus, gerando inconsistência.

Por esse motivo foi implementado o novo processo de envio de mensagens que neste caso, o processo do RM é executado normalmente até o seu final levando a base a um ponto de consistência. Após o processo ser encerrado com sucesso, ocorre o disparo de um novo processo apenas para o envio da mensagem ao Protheus . Se a execução do envio da mensagem ao Protheus retornar um erro, a mensagem fica registrada no banco de dados do RM e poderá ser reenviada após uma ação corretiva. Para mais detalhes sobre o processo, clique aqui.

Associação da Matrícula no Período Letivo a Itens de Contrato

A associação da matrícula no período letivo com o itens de contrato é um recurso do sistema que permite a associar o contrato criado no TOTVS Gestão de Estoque, Compras e Faturamento com a matrícula do aluno no TOTVS Educacional. Desta forma, os lançamentos geradas pelo movimento desse contrato são enviado para o BackOffice Protheus e poderão ser realizados acordo que também serão enviados. Para mais informações sobre o processo de associar a matrícula do aluno com o contrato do TOTVS Gestão de Estoque, Compras e Faturamento, por favor clique aqui.


Geração de Acordo de lançamentos do Movimento do TOTVS Gestão de Estoque, Compras e Faturamento

No TOTVS Gestão de Estoque, Compras e Faturamento deve existir um Contrato associado a uma matrícula no Período Letivo do Aluno, mais informações sobre a associação, clique aqui.

image2020-9-21_19-44-58.png


Só será enviada para o Protheus a baixa do lançamento e inclusão do acordo de movimentos que estiver itens do contrato associados a matricula no período letivo, movimentos que não tiver nessas condições serão gerados acordos somente no TOTVS Financeira.


Acordo de titulo no RM

No TOTVS Gestão Financeira em Parâmetros | Financeiro | Contas a Receber | Geração de Lançamento | Acordo marque a opção Lançamento origem 

No TOTVS Gestão Financeira o acordo do título originado do movimento é realizada conforme as imagens abaixo.

Definição de juros futuros, acréscimo e desconto no acordo, quantas parcelas o acordo será feito, data de vencimento inicial do acordo. 


Cancelamento de Acordo no RM


Acordo de titulo no Protheus

Na efetivação da acordo do título no sistema RM, o mesmo é lançamento é baixado no Protheus e criado as parcelas do acordo.

O número da parcela para lançamentos comuns originados da parcela do aluno ou processo inscrição no processo seletivo, sempre enviamos o valor "1" para o Protheus, já nós lançamentos de acordo enviamos um sequencial, conforme número de parcelas do acordo.


Cancelamento de Acordo

Após o cancelamento do acordo no RM os lançamentos de acordo são excluídos do Protheus e o título a receber volta com status em 'Titulo em Aberto'.

Todas as movimentações da mensagem resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. 


Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

TOTVS Educacional x BackOffice Protheus

FACORDO

CODCOLIGADA|IDACORDO

1|30

T1|D MG 01|000000000000020|0001

D000A915-B304-46E9-84E2-DAD348B5A1FA

A mensagem ACCOUNTPAYABLEDOCUMENT é responsável por enviar dados do lançamento a pagar entre a integração TOTVS Educacional com BackOffice Protheus. 

O processo de geração de lançamentos a pagar devem ser realizados no TOTVS Educacional, serão desabilitadas quaisquer alterações a serem feitas no titulo do lado do BackOffice Protheus.

Entidade

Pontos de Integração

Lançamentos a pagar – TOTVS Educacional

  • Aproveitamento de conta corrente a maior
  • Lançamento a pagar para Bolsa Retroativa


Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Para geração de lançamento a pagar deve ser realizados primeiramente os cadastros abaixo: 

  • Fornecedor (Fornecedor deve ser vinculado no mesmo cliente do RA)
  • Banco / Agencia / Conta Corrente / Conta Caixa e Convenio
  • Moeda
  • Natureza Orçamentaria Financeira (Cadastrada com tipo Contas a Pagar)
  • Centro de Custo - (Quando utiliza o centro de custo na geração de lançamento)

Geração de Lançamentos a Pagar

No TOTVS Gestão Educacional a geração de lançamento a pagar pode ser realizada conforme as imagens abaixo.


No aproveitamento da conta corrente deve ser informado a conta caixa, tipo de documento, moeda, centro de custo, natureza financeira, data de vencimento e o valor a ser aproveitado.



Após todos os dados informado e finalizando o processo de aproveitamento o lançamento a pagar e gerado no TOTVS Gestão Financeira.


Titulo a pagar gerado para o BackOffice Protheus

Módulo ( SIGAFIN )

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


Título enviado para o Protheus


Todas as movimentações da mensagem resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. 


Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

TOTVS Educacional x BackOffice Protheus

FLAN

CODCOLIGADA|IDLAN

1|583

T1|D MG 01|@@@|430|1|NF|000002|1

9978B34E-7056-45DA-B85E-1600B4E0D017

No envio de mensagem para o Protheus é executada ao longo da execução do processo no RM , se por ventura o processamento for interrompido pelo RM após acionado o envio da mensagem, o processo RM pode sofrer um rollback (desfazimento) automático, sem efeito no processo no Protheus, gerando inconsistência.

Por esse motivo foi implementado o novo processo de envio de mensagens que neste caso, o processo do RM é executado normalmente até o seu final levando a base a um ponto de consistência. Após o processo ser encerrado com sucesso, ocorre o disparo de um novo processo apenas para o envio da mensagem ao Protheus . Se a execução do envio da mensagem ao Protheus retornar um erro, a mensagem fica registrada no banco de dados do RM e poderá ser reenviada após uma ação corretiva. Para mais detalhes sobre o processo, clique aqui.