Páginas filhas
  • TOTVS Educacional x BackOffice Protheus EAI 2.0 - Financeiro

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Adapters da Integração

...

idfinanceiro
labelFinanceiro

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ção

...

2.

...

000

...

FO1

...

MATA020

...

CUSTOMERVENDORCliente ou FornecedorSim

...

SimSim

...

SimEAI

...

Todas

...

2.

...

002

...

SA2

...

MATA030

...

CUSTOMERVENDORCliente ou FornecedorSim

...

SimSim

...

SimEAI

...

Todas

...

2.002

...

SA1
MATA070

...

BANK

...

BancoSim

...

Não

...

...

NãoSimEAITodas2.001SA6
FINI070LSTLISTOFACCOUNTRECEIVABLESETTLEMENTSBaixa a receberNãoSimSimNãoEAITodas1.

...

005

...

FK1
FINI035LSTLISTOFCOMPLEMENTARYVALUEValores AcessóriosNãoSimSimNãoEAITodas1.000

...

FKC

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:

Deck of Cards
idinforfinanceiro
Card
idCUSTOMERVENDOR
labelCustomerVendor

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.

Deck of Cards
idinforclifor
Card
idprotheusclifor
labelProtheus

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

Image Modified

Base de dados | Dicionário | Bases de Dados

Image Modified

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.

Image Modified

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

Image Modified

Editar ambas as Tabelas 

Image Modified

Localizar o campo "A1_LOJA" = Editar

Image Modified

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

Image Modified

(A1_COD) = Editar

Image Modified

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

Inicializador Padrão preenchido

Image Modified

Inicializador Padrão em branco

Image Modified

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

Image Modified

Atualizações | Cadastros | Clientes 

Image Modified

Cliente enviado para Protheus

Image Modified



Card
idrmclifor
labelRM
Informações
titleNovidade EAI 2.0

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

Aviso
titleGeração do Código do Cliente/Fornecedor

A geração do código do cliente/fornecedor na integração EAI 2.0 é gerado de

: Campo correspondente ao código da loja presente no BackOffice Protheus. Desta forma, para o preenchimento desse campo teve a criação do parâmetro de integração CODLOJADEFAULT, por padrão terá o valor "01" conforme o campo "LOJA" presente nas tabelas SA1 e SA2, e descrito na aba Protheus
  • Código Externo: Campo correspondente ao código do cliente ou do fornecedor cadastrado no BackOffice Protheus. Deve informar preferencialmente o próximo código correspondente ao código no Protheus
  • Código da Filial de Integração: Campo responsável por armazenar a filial de integração do cliente/fornecedor quando o cadastro do cliente ou do fornecedor do BackOffice Protheus tem compartilhamento exclusivo por filial.
  • Aviso
    titleGeração do Código do Cliente/Fornecedor


    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.

    Image Modified

    A definição da

    Definir a 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,

    .
    Quando definido a mascará vazia, internamente será adotada uma máscara numérica com 09 posições.

     O

    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

    Image Modified


    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.

    Image Modified


    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

    Image Modified

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

    Image Modified

    Cliente / Fornecedor cadastrado no RM

    Image Modified

    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.

    Image Modified


    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

     

    Caminho para o parâmetro de integração:

     Integração / EAI 2.0 / Parâmetros adapter


    Card
    iddeparaclifor
    labelDe/para

    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


    Card
    idrestricoesclifor
    labelRestrições

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

    Aviso
    titleATENÇÃO

    Observação: Recomenda a utilização de

    A configuração para

    cliente/fornecedor global

    é realizada somente caso o Protheus tenha um compartilhamento por Empresa.Image Removed

    somente quando no Protheus não utiliza múltiplos grupos de empresa. 

    Informações
    titleIntegração EAI 2.0

    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.

    Card
    idbank
    Nota

    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

    Nota
    titleCadastro de Cliente no Papel de Trabalho

    Para maiores informações clique aqui

    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) 

    Image Removed

    Atualizações | Cadastros | Moedas Contábeis

    Image Removed

    Cadastro de Moeda Realizado no Protheus

    Image Removed

    Card
    idbank
    labelBank
    Card
    idBANK
    labelBank

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

    Image Modified

    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. 

    Como

    Para realizar o cadastro

    é realizado no

    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.

    Deck of Cards
    idinforbanco
    Card
    idprotheusbanco
    labelProtheus
    Configurar Protheus para cadastro do banco no

    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.

    Image Modified


    Cadastro de banco no Módulo "SIGAFIN"

    Image Modified


    Atualizações | Cadastros | Bancos 

    Image Modified


    Image Modified

    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

    Image Modified

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

    Image Modified

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

    Image Modified

    Na Aba "Cadastrais" informar :

        • Banco
        • Agência
        • Conta
        • Sub Conta 

    Image Modified

    Na Aba "Outros"

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

    Image Modified


    Card
    idrmbanco
    labelRM

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

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

    Image Modified


    Image Modified

    TOTVS Gestão Financeira 

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

    Conta Caixa enviada para o Gestão Financeira

    Image Modified

    Movimentações Bancárias | Convênio

    Convênio enviado para o Gestão Financeiro

    Image Modified


    Aviso

    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.

    Image Added


    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:

    84043D1C-707C-4F5A-A961-48CDCBBE0267
    Card
    iddeparabanco
    labelDe/para

    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
    Card
    iddeparabanco
    labelDe/para
    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

    TOTVS Educacional x BackOffice Protheus

    FCONTA

    CODCOLIGADA|NUMBANCO|NUMAGENCIA|NROCONTA

    1|

    341

    104|

    9598

    1041|

    01214

    1234

    T1||

    341

    104|

    9598

    1041|

    01214

    1234

    BANK

    1A46E902
    84043D1C-
    3D5F-
    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
    Conta Caixa


    Convênio

    Exemplo:

    Aplicativo

    Tabela RM

    Campos RM

    Valor RM

    Valores Externos

    Transação

    Identificador Global
    TOTVS Educacional x BackOffice Protheus
    FCXA

    FCONVENIO

    CODCOLIGADA|

    CODCXA

    IDCONVENIO

    1|2

    T1|D MG 01 |

    318|0001|00001

    1

    BANK_CONVENIO

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

    FCONVENIO

    CODCOLIGADA|

    CODCXA

    IDCONVENIO

    1|3

    T1|D MG

    01

    |

    033|3477|01087756

    2

    BANK_CONVENIO

    Convênio

    Exemplo:Aplicativo

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

    Card
    id
    restricoesbank
    labelRestrições

    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

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

    FCONVENIO

    CODCOLIGADA|IDCONVENIO

    1|3

    T1|D MG |2

    BANK

    Card
    idrestricoesbank
    labelRestrições
    A

    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. 

    Informações
    titleIntegração EAI 2.0
    Card
    idcurrency
    labelCurrency
    Card
    idCURRENCY
    labelCurrency
    Deck of Cards
    idinforcurrency
    Card
    idprotheuscurrency
    labelProtheus
    Card
    idrmcurrency
    labelRM

    Caminho para acesso ao cadastro do Moeda, no sistema:

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

    Image Removed

    Card
    iddeparacurrency
    labelDe/para
    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

    Card
    idrestricoescurrency
    labelRestrições

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

    Informações
    titleIntegração EAI 2.0

    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. 

    Card
    idlistofcomplementaryvalue
    labelListOfComplementaryValue
    Card
    idLISTOFCOMPLEMENTARYVALUE
    labelListOfComplementaryValue

    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.

    Deck of Cards
    idinforcomplementaryvalue
    Card
    idprotheuscomplementaryvalue
    labelProtheus

    Verificação dos valores acessórios enviados para o Protheus no Módulo "SIGAFIN"

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

    Image Removed

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

    Image Removed

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

    Image Removed

    Módulo "SIGAFIN"

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

    Image Removed

    Card
    idrmcomplementaryvalue
    labelRM

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

    BackOffice | Gestão Financeira

    Image Removed

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

    Image Removed

    Card
    iddeparacomplementaryvalue
    labelDe/para

    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 GlobalTOTVS Educacional x BackOffice Protheus

    FPARAM

    CODCOLIGADA|CODIGO

    1|VALOROP4

    T1|D MG 01|000007

    COMPLEMENTARYVALUE

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

    FPARAM

    CODCOLIGADA|CODIGO

    1|VALOROP5

    T1|D MG 01|000008

    COMPLEMENTARYVALUE

    Card
    idrestricoescomplementaryvalue
    labelRestrições

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

    Card
    idFINANCIALNATURE
    labelFinancialNature

    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.

    Deck of Cards
    idinfornatfin
    Card
    idprotheusnatfin
    labelProtheus

    Cadastros Natureza Financeira - Protheus

    Módulo "SIGAFIN" 

    Image Removed

    Atualizações | Cadastros | Naturezas

    Image Removed

    Natureza Cadastrada no BackOffice Protheus 

    Image Removed

    Card
    idrmnatfin
    labelRM
    Aviso
    titleGeração do Código da Natureza Orçamentária Financeira

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

    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

                                                  Image Removed

    Orçamento | Tabelas de Orçamento | Natureza Orçamentária Financeira

    Image Removed

    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 

    Image Removed

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

    Image Removed

    Aviso
    titleOBSERVAÇÃ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.

    Card
    iddeparaclifor
    labelDe/para
    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

    Card
    idrestricoesclifor
    labelRestrições

    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

    Aviso

    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.

    Card
    idcurrency
    labelCurrency
    Card
    idCURRENCY
    labelCurrency

    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.

    Deck of Cards
    idinforcurrency
    Card
    idprotheuscurrency
    labelProtheus

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

    Image Added

    Atualizações | Cadastros | Moedas Contábeis

    Image Added

    Cadastro de Moeda Realizado no Protheus

    Image Added

    Card
    idrmcurrency
    labelRM

    Caminho para acesso ao cadastro do Moeda, no sistema:

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

    Image Added

    Moeda enviada para o RM.Image Added

    Card
    iddeparacurrency
    labelDe/para

    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


    Card
    idrestricoescurrency
    labelRestrições

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

    Informações
    titleIntegração EAI 2.0

    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.
    Card
    idlistofcomplementaryvalue
    labelListOfComplementaryValue
    Card
    idLISTOFCOMPLEMENTARYVALUE
    labelListOfComplementaryValue

    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.

    Deck of Cards
    idinforcomplementaryvalue
    Card
    idprotheuscomplementaryvalue
    labelProtheus

    Verificação dos valores acessórios enviados para o Protheus no Módulo "SIGAFIN"

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

    Image Added


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

    Image Added


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

    Image Added


    Módulo "SIGAFIN"

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

    Image Added


    Card
    idrmcomplementaryvalue
    labelRM

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


    BackOffice | Gestão Financeira

    Image Added


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

    Image Added


    Nota

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

    Card
    iddeparacomplementaryvalue
    labelDe/para

    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


    Card
    idrestricoescomplementaryvalue
    labelRestrições

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


    Card
    idFINANCIALNATURE
    labelFinancialNature

    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.

    Deck of Cards
    idinfornatfin
    Card
    idprotheusnatfin
    labelProtheus

    Cadastros Natureza Financeira - Protheus

    Módulo "SIGAFIN" 

    Image Added

    Atualizações | Cadastros | Naturezas

    Image Added

    Natureza Cadastrada no BackOffice Protheus 

    Image Added


    Card
    idrmnatfin
    labelRM
    Aviso
    titleGeração do Código da Natureza Orçamentária Financeira

    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

    Aviso

    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. 

    Image Added


    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


                                                  Image Added


    Natureza Orçamentária Financeira enviada para o RM

    Image Added


    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 

    Image Added

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

    Image Added


    Aviso
    titleOBSERVAÇÃ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.

    Card
    iddeparaclifor
    labelDe/para

    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

    Card
    idrestricoesclifor
    labelRestrições

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

    Informações

    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.

    Card
    idACCOUNRECEIVABLEDOCUMENT
    labelAccounReceivableDocument

    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.

    Deck of Cards
    idinfornatfin
    Card
    idrmnatfin
    labelRM

    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 

      Nota

      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.pngImage Added


    • 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

    Image Added


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


    Geração de Lançamentos

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

    Image Added


    Deck of Cards
    idtitulos
    Card
    iditensdecontrato
    labelAssociaçã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 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.

    Card
    idlançamentoprocessoseletivo
    labelGeração do lançamento da taxa de inscrição no Processo Seletivo

    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

    Image Added


    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.

    Image Added


    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.

    Image Added


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

    Card
    idprotheusnatfin
    labelProtheus

    Titulo gerado para o BackOffice Protheus

    Módulo ( SIGAFIN )

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


    Image Added


    Título enviado para o Protheus

    Image Added

    Aviso

    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

    Image Added

    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.

    Image Added

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

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

    Image Added


    Card
    iddeparalançamento
    labelDe/para

    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

    Card
    idobservacaolancamento
    labelObservação
    Expandir
    titleReenvio de Mensagem EAI

    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.

    Expandir
    titleCancelamento de Lançamentos RM

    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.



    Card
    idbaixalanreceber
    labelListOfAccountReceivableSettlements

    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.

    Deck of Cards
    ididbaixalanreceber
    Card
    idrmbaixalan
    labelRM

    Baixa de titulo no RM

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

    Image Added


    Lançamento com juros, multa e bolsa incondicional

    Image Added


    O lançamento com status baixado na parcela vinculada.

    Image Added


    Cancelamento da baixa do lançamento 

    Image Added

    Image Added

    Image Added

    Card
    idprotheusbaixa
    labelProtheus

    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. Image Added

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

    Image AddedNo Protheus a título é apresentado baixado.

    Image Added


    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. 

    Image Added


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

    Image Added


    Card
    iddeparabaixalan
    labelDe/para

    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 

    Card
    idobservacaolancamento
    labelObservação
    Expandir
    titleReenvio de Mensagem EAI

    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.

    Expandir
    titleBaixa de Titulo com Valores Acessórios

    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.

    Expandir
    titleMotivo de Baixa
    Informações

    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:

    Expandir
    titleBaixa Automática de parcelas com valores zerados

    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.

    Image Added


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

    Image Added

    Card
    idgeracaodeacordo
    labelFinancingtranding

    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.

    Deck of Cards
    idgeracoacordoModulo
    Card
    idgeracoacordoEducacional
    labelEducacional
    Deck of Cards
    ididbaixalanreceber
    Card
    idrmbaixalan
    labelRM

    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

    Image Added

    Image Added


    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 

    Image Added

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

    Image Added

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

    Image Added

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

    Image Added


    Cancelamento de Acordo no RM

    Image Added



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

    Image Added

    Card
    idprotheusbaixa
    labelProtheus

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

    Image Added


    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.

    Image Added

    Aviso

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

    Image Added

    Card
    iddeparabaixalan
    labelDe/para

    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
    Card
    idobservacaolancamento
    labelObservação
    Expandir
    titleReenvio de Mensagem EAI

    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.

    Card
    idgeracoacordoEstoqueComprasFaturamento
    labelEstoque e Compras e Faturamento

    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.


    Deck of Cards
    idgeracoacordoEstoqueComprasFaturamentoModulo
    Card
    idgeracoacordoEstoqueComprasFaturamentoRM
    labelRM

    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.pngImage Added


    Aviso

    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 

    Image Added

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

    Image Added

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

    Image Added


    Cancelamento de Acordo no RM

    Image Added


    Card
    idgeracoacordoEstoqueComprasFaturamentoRM
    labelProtheus

    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.

    Image Added

    Aviso

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

    Image Added

    Card
    iddeparabaixalan
    labelDe/para

    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
    Card
    idlancamentopagar
    labelAccountpayableadocument

    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.

    Deck of Cards
    ididlancamentopagar
    Card
    idrmlancpagar
    labelRM

    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.

    Image Added


    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.

    Image AddedImage Added



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

    Image Added


    Card
    idprotheuslancpagar
    labelProtheus

    Titulo a pagar gerado para o BackOffice Protheus

    Módulo ( SIGAFIN )

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

    Image Added


    Título enviado para o Protheus

    Image Added


    Card
    iddeparabaixa
    labelDe/para

    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

    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.

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

    Card
    idobservacaolancamento
    labelObservação
    Expandir
    titleReenvio de Mensagem EAI

    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.

    Informações
    Card
    idACCOUNRECEIVABLEDOCUMENT
    labelAccounReceivableDocument

    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)

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

    • Cliente/Fornecedor
    • Banco / Agencia / Conta Corrente
    • Moeda
    • Item Contábil / Classe de Valor - (Quando utiliza esses campos na geração de lançamento)
    • 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".
    • Centro de Custo - (Quando utiliza o centro de custo na geração de lançamento)
    • Produto - (Quando utiliza o centro de custo na geração de lançamento)
    • Valor Acessório
    • Prefixo

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

    image2019-8-7_15-17-26.pngImage Removed

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

    Geração de Lançamentos

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

    Image Removed

    Titulo gerado para o BackOffice Protheus

    Módulo ( SIGAFIN )

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

    Image Removed

    Título enviado para o Protheus

    Image Removed

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

    Image Removed

    info

    Deck of Cards
    idinfornatfin
    Card
    idrmnatfin
    labelRM
    Card
    idprotheusnatfin
    labelProtheus
    Card
    iddeparalançamento
    labelDe/para
    Card
    idrestricoeslancamento
    labelRestrições