Histórico da Página

Deck of Cards

id	Mensagens - Adapters da Integração

Card

id	financeiro
label	Financeiro

Deck of Cards

id	inforfinanceiro

Card

id	CUSTOMERVENDOR
label	CustomerVendor

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

id	inforclifor

Card

id	protheusclifor
label	Protheus

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

id	rmclifor
label	RM

Informações

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

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

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

id	deparaclifor
label	De/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

id	restricoesclifor
label	Restriçõ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

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

Card

id	bank
label	Bank

Card

id	BANK
label	Bank

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

id	inforbanco

Card

id	protheusbanco
label	Protheus

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

id	rmbanco
label	RM

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

id	deparabanco
label	De/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

id	restricoesbank
label	Restriçõ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

title	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 Banco no TOTVS Gestão Financeira não tem a possibilidade de incluir o banco por filial.

Card

id	currency
label	Currency

Card

id	CURRENCY
label	Currency

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

id	inforcurrency

Card

id	protheuscurrency
label	Protheus

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

Atualizações | Cadastros | Moedas Contábeis

Cadastro de Moeda Realizado no Protheus

Card

id	rmcurrency
label	RM

Caminho para acesso ao cadastro do Moeda, no sistema:

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

Card

id	deparacurrency
label	De/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

id	restricoescurrency
label	Restrições

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

Informações

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

Card

id	listofcomplementaryvalue
label	ListOfComplementaryValue

Card

id	LISTOFCOMPLEMENTARYVALUE
label	ListOfComplementaryValue

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

id	inforcomplementaryvalue

Card

id	protheuscomplementaryvalue
label	Protheus

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

id	rmcomplementaryvalue
label	RM

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

id	deparacomplementaryvalue
label	De/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

id	restricoescomplementaryvalue
label	Restrições

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

Card

id	FINANCIALNATURE
label	FinancialNature

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

id	infornatfin

Card

id	protheusnatfin
label	Protheus

Cadastros Natureza Financeira - Protheus

Módulo "SIGAFIN"

Atualizações | Cadastros | Naturezas

Natureza Cadastrada no BackOffice Protheus

Card

id	rmnatfin
label	RM

Aviso

title	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

Card

id	rmnatfin
label	RM

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

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

Card

id	deparaclifor
label	De/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

id	restricoesclifor
label	Restriçõ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

id	FINANCIALNATUREACCOUNRECEIVABLEDOCUMENT
label	FinancialNatureAccounReceivableDocument

Deck of Cards

id	infornatfin

Card

id	protheusnatfin
label	Protheus

Card

id	rmnatfin
label	RM

Card

id	rmnatfin
label	RM

Card

id	deparaclifordeparalançamento
label	De/para

Card

id	restricoescliforrestricoeslancamento
label	Restrições

Informações

Páginas filhas

Versões comparadas

Versão antiga 4

Nova versão 5

Chave