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.

              

     

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

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

    1.2.   Pré-requisitos Linha RM

    Utilizar a versão 12.1.2209 ou superior.

     

     

    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   ( Localhost trocar pelo nome do Servidor )

     

     

    Msg. Rotina Mensagem Envia Recebe Método Operação Canal  Versão 
    Sim CRMA980 CUSTOMERVENDOR Sim Sim Síncrono Todas EAI 2.002
    Sim MATA020 CUSTOMERVENDOR Sim Sim Síncrono Todas EAI 2.002
    Sim CTBA030 COSTCENTER Sim Sim Síncrono Todas EAI 2.000
    Sim MATA070 BANK Sim Sim Síncrono Todas EAI 2.001
    Sim FINA010 FINANCIALNATURE Sim Sim Síncrono Todas EAI 2.000
    Sim FINI035LST LISTOFCOMPLEMENTARYVALUE                           Não Sim Síncrono Todas EAI 1.000
    Sim FINA080 REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE Sim Não Síncrono Exclusão EAI 2.000
    Sim FINA080 ACCOUNTPAYABLEDOCUMENTDISCHARGE Sim Não Síncrono Atualização EAI 2.000
    Sim FINA080 REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE Sim Não Síncrono Exclusão EAI 2.000
    Sim FINA055 FINANCING Sim Sim Síncrono Todas EAI 1.002
    Sim MATA120 ORDER Sim Sim Síncrono Todas EAI 3.005
    Sim MATA105 REQUEST Não Sim Síncrono Todas EAI 1.009
    Sim MATA110 REQUEST Não Sim Síncrono Todas EAI 1.009
    Sim FINA040B UPDATECONTRACTSTATUSPARCEL Sim Não Síncrono Todas EAI 1.000
    Sim MATA120 ORDER Não Sim Síncrono Todas EAI 3.005

     

     

    Para que possamos vincular um Banco RM com Protheus é preciso os seguintes passos abaixo:

    Entrar no Módulo = Integração

    EAI2.0 | Configurador 

    Inserir o usuário e senha do Login RM e em seguida ( Clicar em - Para Avançar - Teste a conexão ).

    Selecionar a Integração - TOTVS Gestão de Imóveis x Backoffice Protheus

    Nesta tela deve-se informar os seguintes dados:

    WebService RM : http://localhost:8051/EAIService/IConWSEAIService   : Informar o servidor onde encontra-se ativo o WebService do RM

    EAI do Protheus: http://localhost:8086/EAISERVICE.apw?WSDL            : Informar o Servidor onde encontra-se ativo do EAI do Protheus

    REST do Protheus : http://localhost:8087/REST                                       : Informar o Servidor onde encontra-se ativo do REST do Protheus

    Usuário e senha do Protheus.


    Para que possa ser validado , EAI e REST do Protheus tem que estar ATIVO.

    Nesta etapa , deve informar Coligada e Filial do RM e Grupo e Empresa - Unidade de negócio - Filial ) Protheus que serão integrados.

    Neste momento do Configurador é feita uma varredura nas Tabelas do Protheus e é caso ocorra alguma incompatibilidade , o configurador te avisa e alerta sobre o erro e não deixa seguir com a configuração.

    Fazendo com que o usuário entre no Protheus e faça os devidos ajustes. 

    Exemplo de Inconsistência.

    Sistema avisa que deve ser arrumado o nível de compartilhamento de uma determinada tabela no Protheus.

    Para corrigir: Entrar no Protheus ( APSDU )

    Selecionar : Top Connect - Topconn 

    Localizar a tabela ( SX2 ---- ) Ok em Seguida 

    Útil | Filtrar

    Campos : X2_Chave

    Operadores : Igual a 

    Em Expressão: Informar a Tabela que ocorreu Inconsistência .. And e em Seguida ( OK )

    Basta editar o campo da incostência.

    Em caso de dúvida sobre as inconsistências e de como devem ficar as tabelas com seus níveis ( Compartilhado ou Exclusivo ) , favor entrar em contato com SUPORTE DO PROTHEUS.


    Feito os acertos , basta avançar no processo e se já fez um BKP do ambiente seguir com Configurador.

    Configuração feita e criado todos os Adpters no Protheus e suas configurações precisas para funcionar a Integração TCGI com Protheus.

     

    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.

       

      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.

      Gerando Títulos ao Protheus

      O RM quando integrado ao Backoffice Protheus tem duas opções para tratar os lançamentos financeiros:
      1 - Gerar os lançamentos no Backoffice Protheus assim que o plano de financiamento é gerado para o contrato, todos ficando bloqueados no RM para qualquer tipo de alteração até que se efetive o contrato.

      Acesse o menu: Ambiente | Parâmetros | [22.04] - Integração Financeira (clique em "Avançar") | Bloqueio de lançamento venda.
      A opção "Bloqueio de lançamento venda" deverá ficar com o campo 'Tipo de bloqueio venda:' com o valor [Bloqueado]


      OU

      2 - Gerar os lançamentos financeiros somente no RM, onde estes não são enviados ao Protheus. Para isso deverá ser efetuada a seguinte parametrização nos parâmetros gerais do TCGI.

       VEJA COMO CONFIGURAR!

      Acesse o menu: Ambiente | Parâmetros | [22.04] - Integração Financeira (clique em "Avançar") | Bloqueio de lançamento venda.
      A opção "Bloqueio de lançamento venda" deverá ficar com o campo 'Tipo de bloqueio venda:' com o valor [Provisionado], então abrirá mais dois campos para informar os tipos de documento a pagar e receber que deverão ser informados obrigatoriamente 'PR - Provisão'

       

       

      Este documento tem por objetivo demonstrar como poderá ser montado o arquivo fiscal SPED quando integrado ao backoffice Protheus.

      SPED: F200 / 1800

      Usuário Fiscal do Protheus, pode utilizar os dados para o registro F200/1800 na elaboração do SPED Contribuições emitido pelo backoffice do RM TCGI.

      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.
      Para saber como disponibilizar o serviço rest pelo host do RM entre no caminho: 

      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: Pontos de Entrada Fiscal Protheus

      Como Fazer no Protheus

      • Caso o cliente possua mais de uma empresa no Protheus vinculadas as coligadas do RM: 
        Exemplo 1: 

        Empresa Protheus

        Filial Protheus

        Coligada RM

        Filial RM

        10 01 6 1
        10 02 6 2

        Protheus poderá solicitar uma unica vez passando no body da API o valor da coligada do RM e as Filiais em array:
        {
            "CodigoColigada" :"6",
            "CodigosFiliais" :[1,2],
            "DataInicial"  :"2020-01-01",
            "DataFinal" : "2020-12-31"
        }

        Exemplo 2:

        Empresa Protheus

        Filial Protheus

        Coligada RM

        Filial RM

        12 1 8 1
        13 1 9 1
        14 1 20 1

        Protheus terá que solicitar a geração dos dados de cada empresa, passando no body da API o valor da coligada do RM e as Filial do RM:
        1º solicitação:
        {
            "CodigoColigada" :"8",
            "CodigosFiliais" :[1],
            "DataInicial"  :"2020-01-01",
            "DataFinal" : "2020-12-31"
        }

        2º solicitação:
        {
            "CodigoColigada" :"9",
            "CodigosFiliais" :[1],
            "DataInicial"  :"2020-01-01",
            "DataFinal" : "2020-12-31"
        }

        3º solicitação:
        {
            "CodigoColigada" :"20",
            "CodigosFiliais" :[1],
            "DataInicial"  :"2020-01-01",
            "DataFinal" : "2020-12-31"
        }


      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.

      Importante!

      • Configure no empreendimento e nas subunidades as informações necessárias para a geração dos blocos de contribuições fiscais.
      • Faça a geração do arquivo de contribuições utilizando o Fiscal RM e verifique se os blocos foram preenchidos corretamente. Dando certo, os valores serão retornados iguais na API.
        Como gerar arquivo fiscal RM: Acesse aqui!
      • Ao acessar o swagger (Como Acessar Api's RM) o serviço poderá ser encontrado dentro da arvoré de 'ImbEmpreendimento'



      Abaixo é demonstrado 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 / 205 / 210
      Todas as informações relacionadas aos registros 200, 205 e 210 será retornados pela api "registryF200".

      Caminho: http://localhost:{porta-configurada-host}/api/imb/v1/realestates/registryF200
      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 que irá trazer uma lista dos blocos (200, 205 e 210) preenchidas, caso já tenha sido configurado e tenha dados para ser retornado no perído do filtro solicitado pela requisição POST com o filtro do Body, no vídeo abaixo, não temos nenhum dados configurado, assim o array de Itens fica vazio:


      Na imagem abaixo temos um outro exemplo, que após ser solicitado via postman tem os dados retornados dentro do array.
      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.


      1800

      Caminho:  http://localhost:{porta-configurada-host}/api/imb/v1/realestates/registry1800
      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:

       

      Importante

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

       

      Baixa TOTAL feita no RM para o Protheus

      Lançamento Receber.

      Baixado total no RM .

      Status do Título no RM fica na cor Verde.

      SIGAFIN ( PROTHEUS )

      Título é Baixado TOTAL no Protheus. 

      Status fica na COR Vermelha no Protheus.


      Baixa Parcial RM para Protheus

      Baixando um título parcialmente no RM .. 

      Status no RM fica na cor Amarela.

      No Protheus o Status fica na cor AZUL do título com Baixa Parcial.




       

       

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

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

      Criando uma nova Parcela do Tipo de Adiantamento

      Recebíveis | Lançamentos

      Novo

      Tipo de Documento : TIPO DE ADIANTAMENTO

      Classificação : Adiantamento

      Pagar e a Receber

      Clicar em SALVAR


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

      Parâmetros | TOTVS Gestão Financeira

      02.01.02 – Baixa

      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 )


      Assuntos relacionados: Como criar Adiantamento

       

       


      Gerando acordo Financeiro do TCGI com  o Protheus.

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

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

      Inserir o Template criado ao perfil do usuário.

      Configurando parametros do TCGI  - Integração Financeira

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


      Gerando Acordo!

      Selecionado as parcelas para Acordo Financeiro.

      Processos | Gerar Acordo

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

      Parcelas de Acordo criadas no Protheus.

      Processo relacionado: FIN - Acordo

       

       

      Como realizar distrato: Distrato - Incorporação

      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:
      Caso exista um fornecedor cadastrado com o mesmo CPF/CNPJ do cliente do contrato, e a integração estando ativa, a tela de associação de fornecedor já aparecerá com o mesmo selecionado,
      Para que seja possível trocar o Fornecedor por um com o CPF/CNPJ diferente do existente no contrato que está sendo distratado, terá que ser parametrizado no sistema está possibilidade.

      Veja abaixo exemplo de Distrato TCGI com Protheus:

      1º - Entrar no cadastro do Cliente no RM ( Integração - Incluir o Fonecedor ao cadastro do Cliente. )

      2º - Contrato de Venda efetivado e neste exemplo já encontra-se com 1 Parcela baixada.

      3º - Gerando o Distrato no Contrato de Venda. 

      Neste exemplo , o distrato esta configurado para gerar parcela à Pagar no protheus e cancelar todas parcelas do contrato vigente.

      Fornecedor vinculado ao cadastro do Cliente é inserido ja nesta etapa.

      Lançamento à pagar gerada ao contrato de compra e venda - Efetivando distrato.

      Contrato agora encontra já no Status de Distrato e com um Título à Pagar em seu plano de financiamento.


      4º - Baixando o título à Pagar 

      Baixa neste caso é feita pelo BackOffice Protheus.

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

      Selecionar o Título .

      Outras Ações | Baixa Manual | Baixar

      Selecionar a forma de Pagamento e Banco e em seguida : Salvar 

      Título baixado no Protheus e RM.












       

       

      Gerando pedido de Compra no Protheus ( SIGACOM ) 

      Configurando TIPO de Movimento no TOTVS Gestão de Estoque e Compras.


      Tipos de Movimentos utilizados na Integração TCGI com Módulo SIGACOM do Protheus.

      • 1.1.70
      • 1.1.71
      • 1.1.72
      • 1.1.73

      Tipo de Classificação do Tipo de Movimento : Outras Movimentações

      OBS: Para configurar os tipos de Movimentos , é preciso alguns cadastros do Protheus como por exemplo:

      • Local de Estoque
      • Condição de Pagamento

      Cadastro de Serviço no Protheus SIGACOM

      • Unidade de Controle   ( Cadastro de Unidade de Medida no Protheus )
      • Unidade de Compra    ( Cadastro de Unidade de Medida no Protheus )
      • Unidade de Venda      ( Cadastro de Unidade de Medida no Protheus )

      ( SIGACOM ) Atualizações | Cadastros | Tipos de Entrada e Saída

      Precisa cadastrar uma saída com código 501 para que possa funcinar a Integração TCGI / Protheus.

      • Código = 501
      • Tipo de TES = Saída
      • Txt Padrão = TESTIN

      Após cadastrar o Tipo de entrada e Saída no Protheus , é preciso fazer o cadastro no RM ( Integração ).

      EAI 2.0 | Parâmetros adpter 

      Cadastro com os seguintes dados:

      • Coligada 
      • Nome do Parâmetro = Neste caso o nome ( TESTIN )
      • Tipo = Texto
      • Valor = 501 


      Para gerar Comissão e sua configuração :CLIQUE AQUI !

      Comissão gerada no TCGI  ( Comissão configurada para utilizar o TIPO de Movimento integrado ao Protheus )


      Informando os seguintes dados :

      • Coligada origem
      • Coligada do Movimento
      • Produto ( Serviço cadastrado no Protheus )
      • Tipo de Movimento (  neste caso 1.1.71 - Um dos Movimentos que serão utilizados para integração )
      • Filial


      Integrando Parcela da Comissão 

      ( SIGACOM ) 

      Atualizações | Solicitações | Solicitação de Compras

      Pedido de Compra enviado para o Protheus 













       

      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.

      Clique abaixo para saber mais sobre :

      CONTTRATO DE LOCAÇÃO

      CONTRATO DE ADMINISTRAÇÃO

      EVENTO FINANCEIRO





      • Sem rótulos