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.
Deck of Cards
idMensagens - Adapters da Integração
Card
idfinanceiro
labelFinanceiro
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".

Base de dados | Dicionário | Bases de Dados

Grupo de Campos = Alterar o tamanho 

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

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

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.

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


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

A configuração para cliente/fornecedor global é realizada somente caso o Protheus tenha um compartilhamento por 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
labelBank
Card
idBANK
labelBank

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. 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 ). É 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)


Card
idrmbanco
labelRM

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


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


Conta Caixa

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

FCXA

CODCOLIGADA|CODCXA

1|2

T1|D MG 01|318|0001|00001

BANK

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

FCXA

CODCOLIGADA|CODCXA

1|3

T1|D MG 01|033|3477|01087756

BANK



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

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 restrição da mensagem está relacionada ao tipo de compartilhamento da tabela SA6 no Protheus, 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 Banco no TOTVS Gestão Financeira não tem a possibilidade de incluir o banco por filial. 

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) 

Atualizações | Cadastros | Moedas Contábeis

Cadastro de Moeda Realizado no Protheus


Card
idrmcurrency
labelRM

Caminho para acesso ao cadastro do Moeda, no sistema:

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

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. 

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 

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

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

Módulo "SIGAFIN"

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

Título enviado para o Protheus

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

Valores Acessórios 

Card
idrmcomplementaryvalue
labelRM

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

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" 

Atualizações | Cadastros | Naturezas

Natureza Cadastrada no BackOffice Protheus 


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

Card
idrmnatfin
labelRM

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

                                              

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


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.


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
idFINANCIALNATUREACCOUNRECEIVABLEDOCUMENT
labelFinancialNatureAccounReceivableDocument
Deck of Cards
idinfornatfin
Card
idprotheusnatfin
labelProtheus


Card
idrmnatfin
labelRM
Card
idrmnatfin
labelRM


Card
iddeparaclifordeparalançamento
labelDe/para

Card
idrestricoescliforrestricoeslancamento
labelRestrições
Informações