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

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



      Novidade 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

      Geração do Código do Cliente/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

      ATENÇÃO

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

      Integraçã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.

      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

      Cadastro de Cliente no Papel de Trabalho

      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

          Integraçã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.

          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 


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

              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.


              OBSERVAÇÃO

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

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

              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.