INTEGRAÇÃO FOLHA DE PAGAMENTO RM X BACKOFFICE LOGIX

Contexto de negócio (Introdução)

A partir do release 12.1.11, estará disponível aos clientes TOTVS a oferta de Integração do RM Folha de Pagamento ao ERP Logix. A integração possibilitará a realização de todos os processos de uma folha de pagamento de forma simples e segura, gerando os compromissos a pagar diretamente no financeiro do Logix, assim também os lançamentos contábeis diretamente no módulo contábil do ERP. Além dos lançamentos financeiros e contábeis, também são integrados os cadastros que sustentam estas operações.O funcionamento da integração ocorre de forma “Síncrona” entre os sistemas, utilizando a tecnologia EAI. Ou seja, sempre que o usuário cadastrar ou alterar uma informação no Logix e a mesma estiver dentro do contexto da integração, a informação será replicada. 

Sistemas Envolvidos

• ERP Logix: O BackOffice Logix é o produto Totvs responsável por enviar via EAI as mensagens de Cliente/Fornecedor, Banco/Agencia, Item contábil (Área e Linha de Negócio), Período Contábil, Histórico padrão, Centro de Custo e Plano de Contas.

• Totvs RM Folha de Pagamento: O RM Folha de Pagamento é o produto RM responsável por receber as mensagens enviadas pelo Logix, e enviar as mensagens de Lançamento Contábil e Financeiro.

Integração

O objetivo do projeto é integrar o ERP Logix com o Totvs RM Folha de Pagamento, através das mensagens únicas "EAI". Desta forma será disponibilizado aos clientes do ERP a possibilidade de trabalhar a sua gestão de backOffice de forma integrada ao Totvs RM.

Escopo

O escopo da integração é a sincronização entre os cadastros de backOffice de ambos sistemas. Para fazer esse controle as seguintes entidades foram integradas:

• Banco/Agencia: Logix envia
• Item Contábil (Área e Linha de Negócio): Logix envia
• Período Contábil: Logix envia
• Histórico Padrão: Logix envia
• Centro de Custo: Logix envia
• Plano de Contas: Logix envia
• Lançamento Contábil: RM envia
• Lançamento Financeiro: RM envia
• Pagamentos de autônomos: Logix envia (a partir da versão 12.1.13)
• Lançamentos de comissão para a folha de pagamento: Logix envia (a partir da versão 12.1.13)
• Devolução de adiantamento de viagem: Logix envia (a partir da versão 12.1.13)
• Cargo: RM envia (a partir da versão 12.1.13)

Pré-requisitos instalação/implantação/utilização

Para o correto funcionamento da integração é necessário realizar as seguintes configurações nos sistemas envolvidos:

RM

  1. Configurar o TBC para comunicação do Logix com o RM:

      Seguir a orientação do link abaixo para configurar o TBC:  http://tdn.totvs.com/pages/releaseview.action?pageId=82477609

          Colocar o endereço abaixo nas configurações de webservice do Logix:  http://{ip-servidor-TBC}/TOTVSBusinessConnect/wsEAIService.asmx?wsdl

2. Executar o Configurador para Integração Logix 

Acesse o módulo Integração: Integração / Ferramentas / Configurar 

Na tela do configurador: 

1. Digite o Usuário e Senha da base de dados;
2. Clique em Testar Conexão (O botão avançar só será habilitado caso o resultado do teste retornar sucesso);
3. Clique em Avançar. 

Selecione a integração: TOTVS Folha de Pagamento RM x BackOffice Logix 

Clique em Avançar 

 Na tela seguinte clique em Executar, e aguarde o final do processo conforme imagem abaixo. 

3. Configurando Integração Logix 

Acesse a integração através do menu: Integração / Mensagem Única / Integrações 

Edite o registro e insira as configurações necessárias para o webservice Logix. 

Verifique e configure (se necessário) os Parâmetros da Integração através do anexo Parâmetro de Integração.

Verifique se todas as Entidades necessárias para a integração foram mapeadas com sucesso. 

4. Configurando o De-Para 

Para a integração é necessário criar manualmente um novo registro para o de-para para coligada. 

Acesse: Integração / Integração / Mensagem Única / De-Para.

Realize um novo cadastro onde:

Tabela RM: GCOLIGADA

Chave Primária RM: CODCOLIGADA 

Valor Chave Primária RM: [Código da coligada utilizada para integração] 

Sistema Integrado: LOGIX 

Valor Chave Integração: [Empresa do Logix enviada pela mensagem EAI] 

5. Parametrizando o Folha de Pagamento para a Integração 

É necessário parametrizar no modulo Folha de Pagamento a utilização de integração com outros BackOffice. 

Acesse o modulo de Folha de Pagamento: RH / Folha de Pagamento / Configurações / Parametrizador 

Selecione a configuração: 06.02 – Integrações / 06.02.06 – Outros BackOffice 

Ative a opção “Usa integração outros BackOffice”, configure a quantidade de partidas contábeis que serão enviados por pacote. Ao ativar a opção de integração com outros BackOffices, automaticamente o parâmetro “Gera lotes contábeis no Folha de Pagamento antes de enviar para o Saldus” localizado em 06.01 – Folha de Pagamento / 06.01.03 – Folha Normal é marcado e bloqueado para alteração. 

Para configurar o agrupamento de partidas contábeis e a geração de lançamentos financeiros rateados por: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor, selecione a configuração: 06.01 – Folha de Pagamento / 06.01.03 – Folha Normal. 

Obs.: Os parâmetros deverão ser habilitados somente se o parâmetro “usa integração outros backOffice” estiver marcado. 

Para a configuração agrupamento de partidas contábeis, acesse a Etapa 11 (Contabilização) e marque as opções: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor. 

Obs.: Os parâmetros dos grupos “Lançamento Contábil (RM Saldus)” e “Contabilização” foram movidos da na Etapa 17 (Geral) para a Etapa 11 (Contabilização). 

Para a configuração da geração de lançamentos rateados, acesse a Etapa 12 (Lancto Financeiro) e marque as opções: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor. 

Necessário:

• Versão do sistema: Totvs RM 12.1.11 ou superior.
• Modulo utilizado: RM Folha de Pagamento.
• Ferramentas que são necessárias a integração: EAI.
  
  
  

Logix

No Logix os seguintes pré-requisitos devem ser atendidos

1.    Versão 12.1.11 ou superior.  

Atenção:  empresas que utilizam a versão 12.1.11 deverão solicitar os seguintes pacotes de chamados/projetos para a área de framework: FRWJOI01-416, FRWJOI01-173, TSTRNJ, TSRLF0, TSRKTG. 

2.    Build Totvstec na versão 7.00.131227A-20140829 ou superior.

3.    EAI Logix e WebService instalados e configurados. Mais informações em: http://tdn.totvs.com/pages/releaseview.action?pageId=223159857  

4.    Configurar a chave MAXSTRINGSIZE que está localizada na seção General do TotvsAppServer.ini. Caso não exista deverá ser adicionada. Ela define o tamanho máximo das mensagens (em MB) que serão trocadas entre os sistemas. Recomendamos qualquer valor acima de 15.

Exemplo:

Mais informações em: http://tdn.totvs.com/pages/viewpage.action?pageId=161349793

5.    Executar o conversor cap00977.cnv através do programa LOG6000 (Gerenciador de conversores). Será criada a tabela: cap_integracao_inss_auton.

6.    Executar o conversor de parâmetro fin10089.cnv, através do programa LOG00088 (Processamento de conversores). Será criado ou alterado o parâmetro: “Último número de nota fiscal para integração de títulos por EAI.”

7.    Cadastrar o Aplicativo externo RM com sua respectiva URL de acesso ao WEB SERVICE no EAI10000.

8.    Cadastrar o relacionamento DE-PARA de empresas do Logix com as coligadas/filiais do RM, no EAI10000, conforme exemplo abaixo: 

Instalação/Atualização

Os seguintes procedimentos deverão ser realizados para a implantação da integração entre os sistemas.

Logix

• Configuração de parâmetros - LOG00087 - Manutenção de parâmetros:  
  
  Nome: Último número de nota fiscal para integração de títulos por EAI
  Local: Logix Financeiro > Contas a pagar > Apropriação de despesa
  Valor: Qualquer valor maior que zero. 
  Objetivo: Este parâmetro armazena o último gerado automaticamente pelo sistema e atribuído ao campo "Nota fiscal" de títulos a pagar originados de sistemas externos que não possuem tal informação. Este valor será incrementado automaticamente a cada integração. 
  
  

• Mensagens únicas:
  
  Para configurar as mensagens que trafegarão entre os sistemas é necessário primeiramente ter realizado a implantação e configuração do Web service e EAI, conforme descrito no item "Pré-requisitos instalação/implantação/utilização" deste documento. Em seguida acesse o EAI10000, escolha a opção "Aplicativo Hospedeiro" no menu "Configuração". Faça a busca dos adapters de mensagens através do botão "Buscar Adapters", conforme demonstrado na figura abaixo. Leia atentamente a mensagem exibida na tela e selecione a opção "Sim" para prosseguir ou "Não" para abortar o processo. 
  
  
  
  
  As mensagens devem ser ativadas observando a sua versão, rota, e contexto. A lista das mensagens encontra-se na seção "Transações/Entidades/Mensagens únicas" deste documento. 
  Nesta integração todas as mensagens devem ser configuradas para o contexto "padrão". A seguir exemplo de ativação da mensagem CustomerVendor: 
  
  
  
  
  
  
   

RM

Insira aqui as informações pertinentes ao RM.

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.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Logix 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

Fluxo das Informações

• Logix envia Cliente/Fornecedor para o RM
  • Cadastro de Cliente/Fornecedor no RM deverá ficar bloqueado para criação/alteração/exclusão.
    
    
• Logix envia Banco/Agência para o RM
  • Será realizado cadastro de:
    • Banco
      • Cadastro de Banco no RM deverá ficar bloqueado para criação/alteração/exclusão.
    • Agência
      • Cadastro de Agência no RM deverá ficar bloqueado para criação/alteração/exclusão.
    • Conta Corrente
      • Cadastro de Conta Corrente no RM deverá ficar bloqueado para criação/alteração/exclusão.
    • Conta Caixa
      • Cadastro de Conta Caixa no RM deverá ficar bloqueado para criação/alteração/exclusão.
        
        
• Logix envia Item Contábil (Área e Linha de Negócio) para o RM
  • Cadastro de Item Contábil (Área e Linha de Negócio) no RM deverá ficar bloqueado para criação/alteração/exclusão.
    
    
• Logix envia Período Contábil para o RM
  • Cadastro de Período Contábil no RM deverá ficar bloqueado para criação/alteração/exclusão.
    
    
• Logix envia Histórico Padrão para o RM
  • Cadastro de Histórico Padrão no RM deverá ficar bloqueado para criação/alteração/exclusão.
    
    
• Logix envia Centro de Custo para o RM
  • Cadastro de Centro de Custo no RM deverá ficar bloqueado para criação/alteração/exclusão.
    
    
• Logix envia Plano de Contas para o RM
  • Cadastro de Plano de Contas no RM deverá ficar bloqueado para criação/alteração/exclusão.
    
    
• RM envia Lançamento Contábil para o Logix
  • Logix consiste o lote e grava para posterior conferência e efetivação pelo contábil.
    
    
• RM envia Lançamento Financeiro para o Logix
  • Logix consiste e efetiva o título para posteriormente ser pago pelo financeiro. 
    
    
• Logix envia Pagamentos a Autônomos para RM
  • RM consiste as informações e as utiliza na confecção do arquivo SEFIP.
    
    
• Logix envia Comissão representante para o RM
  
  • RM faz o lançamento do provento na folha do funcionário.  
    
    
• Logix envia Devolução de adiantamento de viagem para o RM
  
  • RM faz o lançamento do desconto na folha do funcionário.  
    
    
• RM envia Cargos/Funções para o Logix
  • Cadastro de funções no Logix deverá ficar bloqueado para criação/alteração/exclusão
    
    

Cadastros

• Cliente/Fornecedor
  
  

LOGIX

O cadastro de clientes e fornecedores é realizado no Logix e integrado ao RM através da mensagem CUSTOMERVENDOR versão 2.000. Portanto, a mensagem precisa estar habilitada para envio no EAI10000. Possíveis inconsistências ou erros ocorridos durante o processo de integração serão apresentados em tela e a operação não será efetivada, possibilitando ao usuário tomar a ação de correção ou ajuste da inconsistência. Toda o processo de integração fica registrado no monitor de integração do EAI10000 e pode ser consultado a qualquer momento.

As integrações são síncronas, ou seja, para a alteração, inclusão ou exclusão ser efetivada o Logix aguarda o OK da mensagem enviada para o RM, As mensagens retornam além do "status" da operação ("OK" ou "ERROR") os códigos do fornecedor na origem (Logix) e no destino (RM), este código é chamado de "InternalID"  e é composto pelos campos das chaves primárias do cadastro nos respectivos produtos. 

O código interno, também pode ser consultado a qualquer momento no EAI10000 > Configuração > Aplicativo Externo. Efetue a consulta pelo aplicativo RM e utilize o botão "Consulta De/Para", faça a busca conforme o critério desejado:  

Atenção: Para a integração com o RH são integrados somente fornecedores, portanto os clientes não são enviados ao RM, embora a mensagem permita tal integração. 

RM

Para o RM receber a integração de fornecedor é necessário que a entidade CUSTOMERVENDOR na versão 2.000 esteja configurada na integração juntamente com o evento d25b1b1f-2878-40d4-a7bc-ab27ceca5566 (Tratamento de cliente/fornecedor).

Para a mesma também é necessário que a integração tenha os parâmetros RH_CLIFORAUTOINC e RH_CODCLASSIFICPAIS configurados.

O parâmetro RH_CLIFORAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “FCFO.CODCFO”.

Caso o parâmetro esteja configurado para não considerar o auto incremento, a máscara do código do Cliente/Fornecedor do RM deve ser configurada de acordo com a máscara do cliente/fornecedor enviada pelo Logix:
Ex: “QQQQQQQQ”. [Permite qualquer caractere limitado a 8 posições].

Caso o parâmetro esteja configurado para ativar o auto incremento, a máscara deve ser definida como # (numérica) e o parâmetro do financeiro “Usar código sequencial (se máscara for numérica)” deve ser marcado.

Obs.: Por default a opção “Usar código sequencial (se máscara for numérica)” fica desativada. A mesma só é ativa para seleção após definir a máscara como numérica, conforme imagem acima.

Após o envio da mensagem pelo Logix, é possível verificar o recebimento da mesma através da Fila de mensagens únicas que pode ser acessada através do caminho: Integração / Integração / Mensagem Única / Fila de mensagens únicas.

No anexo “Informação de execução de mensagem” acessado através da tela de Fila de mensagem pode verificar o status da mensagem enviada pelo Logix.

Ao receber/atualizar o Cliente/Fornecedor, o EAI deverá criar automaticamente o cadastro De-Para referente a esta integração.

 Integração / Integração / Mensagem Única / De-Para

• Banco/Agência/Contas bancárias
  
  

Logix

O cadastro de banco, agências e contas bancárias é de responsabilidade do Logix, para integrar ao RM a mensagem Bank na versão 2.002 deve estar habilitada para envio. 

A mensagem é disparada a partir dos programas FIN30065 (Agências bancárias) e CAP0120 (Agências).  Os dados enviados são: banco, agencia bancária e as contas bancárias pertencentes ao banco e agência em questão. 

Possíveis erros e inconsistências são exibidos em tela e também ficam registrados no monitor do EAI. A mensagem é síncrona e retorna o código interno (Bank) do banco no RM, que será utilizado posteriormente em outras mensagens. 

Atenção: A integração leva somente as contas bancárias da empresa corrente. Portanto, contas bancárias de outras empresas não serão integradas mesmo que pertençam ao mesmo banco e agência. 

RM

Para o RM receber a integração de Banco/Agência é necessário que a entidade BANK na versão 2.002 esteja configurada na integração juntamente com o evento 1ee544f5-4b15-45cc-aee3-f0a05fde4644 (Tratamento de dados bancários).

Nesta integração é realizado os cadastros de Banco, Agência, Conta Corrente e Conta Caixa. Agência é um anexo da visão de Banco, assim como Conta Corrente é um anexo da visão de Agência. Na Linha RM são tabelas independentes: Banco (GBANCO), Agência (GAGENCIA), Conta Corrente (FCONTA) e Conta Caixa (FCXA). Com isso, a exclusão da entidade banco no Logix, reflete na exclusão de uma Conta caixa, conta, agencias e banco no Lado RM.

Para a mesma também é necessário que a integração tenha o parâmetro RH_ CONTACAIXAAUTOINC configurado. O registro fica disponível em: Integração / Mensagem Única / Integrações / Anexo - Parâmetros de Integração.

O parâmetro RH_ CONTACAIXAAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “FCXA.CODCXA”.

Caso o parâmetro esteja configurado para não considerar o auto incremento, será gravado no campo “FCXA.CODCXA” a conta caixa enviada na mensagem.

Caso o parâmetro esteja configurado para ativar o auto incremento o Código da conta caixa no RM será um valor a partir da tabela GAUTOINC, sempre ignorando o número da conta bancária enviada na mensagem única.

Ao receber/atualizar o Banco/Agência, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

 Integração / Integração / Mensagem Única / De-Para

• Item Contábil (Área e Linha de Negócio)

Logix 

A integração ocorre pela mensagem AREAANDLINEOFBUSINESS, portanto deve estar habilitada para envio. Disparamos a mensagem através dos programas VDP0340 e VDP10056 (Área Estratégica de Negócio). 

Possíveis erros e inconsistências são exibidos em tela e também ficam registrados no monitor do EAI. A mensagem é síncrona e retorna o código interno "AreaAndLineOfBusinessInternalId" que será utilizado nas integrações de títulos, lançamentos contábeis, entre outras. Portanto, é imprescindível o retorno testa informação. 

RM

Para o RM receber a integração de Item Contábil (Área e Linha de Negócio) é necessário que a entidade AREAANDLINEOFBUSINESS na versão 1.000 esteja configurada na integração juntamente com o evento e9e9d0bf-32d6-4343-9531-92d174f92faf (Tratamento de item contábil).

Existem três pontos para visualizar os registros integrados de item contábil (Área e Linha de Negócio):

• • Educacional / Educacional / Integrações / Protheus / Item Contábil
  • RH / Folha de Pagamento / Encargos / Contabilização – Cadastros / Item Contábil
  • RH / Folha de Pagamento / Encargos / Financeiro – Cadastros Financeiros / Item Contábil

No intuito de evitar cadastros duplicados, e tornar possível utilizar as mesmas informações para mais de uma integração, foi padronizado para que ambos menus apontem para a mesma tela (Tela de item contábil do módulo Educacional).

Item contábil no módulo Educacional:

• Item contábil no módulo Folha de Pagamento:

Ao receber/atualizar o Item Contábil (Área e Linha de Negócios), o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

Integração / Integração / Mensagem Única / De-Para

Após recebimento, o Item Contábil (Área e Linha de Negócio) poderá ser vinculado ao Funcionário, na Seção, e no Agrupamento de Contas através do lookup disponibilizado nas respectivas telas.

RM / Folha de Pagamento / Administração de Pessoal / Funcionários

Na tela de cadastro de Funcionários acesse: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Item Contábil.

RM / Folha de Pagamento / Administração de Pessoal / Seções

Na tela de cadastro de Seção acesse: Dados Contábeis / Item Contábil.

RM / Folha de Pagamento / Encargos / Contabilização – Cadastros / Cadastros Contábeis / Agrupamento de Contas

Na tela de cadastro do Agrupamento de Contas: Item Contábil (Área e Linha de Negócio).

Obs 1: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver desmarcado, o campo deverá ficar oculto

Obs 2: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver marcado e os parâmetros "Agrupar partidas contábeis por Item Contábil" e "Gerar lanctos rateados por Item Contábil" estiverem desmarcados, o campo deverá ficar desabilitado.

• Período Contábil

Logix 

Disparamos a mensagem ACCOUNTINGCALENDAR  a partir dos programas CON0050 e CON10009 (Períodos contábeis). É importante ressaltar que esta mensagem enviará uma lista contendo todos períodos e segmentos de períodos da empresa corrente. 

A mensagem só é disparada em operações que envolvam o menor ou maior período cadastrado para a empresa. Sendo assim ao incluir um período, que seja posterior ao maior período cadastrado, será enviado uma mensagem contendo todos os períodos e segmentos da empresa. Da mesma forma ao incluir um período anterior ao menor período já cadastrado. A modificação ou exclusão do maior e menor período também dispara a mensagem. As demais operações não geram integração, pois para o RM a informação relevante são os limites inferior e posterior de período do calendário.  

RM

Para o RM receber a integração de Período Contábil é necessário que a entidade ACCOUNTINGCALENDAR na versão 1.000 esteja configurada na integração juntamente com o evento d1f09a24-9148-4e2d-8e17-bc5a76c9f933 (Período contábil).

Nesse processo de integração, o lado RM atualizará as datas de período contábil sempre de acordo com a menor data inicial e a maior data final enviada pelo Logix. No Logix, essas informações são armazenadas em um cadastro, e no Rm essas informações são armazenadas nos parâmetros, sendo assim, teremos espaço para armazenar somente uma dataIncial e uma dataFinal.

Para esta integração não é salvo um cadastro De-Para porque o período contábil é um parâmetro que não tem uma tela de cadastro, para a sua atualização é realizado um update em seu registro direto no banco de dados.

• Histórico Padrão

Logix

A sincronização do histórico padrão ocorre através da mensagem LISTOFACCOUNTANTDEFAULTHISTORY e é disparada a partir dos programas CON0020 e CON10002 (Histórico padrão dos lançamentos contábeis). Este código é utilizado no lançamento contábil das movimentações da folha de pagamento para a integração com a contabilidade Logix, 

Para as empresas que utilizam a centralização do histórico contábil (Empresa histórico padrão) será envia uma lista onde o histórico padrão será replicado para cada empresa que compartilha o histórico. Conforme exemplo:

Empresa 01 e 02 compartilham o mesmo cadastro de histórico. Então a mensagem de integração conterá uma lista com informações de histórico para a empresa 01 e para a 02.

Atenção:  será gravado o internalid "AccountantDefaultHistory" no de-para do Logix somente para a empresa do histórico. 

RM 

Para o RM receber a integração de Histórico Padrão é necessário que a entidade LISTOFACCOUNTANTDEFAULTHISTORY na versão 2.000 esteja configurada na integração juntamente com o evento 41559d6e-9713-492f-b395-f1e807c32b22 (Tratamento de histórico padrão).

Esta integração se fez necessária devido ao Logix permitir vincular o mesmo histórico padrão para um grupo de empresas.

Ex:

Empresa 01 e 02 utilizam o histórico padrão 01

Empresa 03, 04 e 05 utilizam o histórico padrão 02

Considerando que o De-Para de empresas esteja configurado da seguinte forma:

• • Empresa 01 = Coligada 1
  • Empresa 02 = Coligada 2
  • Empresa 03 = Coligada 3
  • Empresa 04 = Coligada 4
  • Empresa 05 = Coligada 5

O RM deverá salvar da seguinte maneira:

• • Coligada 1 - histórico padrão 01
  • Coligada 2 - histórico padrão 01
  • Coligada 3 - histórico padrão 02
  • Coligada 4 - histórico padrão 02
  • Coligada 5 - histórico padrão 02

Ao receber/atualizar o Histórico Padrão, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

Integração / Integração / Mensagem Única / De-Para

• Centro de Custo

Logix

A mensagem LISTOFCOSTCENTER é utilizada para a integração do cadastro de centro de custos. 

Para as empresas que utilizam a centralização do plano de contas contábil (Empresa plano) será envia uma lista onde o centro de custo será replicado para cada empresa que compartilha o histórico. Conforme exemplo:

Empresa 01 e 02 compartilham o mesmo cadastro de centro de custo. Então a mensagem de integração conterá uma lista com informações de centro de custos para a empresa 01 e para a 02.

Atenção:  será gravado o internalid "CostCenter" no de-para do Logix somente para a empresa do plano. 

RM

Para o RM receber a integração de Centro de Custo é necessário que a entidade LISTOFCOSTCENTER na versão 2.001 esteja configurada na integração juntamente com o evento 670be9e3-f144-4ac9-91f3-1a8eee3c1355 (Tratamento de centro de custo).

Esta integração se fez necessária devido ao Logix permitir vincular o mesmo centro de custo para um grupo de empresas.

Ex:

Empresa 01 e 02 utilizam o centro de custo 01.01

Empresa 03, 04 e 05 utilizam o centro de custo 01.02

Considerando que o de-para de empresas esteja configurado da seguinte forma:

• • Empresa 01 = Coligada 1
  • Empresa 02 = Coligada 2
  • Empresa 03 = Coligada 3
  • Empresa 04 = Coligada 4
  • Empresa 05 = Coligada 5

O RM deverá salvar da seguinte maneira:

• • Coligada 1 - centro de custo 01.01
  • Coligada 2 - centro de custo 01.01
  • Coligada 3 - centro de custo 01.02
  • Coligada 4 - centro de custo 01.02
  • Coligada 5 - centro de custo 01.02

Para a mesma também é necessário que a integração tenha o parâmetro RH_ CENTROCUSTOAUTOINC configurado. O registro fica disponível em: Integração / Mensagem Única / Integrações / Anexo - Parâmetros de Integração.

O parâmetro RH_ CENTROCUSTOAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “GCCUSTO. CODCCUSTO”.

Caso o parâmetro esteja configurado para não considerar o auto incremento, será gravado no campo “GCCUSTO. CODCCUSTO” a conta caixa enviada na mensagem de acordo com a máscara do centro de custo enviada pelo Logix.

Ex: “QQQQQQQQ” [permite qualquer caractere limitado a 8 posições].

Caso o parâmetro esteja configurado para ativar o auto incremento o Código do Centro de Custo no RM será um valor a partir da tabela GAUTOINC, sempre ignorando o código informado na mensagem única. Nesse caso, o parâmetro “Máscara do Centro de Custo” deve ser preenchido como “QQQQQQQ” [qualquer caractere].

Ao receber/atualizar o Centro de Custo, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

Integração / Integração / Mensagem Única / De-Para

Obs.: Os centros de custos serão sincronizados com a GCCUSTO e a PCCUSTO (inclusão/alteração/exclusão).

Após o recebimento o Centro de Custo poderá ser vinculado ao Funcionário através do lookup disponibilizado no cadastro de Funcionários.

RM / Folha de Pagamento / Administração de Pessoal / Funcionários

Na tela de cadastro de Funcionários acesse: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Centro de Custo.

• Plano de Contas

Logix

O plano de contas é integrado pela mensagem LISTOFACCOUNTANTACCOUNT que é disparada pelos programas CON0010 e CON10001 (Plano de contas). 

Para as empresas que utilizam a centralização do plano de contas contábil (Empresa plano) será envia uma lista onde a conta contábil será replicado para cada empresa que compartilha o histórico. Conforme exemplo:

Empresa 01 e 02 compartilham o mesmo plano de contas. Então a mensagem de integração conterá uma lista com informações da conta contábil para a empresa 01 e para a 02.

Atenção:  será gravado o internalid "AccountingEntry" no de-para do Logix somente para a empresa do plano. 

RM

Para o RM receber a integração de Plano de Contas é necessário que a entidade LISTOFACCOUNTANTACCOUNT na versão 2.002 esteja configurada na integração juntamente com o evento 9f0f85bf-f5c8-4ecb-b439-783acd087e11 (Tratamento de conta contábil).

Esta integração se fez necessária devido ao Logix permitir vincular o mesmo plano de contas para um grupo de empresas.

Ex:

Empresa 01 e 02 utilizam o plano de contas P001

Empresa 03, 04 e 05 utilizam o plano de contas P002

Considerando que o de-para de empresas esteja configurado da seguinte forma:

• • Empresa 01 = Coligada 1
  • Empresa 02 = Coligada 2
  • Empresa 03 = Coligada 3
  • Empresa 04 = Coligada 4
  • Empresa 05 = Coligada 5

O RM deverá salvar da seguinte maneira:

• • Coligada 1 - plano de contas P001
  • Coligada 2 - plano de contas P001
  • Coligada 3 - plano de contas P002
  • Coligada 4 - plano de contas P002
  • Coligada 5 - plano de contas P002

Ao receber/atualizar o Plano de Contas, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

Integração / Integração / Mensagem Única / De-Para

Obs 1: O campo “CCONTA.NATSPED” não é enviado pela mensagem pois o mesmo deve estar somente no BackOffice. Por ser obrigatório no RM, ao receber a mensagem de Plano de Contas o mesmo será gravado com o valor “00” (Não informada).

Obs 2: A máscara parametrizada da conta contábil no RM será validada no processo de inclusão da conta contábil. Portanto, o parâmetro de máscara contábil deve ser cadastrado sem máscara contábil para possibilitar o recebimento pelo Logix. Com isso o sistema poderá montar a árvore de plano de contas que atenda o Logix e esteja dentro das regras do RM.

Processos

• Lançamento Contábil

RM 

Para o RM enviar a integração de Lançamento Contábil ao Logix é necessário que a entidade ACCOUNTINGENTRY na versão 2.002 esteja configurada na integração juntamente com o evento xrf09a24-9148-4e2d-8e17-t15a76c9f999 (Envio de lançamentos contábeis).

Gerar os lançamentos contábeis

Para o processo de geração de lançamentos contábeis segue os critérios de aceitação:

• • O cálculo respeitará a seguinte prioridade do cadastro de Item Contábil (Área e Linha de Negócio)/classe de valor:
    • 1º: Funcionário
    • 2º: Agrupamento de Contas
    • 3º: Seção

• • Para esta integração foi criado duas novas colunas na tabela PPARTIDA: Item Contábil (Área e Linha de Negócio) (IDITEMCONTABIL) e Classe de Valor (IDCLASSEVALOR)

Obs.: O parâmetro "Utiliza o cálculo por centro de custo" deverá estar desmarcado.

Para enviar o lançamento Contábil via integração com Logix é necessário acionar o processo:

RH / Folha de Pagamento / Encargos / Contabilização – Lançamentos / Lançamentos / Processos – Integração contábil com outros BackOffices

Ao finalizar o processo é criado um registro na Fila de Mensagem do EAI, nele é possível consultar o status da mensagem enviada ao Logix.

Logix 

Para que o Logix recepcione e processo com sucesso a mensagem de lançamento contábil (ACCOUNTINGENTRY)  é necessário efetuar as seguintes configurações: 

• Cadastrar e configurar o sistema gerador "RM" no CON1640 ou CON10049 (Sistemas geradores); 
• De-para de empresas configurado. 
• Plano de contas do Logix e RM integrados previamente. 
• Cadastro de Área estratégica de negócio previamente integrado. 
• Cadastro de histórico padrão integrado. 
  
  

Os lançamentos gerados pela integração são gravados na tabela "ctb_lanc_ctbl_ctb", pois sua origem não é o Logix.

Na recepção da mensagem são efetuadas algumas validações, como:  período contábil valido, conta contábil ativa, AEN válida, valor de crédito e debito corretos, entre outras validações. Caso encontre alguma inconsistência a mensagem é devolvida com indicador "ERROR" e a descrição do erro encontrado, a operação é desfeita ou seja, os lançamentos não são gravados. 

Após a recepção ser efetuada com sucesso o lote poderá ser consultado no CON10000 (Consulta de lançamentos por origem)  utilizando o botão de origem "Contabilidade". 

Os lotes integrados pelo EAI não são automaticamente efetivados. A efetivação deve ser realizada pelo CON10019 (Consistência/Efetivação de lançamentos) . Na aba "Lotes manuais" selecionar os lotes a serem efetivados. 

A mensagem de lançamento contábil está preparada para receber lotes contábeis de forma particionada. Isto é, em situações em que o volume de lançamentos é muito grande, pode ocorrer queda no desempenho do processamento gerando lentidão e até mesmo erro de "TIME OUT". Então, disponibilizamos a opção da integração segmentada em partes menores, conforme regras abaixo: 

• A consistência e efetivação do lote só será permitida após a recepção com sucesso de todas as partes que compõem o lote. 
• A capa do lote é gravada juntamente com o ultimo segmento do lote. 
• Ocorrendo erro ou inconsistência em algum segmento, o RM enviará mensagem de exclusão de todo o lote. 
• Para garantir a integridade dos lançamentos em ambos os sistemas, sempre que houver alteração no lote será enviada uma mensagem de exclusão e posteriormente novas inclusões. 
• No XML o indicador do segmento do lote é a TAG "Sublot", que deve obedecer o padrão "NN|TT", onde "NN" é o número do segmento e "TT" é o total de segmentos. 

• Lançamento Financeiro

RM 

Para o RM enviar a integração de Lançamento Financeiro ao Logix é necessário que a entidade ACCOUNTPAYABLEDOCUMENT na versão 2.002 esteja configurada na integração juntamente com o evento 2810e737-4e2c-4321-ac27-3b398cc4d7fb (AccountPayableDocument_2_002).

Gerar os lançamentos financeiros:

Para ratear o lançamento financeiro por Item Contábil (Área e Linha de Negócio)/Classe de valor é necessário seguir os seguintes critérios de aceitação:

• • O cálculo deverá respeitar a prioridade do cadastro de Item Contábil (Área e Linha de Negócio):
    • 1º: Funcionário
    • 2º: Seção

• • Para esta integração foi criado duas novas colunas na tabela PRATFINANCEIRO: Item Contábil (Área e Linha de Negócio) (IDITEMCONTABIL) e Classe de Valor (IDCLASSEVALOR)

• • O lançamento deve ser salvo na tabela PFINANCEIRO e o rateio dentro da PRATFINANCEIRO com as seguintes informações: 
    • Centro de Custo
    • Item Contábil (Área e Linha de Negócio)
    • Classe de Valor

Para enviar o lançamento Financeiro via integração com Logix é necessário acionar o processo:

RH / Folha de Pagamento / Encargos / Contabilização – Lançamentos / Lançamentos / Processos – Integração contábil com outros BackOffices

Ao finalizar o processo é criado um registro na Fila de Mensagem do EAI, nele é possível consultar o status da mensagem enviada ao Logix.

LOGIX 

Abaixo encontra-se o detalhamento da Integração Financeira, na qual os Títulos do RM serão integrados no módulo Financeiro Logix. 

Pré-requisitos: 

• Cadastro fornecedor previamente integrado;
• Parâmetro:  "Último número de nota fiscal para integração de títulos por EAI" configurado;
• De-para de empresas configurado; 
• Cadastro de Área estratégica de negócio previamente integrado; 

• Parametrizar a geração automática de APs para todos os fornecedores envolvidos na integração. Conforme abaixo:
  VDP10000 Fornecedores > Informações bancárias > campo “Gera ordem de pagamento?” = “NF’S e conhecimento”. Ou no VDP0815: Fornecedores  > Inf. Bancárias >  campo “Indicador de geração de APs” = “S”;

• A entidade Tipo de Despesa utilizada no contas a pagar do Logix, equivale ao parâmetro: "RH_NATUREZAFINANCEIRADEFAULT" no RM. No entanto no Logix esta entidade só aceita números, por isso é necessário cadastrar o de-para dos códigos no VDP10141 (De-para geral) da seguinte forma: 
  
  
  

Atenção: Repetir o cadastro para todos os tipos de despesas que serão utilizados na integração.

Nota: Este procedimento não será necessário no caso dos códigos em ambos os sistemas serem iguais. 

Para a integração de títulos poderão ser definidas AENs padrão, que serão utilizadas quando esta informações não constar no XML de integração. Os parâmetros ficam localizados no LOG00087 > Administração Logix > Controle geral > Integração entre sistemas: 

Os títulos gerados pelo RM serão incluídos como AD (Apropriação de Despesas) no Logix, na inclusão também será gerada a AP (Autorização de pagamento). Em caso de inconsistência ou erro a mensagem de integração será recusada e o motivo gravado para consulta no monitor do EAI (EAI10000). 

 Após a implantação do título ser efetuada com sucesso o Logix retornará uma resposta (XML) contendo informações do processamento e o número do título na origem (RM) e destino (LOGIX). Esta informação também pode ser consultada no monitor no EAI. 

O título poderá ser consultado no FIN30058 (Apropriações de despesa). Note que a origem da AD será: "INCLUÍDA VIA INTEGRAÇÃO COM OUTROS SISTEMAS" e a aba de informações complementares conterá a chave do título no RM. 

A relação dos títulos na origem e no destino também poderá ser consultada no EAI10000 > Aplicativos Externos > "Consulta De/para", utilizando o filtro abaixo: 

A integração também permite modificar e excluir títulos, porém somente será permitido se as regras de negócio aplicadas ao Logix foram atendidas, como: titulo não pode estar pago, não pode estar contabilizado, entre outras validações  do produto padrão Logix. 

A integração de títulos utiliza a mesma API (FIN80030) de manutenção de títulos do produto padrão Logix, isso significa que títulos implantados pela integração ou manualmente no financeiro passarão pelas mesmas etapas de validação e processamento. Sendo assim, processo de contabilização, lançamento no fluxo de caixa, calculo de impostos etc. permanecem inalterados. 

Após a integração o título fica sob responsabilidade do módulo financeiro, usuário do CAP poderá fazer alterações, cancelamento/exclusão, e/ou pagamento. Estas operações não geram retorno ao RM. 

• Carga inicial de cadastro do Logix para RM 
  
  FIN00000 (Centralização de programas Conversores).
  
  O objetivo do FIN00000 é prover a carga inicial de cadastros do Logix para sistemas externos. É indicado que seja executado uma única vez na implantação da integração. Porém, nada impede que seja executado em outros momentos, conforme a necessidade de sincronização dos cadastros. 
  
  Abaixo a lista das entidades que precisam ser integradas com o RM através da carga inicial. É importante lembrar que o programa possui filtros, assim pode-se integrar somente os registros que o RM realmente irá utilizar.
  
  “Carga Inicial de Fornecedores para sistemas Externos.”
  “Carga Inicial de Plano de contas para integrações.”
  “Carga Inicial de Centro de Custos.”
  “Carga Inicial de Área e linha de negócio.”
  "Carga inicial de agências bancárias"
  "Carga inicial de históricos contábeis"
  "Carga inicial de períodos contábeis"
  
  
   ATENÇÃO é imprescindível que a carga inicial das tabelas acima seja realizada pelo FIN00000. Este programa funciona da seguinte maneira: 
  
  1º - Usuário seleciona a entidade que deseja enviar para o RM;
  2º - Define quais serão os critérios de filtros; 
  3º - Processa a carga; 
  4º - Sistema seleciona as entidades conforme o filtro, para cada registro é enviado um XML para o RM. 
  5º - RM recepciona o XML, consiste e retorna o resultado para o Logix, contendo o código da entidade na Origem (Logix) e Destino (RM). 
  6º - Logix grava o De-para da entidade, que chamamos de "InternalId". 
  
  OBS: A comunicação entre os sistemas utiliza o "InternalID" que trata-se do cadastro "De-para" que é gravado em ambos os sistemas. Esta técnica permite a comunicação entre os sistemas que utilizam tipos de dados diferentes como chave das entidades. Sempre que o Logix referenciar uma chave estrangeira em uma mensagem será utilizado o InternalID do Logix, da mesma forma o RM utilizará o seu InternalID nas comunicações com o Logix. O sistema receptor resolverá o código através do cadastro "De-para"
  
  Os seguintes De-para são utilizados na carga de cadastros do Logix: 

Checklist de suporte da aplicação

Checklist de Verificações:

Passos para Integração RM x ERP Logix

1. Executar o Configurador para instalar a integração com o BackOffice Logix.
2. Parametrizar a integração criada com o BackOffice Logix.
3. Configurar o De-Para referente a Coligada.
4. Parametrizar o Folha de Pagamento para integração dos lançamentos.

Anexos