Este documento tem por objetivo reunir as informações relevantes sobre a Integração do BackOffice Protheus e TOTVS Incorporação (TIN).

A integração respeita todos os pré-requisitos definidos pelas linhas de produto TOTVS envolvidos. Para mais detalhes sobre configuração de hardware recomendada, sistema operacional, bancos de dados suportados e demais dados, consulte os seguintes documentos no TDN:

Documento de Portabilidade da Linha RM

         Os produtos envolvidos utilizam o modelo de licenciamento padrão (License Server). Para pleno funcionamento, as licenças (Hard Lock) devem ser providenciadas junto a TOTVS com antecedência. Vale ressaltar que esta integração está de acordo com as boas práticas recomendadas pelo Comitê de Integração TOTVS e utiliza a arquitetura Mensagem Única e comunicação via WebServices.

1.1.   Pré-requisitos Linha Protheus

Utilizar a versão 12 (ou superior)

Os WebServices exigem uma licença específica “TOTVS I”

1.2.   Pré-requisitos Linha RM

Utilizar a versão 12.1.23 ou Superior.

PROCESSOS TIN 

Guia para Instalação do Produto RM ===== > Instalação do Produto RM Versão 12.1

PROCESSOS TIN

CENTRO DE CUSTO

• Centro de Custo

A Máscara do centro de custo deverá ser removida dos parâmetros do RM para que o financeiro TOTVS Gestão Financeira aceite os códigos enviados pelo BackOffice Protheus na integração.

BackOffice | Gestão Financeira |Ambiente | Parâmetros | TOTVS Gestão Financeira

02.01.01.01 - Lançamento

Centro de Custos = ( Deixar máscara em branco )

Cliente/Fornecedor = Marcar Permite Global – Marcar com o Parâmetro de Integração – CLIFORGLOBAL estiver True , como é mostrado na imagem abaixo.

CLIFORGLOBAL = true

Recursos Adicionais = Permite Rateio  ( SIM )

Valores Opcionais = TIN utiliza os valores Opcionais – Para seu uso é preciso de entrar em um a um , editar , eles serão enviados para o BackOffice Protheus em Valores Acessórios.

Inclusão = Informar o tamanho do Documento = Valor de referência = 11

Utiliza Natureza Orçamentaria Financeira = Marcar o Parâmetro

Cadastrando Meio de Pagamento

Cadastros | Movimento | Meio Pagamento

Cadastrar um Meio de Pagamento com código = 1

Código que é informado nos Parâmetros da Integração

PLANO DE CONTAS

BackOffice | Gestão Contábil

Ambiente | Parâmetros | TOTVS Gestão Contábil

01.01.01 - Plano de Contas Contábil

Marcar o Parâmetro = Não utilizer mascara nas contas

Pois assim o Protheus consegue enviar suas contas contábeis para o RM.

PERÍODO CONTÁBIL

Ambiente | Parâmetros | TOTVS Gestão Contábil

01.02 - Lançamentos

Período Contábil – Este período é enviado do Protheus para o RM.

Após configurar o período Contábil , não esquecer de incluir o período ao Usuário RM como é informado abaixo.

SERVIÇOS GLOBAIS

Serviços Globais

Segurança | Acesso | Usuários

Sistema : BackOffice | Gestão Contábil

Selecionar o Usuário e em seguida: Anexos | Período para Manutenção de Lançamentos Contábeis

Buscar o período Contábil cadastrado e o importando para o usuário RM.

CLASSIFICAÇÃO DE PAÍS

Configurando para ser usado no cadastros de Cliente e Fornecedor 

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

É cadastrado uma classificação para o País desejado – Brasil

Pelo anexo de codificação no cadastro de País no 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:

Cadastros | Globais | Mais | Países

Selecionar o País desejado e em seguida : Anexos | Codificação de País

Inserir o código do País que se encontra no BakOffice Protheus , neste nosso exemplo, o Brasil possui o Código = 105

Código do País no BackOffice Protheus

Esta Classficação é inserida em : Integração

Integrações | EAI 2.0

Parâmetro : CODCLASSIFICPAIS = Inserir a classificação criada e que contenha o código do País do Protheus

Outros parâmetros que devem ser configurados no RM

CLASSE DE VALOR e ITEM CONTÁBIL

Cadastro que é enviado do Protheus para o RM e o mesmo é utilizado dentro do Empreendimento

Empreendimento

Integração | Gestão Financeira

VALORES DE INTEGRAÇÃO

Os Valores de Integração vão para o Protheus em Valores Acessórios.

TOTVS Gestão Incorporação | Contratos | Plano | Valores de Integração

CADASTRO DE De-Para no RM

Integração

EAI 2.0 | Integrações | De/Para

Valores RM ( 1 ) Fixo

Valores Externos ( 1 ) Fixo

De-para ( GCOLIGADA )

De-Para ( GFILAL )

Valores RM ( Coligada e Filial )

Valores Externos ( Empresa e Filial )

Aplicativos

Configuração para inserir EAI do BackOffice Protheus

Obs sobre Coligada :

- RM não está preparado no EAI 2 para trabalhar com o cliente Global e Compartilhado pro Grupo de Empresa no Protheus, O Controle de Multi Grupo Empresas no Protheus para a Integração TINxProtheus no EAI 2 está configurado na tabela  no campo PERMITEMULTGRUPOS que deverá ter o valor zero "0" quando o cliente for compartilhado por empresa no Protheus e Global no RM e no Cadastro de APP no menu Integração >> EAI 2 >> APP, abrir a integração TINxProtheus e configurar o compartilhamento como "Empresa". No Adapter do Protheus terá que informar o nome do Alias para o adapter CUSTOMERVENDOR da rotina MATA030 e MATA020.

Cadastro de Adpter no TOTVS INCORPORAÇÃO

Adpterse e Versão

1º ) CRIANDO UMA BASE DE DADOS VAZIA ( PROTHEUS )

Base de Dados criada ( Vazia )

Neste Exemplo – ( Protheus )

Collation = Latin1_General_BIN

2º ) CONFIGURANDO ODBC

ODBC (acrônimo para Open Database Connectivity) é um padrão para acesso a sistemas gerenciadores de bancos de dados (SGBD). Este padrão define um conjunto de interfaces que permitem o uso de linguagens de programação como Visual Basic, Delphi, Visual C++, Java, entre outras capazes de utilizar estas interfaces, para ter acesso a uma vasta gama de bases de dados distintas sem a necessidade de codificar métodos de acesso especializados.^[1]

O ODBC atinge a independência de bancos de dados usando drivers para operarem como uma camada de tradução entre a aplicação e o SGBD. As aplicações usam funções ODBC através de um gerenciador de driver ODBC (ODBC driver manager) com a qual está ligada e o driver passa a query para o SGBD.

A implementação de uma aplicação baseada em ODBC permite que a mesma possa utilizar simultaneamente o MySQL, o Access e o SQL Server com pouca necessidade de mudanças na sua camada de dados. O uso destas interfaces está condicionado à existência de drivers ODBC específicos para as bases de dados que se deseja acessar

Os comandos SQL enviados pelas aplicações para o ODBC devem ser compatíveis com o SGBD utilizado, exigindo às vezes pequenas implementações especificas na aplicação para suporte a um SGBD especifico.

Obs: Lembrar de efetuar a configuração no OBDC 32 Bits ou 64 se for 64 Bits o Sistema Operacional.

64 Bits : %windir%\System32\odbcad32.exe

32 Bits : %windir%\SysWOW64\odbcad32.exe

Neset exemplo , será usando o ODBC 64 BITS

DSN de Sistema | Adicionar

Nome e Descrição : Mesmo nome do Banco na qual foi criado.

Servidor : Servidor na qual foi criado o Banco de Dados Protheus          

Informar senha do usuário ADM do banco de dados  | Avançar

Localizar o Banco de Dados | Avançar

Testar fonte de dados = Verificar se o Teste é concluído com êxito

3º INSTALANDO E CONFIGURANDO O DBACCESS

https://arte.engpro.totvs.com.br/

• Selecionar = TEC
• Dbaccess  ( O Instalador do Protheus 25 já contém o DBACCESS )

Após a instalação do DBAccess, abra o local onde foi instalado, localize o DBAccess.exe e no caminho do diretório , insira no final–install

O DBAcces será instalado como serviço

Observação:

Outra maneira de configurar o DBAccess para que possa ser iniciado é:

Abra a pasta onde o DBAccess foi instalado e crie um atalho do DBAccess.exe e do DBMonitor.exe na área de trabalho. Selecione o atalhodo DBAccess e abra as propriedades do mesmo. No campo Destino, no final do caminho insira: -console.

Após basta iniciaroDBAcces:

Importante!! Quando o DBAccess é iniciado dessa forma, sempre que for fechar é necessário digitar CTRL+C, e YES para confirmar. Após é necessário aguardar o aplicativo fechar sozinho. Este procedimento deve ser realizado para não dar inconsistências na base.

Configurando o DBACCESS

Localizar o arquivo : dbmonitor.exe

Obsversão : Verificar a porta que encotnra-se configurada no arquivo : dbaccess.ini

Configurações | Microsoft SQL | Novo

Inserir nome do Banco de Dados Criado e configurado no ODBC

Inserir usuário e senha do usuário de Bano | Salvar

Assistentes | Validação de Conexão

Selecionar a Base de Dados

Finalizar

Conexão encontra-se OK

****** CONFIGURAÇÃO DBACCESS PARA ORACLE ******

Para configurarmos a conexão Oracle utilizaremos a aba “Configurações” e depois a aba “Oracle”. Clique no botão “Novo” e informe a base Protheus e RM, o nome do usuário e a senha.

Marque o checkbox“Usar BLOB para campo MEMO”.

Editar o arquivo : dbaccess.ini

O DBAccess precisa que o caminho para a biblioteca do Oracle seja informada para o seu correto funcionamento.

Fazemos isto através do arquivo DBAccess.ini no diretório onde foi instalado o DBAcces. Edite o arquivo e acrescente a propriedade clientlibraryabaixo da chave [Oracle].

4º ) INSTALAÇÃO DO PROTHEUS

Caminho para se baixar o Instalador do P12 :  VERSÃO 25

https://suporte.totvs.com/portal/p/10098/download#000006/all/all/search/instalado

Fazer o DOWNLOAD do arquivo

Localizar o arquivo TOTVS12_x64.exe

Selecionar Linguagem e em seguida | OK

Diretório para instalação do Protheus | Próximo

Próximo

Selecionar as opções para Instalação do P12 | Próximo

Próximo

Informar DNS License Server

Processo de Instalação em progresso

Selecionar opção para Criar Atalhos e para quais tipos de usuários.

Processando a Instalação e finalizada a Instalação do P12.

Estrutura da Instalação do Protheus.

5º ) ATUALIZAÇÃO DO PRTOHEUS ((( QUANDO FOR PRECISO ))) 

APPSERVER E SMARTCLIENT

https://arte.engpro.totvs.com.br/

TEC 

• Appserver
• Smartclient

REPOSITÓRIO | MENUS | DICIONÁRIO DE DADOS

https://arte.engpro.totvs.com.br/

Protheus

• Padrão
• Published
• Dicionário

Menus e Dicionário de Dados

Completo e Diferencial

Repositório

Lobo_Guara

5.5 - CONFIGURANDO APPSERVER.INI E SMARTCLIENT.INI

StartSysInDB=1 ( ESTA TAG É OBRIGATÓRIA NA VERSÃO 25 DO PROTHEUS )

Usar o Appserver do Instalador Padrão . Não incluir caminho e nem conexão de base , Pois ao executar pela primeira vez o Protheus 25 , ele cria esta conexão. Se informar o caminho ocorre o seguinte erro abaixo:

Configurações básicas do Smartclient.ini

Mostra o tipo de conexão ( TCP ) neste exemplo , o mesmo é informado no appserver.ini e aporta que tem que estar também configurada no appserver.ini.

6 - INICIANDO O PROTHEUS

Selecionar qualquer módulo para executar.

Neste exemplo ( SIGAFIN )

Neta fase que será criado a conexão no APPSERVER.INI .. Como mostra o Print ABAIXO.

Criando Empresa 

Inserindo Layout da Empresa

Brasil  | OK

Admin | entrar

Novamente selecionar o País 

Criando as Tabelas

PROTHEUS INSTALADO

Neste momento o Protheus inicia a criação das tabelas de seu Banco.

Ao terminar todo processo de carga de tabelas do Protheus , entrar no Módulo ( SIGAFIS )

Para dar carga na tabela CC2 - Municípios

Sendo criado todos municípios no Prothues

7 - CONFIGURAÇÕES PROTHEUS

Módulo – SIGACFG

Base de Dados | Base de Dados

Parâmetro = MV_RMTINVE

Valor = 2

Parâmetro = MV_EAIMETH

Valor = receiveMessage

Parametro = MV_EAIURL2

http://IP DA MÁQUINA:8051/EAIService/IConWSEAIService

Podendo ser o Nome do Servidor no lugar do IP

Parâmetro = MVEAIWS

Valor = WSEAISERVICE

Parâmetro = MV_EAIUSER

<Nome de usuário> (Opcional em caso do Servidor precisar de Autenticação).

Parâmetro = MV_EAIPASS

<Senha de usuário> (Opcional em caso do Servidor precisar de Autenticação).

Parâmetro = MV_1dup

ESTE PARAMETRO TEM QUE FICAR ASSIM PARA RECEBER LANCAMENTO COM 2 CARACTERES

Parâmetro = MV_ANTCRED

Aceita o cancelamento de parcelas com data de emissão futura.

Parâmetro = MV_MULNATR

Define se vai haver rateio de Natureza Financeira no Contas a recebe

Par:âmetro = MV_MULNATP

Define se vai haver rateio de Natureza Financeira no Contas a pagar

Parâmetro = MV_FINJRTP

Define o que considerar na baixa de titulo em atraso

1 - Taxa de permanecia (padrão). 

2 - Juros

3 - Ambos

Parâmetro = MV_ITLBCPO

Libera os campos Juros e Multa, caso tenha integração TINxProtheu

Dicionário de Dados

Localizar a Tabela ( SA1 e SA2 ) e Editar em seguida

A1_LOJA - EDITAR

Inic . Padrão = "01"

***** CADASTRO DE-PARA ********

DE-PARA EMPRESA / FILIAL   

Ambiente | Shedule | Emp. Filial Mensagem

Informar a Coligada e Filial do RM e Empresa e Filial do Protheus

Parâmetros Opcionais

DE-PARA - CADASTRO DE MOEDA

O Projeto não está contemplado o sincronismo automático de Moeda. Mas as mensagens referentes ao Plano de Financiamento (Financing) e a mensagem de Comissão/Pedido de Compra (Order) farão referência a moeda “R$”. Então a moeda “R$” deve ser cadastrada (manualmente) nos 2 sistemas e o de/para deve ser configurado dos dois lados.

Protheus - Neste exemplo a moeda é cadastrada na Empresa 01

Filial : 0210001

Código da Moeda : 01

DE-PARA moeda no RM.

CADASTRO DE ADAPTERS NO PROTHEUS

Módulo ( SIGACFG )

Ambiente | Schedule | Adapter E.a.i

Cadastro dos Adpters

Veja a lista de todos Adpters atuailzados até Fevereiro de 2019 

Condições dos Adatpters  ( FINA070 ) 

Alltrim(SE1->E1_ORIGEM)== ‘FINI055’

Condições dos Adpters ( FINA080 )

Alltrim(SE2->E2_ORIGEM)== ‘FINI055’

Observação sobre Cadastro dos Adapters.

Versão dos Adpters podem sofrer alterações.

Configurando EAI - RES e WS do RM : Configurando EAI - REST e WS do RM

Cadastro Bancário = Modo correto para se utilizar o cadastro Bancário Protheus x RM : Cadastro Bancário e Convênio (BackOffice Protheus & Totvs Incorporação.)

INTEGRAÇÃO POC TOTVS Incorporação X BackOffice Protheus 

Contexto de negócio (Introdução)

 O objetivo da integração do POC TOTVS Incorporação x BackOffice Protheus é de parametrizar a Apuração de Resultado Contábil por POC entre os módulos da linha RM (TIN) x Protheus  (Financeiro e Contábil) para que seja realizada a exigência da Construção e Incorporação Imobiliária - Norma Brasileira de Contabilidade ITG 02 – Contrato de Construção do Setor Imobiliário, aprovada pela Resolução CFC n° 1266/09, é necessário configurar o Adapter E.A.I para utilização da Mensagem Única.

Para mais informações consulte:  http://www.gerenciamento.ufba.br/Disciplinas/Financeiro/Contabilidade%20de%20Contratos%20de%20Constru%C3%A7%C3%A3o.pdf

Aplicação da Regra aos produtos TIN (linha RM) e gestão Contábil (linha Protheus)

O TOTVS Incorporação possui um recurso que permite parametrizar a Apuração de Resultado Contábil por POC entre módulos da linha RM (TIN, Financeiro e Contábil).

Este recurso é chamado de Apuração de Resultado Contábil por POC que houve alteração para atender a integração com o Protheus.

A seguir, a definição dos modelos de Apuração entendidos e aplicados no TIN:

A apuração de resultado contábil, ou simplesmente POC, deve ser aplicada a todas as operações (fatos contábeis) que impactam em reconhecimento de resultado (receita ou custo) atribuído ao empreendimento em construção, sendo necessário parametrizar por coligada e por empreendimento todas as formulas de apuração  para cada uma das operações necessárias. Esta parametrização é unica por empreendimento e deve ser realizada antes do inicio da apuração.

Para que a apuração de resultado contábil por POC seja realizada é necessário realizar o seguintes cadastros no TIN:

• Cadastros / Empreendimento / Anexo / Avanço da Obra (POC) ou Cadastros / Apuração de Resultado Contábil por POC / Andamento da Obra (POC)
• Cadastros / Apuração de Resultado Contábil por POC/ Regras de Apuração
  • Composição da Base de Calculo
  • Fórmula de Apuração

Avanço da Obra ou POC

O POC (Percentage of Completion) é a identificação do avanço da Obra, seja por meio contábil, ou por medição, sendo que todas as operações dependem desta Identificação para o reconhecimento. O POC pode ser calculado das seguintes maneiras:

• Indicado manualmente: o usuário recebe da engenharia o valor do avanço da obra e indica manualmente no TIN. Este método também pode ser utilizado caso o usuário responsável opte por aproveitar resultados de planilhas utilizadas anteriormente a utilização do TIN;
• Fórmula: a fórmula permite criar um modelo de cálculo do POC baseado em variáveis diversas. O cálculo mais comum é o Custo Incorrido dividido pelo Custo Orçado. Geralmente os dois valores são obtidos pelo saldo de um conjunto de contas contábeis.

Exemplos de Fórmula

CI-> Custo Incorrido = ∑Saldo de Contas Contábeis de Custo Incorrido; 

CO-> Custo Orçado = Valor Atualizado do Custo Orçado que pode ser indicado no cadastro de Sped Pis Cofins ou como Movimento específico de Conta contábil de Custo Orçado do Empreendimento. O Empreendimento pode ter uma conta específica ou se a conta for geral deve ter a identificação por Conta Gerencial ou centro de custo no TIN e no Protheus por Item contábil, classe de receita ou outra entidade contábil customizável. 

i = mês da apuração

POC= CI_i /CO

Cálculo do POC por Indexação CUB 

Custo Orçado em CUB     = CO  / valor do CUB Acumulado (até o mês de apuração)

Custo Incorrido em CUB   = CI_i / valor do CUB Acumulado (até o mês de apuração)

POC_CUB = CI_CUB / CO_CUB

Sistemas Envolvidos

• TOTVS Incorporação (TIN) - Solução que realiza todo o controle de prazos, documentos e previsões da empresa, com gerenciamento de contratos de vendas e planos de financiamento, sendo possível acompanhar desde a fase dos prospects até a fidelização de clientes, com agilidade na emissão dos contratos, garantindo a efetivação das vendas. É o responsável pela definição das regras de apuração e medição do andamento das obras, sendo necessário ou não, de informações oriundas do BackOffice.

• BackOffice Protheus  - Contabilidade Gerencial (SIGACTB) e Financeiro (SIGAFIN).

  
  

Integração

Para atender a demanda de clientes que possuem a solução TOTVS Incorporação integrado ao BackOffice Protheus, foi desenvolvida esta integração que possibilita a execução da Apuração de resultados pelo POC neste ambiente integrado.

Premissas de Integração

TOTVS Incorporação

• Configurar a integração TOTVS Incorporação x BackOffice Protheus por meio do TBC (Integração / Ferramentas / Configuração) na versão 12.1.8 ou superior.
• Caso a integração tenha sido implantada em versão anterior é necessário que o configurador seja executado novamente para implantação dos novos processo de integração.
• Ativar a Integração TOTVS Incorporação x BackOffice Protheus acessando Integração / Mensagem única / Integrações no menu do TBC (Integração);
• Importação das Fórmulas Visuais com gatilhos de integração, enviando os registros ao EAI.
• O cadastro mantido pelo BackOffice RM como Conta Gerencial deve ser desabilitado no Protheus sua entidade correspondente, evitando concorrência de dados.

Protheus

• Configuração dos adapters utilizados na integração TOTVS Incorporação x BackOffice Protheus, assim como toda a configuração do EAI Protheus.
• Utilizar a versão 12.1.8 do Protheus com a LIB 0712  ou superior.
• Incluir uma nova entidade contábil que será responsável pela entidade Conta Gerencial" do RM utilizando o wizard de configuração CTBWIZENT, mais informações no link: Entidades Contábeis Adicionais_TEQCVV.
• O cadastro de entidade gerencial relacionado com o cadastro de Contas gerenciais do RM deve possuir a seguinte configuração de dicionário de dados:
  
  • Empresa:  Exclusivo
  • Unidade:   Deve ser equivalente à entidade relacionada no De-Para de integração (Empresa ou filial)
  • Filial:        Compartilhado
• Todos os cadastros mantidos pelo BackOffice Protheus devem ser desabilitados no RM, evitando concorrência de dados.
  
  

Escopo

O escopo desta implementação se restringe aos processos oriundos do processamento da Apuração de resultados (POC) e os cadastros utilizados por estes.

A integração do TIN com o BackOffice Protheus permite que o processamento da Apuração (POC) seja executado de forma transparente ao usuário final, sem aumento considerável da complexidade de parametrização ou execução dele. Os cadastros envolvidos na integração são integrados pelo sistema mandatário de forma automática, sem necessidade de processamento posterior, ou acompanhamento de filas de integração com inclusão, alteração ou exclusão, que devem ser restritas no sistema de destino.

Em caráter ilustrativo, o cadastro de Contas Contábeis é de domínio do BackOffice Protheus, tendo as modificações enviadas de forma transparentemente ao TOTVS Incorporação e a manutenção do cadastro restrito neste.

É restrito ao escopo deste projeto a integração de processos relacionados ao processamento do POC. Desta maneira, somente os lançamentos contábeis gerados e / ou estornados a partir dos processos do POC são integrados ao BackOffice Protheus. Os demais processos que geram contabilização / estorno no TIN devem ser desabilitados, pois não foram contemplados nos testes.

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

Apesar da integração TOTVS Incorporação x BackOffice Protheus estar disponível para o mercado desde as versões 11.82.26.108 (ou superior) para a linha RM e 11.7 (ou superior) para a linha Protheus, a implementação realizada para tratamento da Apuração de resultados (POC) de forma integrada entre as duas linhas (RM e Protheus) está disponível apenas a partir da versão 12.1.8 para a linha RM e Protheus, com a LIB Protheus na versão 0712 ou superior.

Tem como pré-requisito a instalação e implantação dos módulos envolvidos (TIN, Protheus e seus anexos como o TBC), assim como correta configuração do módulo de POC. (Configurações)

Instalação Protheus

• No Configurador acesse Ambiente / Cadastros / Parâmetros e configure os parâmetros:
  •  MV_EAIURL2 com o endereço do serviço de EAI do ambiente ao qual o Protheus é integrado.
    • Exemplo: http://12.50.90.211:81/MensagemUnicaWS.
  • MV_CTBCGER com a entidade adicional correspondente a entidade de conta gerencial.

• No Configurador acesse  Ambiente / Cadastros / Parâmetros e configure os parâmetros:
•  MV_EAIWS com o nome do cliente WebService do EAI para envio a outro EAI. (WSEAISERVICE).

• MV_ EAIUSER: caso o servidor necessite de autenticação,  com o nome de usuário.

• MV_ EAIPASS: caso o servidor necessite de autenticação, com a senha de usuário.

• No Configurador acesse Ambiente / Schedule / Adapter E.A.I. e realizar o cadastro das rotinas de integração, conforme segue:

Instalação TIN

Esta integração é nativa ao ERP RM, mas é necessário instalá-la a parte para que fique disponível. Isto significa que as rotinas para esta integração já pertencem ao núcleo do sistema, mas a integração não está disponível para ser configurada e ativada, sendo necessário realizar o(s) passo(s) abaixo:

No RM.exe acesse o segmento Integração na aba Ferramentas na opção Configuração.

É apresentada a tela para entrada de usuário e senha para a base de dados RM. Clique no botão Testar conexão e, clique em Avançar para habilitar.

No próximo passo selecione a integração TOTVS Incorporação x BackOffice Protheus, clique em Avançar e em Executar.

É necessário também, executar a importação das formulas visuais com seus gatilhos:

• Mensagem Padrão - Lançamentos Financeiros
• Mensagem Única - Sincronização de Conta Gerencial
• Mensagem Única - Lista de Conta Gerencial

Os demais detalhes de configuração e os tratamentos necessários podem ser consultados nos boletins técnicos existentes. 

Atualização

Protheus

Após as configurações descritas na seção instalação e atendida as premissas, o ambiente Protheus estará pronto para a utilização dessa integração.

Mais detalhes técnicos estão na especificação no link: ER_PCREQ-5854_Integração RM TIN X Protheus POC.

RM

Para atualizar ambientes que já utilizam a integração TIN x BackOffice Protheus, é necessário executar novamente o configurador da integração (da mesma maneira como descrito no tópico acima Instalação TIN).

A diferença da instalação para a atualização, é que será necessário excluir a formula visual Mensagem Padrão - Lançamentos Financeiros, que utiliza a versão 1.001 da mensagem financing e importa a nova versão desta formula visual, que irá utilizar a versão 1.002.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos TOTVS Incorporação e BackOffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Transações/Entidades/Mensagens únicas

A tabela abaixo apresenta quais as Mensagens Únicas TOTVS utilizadas para a integração do TOTVS Incorporação com BackOffice Protheus que causam algum impacto e interferem na Apuração de resultados (POC), com os respectivos processos de integração apresentados na próxima seção do documento. 

Vale ressaltar que existem outras Mensagens únicas TOTVS que fazem parte da integração TOTVS Incorporação x BackOffice Protheus, porém não fazem parte do escopo desta documentação que é voltada para a Apuração de resultados (POC)

Fluxo do Cálculo do POC

O cálculo e contabilização do POC pelo TOTVS Incorporação pode ser dividido em três macro-processos, além da integração dos cadastros base utilizados para vínculos contábeis e demais parametrizações. Abaixo seguem listados os processos de integração com o BackOffice Protheus.

Passo 1 - Cálculo do Avanço da Obra

O cálculo do Avanço da Obra pode ser executado a partir de inserção manual ou por meio de cálculo de fórmula, sendo que somente o segundo pode executar integração com o BackOffice Protheus.
Abaixo segue diagrama que apresenta o cálculo por fórmula, utilizando funções de consulta saldo contábil ao Protheus.

Passo 2 - Apuração de Resultado Contábil pelo POC

A Apuração de Resultado Contábil pelo POC  é efetuada em duas etapas, que são: o cálculo das Composições da Base de Cálculo e o cálculo das Fórmulas de Apuração. 

Estas duas etapas podem efetuar integração com o BackOffice Protheus, caso existam consultas de saldo contábil por uma das funções de fórmula (vide lista na seção 'Funções de Formula') ou por Valor de Origem do tipo 'Contábil'.

Passo 3 - Contabilização das Apurações Realizadas | Estornar/Excluir Contabilização

Os processos de contabilização disponíveis no POC (inclusão ou estorno) são responsáveis por efetuar a leitura dos valores apurados no Passo 2 e executar a respectiva integração com o BackOffice Protheus por meio da mensagem AccountingEntry.

Cadastros

Todos os cadastros contemplam inclusão, alteração e exclusão, e devem ser feitos exclusivamente no sistema descrito como mandatário e com as mesmas operações bloqueadas no outro sistema. Por padrão, a integração de todos os cadastros será realizada de forma síncrona, sendo opcional a alteração do método de envio pela implantação ou cliente.

Os gatilhos de integração, adapters, restrições e demais informações constam na especificação do requisito disponível no item Link do Requisito.

Centro de Custo

Requisito: ER_Integração_Centro_de_Custo - CostCenter

Identificador da Mensagem: CostCenter

Versão: 2.000

Mandatário: BackOffice Protheus

Tipo de Envio: Síncrono

Classe de Valor

Requisito: ER_Integração_Classe_de_Valor - ClassValue

Identificador da Mensagem: ClassValue

Versão: 1.000

Mandatário: BackOffice Protheus

Tipo de Envio: Síncrono

Conta Contábil

Requisito: ER_Integração_Conta_Contábil - AccountantAccount

Identificador da Mensagem: AccountantAccount

Versão: 2.000

Mandatário: BackOffice Protheus

Tipo de Envio: Síncrono

Conta Gerencial

Requisito: ER_Integração_Conta_Gerencial - ListOfManagerialAccountingEntity

Identificador da Mensagem: ListOfManagerialAccountingEntity

Versão: 1.000

Mandatário: BackOffice RM

Tipo de Envio: Síncrono

Item Contábil

Requisito: ER_Integração_Item_Contabil - AccountingItem

Identificador da Mensagem: AccountantItem

Versão: 1.000

Mandatário: BackOffice Protheus

Tipo de Envio: Sincrono

Processos

Segue listado abaixo os processos do módulo de apuração de POC do TOTVS Incorporação que podem vir a executar integração com o BackOffice Protheus.

Os gatilhos de integração, adapters, restrições e demais informações constam na especificação do requisito disponível no item "Link do Requisito".

Calcular Avanço da Obra (POC)

O Cálculo de Avanço da Obra somente executa integração caso o mesmo seja efetuado através de fórmula que utilize uma das funções de Consulta de Saldo Contábil (vide seção 'Funções de Formula').

Requisito: ER_Consulta de Saldos Contábeis - AccountingBalance

Fluxo da Mensagem: RM → Protheus

Mensagem: AccountingBallance

Tipo de Envio: Sincrono 

Apuração de Resultado Contábil pelo POC

O cálculo das Composições da Base de Cálculo e o cálculo das Fórmulas de Apuração podem efetuar integração com o BackOffice Protheus uma vez que utilizem consultas de saldo contábil por uma das funções de fórmula (vide seção 'Funções de Formula') ou Valor de Origem do tipo 'Contábil'.

Requisito: ER_Consulta de Saldos Contábeis - AccountingBalance

Fluxo da Mensagem: RM → Protheus

Mensagem: AccountingBallance

Tipo de Envio: Síncrono 

Contabilização das Apurações Realizadas

O processo de Contabilização das Apurações será executado conforme especificação do requisito abaixo.

Requisito: ER_Lançamentos Contábeis - AccountingEntry

Fluxo da Mensagem: RM → Protheus

Mensagem: AccountingEntry

Tipo de Envio: Síncrono 

Estornar/Excluir Contabilização

Quando o ambiente possuir integração ativa com BackOffice Protheus, sempre será executado estorno e nunca exclusão, ou seja, será gerada mensagem de integração de inclusão de lançamento contábil com "sinais opostos" (contas opostas), conforme descrito na especificação do requisito abaixo.

Requisito: ER_Lançamentos Contábeis - AccountingEntry

Fluxo da Mensagem: RM → Protheus

Mensagem: AccountingEntry

Tipo de Envio: Síncrono 

Geração de lançamentos financeiros

A geração de lançamentos financeiros é um processo que já era integrado nas versões anteriores, porem, para atender demandas da apuração de resultado (POC), foi alterado para tratar alguns campos necessários, conforme descrito na especificação do requisito abaixo.

Requisito: ER_PCREQ-6397_Lançamentos Financeiros - Financing

Fluxo da Mensagem: RM → Protheus

Mensagem: Financing

Tipo de Envio: Síncrono 

Limitações / Restrições Gerais

Lista de funções de fórmula de Consulta Saldo Contábil integradas ao BackOffice Protheus.

• VALORCONTACONTABILPERIODO
  
  • Função de consulta de saldo contábil a partir dos seguintes parâmetros: Conta Contábil, Tipo de Retorno e Centro de Custo, Histórico Padrão e Período de Consulta (Data início e Data fim).
• VALORCONTACONTABIL
  • Função de consulta de saldo contábil a partir dos seguintes parâmetros: Conta Contábil, Tipo de Retorno, Centro de Custo e Histórico Padrão.
  • É utilizado o período da apuração do POC como período de consulta.
• VALORCONTA
  • Função de consulta de saldo contábil a partir dos seguintes parâmetros: Conta Contábil, Tipo de Retorno e Centro de Custo.
  • É utilizado o período da apuração do POC como período de consulta.
  • Não é enviado Histórico Padrão como filtro.

Gatilhos de Integração do cadastro de Plano de Contas Gerencial.

Visto o objetivo do projeto, restringe-se ao escopo da integração os gatilho listados abaixo, não havendo integração dos demais processos de manutenção do cadastro.

• DataServer de Cadastro (tela de Inclusão/Alteração/Exclusão) - CtbGerenciaData
• Processo "Gerar e Associar Contas Gerenciais", responsável por automatizar a geração de contas gerenciais e associar a Empreendimento, Unidades e Sub-Unidades.
• Fórmula Visual de sincronismo
  
  

Tratamento de Período Contábil.

O sistema de Gestão Contábil da linha RM não é somente utilizado na integração, servindo somente como ponte para o sistema integrado, por este motivo, o configurador parametrizará o período contábil para data inicial 01/01/2000 e data final 01/01/2500.Esta restrição não gerará nenhum impacto ao uso do sistema pois o BackOffice Protheus executará todas as validações necessárias com a parametrização contábil executada no mesmo.

Situações comuns (opcional)

Tratamento de erros de integração (TOTVS Incorporação)

Checklist de suporte da aplicação

• Verificar configuração da integração na linha RM e Protheus;
• Verificar se estão corretos os cadastro de De/Para em ambas as linhas;
• Realizar testes com os serviços para garantir que ambos estão ativos (acessando o endereço pelo browser);
• Verificar se estão sendo incluídos registros nas filas de mensagens (RM e Protheus);
• Verificar erros descritos no processamento das mensagens existentes nas filas;
• Verificar configuração da Apuração de resultados (POC);
• Verificar cadastro de avanço;