Versões comparadas

Chave

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


Image RemovedImage Added

               O TCGI (TOTVS CONSTRUÇÃO GESTÃO DE IMÓVEIS) é o sistema de gestão de Vendas/Locaçõ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.

              

Adapters: TOTVS Construção Gestão de Imóveis x BackOffice Protheus

Campos e apresentação dos valores no Protheus.

Deck of Cards
idPAI
Pré-RequisitosRequisitos

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

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.1.25 ou superior

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

1.2.   Pré-requisitos Linha RM

Utilizar a versão 12.1.28 ou superior.

Card
id
Pré
labelPré-Requisitos |title

HTML-

Card
idConfigurando EAI RM - Host |
labelConfigurando EAI RM - Host |
titleConfigurando EAI RM - Host |

Incluir Página
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

Configurando WebService/EAI do RM: Como Expor os Web Services do RM através do Host (recomendado)

Caminho do serviço RM após ter sido configurado estará ao final da apresentação do mesmo no browser como descrito no link acima, a tag wsdl com o atributo name="RM_IRMSServer" o valor do atributo location será o valor que deverá ser inserido no parâmetro MV_EAIURL2 do Protheus.
http://localhost:8051/EAIService/IConWSEAIService

Card
labelConfigurando Integração RM com Protheus
Card
idConfigurador Integração |
labelConfigurador Integração |
titleConfigurador Integração |
Informações
titleConversor EAI 1.0 para EAI 2.0

Para o cliente que já possua a integração do EAI 1.0 rodando, será necessário a conversão para EAI 2.0: Mais detalhes , Clique aqui !!!

Para configurar um ambiente integrado diretamente no EAI 2.0, deverá seguir os passos da documentação: Configurador EAI 2.0 - RM x PROTHEUS

Card
idAdpters Utilizados |
labelAdpters Utilizados |
titleAdpters Utilizados |

Msg.
Única

Rotina

Mensagem

Envia

Recebe

Método

Operação

Canal

Condição

 Versão 

(Protheus 11)

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
Card
labelF200 / 1800

SPED: F200 / 1800

Usuário Fiscal do Protheus, pode utilizar os dos dados para o registro F200 na elaboração do SPED Contribuições emitido por esse backoffice.

Foi criado um serviço REST no TCGI para que o backoffice Protheus possa buscar as informações necessárias para a montagem dos arquivos F200 e 1800.

No Protheus deverá ser utilizado o ponto de entrada disponível na documentação sobre o ponto de entrada para a geração do arquivo:

HTML Include
url
https://tdn.totvs.com/plugins/
pages
viewsource/
viewpage
viewpagesrc.action?pageId=
369623323

Utilizando o ponto de entrada Protheus e requisitando através do serviço Rest do TCGI os valores já montados pelo RM para a composição dos arquivos F200 e/ou 1800, será possível a montagem do arquivo com todos os dados de incorporação corretamente.

Abaixo iremos demonstrar o funcionamento das APIs de retorno dos valores do Sped F200 e 1800
Rest sendo rodado via Postman para verificar retorno e disponibilidade do mesmo para consumo.

Exemplo de montagem no postman:
F200

Body (raw - JSON(application/json))
{
    "CodigoColigada" :"6",
    "CodigosFiliais" :[1],
    "DataInicial"  :"2020-01-01",
    "DataFinal" : "2020-12-31"
}

Demonstração do consumo do serviço F200:

Image Removed

Retorno da mensagem de uma solicitação de valores para a montagem do F200, para um período que possui dados para retorno:
Comparativo do Retorno Postman com o Arquivo Gerado F200.

Image Removed

1800

Body (raw - JSON(application/json))
{
    "CodigoColigada" :"6",
    "CodigosFiliais" :[1],
    "DataInicial"  :"2020-01-01",
    "DataFinal" : "2020-12-31"
}

Demonstração do consumo do serviço 1800:
Image Removed

CADASTROS / PROCESSOS TCGI

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

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)

Card
idProcessos ContábeisCadastros da Integração
labelProcessos Contabeis Cadastros da Integração |
titleProcessos Contábeis
Card
idCadastro Bancário
labelCadastro Bancário |
titleCadastro Bancário
Card
idCliente / Fornecedor
labelCliente / Fornecedor |
titleCliente / Fornecedor
Cadastros 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
idContrato de Venda |
labelContrato de Venda |
titleContrato de Venda |

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.

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.

Processo da Baixa: Processo - Baixa Titulo a Receber Integrado ao Protheus

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

Adiantamento
Card
Card
id
title
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

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

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

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 )

Card
labelDistrato |

HTML Include
urlhttps://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012078
Distrato: Processo Distrato - (Integração RM TCGI x Backoffice Protheus - EAI2)

Gerando acordo Financeiro do TCGI com  o Protheus.

Image Removed

Entrar no TOTVS Gestão Financeira para cadastrar um Template de Acordo.

Image Removed

Em seguida, entrar no cadastro do Perfil de usuário , Sistema : Gestão Financeira | Anexos | Tamplates de Acordo Financeiro

Image Removed

Inserir o Template criado ao perfil do usuário.

Image Removed

Configurando parametros do TCGI  - Integração Financeira

Informar um componente que seja do tipo Princial para se gerar o Acordo.

Gerando Acordo!

Image Removed

Selecionado as parcelas para Acordo Financeiro.

Image Removed

Processos | Gerar Acordo

Image Removed

Acordo gerado no RM e parcelas criadas no Protheus conforme Tamplate.

Image Removed

Parcelas de Acordo criadas no Protheus.

Card
labelAcordo Financeiro
Gerando Comissão - Pedido de Compra |

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

Tudo sobre Evento Financeiro : CLIQUE AQUI !

Clique abaixo para saber mais sobre :

CONTTRATO DE LOCAÇÃO

CONTRATO DE ADMINISTRAÇÃO

EVENTO FINANCEIRO

Card
labelAluguel & Protheus

ALUGUEL

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