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 processo que envolvem contas a pagar/receber, fluxo de caixa entre outros.

BackOffice Protheus (Financeiro).

Integração

Melhoria na integração dos sistemas TOTVS Educacional, TOTVS Processo Seletivo, TOTVS Gestão Bibliotecária e o BackOffice do Protheus (Financeiro), por meio da mensagem única.

Atualmente já existe uma integração entre os produtos, mas que é restrita a troca de algumas outras informações que são enviadas pelo Protheus. Feito a reestruturação e adequação com a criação desta nova integração para envio de informações do TOTVS Educacional para o Protheus.

Definição de Mensagem Única – TotvsMessage

Com o objetivo de padronizar as integrações com os produtos, foi definida a utilização da diretriz para os projetos de integração que todos os produtos devem trabalhar com a mensagem XML única, evitando desta forma, o processo de transformação de mensagens.

Neste cenário, temos o seguinte quadro:

Qualquer dos produtos são executados com o mesmo XML para uma mesma entidade, ou seja, caso um arquivo XML corresponda a mensagem de clientes, pode ser enviado para qualquer um dos produtos que suporte o recebimento desta entidade, como no diagrama abaixo:

A mensagem única torna uniforme a execução destes arquivos XML pelos aplicativos, principalmente para a capacidade de rastreamento.

Todos os processos devem respeitar o fluxo normal de troca de mensagens no padrão de Mensagem Única TOTVS.

Este fluxo pode ocorrer nos seguintes sentidos:

- TOTVS (Educacional, Processo Seletivo, Biblioteca, Financeiro) -> 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): O Protheus consume o WebService TOTVS Conector para recebimento de mensagens únicas. Sendo também responsável por encaminhar as mensagens para o TOTVS Conector, que processa e encaminha o retorno de acordo com o tipo de comunicação definida (síncrona ou assíncrona).

Para mais informações sobre o fluxo dos dados internos ao TBC, vide documentação: TOTVS Business Connect

Assim como definido no protocolo de comunicação de mensagens únicas, a comunicação pode ser efetuada de duas formas:

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

Pré-requisitos instalação/implantação/utilização

Atenção: Para instalar qualquer módulo da linha RM, é necessário instalar da Biblioteca RM 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)

Configurando WS do RM

Para informações da instalação do TBC, consulte os documentos de apoio abaixo:

- Para instalação do TBC através do host acesse o documento Como Expor os Web Services do RM através do Host
- Para Instalação do TBC através do IIS acesse o documento Instalação do TBC no IIS

Instalação do Protheus V12 e configuração do AppServer e Dbaccess

Acesse os documentos de apoio abaixo para instalação e configuração.

- - Guia de instalação Protheus 12 e Dbaccess
  - Configuração do AppServer e Dbaccess

Como Configurar EAI do Protheus

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:

Rotina	Mensagem	Envia	Recebe	Canal	Operação	Versão	Alias
ATFA012	ASSETS	Sim	Não	EAI	Todas	1.001	SN1
CTBA010	ACCOUNTINGCALENDAR	Sim	Não	EAI	Todas	1.000	CTG
CTBA020	ACCOUNTANTACCOUNT	Sim	Não	EAI	Todas	2.000	CT1
CTBA030	COSTCENTER	Sim	Não	EAI	Todas	2.000	CTT
CTBA040	ACCOUNTINGITEM	Sim	Não	EAI	Todas	1.000	CTD
CTBA060	CLASSVALUE	Sim	Não	EAI	Todas	1.000	CTH
CTBA102	ACCOUNTINGENTRY	Não	Sim	EAI	Todas	2.000	CT2
CTBA140	CURRENCY	Sim	Não	EAI	Todas	2.001	CTO
FINA010	FINANCIALNATURE	Sim	Não	EAI	Todas	2.000	SED
FINA040	ACCOUNTRECEIVABLEDOCUMENT	Sim	Sim	EAI	Todas	2.002	SE1
FINA050	ACCOUNTPAYABLEDOCUMENT	Não	Sim	EAI	Todas	2.001	SE2
FINA070	ACCOUNTRECEIVABLEDOCUMENTDISCHARGE	Sim	Sim	EAI	Atualização	2.001	-
FINA070	REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE	Sim	Não	EAI	Exclusão	2.000	-
FINA130	BANK	Sim	Não	EAI	Todas	2.001	SA6
FINA280	FINANCINGTRADING	Sim	Não	EAI	Atualização	1.002	-
FINA280	REVERSALOFFINANCINGTRADING	Sim	Não	EAI	Exclusão	1.000	-
FINA460	FINANCINGTRADING	Sim	Não	EAI	Atualização	1.002	-
FINA460	REVERSALOFFINANCINGTRADING	Sim	Não	EAI	Exclusão	1.000	-
FINI070A	UPDATECONTRACTPARCEL	Sim	Não	EAI	Todas	1.002	-
FINI150A	OURNUMBERBANKING	Sim	Não	EAI	Todas	1.000	-
INTXATU01	INTERNALIDLOAD	Não	Sim	EAI	Todas	1.000	-
MATA010	ITEM	Sim	Não	EAI	Todas	3.007	SB1
MATA020	CUSTOMERVENDOR	Sim	Sim	EAI	Todas	2.002	SA2
MATA030	CUSTOMERVENDOR	Sim	Sim	EAI	Todas	2.002	SA1
MATA035	STOCKGROUP	Sim	Não	EAI	Todas	1.000	SBM
MATA070	BANK	Sim	Não	EAI	Todas	2.001	SA6
QIEA030	UNITOFMEASURE	Sim	Não	EAI	Todas	2.000	SAH
FINI070LST	LISTOFACCOUNTRECEIVABLESETTLEMENTS	Não	Sim	EAI	Todas	1.005	-
FINI035LST	LISTOFCOMPLEMENTARYVALUE	Não	Sim	EAI	Todas	1.000	-
APCFG060	WHOIS	Sim	Sim	EAI	Todas	1.000	-

Novos Adapters ( LISTTOFACCUNTRECEIVABLESETTLEMENTS e LISTOFCOMPLENTARYVALUE )

Novidade: Na nova versão 1.005 do adapter LISTTOFACCUNTRECEIVABLESETTLEMENTS tem a nova tag "CustomPaymentMethod" para ter o motivo de baixa 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 (Protheus)" nesse campo o usuário deverá informar o motivo de baixa conforme presente no Protheus em "SigaFin → Miscelanea → Arquivos → Tabela Mot. Baixas". A tag "PaymentMethod" terá o valor fixo "999"

Não informando o motivo de baixa o RM enviará o código 015 para baixa automática e código 007 para qualquer outra, motivos de baixa código 007 e 015 não poderão ser cadastrados no Protheus, porém para funcionar a baixa do lado do Protheus deverá ser cadastrado os códigos NOR para 007 e BOL para 015

Segue as versões do RM e do Protheus com essa nova versão do adapter:

RM:
- Versões:
  - 12.1.17 a partir do patch 12.1.17.375
  - 12.1.21 a partir do patch 12.1.21.260 ou superior
Protheus
- Versões
  - 12.1.17 com pacote https://suporte.totvs.com/portal/p/10098/download?e=774810
  - 12.1.23 com pacote https://suporte.totvs.com/portal/p/10098/download?e=774811
  - 12.1.25 com pacote https://suporte.totvs.com/portal/p/10098/download?e=774812

O adapter WHOIS é utilizado para testar a conectividade entre a integração no sentido RM para o Protheus. E seu retorno são os adapters cadastrados no Protheus. É necessário o adapter estar cadastro no Protheus, e no RM é necessário a execução do configurador (Módulo Integração -> Menu Integração -> Ferramentas -> Configurar) para que o adapter seja inserido a integração.

- Caso alguma mensagem esteja configurada com o método Assíncrono, acesse o Configurador (SIGACFG) em Ambiente / Schedule / Schedule e configure um agente e um agendamento.
  (Mais detalhes acesso o documento Configuração EAI Protheus)

Novo código de Identificador da Integração : 1021

Nível de compartilhamento

Caso o Protheus esteja configurado para utilizar o compartilhamento das tabelas por Grupo de Empresa, deve ser realizada as configurações necessárias conforme documentação Compartilhamento por grupo de empresas

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 os registros De-Para que serão registrados ao enviar ou receber uma mensagem, como exemplo:

Mensagem Currency (Moeda)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
GMOEDA	SIMBOLO	R$	PROTHEUS	01\|\|01
GMOEDA	SIMBOLO	US$	PROTHEUS	01\|\|02

Mensagem CostCenter (Centro de Custo)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
GCCusto	CODCOLIGADA\|CODCCUSTO	1\|100000000	PROTHEUS	01\|01AM \|100000000
GCCusto	CODCOLIGADA\|CODCCUSTO	1\|100000002	PROTHEUS	01\|01AM \|100000002

Mensagem CustomerVendor (Cliente/Fornecedor)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
FCFO	CODCOLIGADA\|CODCFO	0\|000000001	PROTHEUS	01\|\|000000001\|01\|C
FCFO	CODCOLIGADA\|CODCFO	0\|000000110	PROTHEUS	01\|\|000000110\|01\|F

Mensagem Bank (Banco/Agência/Conta Corrente/Conta Caixa/Convênio)

Banco / Agência / Conta Corrente

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
FConta	CODCOLIGADA\|NUMBANCO\|NUMAGENCIA\|NROCONTA	2\|001\|0455 \|012453	PROTHEUS	01\|02AM0001\|001\|0455\|012453
FConta	CODCOLIGADA\|NUMBANCO\|NUMAGENCIA\|NROCONTA	2\|033\|4268 \|01001459	PROTHEUS	01\|01AM0001\|033\|4268\|01001459

Conta Caixa

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
FCxa	CODCOLIGADA\|CODCXA	2\|01001459	PROTHEUS	01\|01AM0001\|033\|4268\|01001459
FCxa	CODCOLIGADA\|CODCXA	2\|012453	PROTHEUS	01\|02AM0001\|001\|0455\|012453

Convênio

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
FCONVENIO	CODCOLIGADA\|IDCONVENIO	2\|19	PROTHEUS	01\|02AM0001\|001\|0455\|012453
FCONVENIO	CODCOLIGADA\|IDCONVENIO	2\|22	PROTHEUS	01\|01AM0001\|033\|4268\|01001459

Mensagem AccounReceivableDocument (Lançamentos a receber)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
FLAN	CODCOLIGADA\|IDLAN	2\|1380	PROTHEUS	01\|01AM0001\|\|68\|1\|002
FLAN	CODCOLIGADA\|IDLAN	2\|1381	PROTHEUS	01\|01AM0001\|\|69\|2\|002

Mensagem FinancialTrading (Negociação de Lançamentos a receber)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
FACORDO	CODCOLIGADA\|IDACORDO	2\|36	PROTHEUS	01\|01AM0001\|L000016
FACORDO	CODCOLIGADA\|IDACORDO	2\|37	PROTHEUS	01\|01AM0001\|L000017

Mensagem OurNumberBanking (Nosso Número Bancário )

Não haverá registro na tabela De-Para para essa requisição.

Mensagem AccountingItem (Item Contábil)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
SITEMCONTABILPROTHEUS	CODCOLIGADA\|IDITEMCONTABIL	2\|10	PROTHEUS	01\|01AM \|02
SITEMCONTABILPROTHEUS	CODCOLIGADA\|IDITEMCONTABIL	2\|11	PROTHEUS	01\|01AM \|03

Mensagem ClassValue (Classe de Valor)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
SCLASSEVALORPROTHEUS	CODCOLIGADA\|IDCLASSEVALOR	2\|10	PROTHEUS	01\|01AM0001\|01
SCLASSEVALORPROTHEUS	CODCOLIGADA\|IDCLASSEVALOR	2\|11	PROTHEUS	01\|01AM0001\|01.01

Mensagem Item (Produto)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
TPRODUTO	CODCOLIGADA\|IDPRD	2\|16	PROTHEUS	01\|\|1
TPRODUTO	CODCOLIGADA\|IDPRD	2\|17	PROTHEUS	01\|\|2

Caso o RM estiver configurado para produto global, o cadastrado do “de/para” do produto no RM irá considerar a coligada corrente para a montagem do “de/para”. E na geração do lançamento financeiro da parcela do contrato onde o serviço foi vinculado ao produto. A integração irá enviar o produto conforme o “de/para” do produto durante o seu cadastro. Vale ressaltar quando o produto é global no RM, os seus dados são replicados para cada coligada configurada para a integração com o Protheus. Esse comportamento estar presente somente na versão do EAI 1.0.

Exemplo:

No Protheus temos o produto “Caixa Box” com código 19 da entidade 01. O valor da chave de integração é 01||19. No momento do cadastro do produto “Caixa Box” no Protheus, a integração cadastrar o “de/para” desse produto no RM na coligada 1 com o seu identificador 100. Assim o valor da primária no RM será 1|100.

O produto “Caixa Box” presente no sistema da RM é vinculado aos serviços “mensalidade” da coligada 1, e “mensalidade padrão” da coligada 9. Assim na geração do lançamento financeiro para a parcela do contrato da coligada 1 e 9 com seus respectivos serviços, a integração ao irá enviar o “de/para” “1|100” para o Protheus gerar o título de cobrança. Visto que esse “de/para” estar presente nos dois sistemas.

Mensagem StockGroup (Grupo de Produtos)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
TTb2	CODCOLIGADA\|CODTB2FAT	1\|0076	PROTHEUS	01\|\|0076
TTb2	CODCOLIGADA\|CODTB2FAT	1\|0077	PROTHEUS	01\|\|0077

Mensagem UnitOfMeasure (Unidade de Medida)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
TUnd	CODUND	TS	PROTHEUS	01\|\|TS
TUnd	CODUND	T1	PROTHEUS	01\|\|T1

Mensagem OurNumberBanking (Nosso Número Bancário )

Não haverá registro na tabela De-Para para essa requisição.

Mensagem Assets (Ativos Fixos)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
IPATRIMONIO	CODCOLIGADA\|IDPATRIMONIO	1\|1	PROTHEUS	01\|\|01
IPATRIMONIO	CODCOLIGADA\|IDPATRIMONIO	1\|1	PROTHEUS	01\|\|02

Mensagem AccountPayableDocument (Contas a Pagar)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
FLAN	CODCOLIGADA\|IDLAN	2\|1380	PROTHEUS	01\|01AM0001\|\|68\|1\|002
FLAN	CODCOLIGADA\|IDLAN	2\|1381	PROTHEUS	01\|01AM0001\|\|69\|2\|002

Mensagem LISTOFACCOUNTRECEIVABLEDOCUMENTSETTLEMENTS (Contas a Receber)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
FLAN	CODCOLIGADA\|IDLAN	2\|1380	PROTHEUS	01\|01AM0001\|\|68\|1\|002
FLAN	CODCOLIGADA\|IDLAN	2\|1381	PROTHEUS	01\|01AM0001\|\|69\|2\|002

Mensagem LISTOFCOMPLEMENTARYVALUE (Valores Complementares do Contas a Receber)

Tabela RM	Chave Primária RM	Valor Chave Primária RM	Sistema Integrado	Valor Chave Integração
FLAN	CODCOLIGADA\|IDLAN	2\|1380	PROTHEUS	01\|01AM0001\|\|68\|1\|002
FLAN	CODCOLIGADA\|IDLAN	2\|1381	PROTHEUS	01\|01AM0001\|\|69\|2\|002

Carga Inicial

Para utilização da rotina de carga inicial dos dados, acesse o documento Carga inicial dos dados de cadastro.

Cadastros

Cadastros Especiais

É necessário realizar o cadastro manualmente no Protheus e no RM e posteriormente configurar o de/para para a integração correspondente. Ambos produtos, RM e Protheus, possuem interfaces específicas para esta finalidade

Empresa e Filial

Cadastro de De/Para no RM

Módulo ( Integração )

Integrações | RM Conector | Mensagem Única | De-Para

Tabela = GFILIAL

Chave Primária RM = CODCOLIGADA|CODFILIAL

Valor Chave Primária RM = COLIGADA E FILIAL DO RM

Sistema Integrado = PROTHEUS

Valor Chave Integração = Empresa e Filial do Protheus

Cadastro De/Para - Protheus

Módulo ( SIGACFG )

Ambiente | Schedule | Emp.filial Mensagem Única

Cadastros comuns

Cadastros MOEDA - Protheus

Módulo ( SIGACTB )

Atualizações | Cadastros | Moedas Contábeis

Cadastro de Moeda Realizado no Protheus

Moeda

Identificador da Mensagem: Currency

Versão: 2.001

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono

Cadastros Centro de Custos - Protheus

Módulo ( SIGACTB )

Atualizações | Entidades | Custos

Centro de Custo Cadastrado no Protheus

Caminho para acesso ao cadastro do Centro de Custo, no sistema:

Acesse BackOffice / Gestão Financeira / Contabilidade / Centro de Custo

Centro de custo

Identificador da Mensagem: CostCenter

Versão: 2.000

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono

Cadastros Classe de Valor - Protheus

Módulo ( SIGACTB )

Atualizações | Entidades | Custos

Cod Cl Val

Classe de Valor cadastrada

Integrações | Protheus | Classe de Valor

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.

Classe de Valor

Identificador da Mensagem: ClassValue

Versão: 1.000

Módulo Educacional: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono

Cadastros Item Contábil - Protheus

Módulo ( SIGACTB )

Atualizações | Entidades | Custos

Item Conta

Item Contábil enviado para o RM

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.

Item contábil

Identificador da Mensagem: AccountingItem

Versão: 1.000

Módulo Educacional: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono

Cadastros Cliente / Fornecedor - Protheus

Configurar Protheus para uso do cadastro de Cliente / Fornecedor

Módulo ( SIGACFG )

Base de dados | Dicinário | Bases de Dados

Grupo de Campos = Alterar o tamanho

Dicionário de Dados

Localizar as Tabelas ( SA1 e SA2 )

Editar ambas as Tabelas

Localizar o campo ( A1_LOJA ) = Editar

Aba ( Opções )

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

Informações importantes sobre o cadastro de clientes:

O cadastro de cliente/fornecedor é utilizado por ambos os lados. Os cadastrados podem ser realizados no BackOffice Protheus ou no TOTVS Gestão Financeira.

O código de Cliente/Fornecedor é gerado de acordo com a parametrização do TOTVS Gestão Financeira.

É gerado um código incremental de acordo com a máscara cadastrada. Se o sistema estiver integrado ao Protheus por mensageria única, será permitido a inclusão de uma máscara vazia.

Se for definida uma 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 parâmetro para utilização de código sequencial numérico deve ser desabilitado caso a integração Educacional x BackOffice Protheus esteja ativa.

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

Para o cenário em que o Protheus tiver um compartilhamento por Empresa, o TOTVS Gestão Financeira deve ser parametrizado para utilizar clientes globais.
Acesse: BackOffice / 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

A configuração para cliente global é realizada somente caso o Protheus tenha um compartilhamento por Empresa.

Cadastro do Cliente Fornecedor do RM

Gestão Financeira

Cliente / Fornecedor cadastrado no RM

Integrações | Integração Protheus | Fornecedor

Para gerar um lançamento a pagar é preciso vincular um Fornecedor no cadastro do Cliente.

Verificando cadastro do Cliente / Fornecedor no Protheus

Módulo ( SIGAFIN )

Atualizações | Cadastros | Clientes

Cliente enviado para Protheus

Cliente/Fornecedor

Identificador da Mensagem: CustomerVendor

Versão: 2.002

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono

Cadastro de Cliente e Fornecedor pode ser feito no BackOffice Protheus e enviado para o RM

Cadastros Natureza Financeira - Protheus

Módulo ( SIGAFIN )

Atualizações | Cadastros | Naturezas

Natureza Cadastrada no BackOffice Protheus

Caminho para acesso ao cadastro de naturezas no sistema: BackOffice / Gestão Financeira

Cadastros | Natureza Orçamentária Financeira

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

TOTVS Educacional - Financeiro / Contábil | Serviços

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.

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.

Natureza Financeira

Identificador da Mensagem: FinancialNature

Versão: 2.000

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono

Cadastros BANCO - Protheus

Informações importantes sobre o cadastro de bancos:

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

Como o cadastro é realizado no Protheus, os cadastros do TOTVS Gestão Financeira são desabilitados para inclusão e exclusão, caso o parâmetro utilize integração com Protheus e esteja habilitado tendo a integração Educacional x BackOffice Protheus ativa.

Os campos preenchidos pela integração são desabilitados e apenas informações pertinentes do TOTVS Gestão Financeira podem ser editados.

Quando o banco é usado em modo de compartilhamento exclusivo no Protheus, ao cadastrar o mesmo banco em filiais diferentes no Protheus e criado contas/caixas para cada filial no RM.

Tem que estar preenchido o campo: Nome Comercial da Empresa para que possa ser enviado o convênio ao TOTVS Educacional e a TAG obrigatória se preenchida como Código Cedente explicado anteriormente.

Cadastro de Banco / Agência / Conta Corrente / Conta Caixa no BackOffice Protheus

SIGACFG ( Ambiente | Empresa | Filial )

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

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

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

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 )

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

Quando é cadastrado mais de um Contrato Bancário / Parâmetros de banco no Protheus, o sistema irá criar mais de um convênio para uma mesma conta/caixa no RM.

Bancos

Identificador da Mensagem: Bank

Versão: 2.001

Módulo Gestão Financeira: RM

Módulo Protheus: Protheus

Tipo de Envio: Síncrono

Cadastros PERÍODO CONTÁBIL

No processo de integração, o RM atualiza as datas do período contábil sempre de acordo com a menor data inicial e a maior data final enviada pelo Protheus. No Protheus, essas informações são armazenadas em um cadastro, e no RM essas informações são armazenadas nos parâmetros, sendo assim, apenas há espaço para armazenar somente uma dataIncial e uma dataFinal.

Cadastrando peíodo Contábil no Módulo Contábil Protheus

( SIGACTB ).

Atualizações | Cadastros | Calendário Contábil

Calendário cadastrado.

Para vefiricar o Cadastro do Calendário no RM o caminho é :

Acesse: BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros / TOTVS Contabilidade Gerencial

01.04 – Fechamento / 01.04.01 – Fechamento Mensal

Período Contábil

Identificador da Mensagem: AccountingCalendar

Versão: 1.000

Módulo Educacional: RM

Módulo Protheus: Protheus

Tipo de Envio:

Cadastros PLANO DE CONTAS

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

Cadastrando Plano de Contas no Módulo Contábil do Protheus ( SIGACTB ).

Atualizações | Entidades | Plano de Contas

Plano de Contas cadastrada no Protheus

Verificando cadastro do Plano de Contas no RM.

Acesse: BackOffice / Contabilidade Gerencial / Cadastros / Contábil

Plano de Contas enviado para RM.

Plano de Contas

Identificador da Mensagem: AccountAntAccount

Versão: 2.000

Módulo Gestão Contábil: RM

Módulo Protheus: Protheus

Contabilização por Competência

Documentação de configuração da integração Contábil encontra-se no Link ao lado: TOTVS Educacional x BackOffice Protheus - Contábil

Entrando no Módulo TOTVS Educacional

Financeiro / Contábil | Contabilidade | Eventos Contábeis

Criando evento Contábil no TOTVS Educacional

Eventos cadastrados no TOTVS Educacional .

- - Evento Contrato
  - Evento Parcela

Plano de contas informado no cadastro do Evento ( Plano de Contas cadastrado no SIGACTB do Protheus

Parametrizado no Evento contábil para buscar a informação de Item Contábil e Classe de Valor da Matriz Aplicada , conforme já foi explicado no cadastro de Ambos.

Gerando a contabilização :

Pelo Contrato em Processos | Gerar Contabilização ou em :

Financeiro / Contábil | Contabilidade

Contabilização Gerada

Verifiando Lançamento Contábeis no Protheus ( SIGACTB )

Atualizações | Movimentos | Lancam Contabeis

Lançamentos enviados para o Protheus

Geração de Lançamentos

Campo fica bloqueado apenas para este padrão ( Não Contábil )

Com a Nova Integração agora passou a ser obrigatório o envio dos Campos Complementares do TOTVS Gestão Financeira para BackOffice Protheus ( Valor Acessório )

BackOffice | Gestão Fianceira

Ambiente | Parâmetros | TOTVS Gestão Financeira

02.02 – Contas a Receber

Valores Opcionais cadastrados no TOTVS Gestão Financeira

Verificando os Valores Acessórios no BackOffice Protheus

( 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

Baixando o Título pelo RM

Baixa que antes era no Protheus passou a ser pelo RM

Selecionando o Lançamento : Processos | Baixa | Baixar Lançamento

Baixa efetuada

Lançamento com Status de Baixado

Baixa atualizada no BackOffice Protheus

Tentando efetuar a Baixa no BackOffice Protheus

Tentar efetuar a baixa no BackOffice Protheus o Sistema mostra a mensagem abaixo: Efetua a baixa através do sistema RM Classis

Baixa utilizando Valores Opcionais

Efetuando pagamento a Menor ( Utilizando agora os Valores Opcionais )

Valor pago a Menor de 200 Reais

Baixa realizada com valor a menor.

Cliente / Fornecedor encontra-se com um Débito de R$ 200,00 Reais

O Título no BackOffice Protheus levando em Valores Acessórios o débito de R$ 200,00 Reais

Baixando o Título a pagar pelo RM

No RM para realização da baixa do lançamento a pagar deve usar o processo "Protheus - Lançamentos a Pagar → Registrar Lançamentos" conforme imagem abaixo.

O cancelamento da baixa do lançamento a pagar deve usar o processo "Protheus - Lançamentos a Pagar - Cancelar Lançamentos" conforme a imagem abaixo.

Na geração de lançamento em lote, contabilização por competência, baixa de titulo, acordo após a execução do processo não será possível cancelar o processo.
Ao tentar cancelar será exibido a mensagem de alerta "Não é possível cancelar o processo em execução quando existir integração com Protheus".