Histórico da Página
...
O objetivo deste manual é descrever a integração entre o TOTVS Educacional com o BackOffice Protheus e suas formas sua forma de integração entre os seus processos e cadastrados. Atualmente temos três formas de
Atualmente a integração entre os dois sistemas é com a utilização do EAI – Enterprise Application Integration.Essas formas são:
- EAI 12.0Pacote de integração 1012: Nesse nesse pacote os lançamentos a receber e a pagar são gerados pelo TOTVS Educacional e enviado para o BackOffice Protheus para serem baixados quando é realizado o pagamento dos lançamentos pelo responsável financeiro do aluno. Porém a baixa desses títulos a receber e os títulos a pagar gerados pela integração do lado do RM, é realizada no TOTVS Educacional. Os cadastros básicos são continuam sendo realizados no BackOffice e enviados para o TOTVS Educacional. Exceto Protheus, exceto o cadastro de cliente e fornecedor que podem ser realizados nos dois sistemas. Os cadastros básicos são: banco, centro de custo, moeda, natureza financeira, plano de contas, item contábil, classe de valor, e etc. Para realização da conversão dessa integração
Aviso | ||
---|---|---|
| ||
A utilização da integração TOTVS Educacional x BackOffice Protheus no EAI 2.0 só poderá ser ativada quando todos os módulos do RM estiverem com seus adapters (mensagem única) convertido para o EAI 2.0 |
...
. Isso quer dizer que caso a base de dados tiver outras integrações entre os módulos do RM com os módulos do Protheus, todas as integrações devem estar migradas para o EAI 2.0. A liberação da integração do EAI 2.0 é realizada a partir da liberação de script para conversão da integração no EAI 1.0 para o EAI 2.0. |
Sistemas Envolvidos
- TOTVS Processo Seletivo – Módulo Educacional que gerencia os processos seletivos das escolas e faculdades, possibilitando o ingresso de alunos nas instituições por meio de vestibulares.
- TOTVS Gestão Bibliotecária – Módulo Educacional que gerencia as bibliotecas das escolas e faculdades (com diferentes unidades bibliotecárias).
- TOTVS Educacional – Módulo Educacional que gerencia escolas e faculdades (ensino básico e superior), por meio de ferramentas que permitem maior agilidade nos processos que envolvem os alunos, responsáveis, professores e os funcionários.
- TOTVS Gestão Financeira, Gestão Contábil e Gestão de Estoque/Compras e Faturamento – Módulos que gerenciam as operações financeiras, contábeis e fiscais
...
Nessa integração terá o mesmo comportamento do pacote de integração 1021 presente no EAI 1.0. Isso quer dizer que os lançamentos a receber e a pagar são gerados pelo TOTVS Educacional e enviado para o BackOffice Protheus. Porém a baixa desses títulos a receber e os títulos a pagar gerados pela integração do lado do RM, é realizada no TOTVS Educacional. Os cadastros básicos continuam sendo realizados no BackOffice Protheus. Exceto o cadastro de cliente e fornecedor que podem ser realizados nos dois sistemas.
Aviso title Atenção A utilização da integração TOTVS Educacional x BackOffice Protheus no EAI 2.0 só poderá ser ativada quando todos os módulos do RM estiverem com seus adapters (mensagem única) convertido para o EAI 2.0. Isso quer dizer que caso a base de dados tiver outras integrações entre os módulos do RM com os módulos do Protheus, todas as integrações devem estar migradas para o EAI 2.0.
A liberação da integração do EAI 2.0 é realizada a partir da liberação de script para conversão da integração no EAI 1.0 para o EAI 2.0.
Sistemas Envolvidos
- TOTVS Processo Seletivo – Módulo Educacional que gerencia os processos seletivos das escolas e faculdades, possibilitando o ingresso de alunos nas instituições por meio de vestibulares.
- TOTVS Gestão Bibliotecária – Módulo Educacional que gerencia as bibliotecas das escolas e faculdades (com diferentes unidades bibliotecárias).
- TOTVS Educacional – Módulo Educacional que gerencia escolas e faculdades (ensino básico e superior), por meio de ferramentas que permitem maior agilidade nos processos que envolvem os alunos, responsáveis, professores e os funcionários.
- TOTVS Gestão Financeira – Módulo Financeiro que gerencia as operações financeiras das escolas e faculdades, por meio de ferramentas que permitem maior agilidade nos processos que envolvem contas a pagar/receber, fluxo de caixa entre outros.
- BackOffice Protheus (Financeiro).
...
- TOTVS (Educacional, Processo Seletivo, Biblioteca, Financeiro, Contábil e Fiscal) -> PROTHEUS: Os dados são trafegados pelo fluxo normal até a fila de integração TBC, em que este irá consumir o WebService do EAI do Protheus para envio da(s) mensagem(s). Após a resposta do Protheus, o TOTVS Conector atualiza o registro com o status de processamento e demais dados, no monitor da fila de Mensagem Única.
- PROTHEUS -> TOTVS (Educacional, Processo Seletivo, Biblioteca, Financeiro), Contábil e Fiscal): O Protheus consume Protheus consume o WebService TOTVS Conector para recebimento de mensagens únicas. Sendo também responsável também responsável por encaminhar as mensagens para o TOTVS Conector, que processa e processa e encaminha o retorno de acordo com o tipo de comunicação definida (síncrona ou assíncrona).
Assim como definido no protocolo de comunicação de mensagens únicas, a comunicação pode ser efetuada de duas formasda seguinte forma:
- Síncrona: O sistema de origem gera uma mensagem de integração na fila e envia ao WebService de destino. O processo na origem aguarda o processamento da mensagem no destino e ao receber o retorno, atualiza o status do processamento na fila de integração.
- Assíncrona: O sistema de origem gera uma mensagem de integração na fila, envia ao WebService de destino e aguarda somente a confirmação de recebimento da mensagem. O processo na origem não fica parado aguardando o processamento da mensagem de destino.
Ao término do processamento da mensagem por parte do sistema de destino, este envia outra mensagem de retorno ao retorno ao sistema de origem com status do processamento. Lembrando que as mensagens assíncronas podem ser processadas (status pendente) ou reprocessadas (status erro) manualmente por meio do monitor da fila de integração
Aviso |
---|
Nas integrações entre o RM x Protheus as configurações devem seguir como determinado pelo Configurador EAI 2.0, e este sempre configura no método síncrono. |
Pré-requisitos instalação/implantação/utilização
Instalação do Biblioteca RM
Atenção: Para instalar qualquer módulo da linha RM, é necessário instalar da a Biblioteca RM o pacote o pacote que contém a maioria dos arquivos necessários para o funcionamento de todos os módulos, inclusive do TBC. (Mais detalhes acesso o documento Orientações para instalar BibliotecaRM). Os pré-requisitos instalação/implantação/utilização da integração pacote 1012 no EAI 1.0 clique aqui
Configurando WS do RM
Para informações da instalação do TBC, consulte os documentos de apoio abaixo:
...
Para a configuração do EAI acesso documento Configuração EAI Protheus
Configurar (RM e Protheus) para utilizar a Integração, campos complementares, parâmetros e cadastros obrigatórios
Acesso documento de apoio Configurações da Integração - Mensagem única TOTVS Educacional e Protheus
Adapters da Integração:
A seguir a listagem dos adapters da integração com a informação de envio e recebimento para cada sistema. Clique aqui para saber mais dos adapters do EAI 2.0
Rotina
Rotina |
Mensagem | Descrição | Protheus | RM | Canal | Operação | Versão | Alias do Protheus | |||
Envia | Recebe | Envia | Recebe | |||||||
ATFA012 | ASSETS | Ativo Fixo | Sim | Não | Não | Sim | EAI | Todas | 1.001 | SN1 |
CTBA010 | ACCOUNTINGCALENDAR | Calendário Contábil | Sim | Não | Não | Sim | EAI | Todas | 1.000 | CTG |
CTBA020 | ACCOUNTANTACCOUNT | Plano de Conta | Sim | Não | Não | Sim | EAI | Todas | 2. |
001 | CT1 | |||||||||
CTBA030 | COSTCENTER | Centro de Custo | Sim | Não | Não | Sim | EAI | Todas | 2.000 | CTT |
CTBA040A | ACCOUNTINGITEM | Item Contábil | Sim | Não | Não | Sim | EAI | Todas | 1.000 | CTD |
CTBA060 | CLASSVALUE | Classe de Valor | Sim | Não | Não | Sim | EAI | Todas | 1.000 | CTH |
CTBA102 | ACCOUNTINGENTRY | Lançamento Contábil | Não | Sim | Sim | Sim | EAI | Todas | 2. |
001 | CT2 | |||||||||
CTBA140 | CURRENCY | Moeda | Sim | Não | Não | Sim | EAI | Todas | 2.001 | CTO |
FINA010 | FINANCIALNATURE | Natureza Financeira | Sim | Não | Não | Sim | EAI | Todas | 2.000 | SED |
FINA040 | ACCOUNTRECEIVABLEDOCUMENT | Lançamento a receber | Não | Sim | Sim | Não | EAI | Todas | 2. |
005 | SE1 | |||||||||
FINA050 | ACCOUNTPAYABLEDOCUMENT | Lançamento a pagar | Não | Sim | Sim | Não | EAI | Todas | 2.001 | SE2 |
FINA130 | BANK | Banco | Sim | Não | Não | Sim | EAI | Todas | 2.001 | SA6 |
FINA460 | FINANCINGTRADING | Negociação (e cancelamento) de lançamento a receber | Não | Sim | Sim | Não | EAI | Atualização |
2. |
000 |
FO1 |
INTXATU01 |
INTERNALIDLOAD | Sincronização DE - PARA | Não | Sim | Sim | Não | EAI |
Todas | 1.000 | - |
MATA010 |
ITEM |
Produto | Sim | Não |
Não | Sim |
EAI |
Todas |
4. |
005 | SB1 |
MATA030 |
CUSTOMERVENDOR |
Cliente | Sim | Sim |
Sim | Sim |
EAI |
Todas |
2. |
002 |
SA1 |
MATA020 |
CUSTOMERVENDOR | Fornecedor | Sim | Sim | Sim |
Sim | EAI | Todas |
2. |
002 |
SA2 |
MATA035 |
STOCKGROUP | Grupo de Produto | Sim | Não | Não | Sim | EAI | Todas |
1. |
000 |
SBM |
MATA070 |
BANK |
Banco | Sim |
Não |
Não | Sim | EAI | Todas | 2. |
001 |
SA6 |
QIEA030 |
UNITOFMEASURE | Unidade de medida |
Sim |
Não |
Não | Sim | EAI | Todas | 2. |
000 |
SAH |
FINI070LST | LISTOFACCOUNTRECEIVABLESETTLEMENTS | Baixa a receber | Não | Sim |
Sim | Não |
EAI | Todas | 1. |
005 | FK1 |
FINI035LST |
LISTOFCOMPLEMENTARYVALUE |
Valores Acessórios |
Não | Sim |
Sim | Não |
EAI | Todas |
1. |
000 |
FKC |
AGRA045 |
WAREHOUSE |
Local de |
Estoque | Sim | Não | Não | Sim | EAI | Todas |
1.000 |
NNR |
MATA360 |
PAYMENTCONDITION |
Condição de Pagamento | Sim |
Não |
Não | Sim |
EAI | Todas |
2.000 |
SE4 |
MATA410 |
ORDER | Pedido de Vendas | Não | Sim | Sim | Não | EAI | Todas |
4. |
003 |
SC5 |
Tabelas De-Para
Todas as movimentações de mensagens, com algumas exceções, tanto para envio quanto para recebimento, resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações. Considerando as mensagens envolvidas nessas integrações, seguem as informações presentes no de-para e as observações devidas em cada uma.
Integração EAI 2.0 | Observação |
Aplicativo | Nome do aplicativo responsável pela integração entre os dois sistemas |
Tabela RM | Tabela de origem no RM onde os dados são enviados ou recebidos |
Campos RM | Campos da tabela que são utilizados na montagem da chave interna no sistema RM |
Valor RM | Valores dos campos da tabela que são utilizados na montagem da chave interna no sistema RM. |
Valores Externos | Valores dos campos da tabela do sistema que está sendo integrado com o sistema RM |
Transação | Nome na mensagem - adapter responsável por gerar e gerenciar o de-para |
Identificador Global | Identificador enviado na mensagem - adapter como chave de integração no de-para entre o sistema RM e o sistema de destino. Caso esse identificador estiver vazio, a integração envia o valor presente no campo "Valor RM". |
Documento para acessar os Parâmetros de Integração EAI 2.0
Seguir a descrição de cada adapters da integração e sua responsabilidade
...
Deck of Cards | ||||||
---|---|---|---|---|---|---|
| card||||||
id | financeiro | label | deckidinforfinanceiro | |||
Card | ||||||
| ||||||
Deck of Cards | ||||||
|
Card | ||||
---|---|---|---|---|
| ||||
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 |
id | rmclifor |
---|---|
label | RM |
Informações | ||
---|---|---|
| ||
Na integração EAI 2.0 no cadastro do cliente/fornecedor do TOTVS Gestão Financeira tem três campos novos que são:
|
Aviso | ||
---|---|---|
| ||
A geração do código do cliente/fornecedor na integração EAI 2.0 é gerado de duas formas, que sã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
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
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:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
FCFO
CODCOLIGADA|CODCFO
0|000000001
01||000000001|01|C
CUSTOMERVENDOR
FCFO
CODCOLIGADA|CODCFO
0|000000110
01||000000110|01|F
CUSTOMERVENDOR
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 | ||
---|---|---|
| ||
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. |
id | bank |
---|---|
label | Bank |
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.
id | inforbanco |
---|
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)
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
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:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
FCONTA
CODCOLIGADA|NUMBANCO|NUMAGENCIA|NROCONTA
1|104|1041|1234
T1||104|1041|1234
BANK
FCONTA
CODCOLIGADA|NUMBANCO|NUMAGENCIA|NROCONTA
1|341|9598|01214
T1||341|9598|01214
BANK
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
FCXA
CODCOLIGADA|CODCXA
1|2
T1|D MG 01|318|0001|00001
BANK
FCXA
CODCOLIGADA|CODCXA
1|3
T1|D MG 01|033|3477|01087756
BANK
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
FCONVENIO
CODCOLIGADA|IDCONVENIO
1|2
T1|D MG 01 |1
BANK
FCONVENIO
CODCOLIGADA|IDCONVENIO
1|3
T1|D MG |2
BANK
Card | |||||
---|---|---|---|---|---|
| |||||
A restrição da mensagem está relacionada ao tipo de compartilhamento da tabela SA6 no Protheus, para mais informações clique aqui.
|
id | currency |
---|---|
label | Currency |
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.
id | inforcurrency |
---|
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 | ||||
---|---|---|---|---|
| ||||
Caminho para acesso ao cadastro do Moeda, no sistema: Acesse BackOffice / Gestão Financeira / Movimentações Bancárias / Moedas e Índices |
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:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
GMOEDA
SIMBOLO
R$
T1|D MG 01|01
CURRENCY
GMOEDA
SIMBOLO
USD
T1|D MG 01|19
CURRENCY
Card | |||||
---|---|---|---|---|---|
| |||||
A restrição da mensagem está relacionada ao tipo de compartilhamento da tabela CTO, para mais informações clique aqui.
|
id | listofcomplementaryvalue |
---|---|
label | ListOfComplementaryValue |
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.
id | inforcomplementaryvalue |
---|
Card | ||||
---|---|---|---|---|
| ||||
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 | ||||
---|---|---|---|---|
| ||||
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 |
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:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
FPARAM
CODCOLIGADA|CODIGO
1|VALOROP4
T1|D MG 01|000007
COMPLEMENTARYVALUE
FPARAM
CODCOLIGADA|CODIGO
1|VALOROP5
T1|D MG 01|000008
COMPLEMENTARYVALUE
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.
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.
id | infornatfin |
---|
id | protheusnatfin |
---|---|
label | Protheus |
Cadastros Natureza Financeira - Protheus
Módulo "SIGAFIN"
Atualizações | Cadastros | Naturezas
Natureza Cadastrada no BackOffice Protheus
id | rmnatfin |
---|---|
label | RM |
Aviso | ||
---|---|---|
| ||
A geração do código da natureza orçamentária financeira na integração EAI 2.0 é gerado utilizando o parâmetro NATUREZAFINANCEIRAAUTOINC |
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 | ||
---|---|---|
| ||
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. |
id | deparaclifor |
---|---|
label | De/para |
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
TTBORCAMENTO
CODCOLIGADA|CODTBORCAMENTO
1|1
T1|D MG 01 |1
FINANCIALNATURE
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.
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.
id | contabil |
---|---|
label | Contábil |
id | infocontabil |
---|
id | accountingItem |
---|---|
label | AccountingItem |
id | ACCOUNTITEM |
---|---|
label | AccountingItem |
A mensagem de ACCOUNTINGITEM é utilizada para realizar o cadastro dos itens contábeis no TOTVS Educacional para que a integração entre o TOTVS Gestão Contábil e o Backoffice Protheus possa ocorrer.
Os cadastros de item contábil devem ser realizados no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no cadastro de unidade de medida 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.
id | inforAccountingItem |
---|
id | protheusAccountingItem |
---|---|
label | Protheus |
Cadastros Item Contábil - Protheus.
Módulo "SIGACTB"
Atualizações | Entidades | Item Conta
id | rmAccountingItem |
---|---|
label | RM |
Verificando no TOTVS Educacional cadastro dos Itens Contábeis enviado para o RM
Item Contábil cadastrada no TOTVS Educacional
Item Contábil é vinculado ao cadastro da Matriz Aplicada .
Matriz Aplicada | < Anexos > | Dados Financeiros – Integração Protheus
Ao gerar Contabilização por Competência, o evento contábil é parametrizado para buscar a informação de Item Contábil da Matriz Aplicada.
id | deparaAccountingItem |
---|---|
label | De/para |
Todas as movimentações da mensagem AccountingItem resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
SITEMCONTABILPROTHEUS
CODCOLIGADA|IDITEMCONTABIL
1|1
T1|D MG 01 |1
ACCOUNTINGITEM
Card | ||||
---|---|---|---|---|
| ||||
A restrição da mensagem está relacionada ao tipo de compartilhamento das tabelas CTD no Protheus, para mais informações, clique aqui.
Os itens contábeis enviados para o RM são cadastrados no TOTVS Educacional para que posam ser associados em matrizes aplicadas. |
id | classValue |
---|---|
label | ClassValue |
id | CLASSVALUE |
---|---|
label | ClassValue |
A mensagem de ClassValue é utilizada para realizar o cadastro das classes de valor no TOTVS Educacional para que a integração entre o TOTVS Gestão Contábil e o BackOffice Protheus possa ocorrer.
O cadastro da classe deve ser realizado no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no cadastro de unidade de medida 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.
id | inforClassValue |
---|
id | protheusClassValue |
---|---|
label | Protheus |
Cadastro da classe de valor do Protheus
Módulo "SIGACTB"
Atualizações | Entidades | Classe de Valor
Classe de Valor cadastrada
id | rmClassValue |
---|---|
label | RM |
Verificação no TOTVS Educacional das classes de valor enviado para o RM
Classe de Valor cadastrada no TOTVS Educacional
Classe de valor é vinculada ao cadastro da Matriz Aplicada.
Matriz Aplicada | < Anexos > | Dados Financeiros – Integração Protheus
Ao gerar Contabilização por Competência, o evento contábil é parametrizado para buscar a informação de Classe de valor da Matriz Aplicada.
id | deparaClassValue |
---|---|
label | De/para |
Todas as movimentações da mensagem ClassValue resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
SCLASSEVALORPROTHEUS
CODCOLIGADA|IDCLASSEVALOR
1|1
T1|D MG 01 |1
CLASSVALUE
Card | ||||
---|---|---|---|---|
| ||||
A restrição da mensagem está relacionada ao tipo de compartilhamento da tabela CTH no Protheus, para mais informações, clique aqui.
As classes de valor enviados para o RM são cadastrados no TOTVS Educacional para que posam ser associados em matrizes aplicadas. |
id | accountAntAccount |
---|---|
label | AccountAntAccount |
id | ACCOUNTANTACCOUNT |
---|---|
label | AccountAntAccount |
A mensagem de ACCOUNTANTACCOUNT é utilizada para realizar o cadastro dos planos de contas no TOTVS Gestão Contábil para que a integração entre o TOTVS Gestão Contábil e o Backoffice Protheus possa ocorrer.
O cadastro do plano de contas deve ser realizado no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no cadastro de unidade de medida 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.
id | inforAccountAntAccount |
---|
id | protheusAccountAntAccount |
---|---|
label | Protheus |
Cadastrando Plano de Contas no Protheus
Módulo Contábil "SIGACTB"
Atualizações | Entidades | Plano de Contas
Plano de Contas cadastrada no Protheus
id | rmAccountAntAccount |
---|---|
label | RM |
A máscara parametrizada da conta contábil no TOTVS Contabilidade Gerencial é validada no processo de inclusão da conta contábil. Portanto, o parâmetro de máscara contábil deve ser cadastrado de acordo com o formato do código da conta a ser enviado pelo Protheus. Caso o Protheus não envie máscara no código de conta, exemplo: 1011214, então o parâmetro Não utiliza máscara nas contas deve ser marcado, em cada coligada. Caso contrário, ocorrerá um erro no processo de inclusão da conta.
Caminho para acesso ao parâmetro para não utilizar máscara:
Acesse: BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros
01.01 – Plano de Contas / 01.01.01 – Plano de Contas contábil / Plano de Contas Contábil / Não utilizar máscara nas contas
No TOTVS Contabilidade Gerencial deve ser parametrizado para utilizar contas globais por padrão.
Caminho para acesso ao parâmetro para utilizar conta global:
Acesse: BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros
01.01 – Plano de Contas / 01.01.01 – Plano de Contas contábil / Plano Contas / Acessa conta globais
01.01 – Plano de Contas / 01.01.01 – Plano de Contas contábil / Plano Contas / Cadastrar como global por padrão
Verificando cadastro do Plano de Contas no RM.
Acesse: BackOffice / Contabilidade Gerencial / Cadastros / Contábil
Plano de Contas enviado para RM.
id | deparaAccountAntAccount |
---|---|
label | De/para |
Todas as movimentações da mensagem AccountAntAccount resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
CCONTA
CODCOLIGADA|CODCONTA
1|1
T1|D MG |1
ACCOUNTANTACCOUNT
Card | ||||
---|---|---|---|---|
| ||||
A restrição da mensagem está relacionada ao tipo de compartilhamento da tabela CT1 no Protheus, para mais informações, clique aqui.
|
id | COSTCENTER |
---|---|
label | CostCenter |
A mensagem COSTCENTER é responsável por receber os dados de centro de custo entre a integração TOTVS Educacional com BackOffice Protheus.
Os cadastros de centro de custo devem ser realizados no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no cadastro de centro de custo 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.
id | inforcentrocusto |
---|
id | protheuscentrocusto |
---|---|
label | Protheus |
Cadastros Centro de Custos - Protheus
Módulo "SIGACTB"
Atualizações | Entidades | Custos
Centro de Custo Cadastrado no Protheus
id | rmcentrocusto |
---|---|
label | RM |
Cadastros Centro de Custos - RM
Caminho para acesso ao cadastro do Centro de Custo, no sistema:
Acesse BackOffice / Gestão Contábil / Cadastro / Auxiliares / Centros de Custos
id | deparacentrocusto |
---|---|
label | De/para |
Todas as movimentações da mensagem CostCenter resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.
Centro de Custo
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
GCCUSTO
CODCOLIGADA|CODCCUSTO
1|1
T1|D MG 01 |1
COSTCENTER
Card | ||||
---|---|---|---|---|
| ||||
A restrição da mensagem está relacionada ao tipo de compartilhamento da tabela CTT no Protheus, para mais informações, clique aqui.
|
id | ACCOUNTINGCALENDAR |
---|---|
label | AccountingCalendar |
A mensagem ACCOUNTINGCALENDAR é responsável por enviar a informação de "Período contábil" do BackOffice Protheus com o TOTVS Educacional.
O cadastro de calendário contábil deve ser realizado no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no Período Contábil 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.
id | Protheus |
---|
label | Protheus |
---|
Cadastros de calendário contábil - Protheus
Módulo "SIGACTB"
Atualizações | Cadastros | Calendário Contábil
Inserção do calendário no Protheus
Preencha o código e as datas
label | RM |
---|
As informações de periodo contábil podem ser visualizadas nos parametros do Totvs Gestão contábil.
Acesse o Backoffice | Gestão contábil
Acesse a aba "Ambiente"
Acesse Parametros | Totvs Gestão Contábil
Selecione a opção "Fechamento" e avance
O período estará informado nesta tela
Ressaltamos que, com a integração EAI 2.0 habilitada, não haverá como atualizar este período pelo Totvs Gestão contábil.
A alteração será feita pelo Backoffice Protheus - Calendário Contábil.
Card | ||
---|---|---|
| ||
Por se tratar de um processo de Sincronização de datas, a inserção do Calendário Contábil no Protheus não gera De/Para. |
Card | ||
---|---|---|
| ||
|
id | estoque |
---|---|
label | Estoque |
id | Estoque |
---|
id | UNITOFMEASURE |
---|---|
label | UnitOfMeasure |
A mensagem UNITOFMEASURE é responsável por receber os dados de unidade de medida entre a integração BackOffice Protheus com o TOTVS Educacional.
Os cadastros de unidade de medida devem ser realizados no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no cadastro de unidade de medida 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.
id | infounidademedida |
---|
Card | ||||
---|---|---|---|---|
| ||||
Cadastro de Unidade de Medida - Protheus Módulo "SIGAEST" Atualizações | Cadastros | Unidade de Medida Unidade de Medida no Protheus |
id | RM |
---|---|
label | RM |
Cadastro de Unidade de Medida - RM
Acesse o módulo BackOffice | Gestão de Estoque, Compras e Faturamento
Unidade de Medida no RM
id | DePara |
---|---|
label | De/Para |
Todas as movimentações da mensagem Unitofmeasure resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
TUND
CODUND
UN
T1|UN
UNITOFMEASURE
Card | ||||
---|---|---|---|---|
| ||||
A restrição da mensagem está relacionada ao tipo de compartilhamento das tabelas SAH no Protheus, para mais informações clique aqui.
|
id | grupodeproduto |
---|---|
label | StockGroup |
A mensagem STOCKGROUP é responsável por receber os dados do grupo de produto entre a integração BackOffice Protheus com o TOTVS Educacional.
Os cadastros de grupo de produto devem ser realizados no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no cadastro de grupo de produto 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.
id | infogrupoproduto |
---|
id | Protheus |
---|---|
label | Protheus |
Cadastro de Grupo de Produto - Protheus
Módulo "SIGAEST"
Atualizações | Cadastros | Grupos
Grupo de Produto no Protheus
id | rm |
---|---|
label | RM |
Caminho para acesso a tabela de classificação, no sistema:
BackOffice / Gestão de Estoque, Compras e Faturamento / Cadastros / Tabelas de Classificação.
Grupo de produto no RM
As informações de grupo de produtos utilizam sempre a Tabela de Classificação 2 com o nome de Grupo de Produtos.
Os parâmetros de tabelas de classificação podem ser acessados, no caminho:
BackOffice / Gestão de Estoque, Compras e Faturamento / Ambiente / Parâmetros / Gestão de Estoque, Compras e Faturamento
04.01 – Parâmetros Gerais / 04.01.04 – Tabelas / 04.01.04.01 – Classificação
Marque as opções Usar em Produto, Usar em Item de Movimento e Usar em Movimento.
id | depara |
---|---|
label | De/Para |
Todas as movimentações da mensagem StockGroup resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
TTB2
CODCOLIGADA|CODTB2FAT
T1||0015
STOCKGROUP
Card | ||||
---|---|---|---|---|
| ||||
As restrições da mensagem está relacionada ao tipo de compartilhamento das tabelas SBM no Protheus, para mais informações clique aqui.
|
id | produto |
---|---|
label | Item |
A mensagem ITEM é responsável por receber e enviar os dados do produto entre a integração BackOffice Protheus com o TOTVS Educacional.
Os cadastros de produto devem ser realizados no BackOffice Protheus, as alterações a serem feitas no cadastro de grupo de produto 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.
id | infoproduto |
---|
id | protheus |
---|---|
label | Protheus |
Cadastro de Grupo de Produto - Protheus
Módulo "SIGAEST"
Atualizações | Cadastros | Produto
Produto no Protheus
id | rm |
---|---|
label | RM |
Informações importantes sobre o cadastro de produtos:
O cadastro de produto é utilizado somente para vínculo com o serviço do Educacional e envio posterior junto com o lançamento a receber para o Backoffice Protheus, por isso são utilizados os campos código e descrição do produto.
As definições Máscara e Opções para a Máscara de produto devem ser alteradas para QQQQQQQQQQQQQ e Não controla níveis de máscara respectivamente, para que o RM aceite os produtos enviados pelo Protheus na integração.
Acesse: BackOffice / Gestão de Estoque, Compras e Faturamento / Ambiente / Parâmetros / Gestão de Estoque, Compras e Faturamento
04.01 – Parâmetros Gerais / 04.01.04 – Tabelas / 04.01.04.01 – Definições Gerais
Caso possua no Protheus informações de unidade de medida e grupo de produtos, são enviados antes pela integração por meio das mensagens: UnitOfMeasure e StockGroup,
Caminho para o cadastro de produtos no TOTVS Gestão de Estoque, Compras e Faturamento:
Acesse: BackOffice / Gestão de Estoque, Compras e Faturamento / Cadastros / Produto
Produto no RM
Caminho para a parametrização do produto para a integração com o Protheus:
Acesse: Educacional / Educacional / Financeiro/Contábil / Serviços
Anexo: Dados financeiros - Integração Protheus
No cenário em que o Protheus possua compartilhamento por Empresa e por Filial para o produto, o TOTVS Gestão de Estoque, Compras e Faturamento deve ser parametrizado para utilizar um cadastro de produto global. Dessa maneira, todos os produtos são cadastrados na coligada 0 assumindo o comportamento de compartilhados para todas as coligadas.
Vale ressaltar que quando o produto não é global no RM, os seus dados são replicados para cada coligada configurada para a integração com o Protheus.
Caminho para acesso ao parâmetro para permitir o cadastro global:
Acesse BackOffice / Gestão de Estoque, Compras e Faturamento / Ambiente / Parâmetros / Gestão de Estoque, Compras e Faturamento 04.01 – Parâmetros Gerais / 04.01.04 – Tabelas / 04.01.04.07 – Produtos / 04.01.04.07.07 –Produto Global / Usa Produto Global
Importante: Essa configuração é realizada somente caso o Protheus tenha um compartilhamento por Empresa.
id | depara |
---|---|
label | De/Para |
Todas as movimentações da mensagem Item resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
TPRODUTO
CODCOLPRD|IDPRD
T1||001
ITEM
Quando o RM estiver configurado para produto global, o cadastrado do “De/Para” do produto no RM irá considerar a coligada 0 para a montagem do “de/para”.
Exemplo:
Tabela RM
Campos RM
Valor RM
Valores Externos
Transação
TPRODUTO
CODCOLPRD|IDPRD
T1||001
ITEM
id | restricoes |
---|---|
label | Restrições |
As restrições da mensagem está relacionada ao tipo de compartilhamento das tabelas SBM no Protheus, para mais informações clique aqui.
Quando no RM está cadastrado a coligada em Integração / EAI 2.0 / Aplicativos como:
Carga Inicial
Para utilização da rotina de carga inicial dos dados, acesse o documento Carga inicial dos dados de cadastro.
Configurador
O Configurador do EAI 2.0 deve ser executado por aqueles que desejam implantar a integração entre os sistemas RM x PROTHEUS.
Para utilização da rotina de configurador, acesse o documento RM x PROTHEUS - Configurador EAI 2.0.