|
| Pré-Requisitos |
label | Pré-Requisitos | |
---|
title | Pré-Requisitos |
---|
Este documento tem por objetivo reunir as informações relevantes sobre a Integração do BackOffice Protheus e TOTVS Incorporação (TIN). A integração respeita todos os pré-requisitos definidos pelas linhas de produto TOTVS envolvidos. Para mais detalhes sobre configuração de hardware recomendada, sistema operacional, bancos de dados suportados e demais dados, consulte os seguintes documentos no TDN: Documento de Portabilidade da Linha RM Os produtos envolvidos utilizam o modelo de licenciamento padrão (License Server). Para pleno funcionamento, as licenças (Hard Lock) devem ser providenciadas junto a TOTVS com antecedência. Vale ressaltar que esta integração está de acordo com as boas práticas recomendadas pelo Comitê de Integração TOTVS e utiliza a arquitetura Mensagem Única e comunicação via WebServices. 1.1. Pré-requisitos Linha Protheus Utilizar a versão 12 (ou superior) Os WebServices exigem uma licença específica “TOTVS I” 1.2. Pré-requisitos Linha RM Utilizar a versão 12.1.23 ou Superior. CADASTROS / PROCESSOS TIN |
Card |
---|
id | Instalação Biblioteca RM |
---|
label | Instalação Biblioteca RM | |
---|
title | Instalação Biblioteca RM |
---|
|
Guia para Instalação do Produto RM ===== > Instalação do Produto RM Versão 12.1
CADASTROS / PROCESSOS TIN
Card |
---|
id | Configurações RM ( Integração ) |
---|
label | Configurações RM ( Integração ) | |
---|
title | Configurações RM ( Integração ) |
---|
|
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 |
---|
id | Cadastro de Adpter |
---|
label | Cadastro de Adpter | |
---|
title | Cadastro de Adpter |
---|
|
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
Informações |
---|
|
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 | UPDATECONTRACTSTATUSPARCEL | Sim | Não | Síncrono | Todas | EAI | 1.000 | Image Removed
Card |
---|
id | Configuração EAI e WS do RM |
---|
label | Configuração EAI e WS do RM | |
---|
title | Configuração EAI e WS do RM |
---|
|
Configurando EAI - RES e WS do RM : Configurando EAI - REST e WS do RM
Image Removed
Card |
---|
label | POC - Gestão de Imóveis com Prothues | |
---|
|
Informações |
---|
Importante Para garantir a qualidade, a Integração da Apuração de resultados (POC) com o BackOffice Protheus será validada em cliente piloto para que, posteriormente seja disponibilizada a todos os clientes. Caso seja necessária a utilização deste recurso, entre em contato com o Suporte RM para que seja avaliada a possibilidade de participar do programa de pilotos. |
INTEGRAÇÃO POC TOTVS Incorporação X BackOffice Protheus
Contexto de negócio (Introdução)
O objetivo da integração do POC TOTVS Incorporação x BackOffice Protheus é de parametrizar a Apuração de Resultado Contábil por POC entre os módulos da linha RM (TIN) x Protheus (Financeiro e Contábil) para que seja realizada a exigência da Construção e Incorporação Imobiliária - Norma Brasileira de Contabilidade ITG 02 – Contrato de Construção do Setor Imobiliário, aprovada pela Resolução CFC n° 1266/09, é necessário configurar o Adapter E.A.I para utilização da Mensagem Única.
Para mais informações consulte: http://www.gerenciamento.ufba.br/Disciplinas/Financeiro/Contabilidade%20de%20Contratos%20de%20Constru%C3%A7%C3%A3o.pdf
Aplicação da Regra aos produtos TIN (linha RM) e gestão Contábil (linha Protheus)
O TOTVS Incorporação possui um recurso que permite parametrizar a Apuração de Resultado Contábil por POC entre módulos da linha RM (TIN, Financeiro e Contábil).
Este recurso é chamado de Apuração de Resultado Contábil por POC que houve alteração para atender a integração com o Protheus.
A seguir, a definição dos modelos de Apuração entendidos e aplicados no TIN:
Apuração de Resultado Contábil |
Cod. Modelo | Modelo de Cálculo | Contabilização |
1 | Cálculo por Empreendimento | Por Empreendimento |
2 | Cálculo por Subunidade/ Contrato | Por Empreendimento |
3 | 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
Cadastros da Integração | label | Cadastros da Integração | |
---|
title | Cadastros da Integração |
---|
| HTML Include |
---|
url | https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=547246128 |
---|
|
|
Card |
---|
accessKey | contratovendaeai2 |
---|
id | Contrato de Venda | |
---|
label | Contrato de Venda | |
---|
title | Contrato de Venda | |
---|
| HTML Include |
---|
url | https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780010027 |
---|
|
|
Card |
---|
id | SPED F200 / 205 /210 e 1800 |
---|
label | SPED F200 / 205 /210 e 1800 | |
---|
title | SPED F200 / 205 /210 e 1800 |
---|
| HTML Include |
---|
url | https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780009968 |
---|
|
|
Card |
---|
id | Processo da Baixa de Títulos |
---|
label | Processo da Baixa de Títulos | |
---|
title | Processo da Baixa de Títulos |
---|
| Nota |
---|
| Lançamentos/Títulos a Pagar terão todo o processo de baixa mantido no Protheus. |
HTML Include |
---|
url | https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780010907 |
---|
|
|
Card |
---|
| HTML Include |
---|
url | https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780010980 |
---|
|
|
Card |
---|
| HTML Include |
---|
url | https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780011883 |
---|
|
|
Card |
---|
| HTML Include |
---|
url | https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780012078 |
---|
|
|
Card |
---|
label | Gerando Comissão - Pedido de Compra | |
---|
| HTML Include |
---|
url | https://tdn.totvs.com/plugins/viewsource/viewpagesrc.action?pageId=780015891 |
---|
|
|
|
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.001 |
Sim | CTBA800A | LISTOFMANAGERIALACCOUNTINGENTITY | Não | Sim | Síncrono | Todas | EAI | CV0 | 1.000 |
Sim | CTBXSINT | ACCOUNTINGBALANCE | Não | Sim | Síncrono | Todas | EAI | CQ0 | 1.000 |
Sim | FINA055 | FINANCING | Não | Sim | Síncrono | Todas | EAI | SE1 | 1.002 |
Sim | CTBA140 | CURRENCY | Sim | Não | Síncrono | Todas | EAI | CTO | 2.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ábil | RM | Protheus | AccountingBalance_1_000.xsd | 01, 03, 04 |
07 | Lançamento Contábil | RM | Protheus | AccountingEntry_2_001.xsd | 01, 02, 03, 04, 05 |
08 | Lançamento Financeiro | RM | Protheus | Financing_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) - CtbGerenciaDataProcesso "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 violated | Verificar 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 |
---|
|
Card |
---|
id | Processos Contábeis |
---|
label | Processos Contabeis | |
---|
title | Processos 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 |
---|
id | Cadastro Bancário |
---|
label | Cadastro Bancário | |
---|
title | Cadastro Bancário |
---|
| Cadastro Bancário: Cadastro Bancário e/ou Convênio (Totvs Incorporação x Backoffice Protheus - EAI2) Card |
---|
id | Cliente / Fornecedor |
---|
label | Cliente / Fornecedor | |
---|
title | Cliente / Fornecedor |
---|
| Cadastro de Cliente / Fornecedor: Cadastro Cliente/Fornecedor (Integração RM TCGI x Backoffice Protheus - EAI2) Card |
---|
id | Contrato | Plano de Financiamento | Efetivar Contrato |
---|
label | Contrato | Plano de Financiamento | Efetivar Contrato | |
---|
title | Contrato | Plano de Financiamento | Efetivar Contrato |
---|
| 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 |
---|
id | Baixa Total | Cancelamento de Baixa | Baixa Parcial |
---|
label | Baixa Total | Cancelamento de Baixa | Baixa Parcial | |
---|
title | Baixa Total | Cancelamento de Baixa | Baixa Parcial |
---|
| 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 Card |
---|
id | Lançamento a Pagar |
---|
label | Lançamento a Pagar | |
---|
title | Lançamento a Pagar |
---|
| 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 Card |
---|
id | Aditivo |
---|
label | Aditivo | |
---|
title | Aditivo |
---|
| ADITIVO ( Integrado ao Protheus ) Image Removed Contrato novo criado no TOTVS Incorporação Image Removed Comprador inserido no contratoImage 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 ComponenteImage 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
Card |
---|
id | Adiantamento |
---|
label | Adiantamento | |
---|
title | Adiantamento |
---|
| - 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 Card |
---|
id | Ferramenta de Diagnostico |
---|
label | Ferramenta de Diagnostico | |
---|
title | Ferramenta de Diagnostico |
---|
| 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. Card |
---|
label | Distrato com Devolução e Geração de Títulos no Protheus | |
---|
| Processo Distrato - (Integração RM TCGI x Backoffice Protheus - EAI2) Deck of Cards |
---|
| 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 |
---|
label | Contrato de Locação | |
---|
| Tudo sobre Contrato de Locação : CLIQUE AQUI ! |
Card |
---|
label | Contratos de Administração | |
---|
| Tudo sobre Contrato de Administração : CLIQUE AQUI ! |
Card |
---|
| | Tudo sobre Evento Financeiro : CLIQUE AQUI !Clique abaixo para saber mais sobre : CONTTRATO DE LOCAÇÃO CONTRATO DE ADMINISTRAÇÃO EVENTO FINANCEIRO
|