Versões comparadas

Chave

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

...

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 (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
idConfigurando EAI RM - Host |
labelConfigurando EAI RM - Host |
titleConfigurando EAI RM - Host |

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

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

Campos e apresentação dos valores no Protheus.

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íncronoTodasEAI
1.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: https://tdn.totvs.com/pages/viewpage.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 os dados do Arquivoretorno e disponibilidade do mesmo para consumo.

Exemplo do teste:

{

    "CodColigada" de montagem no postman:
F200

Body (raw - JSON(application/json))
{
    "CodigoColigada" :"6",
        "FilialCodigosFiliais"   :[1],
        "DtInicialDataInicial"    :"2020-01-01",
        "DtFinalDataFinal"   :   "2020-12-31"
   }

Image Removed

Image Removed

Informar dados para executar o processo.

Postman executa e processa um Retorno.

Image Removed

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

Image Added

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 Added


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 Added

CADASTROS / PROCESSOS TCGI

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
idProcessos Contábeis
labelProcessos Contabeis |
titleProcessos Contábeis

Processos Contábeis :

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

Processos : Processos Contábeis


Card
idCadastro Bancário
labelCadastro Bancário |
titleCadastro Bancário

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


Card
idCliente / Fornecedor
labelCliente / Fornecedor |
titleCliente / Fornecedor

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


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


Card
idAdiantamento
labelAdiantamento |
titleAdiantamento
  • 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 )


Card
labelDistrato |

Distrato: Processo Distrato - (Integração RM TCGI x Backoffice Protheus - EAI2)


Card
labelAcordo Financeiro

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.

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 |

Tudo sobre Evento Financeiro : CLIQUE AQUI !








...