Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Image Added

...

Informações
titleEAI 2.0

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

               O TCGI (TOTVS CONSTRUÇÃO GESTÃO DE IMÓVEIS) é o sistema de gestão de Vendas/LocaçoesLocações/Condomínio da TOTVS. Com o 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 facilitar a utilização integrada do módulo financeiro do BackOffice Protheus. A seguir mais detalhes sobre o escopo da integração.

              

Informações
titleObservaçã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.

Parâmetros Opcionais

MV_EAISRC

     Ao ultilizar o sistema Protheus para integrações, o Source Aplication do  ambiente é formado pelo nome do ambiente + o grupo de empresas, entretanto pode ser substituída pelo conteúdo do parâmetro MV_EAISRC

MV_EAICONV

     Endereço para buscar do conversor de XML/JSON, para que o sistema utilize o serviço. Por padrão é definido o endereço na TOTVS.

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
idPAI
Card
labelPré-Requisitos

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=778788401

Card
labelConfigurando WebServiçe RM

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012234

Card
labelAdpters Integração TCGI / Protheus

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012301

Card
labelConfigurando Integração RM com Protheus

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012346

Image Added

Informações
titleObservaçã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
idPai2
Card
idCadastros da Integração
labelCadastros da Integração |
titleCadastros da Integração

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=547246128

Card
accessKeycontratovendaeai2
idContrato de Venda |
labelContrato de Venda |
titleContrato de Venda |

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780010027

Card
idSPED F200 / 205 /210 e 1800
labelSPED F200 / 205 /210 e 1800 |
titleSPED F200 / 205 /210 e 1800

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780009968

Card
idProcesso da Baixa de Títulos
labelProcesso da Baixa de Títulos |
titleProcesso da Baixa de Títulos
Nota
titleImportante

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

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780010907

Card
labelAdiantamento |

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780010980

Card
labelAcordo |

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780011883

Card
labelDistrato |

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012078

Card
labelGerando Comissão - Pedido de Compra |

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780015891

Card
labelAluguel & Protheus

ALUGUEL

Deck of Cards
idPAI
Card
idPré-Requisitos
labelPré-Requisitos |
titlePré-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.

CADASTROS / PROCESSOS TIN

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

CADASTROS / 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

CADASTROS / PROCESSOS TIN

Card
idInstalação Biblioteca RM
labelInstalação Biblioteca RM |
titleInstalação Biblioteca RM
Card
idConfigurações RM ( Integração )
labelConfigurações RM ( Integração ) |
titleConfigurações RM ( Integração )
Card
idInstalação e Configuração do Protheus
labelInstalação e Configuração do Protheus ( PROTHEUS 25 - LOBO GUARA ) |
titleInstalação e Configuração do Protheus
Informações
titleCompartilhamento

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

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

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

Próximo

Image Removed

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

Image Removed

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

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

Image Removed

Criando Empresa 

Image Removed

Inserindo Layout da Empresa

Image Removed

Image Removed

Brasil  | OK

Image Removed

Admin | entrar

Image Removed

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

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

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 receberF/T

MV_MULNATP

Define se vai haver rateio de Natureza Financeira no Contas a pagarF/T

MV_FINJRTP

Define o que considerar na baixa de titulo em atraso

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

MV_ITLBCPOLibera os campos Juros e Multa, caso tenha integração TINxProtheusF/T
Informações
titleFAQs Protheus
Card
idCadastro de Adpter
labelCadastro de Adpter |
titleCadastro de Adpter
Informações
titleVersã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

Sim

Síncrono

Todas

EAI

2.000

Sim

MATA030

CUSTOMERVENDOR

Sim

Sim

Síncrono

Todas

EAI

2.000

Sim

CTBA030

COSTCENTER

Sim

Sim

Síncrono

Todas

EAI

2.000

Sim

MATA070

BANK

Sim

Sim

Síncrono

Todas

EAI

2.000

Sim

FINA010

FINANCIALNATURE

Sim

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

Sim

Síncrono

Todas

EAI

1.000

Sim

MATA120

ORDER

Sim

Sim

Síncrono

Todas

EAI

2.000

Sim

FINI070A

UPDATECONTRACTPARCEL

Sim

Sim

Síncrono

Todas

EAI

1.000

Sim

FINA040B

UPDATECONTRACTSTATUSPARCELSimNãoSíncronoTodasEAI1.000

Image Removed

Card
idConfiguração EAI e WS do RM
labelConfiguração EAI e WS do RM |
titleConfiguração EAI e WS do RM

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

Image Removed

Card
labelPOC - 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

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= CIi /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   = CIi / valor do CUB Acumulado (até o mês de apuração)

POCCUB = CICUB / COCUB

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

    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)

    Erro

    Mensagem

    Origem / Motivo

    Solução

    General Error

    General Error http://172.116.103.189:92/EAISERVICE.apw?WSDL

    Verificar o serviço do EAI Protheus e/ou endereço configurado no RM

    HELP: SEMMOEDA  

    Nao existe moeda cadastrada!

    Verificar o cadastro do De/Para de moeda no Protheus. SE1T10 - Error : 1 - ORA-00001: unique constraint violated SE1T10 - Error : 1 - ORA-00001: unique constraint violatedVerificar se a numeração do HardLock referente a tabela SE1 (Campo E1_NUM ) está funcionando corretamente. Utilize a função APCFG110.

    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;
    Deck of Cards
    idPai2

    Processos Contábeis :

    • Plano de Contas
    • Centro de Custo
    • Ítem contábil
    • Classe de Valor
    • Lançamento Contábil

    Processos : Processos Contábeis

    Cadastro Bancário: Cadastro Bancário e/ou Convênio (Totvs Incorporação x Backoffice Protheus - EAI2)

    Cadastro de Cliente / Fornecedor: Cadastro Cliente/Fornecedor (Integração RM TCGI x Backoffice Protheus - EAI2)

    Contrato de Venda: Contratos de Venda - How To - Como cadastrar uma Venda

    Plano de Financiamento: Contratos de Venda - Processo - Gerar Plano de Financiamento

    Efetivando Contrato: Contratos de Venda - Processo - Efetivar Contrato
    Ao efetivar o contrato e o sistema estiver parametrizado para desbloquear os títulos no momento da efetivação do contrato, será enviado todos os títulos do RM ao Protheus.
    Para este envio de criação/atualização do título é utilizado a mensagem ( FINANCING ) para o BackOffice Protheus.

    Baixando um Lançamento no TOTVS Incorporação

    Image Removed

    Selecionar o Lançamento e em seguida = Baixa

    Image Removed

    Processo de Baixa no RM

    Image Removed

    Avançar

    Image Removed

    Baixado o título no RM

    Image Removed

    Atualizações | Contas a Receber | Funções Contas a Receber

    Image Removed

    Título Baixado no Protheus

    Image RemovedOBSERVAÇÃO

    Em caso de baixa com data retroativa veja como configurar o Protheus = > Parâmetros MV_DATAFIN e MV_BXDTFIN

    Cancelamento de Baixa

    Image Removed

    Cancelamento de Baixa

    Image Removed

    Baixa Cancelada no RM

    Image Removed

    Cancelada a Baixa no Protheus

    Baixa Parcial

    Image Removed

    Baixando o título Parcialmente

    Image Removed

    Baixa Parcial realizada

    Image Removed

    Image Removed Título Baixado no Protheus Parcialmente

    Lançamento a pagar

    Image Removed

    Selecionar o contrato e sem seguida : Anexos | Distrato

    Image Removed

    Novo

    Image Removed

    Inserir Código do Motivo do Distrato | Salvar e em seguida : Condições de Financiamento

    Image Removed

    Incluindo uma nova condição de financiamento

    Image Removed

    Componente = 600 ( Devolução )

    Informo nesta tela o Valor que será devolvido e quantidade de Parcelas

    E Natureza Orçamentaria a pagar

    Image Removed

    Gerando Plano de Financiamento do Distrato

    Image Removed

    Avançar

    Image Removed

    Selecionar o Fornecedor

    Image Removed

    Fornecedor selecionado e em seguida | Executar

    Image Removed

    Selecionar o Distrato e em seguida : Processos | Efetivar distrato

    Image Removed

    Após realizado o Distrato , as parcelas do Cliente foram todas canceladas e gerado um Lançamento a pagar para o Fornecedor selecionado no Processo.

    Image Removed

    Verificando o Lançamento a Pagar no Protheus

    Atualizações | Contas a Pagar | Funções Contas a Pagar

    Image Removed

    Título enviado para o BackOffice Protheus

    OBS: Baixa de títulos a pagar é feito pelo Protheus

    Image Removed

    Atualizações | Contas a Pagar | Baixas Pagas Manual

    Image Removed

    Baixando o título

    Image Removed

    ADITIVO ( Integrado ao Protheus )

    Image Removed

    Contrato novo criado no TOTVS Incorporação

    Image Removed

    Comprador inserido no contrato

    Image Removed

    Contrato criado no valor de R$50.000,00 Reais e em 10 Parcelas de R$5.000,00

    Image Removed

    Plano de Financiamento Efetivando e em Seguida , efetivando o Contrato

    Image Removed

    Contrato efetivado

    Image Removed

    10 Parcelas enviadas para o Protheus

    Image Removed

    Selecionar o contrato em seguida : Anexos | Aditivo

    Image Removed

    Inserindo um novo Aditivo

    Image Removed

    Neste exemplo , RENEGOCIAÇÃO DE CONTRATO

    Image Removed

    Clicar em : Condição de Financiamento

    Image Removed

    Incluindo um novo Componente

    Image Removed

    Neste exemplo , incluído o componente ( DECORAÇÃO ) , acrescentando em seu contrato mais 2 Parcelas de R$750,00 Reais

    Image Removed

    Gerando Plano de Financiamento do Aditivo

    Tipo de Renegociação neste caso : Inclusão

    Image Removed

    Processo para efetivar o Plano

    Image Removed

    Em seguida: Efetivando o Aditivo

    Processos | Efetivar Aditivo

    Image Removed

    Aditivo efetivado

    Image Removed

    • Help para se Parametrizar e utilizar ( ADIANTAMENTO ) Integração TIN x Protheus

    Image Removed

    Contrato criado no TOTVS Incorporação

    Image Removed

    Comprador vinculado ao Contrato

    Image Removed

    Efetivando Contrato

    Image Removed

    Contrato efetivado

    Image Removed

    Parcelas enviadas para o Protheus

    Image Removed

    Exemplo : Parcela no Valor de R$1.143,77 Reais

    Image Removed

    Criando uma nova Parcela do Tipo de Adiantamento

    Recebíveis | Lançamentos

    Novo

    Image Removed

    Tipo de Documento : TIPO DE ADIANTAMENTO

    Image Removed

    Classificação : Adiantamento

    Pagar e a Receber

    Clicar em SALVAR

    Image Removed

    Este erro mostra que O Tipo de documento te que ser criado no Protheus e com o mesmo código que esta sendo utilizado no TOTVS Incorporação

    Image Removed

    Módulo ( SIGACFG )

    Image Removed

    Cadastros | Tabelas

    Image Removed

    Editar tabela : TIPOS DE TÍTULOS

    Image Removed

    O Cadastro do Tipo de Documento no Protheus tem que possuir a Chave = ao Código do Tipo de Documento do RM.

    Image Removed

    Outro tipo de Documento que deve ser cadastrado e parametrizado.

    ( Crédito de Adiantamento )

    Este é informado no TOTVS Gestão Financeira ( Parâmetros )

    Image Removed

    Parâmetros | TOTVS Gestão Financeira

    Image Removed

    02.01.02 – Baixa

    Image Removed

    Inserindo o Tipo de Documento ( Crédito de Adiantamento )

    Código do Tipo de Documento neste exemplo = NCA

    Criando este Tipo de Documento no Protheus com este mesmo código ( NCA )

    Image Removed

    Criando um novo :

    Selecioando o útlimo Típo de Títulos no Protheus ( Seta para baixo ) para inserir mais uma LINHA e ai neste momento incluír o novo com Código ( NCA )

    Image Removed

    Criado o novo Tipo de Título no Protheus com mesmo código do RM.

    Image Removed

    Após criar os Típos de Títulos no Protheus ( Salvar ) para criar o lançamento de Adiantamento no RM.

    Image Removed

    Lançamento salvo e Criado

    Image Removed

    Lançamento enviado para o Protheus

    Image Removed

    Baixando titulo no RM

    Image Removed

    Baixando o Titulo

    Image Removed

    Image Removed

    Avançar

    Image Removed

    Título baixado

    Image Removed

    Titulo Baixado no Protheus

    Image Removed

    Baixando o Título no contrato do cliente no Valor de R$1.453,77 e será aproveitado o Adiantamento feito rescentemente neste mesmo valor.

    Image Removed

    Clicar em Editar

    Image Removed

    Image Removed

    Image Removed

    Avançar

    Image Removed

    Image Removed

    Parcela Baixada no RM.

    Image Removed

    Título Baixado no PROTHEUS

    Image Removed

    Feita a baixa no valor ( ZERADO ) utilizando todo saldo de Adiantamento

    Sobre ferramenta de Diagnóstico ==== > Utilitários - Conversores - Diagnóstico de Integração

    Exemplo de Título Baixado no Protheus e em Aberto no RM 

    1º ) Dando permissão para o Usuario do banco de Origem efetuar conexão com o Banco Destino

    Selecionando o usuário do Banco Origem ( rm ) em seguida – Properties

    Image Removed

    Image Removed

    Server Roles |

    Marcar o parâmetro = SYSADMIN

    Image Removed

    Projetos | Utilitários | Diagnóstico de Integração.

    Image Removed

    Configurando a conexão com Banco Proheus.

    Neste caso a Ferramenta de Diagnostico vai ajustar títulos que encontram-se Baixados no Protheus e em Abertos no RM .. Cancelando a Baixo dos mesmos no Protheus.

    Image Removed

    Contrato criado = Cliente ( CLIENTE FERRAMENTA DIAGNOSTICO )

    Image Removed

    Título em Aberto no RM 

    Image Removed

    Título Baixado no Protheus

    Image Removed

    Corrigindo a inconsistência do Título em: Utilitários | Diagnóstico de Integração

    Image Removed

    Corrigindo o título que encontra-se Baixado no Protheus e no RM continua em aberto.

    Título do Contrato : 2527

    Image Removed

    Avançar

    Image Removed

    Cancelar Baixa

    Image Removed

    Título no Protheus passou a ficar em Aberto.

    As parcelas a pagar do TIN geradas pelo distrato, serão gerenciadas pelo Protheus assim como no EAI 1.0. Abaixo temos alguns pontos a serem verificados para podermos gerarmos os títulos a pagar no Protheus.

    1) Natureza financeira a pagar.

    É necessário cadastrar no Protheus uma natureza financeira a pagar, esta natureza deve ter o parâmetro "Uso natureza" como LIVRE para funcionar corretamente.

    Image Removed

    2) Tipo de Título / Tipo de Documento

    Caso desejar utilizar o mesmo tipo de documento cadastrado no RM, devemos no protheus cadastrar o tipo de título correspondente, conforme imagem abaixo.

    Tipo de documento RM

    Cadastro de Tipo de Documento RMImage Removed

    Tipo de Título Protheus

    Cadastro de Tipo de Título ProtheusImage Removed

    Além desse cadastro, é necessário ativar o parâmetro de integração USESDOCUMENTTYPE. Assim será possível definir qual tipo de documento será utilizado. Este cadastro fica no sistema Integração no RM no menu EAI 2.0 → Parâmetros adapter.

    Image Removed

    3) Parametrização RM

    Existe no RM um parâmetro para o bloqueio de lançamentos de distrato. Com o parâmetro como Bloqueado, o protheus irá gerar os títulos com o Tipo de Documento "NF". 

    Bloqueio de lançamentos de distratoImage Removed

    Ou então Provisionado, sendo que deveremos escolher o tipo de documento para este caso.

    Image Removed

    4) Geração do distrato

    Para gerar o distrato é necessário uma venda efetivada e com o contrato gerado de acordo com a parametrização.

    Para maiores informações sobre como realizar um distrato acesse: Distrato - Incorporação

    Image Removed

    É necessário informar um plano de financiamento de distrato e então executar o processo de gerar plano de financiamento de distrato, e depois efetivar o distrato.

    Image Removed

    Ao avançar no processo para gerar o plano de financiamento de distrato, aparecerá uma tela em que é possível escolher qual o fornecedor irá receber as parcelas de devolução, conforme imagem abaixo:

    Image Removed

    No protheus, os títulos são gerados de acordo com as parametrizações acima, como podemos ver.

    Image Removed

    5) Baixa de títulos a pagar

    Todo o módulo de contas a pagar será gerenciado pelo Protheus, a baixa e o cancelamento de baixa será feito como no EAI 1.0. A baixa total ou parcial do título refletirá nos lançamentos de distrato do RM. 

    Image Removed

    Tela de baixa

    Image Removed

    Posição do Título baixado (Menu Outras Ações → Posição )

    Image Removed

    Foi inserido um movimento de baixa no título. 

    Image Removed

    Dentro da venda no TIN, podemos ver que a parcela foi baixada.

    Image Removed

    6) Cancelamento de baixa.

    O cancelamento da baixa será feito também pelo Protheus. O resultado da baixa também será refletido no TIN.

    A mensagem responsável por esse processo é a REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE.

    Tela de cancelamento:

    Image Removed

    Após a baixa, o título volta a ficar em aberto, e é incluído um movimento de cancelamento de baixa. O saldo do Título volta para o valor anterior a baixa.

    Image Removed

    No RM, ao verificar os lançamentos financeiros, o lançamento financeiro está em aberto e o saldo está idêntico ao do Protheus.

    Image Removed

     Image Removed

    Tudo sobre Evento Financeiro : CLIQUE AQUI !

    Clique abaixo para saber mais sobre :

    CONTTRATO DE LOCAÇÃO

    CONTRATO DE ADMINISTRAÇÃO

    EVENTO FINANCEIRO

    Card
    idProcessos Contábeis
    labelProcessos Contabeis |
    titleProcessos Contábeis
    Card
    idCadastro Bancário
    labelCadastro Bancário |
    titleCadastro Bancário
    Card
    idCliente / Fornecedor
    labelCliente / Fornecedor |
    titleCliente / Fornecedor
    Card
    idContrato | Plano de Financiamento | Efetivar Contrato
    labelContrato | Plano de Financiamento | Efetivar Contrato |
    titleContrato | Plano de Financiamento | Efetivar Contrato
    Card
    idBaixa Total | Cancelamento de Baixa | Baixa Parcial
    labelBaixa Total | Cancelamento de Baixa | Baixa Parcial |
    titleBaixa Total | Cancelamento de Baixa | Baixa Parcial
    Card
    idLançamento a Pagar
    labelLançamento a Pagar |
    titleLançamento a Pagar
    Card
    idAditivo
    labelAditivo |
    titleAditivo
    Card
    idAdiantamento
    labelAdiantamento |
    titleAdiantamento
    Card
    idFerramenta de Diagnostico
    labelFerramenta de Diagnostico |
    titleFerramenta de Diagnostico
    Card
    labelDistrato com Devolução e Geração de Títulos no Protheus |
    Deck of Cards
    idProcessos do Aluguel.
    Aluguel :

    Com a integração TOTVS Construção Gestão de Imóveis x Protheus, todos os lançamentos de aluguel serão enviados ao Protheus, para acontecer esse envio, deve ser necessário realizar os seguintes processos:

    Lançamentos a receber: Em um contrato de locação efetivado, basta executar o processo de gerar os lançamentos financeiros.
    Lançamentos de repasse: O imóvel do contrato de locação deve estar atrelado ao contrato de administração, ao executar o processo de gerar os lançamentos financeiros, será criado uma parcela a pagar.
    Evento financeiro: Ao criar o evento financeiro avulso, devemos associar este evento a um contrato de locação efetivado, e depois executar o processo de Incluir lançamento financeiro. Assim será gerado um lançamento a receber e um pagar dentro do contrato de locação e também no Protheus. Já no evento financeiro agregado, será adicionado ao lançamento do

    TIN

    TCGI o valor correspondente, no protheus um novo componente será adicionado na parcela.

    Card
    labelContrato de Locação |

    Tudo sobre Contrato de Locação : CLIQUE AQUI !

    Card
    labelContratos de Administração |

    Tudo sobre Contrato de Administração : CLIQUE AQUI !

    Card
    labelEvento Financeiro |