Image Added

Image Removed

Informações

title	EAI 2.0

Para que seja usada esta Integração é necessário a conversão para EAI 2.0 = Mais detalhes , Clique aqui !!!

O TIN TCGI (TOTVS CONSTRUÇÃO GESTÃO DE IMÓVEIS) é o sistema de gestão de empreendimentos Vendas/Locações/Condomínio da TOTVS. Com ele o cliente TCGI a empresa fará a gestão de Empreendimentos, disponibilidade de subunidades e seus contratos de venda e planos de financiamento, enviando e recebendo informações do módulo financeiro. Esta integração foi feita para viabilizar facilitar a comercialização utilização integrada do TIN integrado ao módulo financeiro do BackOffice Protheus. A seguir mais detalhes sobre o escopo da integração.

Os cadastros comuns serão feitos no BackOffice Protheus pelos módulos: SIGACOM, SIGAFIN, SIGACTB) e sincronizados para o RM. Os cadastros e processos de gestão imobiliária - exemplo plano de financiamento e negociação de contrato serão feitos no TIN e sincronizados para módulo financeiro do Protheus. O processo de comissionamento será sincronizado com o módulo de Compras. Processos estritamente financeiros - exemplo baixa de títulos (Pagar), serão realizados no Protheus. Títulos (Receber) pelo RM.

Parâmetros Opcionais

FAQs Protheus:

1 - Erro: "Configure o roteamento de mensagem corretamente".

Ocorre quando tentamos efetuar um cadastro básico integrado do Protheus para o TIN (Banco, Cliente ou outro).

Solução: parâmetro MV_EAIURL2 deve receber o caminho de Endereço do WebService RM.

2 - Erro:

WSCERR044 / Não foi possível POST : URL http://localhost/TOTVSBusinessConnect/wseaiservice.asmx?wsdl ( 401 : Unauthorized) ADVPL WSDL Client 1.120703 / TOTVS 2011 Série T Serviços MSSQL P1210 on 20161031 17:24:52

pode ocorrer quando tentamos efetuar qualquer operação no Protheus que deverá ser enviada ao RM e o WebService do RM não autoriza a entrega do pacote do protheus.

Solução: 1 - Desinstalar o TBC e instalar o mais atual da versão RM em que se encontra o RM.Net.

2 - Verificar o usuário que está sendo utilizado para autenticação no default WebSite do IIS onde está o TBC está instalado modificar para o administrador da máquina.

3 - Verificar se o usuário e senha que está sendo utilizado para a integração está correto.

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.

Image Removed

Protheus - Neste exemplo a moeda é cadastrada na Empresa 01

Filial : 0210001

Código da Moeda : 01

Image Removed

DE-PARA moeda no RM.

Image Removed

CADASTRO DE ADAPTERS NO PROTHEUS

Image Removed

Módulo ( SIGACFG )

Image Removed

Ambiente | Schedule | Adapter E.a.i

Image Removed

Cadastro dos Adpters

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

Image Removed

Condições dos Adatpters ( FINA070 )
Image Removed

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

Image Removed

Condições dos Adpters ( FINA080 )

Image Removed

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

Observação sobre Cadastro dos Adapters.

Image Removed

Deck of Cards

id	PAI

Card

label	Pré-Requisitos

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=778788401

Card

label	Configurando WebServiçe RM

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012234

Card

label	Adpters Integração TCGI / Protheus

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012301

Card

label	Configurando Integração RM com Protheus

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012346

Image Added

Informações

title	Observação

Os cadastros comuns serão feitos no BackOffice Protheus pelos módulos: SIGACOM, SIGAFIN, SIGACTB) e sincronizados para o RM. Os cadastros e processos de gestão de Imóveis - exemplo: Títulos a Receber/Pagar e Negociações relacionadas ao contrato, serão feitos no TCGI e sincronizados para módulo financeiro do Protheus.
O processo de comissionamento será sincronizado com o módulo de Compras.
Processos Financeiros: Baixa de Títulos a Pagar, serão realizados no Protheus. Já as Baixas de Títulos a Receber deverão ser feitas pelo RM.

ATENÇÃO:
Apenas os Lançamentos do tipo ( Adiantamento ), podem ser incluídos de forma manual pelo TOTVS Construção Gestão de Imóveis sem vínculo a algum contrato do Gestão de Imóveis.

Deck of Cards

id	Pai2

Card

id	Cadastros da Integração
label	Cadastros da Integração \|
title	Cadastros da Integração

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=547246128

Card

accessKey	contratovendaeai2
id	Contrato de Venda \|
label	Contrato de Venda \|
title	Contrato de Venda \|

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780010027

Card

id	SPED F200 / 205 /210 e 1800
label	SPED F200 / 205 /210 e 1800 \|
title	SPED F200 / 205 /210 e 1800

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780009968

Card

id	Processo da Baixa de Títulos
label	Processo da Baixa de Títulos \|
title	Processo da Baixa de Títulos

Nota

title	Importante

Lançamentos/Títulos a Pagar terão todo o processo de baixa mantido no Protheus.

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780010907

Card

label	Adiantamento \|

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780010980

Card

label	Acordo \|

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780011883

Card

label	Distrato \|

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012078

Card

label	Gerando Comissão - Pedido de Compra \|

HTML Include

url	https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780015891

Card

label	Aluguel & Protheus

ALUGUEL

Deck of Cards

id	PAI

Card

id	Pré-Requisitos
label	Pré-Requisitos \|
title	Pré-Requisitos

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

Image Removed

02.01.01.01 - Lançamento

Image Removed

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

Image Removed

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

Image Removed

CLIFORGLOBAL = true

Image Removed

Recursos Adicionais = Permite Rateio ( SIM )

Image Removed

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.

Image Removed

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

Image Removed

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

Cadastrando Meio de Pagamento

Cadastros | Movimento | Meio Pagamento

Image Removed

Cadastrar um Meio de Pagamento com código = 1

Image Removed

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

PLANO DE CONTAS

BackOffice | Gestão Contábil

Image Removed

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

Image Removed

01.01.01 - Plano de Contas Contábil

Image Removed

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

Image Removed

01.02 - Lançamentos

Image Removed

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

Image Removed

Serviços Globais

Image Removed

Segurança | Acesso | Usuários

Image Removed

Sistema : BackOffice | Gestão Contábil

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

Cadastros | Globais | Mais | Países

Image Removed

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

Image Removed

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

Image Removed

Código do País no BackOffice Protheus

Image Removed

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

Image Removed

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

Image Removed

CLASSE DE VALOR e ITEM CONTÁBIL

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

Image Removed

Empreendimento

Image Removed

Integração | Gestão Financeira

VALORES DE INTEGRAÇÃO

Image Removed

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

Image Removed

Integração

Image Removed

EAI 2.0 | Integrações | De/Para

Image Removed

Valores RM ( 1 ) Fixo

Valores Externos ( 1 ) Fixo

De-para ( GCOLIGADA )

Image Removed

De-Para ( GFILAL )

Valores RM ( Coligada e Filial )

Valores Externos ( Empresa e Filial )

Image Removed

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

Image Removed

Adpterse e Versão

Image Removed

Card

id	Instalação Biblioteca RM
label	Instalação Biblioteca RM \|
title	Instalação Biblioteca RM

Card

id	Configurações RM ( Integração )
label	Configurações RM ( Integração ) \|
title	Configurações RM ( Integração )

Card

id	Instalação e Configuração do Protheus
label	Instalação e Configuração do Protheus ( PROTHEUS 25 - LOBO GUARA ) \|
title	Instalação e Configuração do Protheus

Informações

title	Compartilhamento

Detalhes sobre Compartilhamento no Protheus - Grupo de empresa - Unidade de Negócio - Filial : Clique aqui !

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

Image Removed

Base de Dados criada ( Vazia )

Neste Exemplo – ( Protheus )

Image Removed

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

Image Removed

DSN de Sistema | Adicionar

Image Removed

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

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

Image Removed

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

Image Removed

Localizar o Banco de Dados | Avançar

Image Removed

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 )

Image Removed

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

Image Removed

O DBAcces será instalado como serviço

Image Removed

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.

Image Removed

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

Image Removed

Localizar o arquivo : dbmonitor.exe

Image Removed

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

Image Removed

Configurações | Microsoft SQL | Novo

Image Removed

Inserir nome do Banco de Dados Criado e configurado no ODBC

Image Removed

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

Image Removed

Assistentes | Validação de Conexão

Image Removed

Selecionar a Base de Dados

Image Removed

Finalizar

Image Removed

Conexão encontra-se OK

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

Image Removed

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

Image Removed

Editar o arquivo : dbaccess.ini

Image Removed

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

Image Removed

Fazer o DOWNLOAD do arquivo

Image Removed

Localizar o arquivo TOTVS12_x64.exe

Image Removed

Selecionar Linguagem e em seguida | OK

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

Menus e Dicionário de Dados

Completo e Diferencial

Image Removed

Repositório

Image Removed

Lobo_Guara

5.5 - CONFIGURANDO APPSERVER.INI E SMARTCLIENT.INI

Image Removed

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:

Image Removed

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.

Image Removed

6 - INICIANDO O PROTHEUS

Image Removed

Selecionar qualquer módulo para executar.

Neste exemplo ( SIGAFIN )

Image Removed

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

Image Removed

Criando Empresa

Image Removed

Inserindo Layout da Empresa

Image Removed

Brasil | OK

Image Removed

Admin | entrar

Image Removed

Novamente selecionar o País

Image Removed

Criando as Tabelas

PROTHEUS INSTALADO

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

Image Removed

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

Para dar carga na tabela CC2 - Municípios

Image Removed

Sendo criado todos municípios no Prothues

7 - CONFIGURAÇÕES PROTHEUS

Image Removed

Módulo – SIGACFG

Image Removed

Base de Dados | Base de Dados

Image Removed

Parâmetro = MV_RMTINVE

Valor = 2

Image Removed

Parâmetro = MV_EAIMETH

Image Removed

Valor = receiveMessage

Image Removed

Parametro = MV_EAIURL2

Image Removed

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

Podendo ser o Nome do Servidor no lugar do IP

Image Removed

Parâmetro = MVEAIWS

Image Removed

Valor = WSEAISERVICE

Image Removed

Parâmetro = MV_EAIUSER

Image Removed

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

Image Removed

Parâmetro = MV_EAIPASS

Image Removed

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

Image Removed

Parâmetro = MV_1dup

Image Removed

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

Image Removed

Parâmetro = MV_ANTCRED

Image Removed

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

Image Removed

Parâmetro = MV_MULNATR

Image Removed

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

Image Removed

Par:âmetro = MV_MULNATP

Image Removed

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

Image Removed

Parâmetro = MV_FINJRTP

Image Removed

Define o que considerar na baixa de titulo em atraso

1 - Taxa de permanecia (padrão).

2 - Juros

3 - Ambos

Image Removed

Parâmetro = MV_ITLBCPO

Image Removed

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

Image Removed

Dicionário de Dados

Image Removed

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

Image Removed

A1_LOJA - EDITAR

Image Removed

Inic . Padrão = "01"

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

DE-PARA EMPRESA / FILIAL

Image Removed

Ambiente | Shedule | Emp. Filial Mensagem

Image Removed

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

MV_EAIURL2

Endereço do WebService RM

Exemplo:http://localhost/TOTVSBusinessConnect/wsEAIService.asmx

MV_EAIWS

Nome do Client WebSevice do EAI para envio a outro EAI

WSEAISERVICE

MV_EAIUSER

Usuário para autenticação no RM.

Exemplo: mestre

MV_EAIPASS

Senha do usuário para autenticação no RM.

Exemplo: totvs

MV_EAIMETH

Método de envio do EAI para envio a outro EAI.

RECEIVEMESSAGE

MV_ANTCRED

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

F/T

MV_MULNATR

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

F/T

MV_MULNATP

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

F/T

MV_FINJRTP

Define o que considerar na baixa de titulo em atraso

1 - Taxa de permanecia (padrão).
2 - Juros
3 - Ambos

MV_ITLBCPO

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

F/T

Informações

title	FAQs Protheus

Card

id	Cadastro de Adpter
label	Cadastro de Adpter \|
title	Cadastro de Adpter

Informações

title	Versão \|

Verificar a versão do Adpter no Sistema RM e replicar no Protheus .

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

Msg.
Única

Rotina

Mensagem

Envia

Recebe

Método

Operação

Canal

Condição

Versão (Protheus 11)

Versão (Protheus 12)

Sim

MATA020

CUSTOMERVENDOR

Sim

Síncrono

Todas

EAI

2.000

Sim

MATA030

CUSTOMERVENDOR

Sim

Síncrono

Todas

EAI

2.000

Sim

CTBA030

COSTCENTER

Sim

Síncrono

Todas

EAI

2.000

Sim

MATA070

BANK

Sim

Síncrono

Todas

EAI

2.000

Sim

FINA010

FINANCIALNATURE

Sim

Síncrono

Todas

EAI

2.000

Sim

FINA070

ACCOUNTRECEIVABLEDOCUMENTDISCHARGE

Sim

Não

Síncrono

Atualização

EAI

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

2.000

Sim

FINA070

REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE

Sim

Não

Síncrono

Exclusão

EAI

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

2.000

Sim

FINA080

ACCOUNTPAYABLEDOCUMENTDISCHARGE

Sim

Não

Síncrono

Atualização

EAI

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

2.000

Sim

FINA080

REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE

Sim

Não

Síncrono

Exclusão

EAI

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

2.000

Sim

FINA055

FINANCING

Sim

Síncrono

Todas

EAI

1.000

Sim

MATA120

ORDER

Sim

Síncrono

Todas

EAI

2.000

Sim

FINI070A

UPDATECONTRACTPARCEL

Sim

Síncrono

Todas

EAI

1.000

Sim

FINA040B

UPDATECONTRACTSTATUSPARCELSimNãoSíncronoTodasEAI1.000

Image Removed

Card

id	Configuração EAI e WS do RM
label	Configuração EAI e WS do RM \|
title	Configuração EAI e WS do RM

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

Image Removed

Card

id	Cadastro Bancário
label	Cadastro Bancário \|
title	Cadastro Bancário

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

Image Removed

Card

label	POC - Gestão de Imóveis com Prothues \|

Informações

Importante

Para garantir a qualidade, a Integração da Apuração de resultados (POC) com o BackOffice Protheus será validada em cliente piloto para que, posteriormente seja disponibilizada a todos os clientes.

Caso seja necessária a utilização deste recurso, entre em contato com o Suporte RM para que seja avaliada a possibilidade de participar do programa de pilotos.

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:

Apuração de Resultado Contábil
Cod. Modelo	Modelo de Cálculo	Contabilização
1	Cálculo por Empreendimento	Por Empreendimento
2	Cálculo por Subunidade/ Contrato	Por Empreendimento
3	Cálculo por Subunidade/ Contrato	Por Subunidade

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:

Mensagem Única

Rotina

Mensagem

Envia

Recebe

Método

Operação

Canal

Alias

Versão

Sim

CTBA020

ACCOUNTANTACCOUNT

Sim

Não

Síncrono

Todas

EAI

CT1

2.001

Sim

CTBA030

COSTCENTER

Sim

Não

Síncrono

Todas

EAI

CTT

2.000

Sim

CTBA040A

ACCOUNTINGITEM

Sim

Não

Síncrono

Todas

EAI

CTD

1.000

Sim

CTBA060

CLASSVALUE

Sim

Não

Síncrono

Todas

EAI

CTH

1.000

Sim

CTBA102

ACCOUNTINGENTRY

Não

Sim

Síncrono

Todas

EAI

CT2

2.001SimCTBA800ALISTOFMANAGERIALACCOUNTINGENTITYNãoSimSíncronoTodasEAICV01.000SimCTBXSINTACCOUNTINGBALANCENãoSimSíncronoTodasEAICQ01.000SimFINA055FINANCING NãoSimSíncronoTodasEAISE11.002SimCTBA140CURRENCYSimNãoSíncronoTodasEAICTO2.001

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.

Método

ID

Descrição

Origem

Destino

XSD (versões podem variar)

Pré-Requisitos (ID)

Cadastros

01

Centro de Custo

Protheus

RM

CostCenter_2_000.xsd

02

Classe de Valor

Protheus

RM

ClassValue_1_000.xsd

03

Conta Contábil

Protheus

RM

AccountantAccount_2_001.xsd

04

Conta Gerencial

RM

Protheus

ListOfManagerialAccountingEntity_1_000.xsd

05

Item Contábil

Protheus

RM

AccountantItem_1_000.xsd

Processos

06

Consulta Saldo ContábilRMProtheusAccountingBalance_1_000.xsd01, 03, 0407Lançamento ContábilRMProtheusAccountingEntry_2_001.xsd01, 02, 03, 04, 0508Lançamento FinanceiroRMProtheusFinancing_1_002.xsd

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.

Image Removed

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

Image Removed

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.

Image Removed

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